$NetBSD: netconfig.5,v 1.2 2000/11/08 13:18:28 lukem Exp $
$FreeBSD$
.Dd November 17, 2000 .Dt NETCONFIG 5 .Os .Sh NAME .Nm netconfig .Nd network configuration data base .Sh SYNOPSIS
a /etc/netconfig .Sh DESCRIPTION The .Nm file defines a list of .Dq transport names , describing their semantics and protocol. In .Fx , this file is only used by the RPC library code.
p Entries have the following format:
p .Ar network_id semantics flags family protoname device libraries
p Entries consist of the following fields: l -tag -width network_id t Ar network_id The name of the transport described. t Ar semantics Describes the semantics of the transport. This can be one of: l -tag -width tpi_cots_ord -offset indent t Sy tpi_clts Connectionless transport. t Sy tpi_cots Connection-oriented transport t Sy tpi_cots_ord Connection-oriented, ordered transport. t Sy tpi_raw A raw connection. .El t Ar flags This field is either blank (specified by .Dq Li - ) , or contains one or more of the following characters: l -tag -width b -offset indent t Sy b The network represented by this entry is broadcast capable. This flag is meaningless in .Fx . t Sy v The entry may be returned by the .Xr getnetpath 3 function. .El t Ar family The protocol family of the transport. This is currently one of: l -tag -width loopback -offset indent t Sy inet6 The IPv6
q Dv PF_INET6 family of protocols. t Sy inet The IPv4
q Dv PF_INET family of protocols. t Sy loopback The .Dv PF_LOCAL protocol family. .El t Ar protoname The name of the protocol used for this transport. Can currently be either .Sy udp , .Sy tcp or empty. t Ar device This field is always empty in .Fx . t Ar libraries This field is always empty in .Fx . .El
p The order of entries in this file will determine which transport will be preferred by the RPC library code, given a match on a specified network type. For example, if a sample network config file would look like this: d -literal -offset indent udp6 tpi_clts v inet6 udp - - tcp6 tpi_cots_ord v inet6 tcp - - udp tpi_clts v inet udp - - tcp tpi_cots_ord v inet tcp - - rawip tpi_raw - inet - - - local tpi_cots_ord - loopback - - - .Ed
p then using the network type .Sy udp in calls to the RPC library function (see .Xr rpc 3 ) will make the code first try .Sy udp6 , and then .Sy udp .
p .Xr getnetconfig 3 and associated functions will parse this file and return structures of the following format: d -literal struct netconfig { char *nc_netid; /* Network ID */ unsigned long nc_semantics; /* Semantics */ unsigned long nc_flag; /* Flags */ char *nc_protofmly; /* Protocol family */ char *nc_proto; /* Protocol name */ char *nc_device; /* Network device pathname (unused) */ unsigned long nc_nlookups; /* Number of lookup libs (unused) */ char **nc_lookups; /* Names of the libraries (unused) */ unsigned long nc_unused[9]; /* reserved */ }; .Ed .Sh FILES l -tag -width /etc/netconfig -compact t Pa /etc/netconfig .El .Sh SEE ALSO .Xr getnetconfig 3 , .Xr getnetpath 3