1 .\" @(#)getnetpath.3n 1.26 93/05/07 SMI; from SVr4
2 .\" $NetBSD: getnetpath.3,v 1.1 2000/06/02 23:11:11 fvdl Exp $
3 .\" $FreeBSD: src/lib/libc/rpc/getnetpath.3,v 1.5 2002/12/18 12:45:10 ru Exp $
4 .\" Copyright 1989 AT&T
14 entry corresponding to
21 .Ft "struct netconfig *"
22 .Fn getnetpath "void *handlep"
26 .Fn endnetpath "void *handlep"
28 The routines described in this page provide the application access to the system
29 network configuration database,
35 environment variable (see
39 for other routines that also access the
40 network configuration database directly.
43 variable is a list of colon-separated network identifiers.
48 returns a pointer to the
49 netconfig database entry corresponding to the first valid
52 The netconfig entry is formatted as a
53 .Ft "struct netconfig" .
54 On each subsequent call,
56 returns a pointer to the netconfig entry that corresponds to the next
63 can thus be used to search the netconfig database for all networks
83 must be called before the first call to
85 and may be called at any other time.
86 It returns a handle that is used by
92 silently ignores invalid
97 component is invalid if there is no corresponding
98 entry in the netconfig database.
106 were set to the sequence of
110 networks in the netconfig database, in the
111 order in which they are listed.
112 .\"This proviso holds also for this
122 when processing is complete, releasing resources for reuse.
123 Programmers should be aware, however, that
125 frees all memory allocated by
127 for the struct netconfig data structure.
132 returns a handle that is used by
142 returns 0 on success and \-1 on failure
145 was not called previously).
151 can be used to print out the reason for failure.
157 returns a pointer to the netconfig database entry corresponding to the first