pdiag_shared_slot
Purpose
Finds all devices that share a slot with the requested device.
Syntax
#include <sys/pdiag_def.h>
int32 pdiag_shared_slot (char *device_instance)
Description
The pdiag_shared_slot subroutine finds the siblings
of a device and then attempts to determine which siblings are on the
same slot. Under some circumstances this function may return more
devices sharing a slot than physically exist. This function will
always return the device instance at the front of the list, if there
are no other devices sharing the slot, the function will return a
pointer to the device instance.
Note: This subroutine function will
return adapters that are in available and in defined state. It is
the responsibility of the calling application to determine if any
of the adapters have been removed from the system.
Parameters
| Parameter | Description |
|---|---|
| device_instance | Name of device under test. |
Return Value
The pdiag_shared_slot subroutine returns one of the following values:
| Return Value | Description |
|---|---|
| A pointer to the head of a doubly-linked list | Successful return. Note: The device_instance lies at
the front of the list.
|
| NULL | An error occurred while finding siblings or retrieving data from the ODM. |