1*3385b472SRobert Mustacchi.\"
2*3385b472SRobert Mustacchi.\" This file and its contents are supplied under the terms of the
3*3385b472SRobert Mustacchi.\" Common Development and Distribution License ("CDDL"), version 1.0.
4*3385b472SRobert Mustacchi.\" You may only use this file in accordance with the terms of version
5*3385b472SRobert Mustacchi.\" 1.0 of the CDDL.
6*3385b472SRobert Mustacchi.\"
7*3385b472SRobert Mustacchi.\" A full copy of the text of the CDDL should have accompanied this
8*3385b472SRobert Mustacchi.\" source.  A copy of the CDDL is also available via the Internet at
9*3385b472SRobert Mustacchi.\" http://www.illumos.org/license/CDDL.
10*3385b472SRobert Mustacchi.\"
11*3385b472SRobert Mustacchi.\"
12*3385b472SRobert Mustacchi.\" Copyright (c) 2017, Joyent, Inc.
13*3385b472SRobert Mustacchi.\"
14*3385b472SRobert Mustacchi.Dd Apr 18, 2017
15*3385b472SRobert Mustacchi.Dt SCSI_HBA_IPORT_UNIT_ADDRESS 9F
16*3385b472SRobert Mustacchi.Os
17*3385b472SRobert Mustacchi.Sh NAME
18*3385b472SRobert Mustacchi.Nm scsi_hba_iport_unit_address
19*3385b472SRobert Mustacchi.Nd Get the unit address of an iport
20*3385b472SRobert Mustacchi.Sh SYNOPSIS
21*3385b472SRobert Mustacchi.In sys/scsi/scsi.h
22*3385b472SRobert Mustacchi.Ft "char *"
23*3385b472SRobert Mustacchi.Fo scsi_hba_iport_unit_address
24*3385b472SRobert Mustacchi.Fa "dev_info_t *dip"
25*3385b472SRobert Mustacchi.Fc
26*3385b472SRobert Mustacchi.Sh INTERFACE LEVEL
27*3385b472SRobert Mustacchi.Sy Evolving -
28*3385b472SRobert MustacchiThis interface is still evolving in illumos.
29*3385b472SRobert MustacchiAPI and ABI stability is
30*3385b472SRobert Mustacchinot guaranteed.
31*3385b472SRobert Mustacchi.Sh PARAMETERS
32*3385b472SRobert Mustacchi.Bl -tag -width Fa
33*3385b472SRobert Mustacchi.It Fa dip
34*3385b472SRobert MustacchiPointer to
35*3385b472SRobert Mustacchi.Vt dev_info
36*3385b472SRobert Mustacchistructure.
37*3385b472SRobert Mustacchi.El
38*3385b472SRobert Mustacchi.Sh DESCRIPTION
39*3385b472SRobert MustacchiThe
40*3385b472SRobert Mustacchi.Fn scsi_hba_iport_unit_address
41*3385b472SRobert Mustacchifunction is used to obtain the unit address of an iport.
42*3385b472SRobert MustacchiFor more information on iports, see
43*3385b472SRobert Mustacchi.Xr iport 9 .
44*3385b472SRobert Mustacchi.Pp
45*3385b472SRobert MustacchiThis function can be used to determine whether or not a device node in
46*3385b472SRobert Mustacchithe tree is an iport.
47*3385b472SRobert MustacchiIf the device node corresponds to an iport, then
48*3385b472SRobert Mustacchithe unit address used when it was created either through
49*3385b472SRobert Mustacchi.Xr scsi_hba_iport_register 9F
50*3385b472SRobert Mustacchior
51*3385b472SRobert Mustacchi.Xr scsi_hba_iportmap_iport_add 9F
52*3385b472SRobert Mustacchiwill be returned.
53*3385b472SRobert Mustacchi.Sh CONTEXT
54*3385b472SRobert MustacchiThe
55*3385b472SRobert Mustacchi.Fn scsi_hba_iport_unit_address
56*3385b472SRobert Mustacchifunction may be called in
57*3385b472SRobert Mustacchi.Sy user ,
58*3385b472SRobert Mustacchi.Sy kernel ,
59*3385b472SRobert Mustacchior
60*3385b472SRobert Mustacchi.Sy interrupt
61*3385b472SRobert Mustacchicontext.
62*3385b472SRobert Mustacchi.Sh RETURN VALUES
63*3385b472SRobert MustacchiIf
64*3385b472SRobert Mustacchi.Fa dip
65*3385b472SRobert Mustacchiis an iport, then the unit address string the device was registered with
66*3385b472SRobert Mustacchiis returned.
67*3385b472SRobert MustacchiOtherwise,
68*3385b472SRobert Mustacchi.Dv NULL
69*3385b472SRobert Mustacchiis returned.
70*3385b472SRobert Mustacchi.Sh SEE ALSO
71*3385b472SRobert Mustacchi.Xr iport 9 ,
72*3385b472SRobert Mustacchi.Xr iportmap 9 ,
73*3385b472SRobert Mustacchi.Xr scsi_hba_iport_register 9F ,
74*3385b472SRobert Mustacchi.Xr scsi_hba_iportmap_iport_add 9F
75