1 '\" te
2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SMHBA.CONF 4 "Sep 28, 2009"
7 .SH NAME
8 smhba.conf \- configuration file for the SMHBAAPI library
9 .SH DESCRIPTION
10 .sp
11 .LP
12 The \fB/etc/smhba.conf\fR file is used to specify the Vendor-Specific Libraries
13 that are installed on the system. This file is used by the Common Library to
14 load the individual VSLs when \fBHBA_LoadLibrary\fR(3HBAAPI) is called. If
15 changes are made to the file while the library is in use, the library should be
16 freed and reloaded. A version 1 VSL is compatible only with a version 1 Common
17 Library. A version 2 VSL is compatible with both a version 1 and a version 2
18 Common Library.
19 .sp
20 .LP
21 Each VSL entry is a single line of the form:
22 .sp
23 .in +2
24 .nf
25 "name" "library path"
26 .fi
27 .in -2
28
29 .sp
30 .LP
31 where:
32 .sp
33 .ne 2
34 .na
35 \fB\fIname\fR\fR
36 .ad
37 .RS 16n
38 is the description of library. The library name should be prepended with the
39 domain of the manufacturer of the library.
40 .RE
41
42 .sp
43 .ne 2
44 .na
45 \fB\fIlibrary path\fR\fR
46 .ad
47 .RS 16n
48 is the absolute path to the shared object library file.
49 .RE
50
51 .SH EXAMPLES
52 .LP
53 \fBExample 1 \fRContents of \fB/etc/smhba.conf\fR
54 .sp
55 .in +2
56 .nf
57 #
58 # This file contains names and references to SM-HBA libraries
59 #
60 # Format:
61 #
62 # <library name> <library pathname>
63 #
64 # The library name should be prepended with the domain of
65 # the manufacturer or driver author.
66 com.sun.sashba /usr/lib/libsun_sas.so.1
67 com.sun.sashba64 /usr/lib/64/libsun_sas.so.1
68 .fi
69 .in -2
70
71 .SH ATTRIBUTES
72 .sp
73 .LP
74 See \fBattributes\fR(5) for descriptions of the following attributes:
75 .sp
76
77 .sp
78 .TS
79 box;
80 c | c
81 l | l .
82 ATTRIBUTE TYPE ATTRIBUTE VALUE
83 _
84 Interface Stability Committed
85 _
86 Standard T{
87 ANSI INCITS 428 Storage Management Host Bus Adapter Application Programming Ingerface(SM-HBA)
88 T}
89 .TE
90
91 .SH SEE ALSO
92 .sp
93 .LP
94 \fBHBA_LoadLibrary\fR(3HBAAPI), \fBlibSMHBAAPI\fR(3LIB), \fBattributes\fR(5)
95 .SH NOTES
96 .sp
97 .LP
98 The SMHBAAPI library is provided in both 32-and 64-bit versions, but only one
99 configuration file is specified. As a result, both 32- and 64-bit VSL libraries
100 must be specified within the same file. When using the 32-bit Common Library,
101 the 64-bit VSLs will fail to load. When using the 64-bit Common Library, the
102 32-bit VSLs will fail to load. These failures are silently ignored by the
103 Common Library during normal usage, but can result in warning messages when
104 running client applications in a debugger.
|
1 '\" te
2 .\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.
3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
4 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
5 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
6 .TH SMHBA.CONF 4 "May 16, 2020"
7 .SH NAME
8 smhba.conf \- configuration file for the SMHBAAPI library
9 .SH DESCRIPTION
10 The \fB/etc/smhba.conf\fR file is used to specify the Vendor-Specific Libraries
11 that are installed on the system. This file is used by the Common Library to
12 load the individual VSLs when \fBHBA_LoadLibrary\fR(3HBAAPI) is called. If
13 changes are made to the file while the library is in use, the library should be
14 freed and reloaded. A version 1 VSL is compatible only with a version 1 Common
15 Library. A version 2 VSL is compatible with both a version 1 and a version 2
16 Common Library.
17 .sp
18 .LP
19 Each VSL entry is a single line of the form:
20 .sp
21 .in +2
22 .nf
23 "name" "library path"
24 .fi
25 .in -2
26
27 .sp
28 .LP
29 where:
30 .sp
31 .ne 2
32 .na
33 \fB\fIname\fR\fR
34 .ad
35 .RS 16n
36 is the description of library. The library name should be prepended with the
37 domain of the manufacturer of the library.
38 .RE
39
40 .sp
41 .ne 2
42 .na
43 \fB\fIlibrary path\fR\fR
44 .ad
45 .RS 16n
46 is the absolute path to the shared object library file.
47 .RE
48
49 .SH EXAMPLES
50 \fBExample 1 \fRContents of \fB/etc/smhba.conf\fR
51 .sp
52 .in +2
53 .nf
54 #
55 # This file contains names and references to SM-HBA libraries
56 #
57 # Format:
58 #
59 # <library name> <library pathname>
60 #
61 # The library name should be prepended with the domain of
62 # the manufacturer or driver author.
63 com.sun.sashba /usr/lib/libsun_sas.so.1
64 com.sun.sashba64 /usr/lib/64/libsun_sas.so.1
65 .fi
66 .in -2
67
68 .SH ATTRIBUTES
69 See \fBattributes\fR(5) for descriptions of the following attributes:
70 .sp
71
72 .sp
73 .TS
74 box;
75 c | c
76 l | l .
77 ATTRIBUTE TYPE ATTRIBUTE VALUE
78 _
79 Interface Stability Committed
80 _
81 Standard T{
82 ANSI INCITS 428 Storage Management Host Bus Adapter Application Programming Interface(SM-HBA)
83 T}
84 .TE
85
86 .SH SEE ALSO
87 \fBHBA_LoadLibrary\fR(3HBAAPI), \fBlibSMHBAAPI\fR(3LIB), \fBattributes\fR(5)
88 .SH NOTES
89 The SMHBAAPI library is provided in both 32-and 64-bit versions, but only one
90 configuration file is specified. As a result, both 32- and 64-bit VSL libraries
91 must be specified within the same file. When using the 32-bit Common Library,
92 the 64-bit VSLs will fail to load. When using the 64-bit Common Library, the
93 32-bit VSLs will fail to load. These failures are silently ignored by the
94 Common Library during normal usage, but can result in warning messages when
95 running client applications in a debugger.
|