Commands Reference, Volume 3

lsparent Command

Purpose

Displays the possible parent devices that accept a specified connection type or device.

Syntax

lsparent { -C | -P } { -k ChildConnectionKey | -l ChildName } [ -f File ] [ -FFormat] [ -h ] [ -H]

The lsparent command lists devices from the Device Configuration database that can accept a given device as a child device, specified by the -l ChildName flag, or a given type of child device connection, specified by the -k ChildConnectionKey flag.

You can display the default output one of two ways. You can either display the default output information for a device from the Customized Devices object class, which is name, state, location, and description, using the -C flag, or display the default output information for a device from the Predefined Devices object class, which is class, type, subclass, and description, using the -P flag. To override these two default outputs, you can use the -F Format flag to display the output as designated by a user-formatted string. The Format parameter is a quoted list of column names separated and possibly terminated by nonalphanumeric characters.

You can supply the flags either on the command line or from the specified File parameter.

Flags

-C	Lists information about a device that is in the Customized Devices object class. The information displayed can be from both the Customized and Predefined Devices object classes. This flag cannot be used with the -P flag.
-f File	Reads the needed flags from the File variable.
-F Format	Displays the output in a user-specified format, where the Format variable is a quoted list of column names from the Predefined Devices object class or the Customized Devices object class separated and possibly terminated by nonalphanumeric characters. Using white space as the separator, the lsparent command displays the output in aligned columns. In addition to the column names in the two object classes, the special name description can be used to display a text description of the device.
-H	Displays headers above the column output.
-h	Displays the command usage message.
-k ChildConnectionKey	Specifies the connection key that identifies the device subclass name of the child device. This flag cannot be used with the -l flag.
-l ChildName	Specifies the logical name of a possible child device. This flag cannot be used with the -k flag.
-P	Lists information about a device that is in the Predefined Devices object class. The information displayed can be from both the Customized and Predefined Devices object classes. This flag cannot be used with the -C flag.

Examples

To list possible parent devices in the Customized Devices object class that accept an RS-232 device, enter:
lsparent -C -k rs232
The system displays a message similar to the following:

sa0  Available    00-03       8-Port Asynchronous Adapter EIA-232
sa1  Available    00-00-S1    Standard I/O Serial Port 1
sa2  Available    00-00-S2    Standard I/O Serial Port 2

To list possible types of parent devices in the Predefined Devices object class that accept an RS-232 device, enter:
lsparent -P -k rs232
The system displays a message similar to the following:

adapter  8p232   mca     8-Port Asynchronous Adapter EIA-232
adapter  16p232  mca     16-Port Asynchronous Adapter EIA-232
adapter  s1a     sio     Standard I/O Serial Port 1
adapter  s2a     sio     Standard I/O Serial Port 2
adapter  64p232  mca     64-Port Asynchronous Controller

To list possible parent devices in the Customized Devices object class that accept the tape device rmt0 as a child device, enter:
lsparent -C -l rmt0
The system displays a message similar to the following:
```
scsi0  Available         00-07   SCSI I/O Controller
scsi1  Available         00-08   SCSI I/O Controller
```
To list possible types of parent devices in the Predefined Devices object class that accept the tape device rmt0 as a child device, enter:
lsparent -P -l rmt0
The system displays a message similar to the following:
```
adapter hscsi   mca    SCSI I/O Controller
```

Files

/usr/sbin/lsparent

Contains the lsparent command.

Related Information

The chdev command, lsattr command, lsconn command, lsdev command, mkdev command, rmdev command.

Devices Overview for System Management in AIX 5L Version 5.1 System Management Concepts: Operating System and Devices provides information about adding, changing, moving, and removing devices.