1 .\" $NetBSD: netconfig.5,v 1.2 2000/11/08 13:18:28 lukem Exp $
2 .\" $NetBSD: netconfig.5,v 1.2 2000/11/08 13:18:28 lukem Exp $
9 .Nd network configuration data base
15 file defines a list of
17 describing their semantics and protocol.
20 this file is only used by the RPC library code.
22 Entries have the following format:
24 .Ar network_id semantics flags family protoname device libraries
26 Entries consist of the following fields:
27 .Bl -tag -width network_id
29 The name of the transport described.
31 Describes the semantics of the transport.
33 .Bl -tag -width tpi_cots_ord -offset indent
35 Connectionless transport.
37 Connection-oriented transport
39 Connection-oriented, ordered transport.
44 This field is either blank (specified by
46 or contains one or more of the following characters:
47 .Bl -tag -width b -offset indent
49 The network represented by this entry is broadcast capable.
50 This flag is meaningless in
53 The entry may be returned by the
58 The protocol family of the transport.
59 This is currently one of:
60 .Bl -tag -width loopback -offset indent
75 The name of the protocol used for this transport.
76 Can currently be either
81 This field is always empty in
84 This field is always empty in
88 The order of entries in this file will determine which transport will
89 be preferred by the RPC library code, given a match on a specified
91 For example, if a sample network config file would look like this:
92 .Bd -literal -offset indent
93 udp6 tpi_clts v inet6 udp - -
94 tcp6 tpi_cots_ord v inet6 tcp - -
95 udp tpi_clts v inet udp - -
96 tcp tpi_cots_ord v inet tcp - -
97 rawip tpi_raw - inet - - -
98 local tpi_cots_ord - loopback - - -
101 then using the network type
103 in calls to the RPC library function (see
105 will make the code first try
111 and associated functions will parse this file and return structures of
112 the following format:
115 char *nc_netid; /* Network ID */
116 unsigned long nc_semantics; /* Semantics */
117 unsigned long nc_flag; /* Flags */
118 char *nc_protofmly; /* Protocol family */
119 char *nc_proto; /* Protocol name */
120 char *nc_device; /* Network device pathname (unused) */
121 unsigned long nc_nlookups; /* Number of lookup libs (unused) */
122 char **nc_lookups; /* Names of the libraries (unused) */
123 unsigned long nc_unused[9]; /* reserved */
127 .Bl -tag -width /etc/netconfig -compact
128 .It Pa /etc/netconfig