getnetpath(3N)															    getnetpath(3N)

NAME

       getnetpath(), setnetpath(), endnetpath() - get /etc/netconfig entry corresponding to NETPATH component

SYNOPSIS

DESCRIPTION

       The routines described on this page are part of the Network Selection component.  They provide the application access to the system network
       configuration database, as it is "filtered" by the environment variable (see environ(5)).  See getnetconfig(3N)	for  other  routines  that
       also access the network configuration database directly.  The variable is a list of colon-separated network identifiers.

       returns	a  pointer to the database entry corresponding to the first valid component.  The entry is formatted as a On each subsequent call,
       returns a pointer to the entry that corresponds to the next valid component.  can thus be used to search  the  database	for  all  networks
       included in the variable.  When has been exhausted, returns NULL.

       A call to "binds" to or "rewinds" must be called before the first call to and may be called at any other time.  It returns a handle that is
       used by

       silently ignores invalid components.  A component is invalid if there is no corresponding entry in the database.

       If the variable is unset, behaves as if were set to the sequence of "default" or "visible" networks in the database, in the order in  which
       they are listed.

       may  be	called	to  "unbind"  from when processing is complete, releasing resources for reuse.	Programmers should be aware, however, that
       frees all memory allocated by for the data structure.

MULTITHREAD USAGE

       Thread Safe:	     Yes
       Cancel Safe:	     Yes
       Fork Safe:	     No
       Async-cancel Safe:    No
       Async-signal Safe:    No

       These functions can be called safely in a multithreaded environment.  They may be cancellation points in that they call functions that  are
       cancel points.

       In a multithreaded environment, these functions are not safe to be called by a child process after and before These functions should not be
       called by a multithreaded application that supports asynchronous cancellation or asynchronous signals.

RETURN VALUES

       returns a handle that is used by In case of an error, returns NULL.  or can be used to print out the reason for	failure.   See	getnetcon-
       fig(3N).

       When  first  called,  returns a pointer to the database entry corresponding to the first valid component.  When has been exhausted, returns
       NULL.

       returns on success and on failure (for example, if was not called previously).

SEE ALSO

       getnetconfig(3N), netconfig(4), environ(5).

																    getnetpath(3N)