illumos: manual page: scsi_hba_iport

SCSI_HBA_IPORT_EXIST(9F) Kernel Functions for Drivers SCSI_HBA_IPORT_EXIST(9F)

NAME

scsi_hba_iport_exist, scsi_hba_iport_find - find and check if an iport
exists

SYNOPSIS

#include <sys/scsi/scsi.h>

int
scsi_hba_iport_exist(dev_info_t *dip);

dev_info_t *
scsi_hba_iport_find(dev_info_t *dip, char *ua);

INTERFACE LEVEL

Evolving - This interface is still evolving in illumos. API and ABI
stability is not guaranteed.

PARAMETERS

dip Pointer to dev_info structure.

ua The unit address of the iport being searched for.

DESCRIPTION

The scsi_hba_iport_exists() function is used to determine whether or not
dip has any child devices that are iports which have been added through
scsi_hba_iport_register(9F) or scsi_hba_iportmap_iport_add(9F). For more
information on iports, see iport(9).

The scsi_hba_iport_find() function attempts to find a child iport and
return its dev_info structure if it exists. The iport is searched for by
its unit address, which is passed in the ua argument. The unit address for
an iport is established when the iport is created.

CONTEXT

The scsi_hba_iport_exist() and scsi_hba_iport_find() functions may be
called in either user or kernel context.

RETURN VALUES

The scsi_hba_iport_exists() function returns 1 when there is a child iport
of dip. Otherwise, it returns 0.

The scsi_hba_iport_find() function returns a pointer to the iport's
dev_info structure, if found. Otherwise, NULL is returned.