1soconfig(1M) System Administration Commands soconfig(1M)
2
3
4
6 soconfig - configure transport providers for use by sockets
7
9 /sbin/soconfig -f file
10
11
12 /sbin/soconfig family type protocol [path]
13
14
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
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
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
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
113 /etc/sock2path File containing mappings from sockets to transport
114 providers.
115
116
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
130 init(1M), sock2path(4), attributes(5)
131
132
133 Network Interface Guide
134
135
136
137SunOS 5.11 29 Oct 2008 soconfig(1M)