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