PPTADM(8) Maintenance Commands and Procedures PPTADM(8)

NAME

pptadm - PPT administration utility

SYNOPSIS

pptadm list -j [-a]
pptadm list [-ap [-o fields]]

DESCRIPTION

The pptadm utility can enumerate passthrough devices for use by a
virtualized guest.

OPTIONS

The following options to the list command are supported:

-a Show all PPT devices, both available and assigned.

-j Output JSON.

-o Specify fields to output, or "all". Available fields are
dev,path,vendor,device,subvendor,subdevice,rev,label

-p Output in a parsable format; this requires the -o option to be
specified.

JSON OUTPUT

The JSON output consists of an array under the key "devices" with the
fields:

dev The PPT /dev path, if assigned and bound.

path The physical /devices path.

vendor-id
The PCI vendor ID.

device-id
The PCI device ID.

subsystem-vendor-id
The PCI subsystem vendor ID.

subsystem-id
The PCI subsystem ID.

revision-id
The PCI device revision.

label Human-readable description from the PCI database.

FILES

/etc/ppt_aliases
Containts the bindings of PPT devices in the same format as
/etc/driver_aliases

/etc/ppt_matches
Identifies devices that PPT could be bound to, either by
physical path, or by PCI ID.

EXIT STATUS

The pptadm utility exits 0 on success, and >0 if an error occurs.

illumos April 10, 2018 illumos