1 SMHBA.CONF(4)           File Formats and Configurations          SMHBA.CONF(4)
   2 
   3 
   4 
   5 NAME
   6        smhba.conf - configuration file for the SMHBAAPI library
   7 
   8 DESCRIPTION
   9        The /etc/smhba.conf file is used to specify the Vendor-Specific
  10        Libraries that are installed on the system. This file is used by the
  11        Common Library to load the individual VSLs when
  12        HBA_LoadLibrary(3HBAAPI) is called. If changes are made to the file
  13        while the library is in use, the library should be freed and reloaded.
  14        A version 1 VSL is compatible only with a version 1 Common Library. A
  15        version 2 VSL is compatible with both a version 1 and a version 2
  16        Common Library.
  17 
  18 
  19        Each VSL entry is a single line of the form:
  20 
  21          "name"        "library path"
  22 
  23 
  24 
  25        where:
  26 
  27        name
  28                        is the description of library. The library name should
  29                        be prepended with the domain of the manufacturer of the
  30                        library.
  31 
  32 
  33        library path
  34                        is the absolute path to the shared object library file.
  35 
  36 
  37 EXAMPLES
  38        Example 1 Contents of /etc/smhba.conf
  39 
  40          #
  41          # This file contains names and references to SM-HBA libraries
  42          #
  43          # Format:
  44          #
  45          # <library name>  <library pathname>
  46          #
  47          # The library name should be prepended with the domain of
  48          # the manufacturer or driver author.
  49          com.sun.sashba        /usr/lib/libsun_sas.so.1
  50          com.sun.sashba64      /usr/lib/64/libsun_sas.so.1
  51 
  52 
  53 ATTRIBUTES
  54        See attributes(5) for descriptions of the following attributes:
  55 
  56 
  57 
  58 
  59        +--------------------+-------------------------+
  60        |  ATTRIBUTE TYPE    |     ATTRIBUTE VALUE     |
  61        +--------------------+-------------------------+
  62        |Interface Stability | Committed               |
  63        +--------------------+-------------------------+
  64        |Standard            | ANSI INCITS 428         |
  65        |                    | Storage Management Host |
  66        |                    | Bus Adapter Application |
  67        |                    | Programming             |
  68        |                    | Interface(SM-HBA)       |
  69        +--------------------+-------------------------+
  70 
  71 SEE ALSO
  72        HBA_LoadLibrary(3HBAAPI), libSMHBAAPI(3LIB), attributes(5)
  73 
  74 NOTES
  75        The SMHBAAPI library is provided in both 32-and 64-bit versions, but
  76        only one configuration file is specified. As a result, both 32- and
  77        64-bit VSL libraries must be specified within the same file. When using
  78        the 32-bit Common Library, the 64-bit VSLs will fail to load. When
  79        using the 64-bit Common Library, the 32-bit VSLs will fail to load.
  80        These failures are silently ignored by the Common Library during normal
  81        usage, but can result in warning messages when running client
  82        applications in a debugger.
  83 
  84 
  85 
  86                                  May 16, 2020                    SMHBA.CONF(4)