1 .\" $NetBSD: netconfig.5,v 1.2 2000/11/08 13:18:28 lukem Exp $
2 .\" $FreeBSD: src/lib/libc/rpc/netconfig.5,v 1.3 2006/01/11 13:57:15 ceri Exp $
8 .Nd network configuration data base
14 file defines a list of
16 describing their semantics and protocol.
19 this file is only used by the RPC library code.
21 Entries have the following format:
23 .Ar network_id semantics flags family protoname device libraries
25 Entries consist of the following fields:
26 .Bl -tag -width network_id
28 The name of the transport described.
30 Describes the semantics of the transport.
32 .Bl -tag -width tpi_cots_ord -offset indent
34 Connectionless transport.
36 Connection-oriented transport
38 Connection-oriented, ordered transport.
43 This field is either blank (specified by
45 or contains one or more of the following characters:
46 .Bl -tag -width b -offset indent
48 The network represented by this entry is broadcast capable.
49 This flag is meaningless in
52 The entry may be returned by the
57 The protocol family of the transport.
58 This is currently one of:
59 .Bl -tag -width loopback -offset indent
74 The name of the protocol used for this transport.
75 Can currently be either
80 This field is always empty in
83 This field is always empty in
87 The order of entries in this file will determine which transport will
88 be preferred by the RPC library code, given a match on a specified
90 For example, if a sample network config file would look like this:
91 .Bd -literal -offset indent
92 udp6 tpi_clts v inet6 udp - -
93 tcp6 tpi_cots_ord v inet6 tcp - -
94 udp tpi_clts v inet udp - -
95 tcp tpi_cots_ord v inet tcp - -
96 rawip tpi_raw - inet - - -
97 local tpi_cots_ord - loopback - - -
100 then using the network type
102 in calls to the RPC library function (see
104 will make the code first try
110 and associated functions will parse this file and return structures of
111 the following format:
114 char *nc_netid; /* Network ID */
115 unsigned long nc_semantics; /* Semantics */
116 unsigned long nc_flag; /* Flags */
117 char *nc_protofmly; /* Protocol family */
118 char *nc_proto; /* Protocol name */
119 char *nc_device; /* Network device pathname (unused) */
120 unsigned long nc_nlookups; /* Number of lookup libs (unused) */
121 char **nc_lookups; /* Names of the libraries (unused) */
122 unsigned long nc_unused[9]; /* reserved */
126 .Bl -tag -width /etc/netconfig -compact
127 .It Pa /etc/netconfig