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.