File Formats netconfig(4)
NAME
netconfig - network configuration database
SYNOPSIS
/etc/netconfig
DESCRIPTION
The network configuration database, /etc/netconfig, is a
system file used to store information about networks that
are connected to the system. The netconfig database and the
routines that access it (see getnetconfig(3NSL)) are part of
the Network Selection component. The Network Selection com-
ponent also includes getnetpath(3NSL) routines to provide
application-specific network search paths. These routines
access the netconfig database based on the environment vari-
able NETPATH. See environ(5).
netconfig contains an entry for each network available on
the system. Entries are separated by newlines. Fields are
separated by whitespace and occur in the order in which they
are described below. Whitespace can be embedded as
``\blank'' or ``\tab''. Backslashes may be embedded as
``\\''. Lines in /etc/netconfig that begin with a # (hash)
in column 1 are treated as comments.
Each of the valid lines in the netconfig database correspond
to an available transport. Each entry is of the form:
network ID semantics flag protocol-family \
protocol-name network-device translation-libraries
network ID A string used to uniquely identify
a network. network ID consists of
non-null characters, and has a
length of at least 1. No maximum
length is specified. This namespace
is locally significant and the
local system administrator is the
naming authority. All network IDs
on a system must be unique.
semantics The semantics field is a string
identifying the ``semantics'' of
the network, that is, the set of
services it supports, by identify-
ing the service interface it pro-
vides. The semantics field is
SunOS 5.11 Last change: 18 Nov 2003 1
File Formats netconfig(4)
mandatory. The following semantics
are recognized.
tpiclts Transport Provider
Interface, connec-
tionless
tpicots Transport Provider
Interface, connec-
tion oriented
tpicotsord Transport Provider
Interface, connec-
tion oriented, sup-
ports orderly
release.
flag The flag field records certain
two-valued (``true'' and ``false'')
attributes of networks. flag is a
string composed of a combination of
characters, each of which indicates
the value of the corresponding
attribute. If the character is
present, the attribute is ``true.''
If the character is absent, the
attribute is ``false.'' ``-'' indi-
cates that none of the attributes
are present. Only one character is
currently recognized:
v Visible (``default'') network.
Used when the environment
variable NETPATH is unset.
protocol family The protocol family and protocol
name fields are provided for
protocol-specific applications. The
protocol family field contains a
string that identifies a protocol
family. The protocol family iden-
tifier follows the same rules as
those for network IDs; the string
consists of non-null characters, it
has a length of at least 1, and
there is no maximum length
SunOS 5.11 Last change: 18 Nov 2003 2
File Formats netconfig(4)
specified. A ``-'' in the protocol
family field indicates that no pro-
tocol family identifier applies
(the network is experimental). The
following are examples:
loopback Loopback (local to
host).
inet Internetwork: UDP,
TCP, and the like.
inet6 Internetwork over
IPv6: UDP, TCP, and
the like.
implink ARPANET imp addresses
pup PUP protocols: for
example, BSP
chaos MIT CHAOS protocols
ns XEROX NS protocols
nbs NBS protocols
ecma European Computer
Manufacturers Associa-
tion
datakit DATAKIT protocols
ccitt CIT protocols, X.25,
and the like.
sna IBM SNA
decnet DECNET
SunOS 5.11 Last change: 18 Nov 2003 3
File Formats netconfig(4)
dli Direct data link
interface
lat LAT
hylink NSC Hyperchannel
appletalk Apple Talk
nit Network Interface Tap
ieee802 IE 802.2; also ISO
8802
osi Umbrella for all fami-
lies used by OSI (for
example, protosw
lookup)
x25 CIT X.25 in particu-
lar
osinet AFI = 47, IDI = 4
gosip U.S. Government OSI
protocol name The protocol name field contains a
string that identifies a protocol.
The protocol name identifier fol-
lows the same rules as those for
network IDs; that is, the string
consists of non-NUL characters, it
has a length of at least 1, and
there is no maximum length speci-
fied. A ``-'' indicates that none
of the names listed apply. The fol-
lowing protocol names are recog-
nized.
tcp Transmission Control Proto-
col
SunOS 5.11 Last change: 18 Nov 2003 4
File Formats netconfig(4)
udp User Datagram Protocol
icmp Internet Control Message
Protocol
network device The network device is the full
pathname of the device used to con-
nect to the transport provider.
Typically, this device will be in
the /dev directory. The network
device must be specified.
translation libraries The name-to-address translation
libraries support a ``directory
service'' (a name-to-address map-
ping service) for the network. A
``-'' in this field indicates the
absence of any translation
libraries. This has a special mean-
ing for networks of the protocol
family inet : its name-to-address
mapping is provided by the name
service switch based on the entries
for hosts and services in
nsswitch.conf(4). For networks of
other families, a ``-'' indicates
non-functional name-to-address map-
ping. Otherwise, this field con-
sists of a comma-separated list of
pathnames to dynamically linked
libraries. The pathname of the
library can be either absolute or
relative. See dlopen(3C).
Each field corresponds to an element in the struct netconfig
structure. struct netconfig and the identifiers described on
this manual page are defined in . This struc-
ture includes the following members:
char *ncnetid Network ID, including NUL
terminator.
unsigned long ncsemantics Semantics.
SunOS 5.11 Last change: 18 Nov 2003 5
File Formats netconfig(4)
unsigned long ncflag Flags.
char *ncprotofmly Protocol family.
char *ncproto Protocol name.
char *ncdevice Full pathname of the network
device.
unsigned long ncnlookups Number of directory lookup
libraries.
char **nclookups Names of the name-to-address
translation libraries.
unsigned long ncunused[9] Reserved for future expansion.
The ncsemantics field takes the following values,
corresponding to the semantics identified above:
NCTPICLTS
NCTPICOTS
NCTPICOTSORD
The ncflag field is a bitfield. The following bit,
corresponding to the attribute identified above, is
currently recognized. NCNOFLAG indicates the absence of any
attributes.
NCVISIBLE
EXAMPLES
Example 1 A Sample netconfig File
Below is a sample netconfig file:
#
# The "Network Configuration" File.
#
# Each entry is of the form:
#
SunOS 5.11 Last change: 18 Nov 2003 6
File Formats netconfig(4)
#
#
#
# The "-" in for inet family transports indicates
# redirection to the name service switch policies for "hosts" and
# "services". The "-" may be replaced by nametoaddr libraries that
# comply with the SVr4 specs, in which case the name service switch
# will not be used for netdirgetbyname, netdirgetbyaddr,
# gethostbyname, gethostbyaddr, getservbyname, and getservbyport.
# There are no nametoaddrlibs for the inet family in Solaris anymore.
#
udp6 tpiclts v inet6 udp /dev/udp6 -
tcp6 tpicotsord v inet6 tcp /dev/tcp6 -
udp tpiclts v inet udp /dev/udp -
tcp tpicotsord v inet tcp /dev/tcp -
rawip tpiraw - inet - /dev/rawip -
ticlts tpiclts v loopback - /dev/ticlts straddr.so
ticotsord tpicotsord v loopback - /dev/ticotsord straddr.so
ticots tpicots v loopback - /dev/ticots straddr.so
FILES
SEE ALSO
dlopen(3C), getnetconfig(3NSL), getnetpath(3NSL),
nsswitch.conf(4)
System Administration Guide: IP Services
SunOS 5.11 Last change: 18 Nov 2003 7
|
