System Administration Commands 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 map-
ping 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
soconfig 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 sec-
tion below.
An example of file can be found in the EXAMPLES
section 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.
SunOS 5.11 Last change: 29 Oct 2008 1
System Administration Commands soconfig(1M)
protocol The protocol number as specified in the
family-specific include file, expressed as
an integer. For example, for AFINET this
number is specified in
/usr/include/netinet/in.h. An unspecified
protocol number is denoted with the value
zero.
module path The module name or path name of a device
that corresponds to the transport provider,
such as tcp or /dev/tcp. Modules must
reside in kernel/socketmod. A device name
must begin with /dev. If this parameter is
specified, the configuration will be added
for the specified family, type, and proto-
col. If this parameter is not specified,
the configuration will be removed.
EXAMPLES
Example 1 Using soconfig
The following example sets up a module for family AFINET
and type SOCKSTREAM:
example# soconfig 2 2 0 tcp
The following example sets up /dev/tcp for family AFINET
and type SOCKSTREAM:
example# soconfig 2 2 0 /dev/tcp
The following is a sample file used with the -f option. Com-
ment lines begin with a hash mark (#):
# Family Type Protocol Module Path
2 2 0 tcp
2 2 6 tcp
2 1 0 udp
2 1 17 udp
SunOS 5.11 Last change: 29 Oct 2008 2
System Administration Commands soconfig(1M)
1 2 0 /dev/ticotsord
1 1 0 /dev/ticlts
2 4 0 icmp
FILES
/etc/sock2path File containing mappings from sockets to
transport providers.
ATRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
ATRIBUTE TYPE ATRIBUTE VALUE
Availability SUNWcsr
SEE ALSO
init(1M), sock2path(4), attributes(5)
Network Interface Guide
SunOS 5.11 Last change: 29 Oct 2008 3
|
