1 SERVICE_PROVIDER.CONF(4)                       File Formats and Configurations
   2 
   3 
   4 
   5 NAME
   6        service_provider.conf - service provider configuration file
   7 
   8 SYNOPSIS
   9        service_provider.conf
  10 
  11 
  12 DESCRIPTION
  13        service_provider.conf contains information about the device type that
  14        the service provider supports. This information includes the pathname
  15        of the service provider library, the library version and other library
  16        characteristics that are required by the system administrative command,
  17        datadm(1M).  datadm(1M) puts this information in the DAT static
  18        register file, dat.conf(4).
  19 
  20 
  21        The datadm program enumerates each device entry into a list of
  22        interface adapters, that is, interfaces to external network that are
  23        available to uDAPL consumers. This new list of interface adapters is
  24        appended to other service providers' information in the DAT static
  25        registry, dat.conf. You can do this if you invoke the datadm program
  26        with the -a option and the pathname of the service_provider.conf file.
  27 
  28 
  29        Each entry in the service_provider.conf is a single line of 7 fields.
  30 
  31 
  32        The following shows the order of the fields in a service_provider.conf
  33        entry:
  34 
  35          "driver_name" "API_version" "threadsafe_library | \
  36                nonthreadsafe_library"\
  37          "default_version | nondefault_version" \
  38               "service_provider_library_pathname"\
  39          "service_provider_version" "service_provider_instance_data"\
  40 
  41 
  42 
  43        The fields are defined as follows:
  44 
  45        driver_name
  46 
  47            Specifies a driver name in the format of driver_name=value pair,
  48            for example, driver_name=tavor.
  49 
  50 
  51        API_version
  52 
  53            Specifies the API version of the service provider library: For
  54            example, "u"major.minor is u1.2.
  55 
  56 
  57        threadsafe_library | nonthreadsafe_library
  58 
  59            Specifies a threadsafe or non-threadsafe library.
  60 
  61 
  62        default_version | nondefault_version
  63 
  64            Specifies a default or non-default version of a library. A service
  65            provider can offer several versions of the library. If so, one
  66            version is designated as default with the rest as nondefault.
  67 
  68 
  69        service_provider_library_pathname
  70 
  71            Specifies the pathname of the library image.
  72 
  73 
  74        service_provider_version
  75 
  76            Specifies the version of the service provider. By convention,
  77            specify the company stock symbol as the service provider, followed
  78            by major and minor version numbers, for example, SUNW1.0.
  79 
  80 
  81        service_provider_instance_data
  82 
  83            Specifies the service provider instance data.
  84 
  85 
  86 EXAMPLES
  87        Example 1 Using a Logical Device Name
  88 
  89 
  90        The following example service_provider.conf entry uses a logical device
  91        name:
  92 
  93 
  94          #
  95          # Sample service_provider.conf entry showing an uDAPL 1.2 service
  96          # provider, udapl_tavor.so.1 supporting a device with a driver named
  97          # tavor
  98          driver_name=tavor u1.2 nonthreadsafe default udapl_tavor.so.1 \
  99              SUNW.1.0 ""
 100 
 101 
 102        Example 2 Using a Physical Device Name
 103 
 104 
 105        The following example service_provider.conf uses a physical device
 106        name:
 107 
 108 
 109          #
 110          # Sample service_provider.conf entry showing an uDAPL 1.2
 111          # service provider, udapl_tavor.so.1 supporting a device named
 112          # pci15b3,5a44 that can be located under /devices
 113          #
 114          pci15b3,5a44 u1.2 nonthreadsafe default \
 115              /usr/lib/tavor/udapl_tavor.so.1 SUNWudaplt1.0 ""
 116 
 117 
 118 ATTRIBUTES
 119        See attributes(5) for descriptions of the following attributes:
 120 
 121 
 122 
 123 
 124        +---------------+-----------------+
 125        |ATTRIBUTE TYPE | ATTRIBUTE VALUE |
 126        |Stability      | Evolving        |
 127        +---------------+-----------------+
 128 
 129 SEE ALSO
 130        datadm(1M), dat.conf(4), attributes(5)
 131 
 132 
 133 
 134                                  June 18, 2004        SERVICE_PROVIDER.CONF(4)