1soconfig(1M)            System Administration Commands            soconfig(1M)
2
3
4

NAME

6       soconfig - configure transport providers for use by sockets
7

SYNOPSIS

9       /sbin/soconfig -f file
10
11
12       /sbin/soconfig family type protocol [path]
13
14

DESCRIPTION

16       The  soconfig  utility configures the transport provider driver for use
17       with sockets. It specifies how the family, type, and  protocol  parame‐
18       ters  in the socket(3SOCKET) call are mapped to the name of a transport
19       provider such as /dev/tcp. This utility can be used  to  add  an  addi‐
20       tional mapping or remove a previous mapping.
21
22
23       The  init(1M)  utility  uses soconfig with the sock2path(4) file during
24       the booting sequence.
25

OPTIONS

27       The following options are supported:
28
29       -f file    Set up the soconfig configuration for each driver  according
30                  to  the information stored in file. A soconfig file consists
31                  of lines of at least the first three  fields  listed  below,
32                  separated by spaces:
33
34                  family  type  protocol  path
35
36                  These fields are described in the OPERANDS section below.
37
38                  An  example  of  file  can  be found in the EXAMPLES section
39                  below.
40
41

OPERANDS

43       The following operands are supported:
44
45       family           The    protocol    family    as    listed    in    the
46                        /usr/include/sys/socket.h  file, expressed as an inte‐
47                        ger.
48
49
50       type             The    socket    type     as     listed     in     the
51                        /usr/include/sys/socket.h  file, expressed as an inte‐
52                        ger.
53
54
55       protocol         The protocol number as specified  in  the  family-spe‐
56                        cific include file, expressed as an integer. For exam‐
57                        ple,  for  AF_INET  this  number   is   specified   in
58                        /usr/include/netinet/in.h.   An  unspecified  protocol
59                        number is denoted with the value zero.
60
61
62       module | path    The module name or path name of a device  that  corre‐
63                        sponds  to  the  transport  provider,  such  as tcp or
64                        /dev/tcp. Modules must reside in  kernel/socketmod.  A
65                        device name must begin with /dev. If this parameter is
66                        specified, the configuration will  be  added  for  the
67                        specified  family, type, and protocol. If this parame‐
68                        ter  is  not  specified,  the  configuration  will  be
69                        removed.
70
71

EXAMPLES

73       Example 1 Using soconfig
74
75
76       The  following  example  sets  up  a module for family AF_INET and type
77       SOCK_STREAM:
78
79
80         example# soconfig 2 2 0 tcp
81
82
83
84
85       The following example sets up /dev/tcp  for  family  AF_INET  and  type
86       SOCK_STREAM:
87
88
89         example# soconfig 2 2 0 /dev/tcp
90
91
92
93
94       The  following  is a sample file used with the -f option. Comment lines
95       begin with a hash mark (#):
96
97
98         #   Family  Type  Protocol   Module | Path
99               2       2       0          tcp
100               2       2       6          tcp
101
102               2       1       0          udp
103               2       1       17         udp
104
105               1       2       0          /dev/ticotsord
106               1       1       0          /dev/ticlts
107
108               2       4       0          icmp
109
110
111

FILES

113       /etc/sock2path    File containing mappings from  sockets  to  transport
114                         providers.
115
116

ATTRIBUTES

118       See attributes(5) for descriptions of the following attributes:
119
120
121
122
123       ┌─────────────────────────────┬─────────────────────────────┐
124       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
125       ├─────────────────────────────┼─────────────────────────────┤
126       │Availability                 │SUNWcsr                      │
127       └─────────────────────────────┴─────────────────────────────┘
128

SEE ALSO

130       init(1M), sock2path(4), attributes(5)
131
132
133       Network Interface Guide
134
135
136
137SunOS 5.11                        29 Oct 2008                     soconfig(1M)
Impressum