soconfig(1M)

NAME

     soconfig - configure transport providers for use by sockets

SYNOPSIS

     /sbin/soconfig -f file

     /sbin/soconfig family type protocol [path]

DESCRIPTION

     The  soconfig  utility  configures  the  transport  provider
     driver  for  use  with sockets. It specifies how the family,
     type, and protocol parameters in  the  socket(3SOCKET)  call
     are  mapped  to  the  name  of  a transport provider such as
     /dev/tcp.  This utility can be used  to  add  an  additional
     mapping or remove a previous mapping.

     The init(1M) utility uses  soconfig  with  the  sock2path(4)
     file during the booting sequence.

OPTIONS

     The following options are supported:

     -f file
           Set up the  soconfig  configuration  for  each  driver
           according  to the information stored in file. A socon-
           fig file consists of lines of at least the first three
           fields listed below, separated by spaces:

           family  type  protocol  path

     These fields are described in the OPERANDS section below.

           An example of file can be found in the  EXAMPLES  sec-
           tion below.

OPERANDS

     The following operands are supported:

     family
           The    protocol    family    as    listed    in    the
           /usr/include/sys/socket.h   file,   expressed   as  an
           integer.

     type  The    socket    type     as     listed     in     the
           /usr/include/sys/socket.h   file,   expressed   as  an
           integer.

     protocol
           The  protocol  number  as  specified  in  the  family-
           specific  include  file, expressed as an integer.  For
           example, for  AF_INET  this  number  is  specified  in
           /usr/include/netinet/in.h.   An  unspecified  protocol
           number is denoted with the value zero.

     path  The string that specifies the path name of the  device
           that  corresponds  to the transport provider.  If this
           parameter is  specified,  the  configuration  will  be
           added for the specified family, type, and protocol. If
           this parameter is  not  specified,  the  configuration
           will be removed.

EXAMPLES

     Example 1: Using soconfig

     The following example sets up /dev/tcp  for  family  AF_INET
     and type SOCK_STREAM:

     example# soconfig 2 2 0 /dev/tcp

     The following is a sample file used with the -f option. Com-
     ment lines begin with a number sign (#):

     #     Family   Type  Protocol    Path
           2       2       0       /dev/tcp
           2       2       6       /dev/tcp

           2       1       0       /dev/udp
           2       1       17      /dev/udp

           1       2       0       /dev/ticotsord
           1       1       0       /dev/ticlts

           2       4       0       /dev/rawip

FILES

     /etc/sock2path
           file containing mappings  from  sockets  to  transport
           providers

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsr                     |
    |_____________________________|_____________________________|

SEE ALSO

     init(1M), , sock2path(4), attributes(5)

     Network Interfaces Programmer's Guide