SERVICE_PROVIDER.CONF(4) File Formats and Configurations NNAAMMEE service_provider.conf - service provider configuration file SSYYNNOOPPSSIISS sseerrvviiccee__pprroovviiddeerr..ccoonnff DDEESSCCRRIIPPTTIIOONN sseerrvviiccee__pprroovviiddeerr..ccoonnff 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 command, ddaattaaddmm(1M). ddaattaaddmm(1M) puts this information in the DAT static register file, ddaatt..ccoonnff(4). The ddaattaaddmm program enumerates each device entry into a list of interface adapters, that is, interfaces to external network that are available to uDAPL consumers. This new list of interface adapters is appended to other service providers' information in the DAT static registry, ddaatt..ccoonnff. You can do this if you invoke the ddaattaaddmm program with the --aa option and the pathname of the sseerrvviiccee__pprroovviiddeerr..ccoonnff 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 sseerrvviiccee__pprroovviiddeerr..ccoonnff entry: "_d_r_i_v_e_r___n_a_m_e" "_A_P_I___v_e_r_s_i_o_n" "_t_h_r_e_a_d_s_a_f_e___l_i_b_r_a_r_y | \ _n_o_n_t_h_r_e_a_d_s_a_f_e___l_i_b_r_a_r_y"\ "_d_e_f_a_u_l_t___v_e_r_s_i_o_n | _n_o_n_d_e_f_a_u_l_t___v_e_r_s_i_o_n" \ "_s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___l_i_b_r_a_r_y___p_a_t_h_n_a_m_e"\ "_s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___v_e_r_s_i_o_n" "_s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___i_n_s_t_a_n_c_e___d_a_t_a"\ The fields are defined as follows: _d_r_i_v_e_r___n_a_m_e Specifies a driver name in the format of ddrriivveerr__nnaammee=_v_a_l_u_e _p_a_i_r, for example, ddrriivveerr__nnaammee==ttaavvoorr. _A_P_I___v_e_r_s_i_o_n Specifies the API version of the service provider library: For example, ""uu""mmaajjoorr..mmiinnoorr is uu11..22. _t_h_r_e_a_d_s_a_f_e___l_i_b_r_a_r_y | _n_o_n_t_h_r_e_a_d_s_a_f_e___l_i_b_r_a_r_y Specifies a threadsafe or non-threadsafe library. _d_e_f_a_u_l_t___v_e_r_s_i_o_n | _n_o_n_d_e_f_a_u_l_t___v_e_r_s_i_o_n Specifies a default or non-default version of a library. A service provider can offer several versions of the library. If so, one version is designated as ddeeffaauulltt with the rest as nnoonnddeeffaauulltt. _s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___l_i_b_r_a_r_y___p_a_t_h_n_a_m_e Specifies the pathname of the library image. _s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___v_e_r_s_i_o_n 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, SSUUNNWW11..00. _s_e_r_v_i_c_e___p_r_o_v_i_d_e_r___i_n_s_t_a_n_c_e___d_a_t_a Specifies the service provider instance data. EEXXAAMMPPLLEESS EExxaammppllee 11 Using a Logical Device Name The following example sseerrvviiccee__pprroovviiddeerr..ccoonnff 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 "" EExxaammppllee 22 Using a Physical Device Name The following example sseerrvviiccee__pprroovviiddeerr..ccoonnff 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 "" AATTTTRRIIBBUUTTEESS See aattttrriibbuutteess(5) for descriptions of the following attributes: +---------------+-----------------+ |ATTRIBUTE TYPE | ATTRIBUTE VALUE | |Stability | Evolving | +---------------+-----------------+ SSEEEE AALLSSOO ddaattaaddmm(1M), ddaatt..ccoonnff(4), aattttrriibbuutteess(5) June 18, 2004 SERVICE_PROVIDER.CONF(4)