service_provider.conf(4) [opensolaris man page]
service_provider.conf(4) File Formats service_provider.conf(4) NAME
service_provider.conf - service provider configuration file SYNOPSIS
service_provider.conf DESCRIPTION
service_provider.conf contains information about the device type that the service provider supports. This information includes the pathname of the service provider library, the library version and other library characteristics that are required by the system administrative com- mand, datadm(1M). datadm(1M) puts this information in the DAT static register file, dat.conf(4). The datadm program enumerates each device entry into a list of interface adapters, that is, interfaces to external network that are avail- able to uDAPL consumers. This new list of interface adapters is appended to other service providers' information in the DAT static reg- istry, dat.conf. You can do this is you invoke the datadm program with the -a option and the pathname of the service_provider.conf file. Each entry in the service_provider.conf is a single line of 7 fields. The following shows the order of the fields in a service_provider.conf entry: "driver_name" "API_version" "threadsafe_library | nonthreadsafe_library" "default_version | nondefault_version" "service_provider_library_pathname" "service_provider_version" "service_provider_instance_data" The fields are defined as follows: driver_name Specifies a driver name in the format of driver_name=value pair, for example, driver_name=tavor. API_version Specifies the API version of the service provide library: For example, "u"major.minor is u1.2. threadsafe_library | nonthreadsafe_librar Specifies a threadsafe or non-threadsafe library. default_version | nondefault_version Specifies a default or non-default version of library. A service provider can offer several versions of the library. If so, one version is designated as default with the rest as nondefault. service_provider_library_pathname Specifies the pathname of the library image. service_provider_version Specifies the version of the service provider. By convention, specify the company stock symbol as the service provider, followed by major and minor version numbers, for example, SUNW1.0. service_provider_instance_data Specifies the service provider instance data. EXAMPLES
Example 1 Using a Logical Device Name The following example service_provider.conf entry uses a logical device name: # # Sample service_provider.conf entry showing an uDAPL 1.2 service # provider, udapl_tavor.so.1 supporting a device with a driver named # tavor driver_name=tavor u1.2 nonthreadsafe default udapl_tavor.so.1 SUNW.1.0 "" Example 2 Using a Physical Device Name The following example service_provider.conf uses a physical device name: # # Sample service_provider.conf entry showing an uDAPL 1.2 # service provider, udapl_tavor.so.1 supporting a device named # pci15b3,5a44 that can be located under /devices # pci15b3,5a44 u1.2 nonthreadsafe default /usr/lib/tavor/udapl_tavor.so.1 SUNWudaplt1.0 "" ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |Evolving | +-----------------------------+-----------------------------+ SEE ALSO
datadm(1M), dat.conf(4), attributes(5) SunOS 5.11 18 Jun 2004 service_provider.conf(4)
Check Out this Related Man Page
dat.conf(4) File Formats dat.conf(4) NAME
dat.conf - DAT static registry SYNOPSIS
/etc/dat/dat.conf DESCRIPTION
The DAT static registry, /etc/dat/dat.conf is a system-wide data resource maintained by the system administrative command datadm(1M). /etc/dat/dat.conf contains a list of interface adapters supported by uDAPL service providers. An interface adapter on Infiniband (IB) cor- responds to an IPoIB device instance, for example, ibd0. An IPoIB device name represents an IP interface plumbed by ifconfig(1M) on an IB partition/Host Channel Adapter port combination. Each entry in the DAT static registry is a single line that contains eight fields. Fields are separated by a <SPACE>. Lines that begin with a pound sign (#) are considered comments. All characters that follow the # are ignored. Enclose Solaris specific strings (Solaris_spe- cific_string) and service provider's instance data (service _provider_instance_data) in quotes. The following shows the order of the fields in a dat.conf entry: "interface_adapter_name" "API_version" "threadsafe | nonthreadsafe" "default | nondefault" "service_provider_library_pathname" "service_provider_version" "service _provider_instance_data" "Solaris_specific_string" The fields are defined as follows: interface_adapter_name Specifies the Interface Adapter (IA) name. In IB, this is the IPoIB device instance name, for example, ibd0. This represents an IP interface plumbed on an IB partition/port combination of the HCA. API_version Specifies the API version of the service provide library: For example, "u"major.minor is u1.2. threadsafe | nonthreadsafe Specifies a threadsafe or non-threadsafe library. default | nondefault Specifies a default or non-default version of library. A service provider can offer several versions of the library. If so, one version is designated as default with the rest as nondefault. service_provider_library_pathname Specifies the pathname of the library image. service_provider_version Specifies the version of the service provider. By convention, specify the company stock symbol as the service provider, followed by major and minor version numbers, for example, SUNW1.0. service _provider_instance_data Specifies the service provider instance data. Solaris_specific_string Specifies a platform specific string, for example, the device name in the service_provider.conf file. EXAMPLES
Example 1: Sample dat.conf File The following dat.conf file shows a uDAPL 1.2 service provider for tavor, udapl_tavor.so.1 supporting two interfaces, ibd0 and ibd1: # # dat.conf for uDAPL 1.2 # ibd0 u1.2 nonthreadsafe default udapl_tavor.so.1 SUNW.1.0 "" "driver_name=tavor" ibd1 u1.2 nonthreadsafe default udapl_tavor.so.1 SUNW.1.0 "" "driver_name=tavor" ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWudaplr | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ SEE ALSO
datadm(1M), ifconfig(1M), libdat(3LIB), service_provider.conf(4), attributes(5) NOTES
An empty dat.conf is created during the package SUNWudaplr installation if no file is present beforehand. Entries in the file are added or removed by running datadm(1M). The content of the platform specific string does not constitute an API. It is generated by datadm(1M) and might have a different content or interpretation in a future release. SunOS 5.10 18 Jun 2004 dat.conf(4)