GETNETENT (3)
Get a standard IO File * handle from a channel. (Unix only)
get network entry
SYNOPSIS
#include <netdb.h>
struct netent *getnetent(void);
struct netent *getnetbyname(const char * name );
struct netent *getnetbyaddr(long net , int type );
void setnetent(int stayopen );
void endnetent(void);
DESCRIPTION
The getnetent() function reads the next line from the file
/etc/networks and returns a structure netent containing
the broken out fields from the line. The /etc/networks file
is opened if necessary.
The getnetbyname() function returns a netent structure
for the line from /etc/networks that matches the network
name.
The getnetbyaddr() function returns a netent structure
for the line that matches the network number net of type
type.
The setnetent() function opens and rewinds the
/etc/networks file. If stayopen is true (1), then the
file will not be closed between calls to getnetbyname() and
getnetbyaddr().
The endservent() function closes /etc/networks.
The netent structure is defined in <netdb.h> as follows:
6
8n 16n 34n
struct netent {
char *n_name; /* official network name */
char **n_aliases; /* alias list */
int n_addrtype; /* net address type */
unsigned long int n_net; /* network number */
}
The members of the netent structure are:
n_name
The official name of the network.
n_aliases
A zero terminated list of alternative names for the network.
n_addrtype
The type of the network number; always AF_INET.
n_net
The network number in host byte order.
RETURN VALUE
The getnetent(), getnetbyname() and getnetbyaddr()
functions return the netent structure, or a NULL pointer if an
error occurs or the end of the file is reached.
FILES
/etc/networks networks database file
CONFORMING TO
SEE ALSO
- getprotoent (3) -
- getservent (3) -
networks(5) RFC 1101 ' " ' " Copyright(c) 1996-1997 Sun Microsystems Inc ' " ' " See the file "license terms" for information on usage and redistribution ' " of this file and for a DISCLAIMER OF ALL WARRANTIES ' " ' " RCS: @(#) $Id: GetOpnFl 3 v 1 2 1998/09/14 18:39:48 stanton Exp $ ' " The definitions below are for supplemental macros used in Tcl/Tk ' " manual entries ' " ' " AP type name in/out ?indent? ' " Start paragraph describing an argument to a library procedure ' " type is type of argument(int etc ) in/out is either "in" "out" ' " or "in/out" to describe whether procedure reads or modifies arg ' " and indent is equivalent to second arg of IP(shouldn't ever be ' " needed; use AS below instead) ' " ' " AS ?type? ?name? ' " Give maximum sizes of arguments for setting tab stops Type and ' " name are examples of largest possible arguments that will be passed ' " to AP later If args are omitted default tab stops are used ' " ' " BS ' " Start box enclosure From here until next BE everything will be ' " enclosed in one large box ' " ' " BE ' " End of box enclosure ' " ' " CS ' " Begin code excerpt ' " ' " CE ' " End code excerpt ' " ' " VS ?version? ?br? ' " Begin vertical sidebar for use in marking newly-changed parts ' " of man pages The first argument is ignored and used for recording ' " the version when the VS was added so that the sidebars can be ' " found and removed when they reach a certain age If another argument ' " is present then a line break is forced before starting the sidebar ' " ' " VE ' " End of vertical sidebar ' " ' " DS ' " Begin an indented unfilled display ' " ' " DE ' " End of indented unfilled display ' " ' " SO ' " Start of list of standard options for a Tk widget The ' " options follow on successive lines in four columns separated ' " by tabs ' " ' " SE ' " End of list of standard options for a Tk widget ' " ' " OP cmdName dbName dbClass ' " Start of description of a specific option cmdName gives the ' " option's name as specified in the class command dbName gives ' " the option's name in the option database and dbClass gives ' " the option's class in the option database ' " ' " UL arg1 arg2 ' " Print arg1 underlined then print arg2 normally ' " ' " RCS: @(#) $Id: man macros v 1 2 1998/09/14 18:39:54 stanton Exp $ ' " ' " # Set up traps and other miscellaneous stuff for Tcl/Tk man pages t wh -1 3i ^B ^l n( l b ' " # Start an argument description AP !" $4"" TP $4 { !" $2"" TP n()Cu 15
| 
