getnetent.cat3 revision 1.1.1.1.6.2 
1GETNETENT(3)             BSD Library Functions Manual             GETNETENT(3)
2
3NNAAMMEE
4     ggeettnneetteenntt, ggeettnneettbbyyaaddddrr, ggeettnneettbbyynnaammee, sseettnneetteenntt, eennddnneetteenntt - get net���
5     works entry
6
7SSYYNNOOPPSSIISS
8     ##iinncclluuddee <<nneettddbb..hh>>
9
10     _s_t_r_u_c_t _n_e_t_e_n_t _*
11     ggeettnneetteenntt();
12
13     _s_t_r_u_c_t _n_e_t_e_n_t _*
14     ggeettnneettbbyynnaammee(_c_h_a_r _n_a_m_e);
15
16     _s_t_r_u_c_t _n_e_t_e_n_t _*
17     ggeettnneettbbyyaaddddrr(_u_n_s_i_g_n_e_d _l_o_n_g _n_e_t, _i_n_t _t_y_p_e);
18
19     _v_o_i_d
20     sseettnneetteenntt(_i_n_t _s_t_a_y_o_p_e_n);
21
22     _v_o_i_d
23     eennddnneetteenntt();
24
25DDEESSCCRRIIPPTTIIOONN
26     The ggeettnneetteenntt(), ggeettnneettbbyynnaammee(), and ggeettnneettbbyyaaddddrr() subroutines each
27     return a pointer to an object with the following structure containing the
28     broken-out fields of a line in the _n_e_t_w_o_r_k_s database.
29
30           struct  netent {
31                   char    *n_name;        /* official name of net */
32                   char    **n_aliases;    /* alias list */
33                   int     n_addrtype;     /* net number type */
34                   long    n_net;          /* net number */
35           };
36
37     The members of this structure are:
38
39     n_name      The official name of the network.
40
41     n_aliases   A zero-terminated list of alternate names for the network.
42
43     n_addrtype  The type of the network number returned: AF_INET.
44
45     n_net       The network number.  Network numbers are returned in machine
46                 byte order.
47
48     If the _s_t_a_y_o_p_e_n flag on a sseettnneetteenntt() subroutine is NULL, the _n_e_t_w_o_r_k_s
49     database is opened.  Otherwise, the sseettnneetteenntt() has the effect of rewind���
50     ing the _n_e_t_w_o_r_k_s database.  The eennddnneetteenntt() subroutine may be called to
51     close the _n_e_t_w_o_r_k_s database when processing is complete.
52
53     The ggeettnneetteenntt() subroutine simply reads the next line while
54     ggeettnneettbbyynnaammee() and ggeettnneettbbyyaaddddrr() search until a matching _n_a_m_e or _n_e_t
55     number is found (or until EOF is encountered).  The _t_y_p_e _m_u_s_t _b_e AF_INET.
56     The ggeettnneetteenntt() subroutine keeps a pointer in the database, allowing suc���
57     cessive calls to be used to search the entire file.
58
59     Before a wwhhiillee loop using ggeettnneetteenntt(), a call to sseettnneetteenntt() must be made
60     in order to perform initialization; a call to eennddnneetteenntt() must be used
61     after the loop.  Both ggeettnneettbbyynnaammee() and ggeettnneettbbyyaaddddrr() make calls to
62     sseettnneetteenntt() and eennddnneetteenntt().
63
64FFIILLEESS
65     _/_e_t_c_/_n_e_t_w_o_r_k_s
66
67DDIIAAGGNNOOSSTTIICCSS
68     Null pointer (0) returned on EOF or error.
69
70SSEEEE AALLSSOO
71     networks(5), RFC 1101.
72
73HHIISSTTOORRYY
74     The ggeettnneetteenntt(), ggeettnneettbbyyaaddddrr(), ggeettnneettbbyynnaammee(), sseettnneetteenntt(), and
75     eennddnneetteenntt() functions appeared in 4.2BSD.
76
77BBUUGGSS
78     The data space used by these functions is static; if future use requires
79     the data, it should be copied before any subsequent calls to these func���
80     tions overwrite it.  Only Internet network numbers are currently under���
81     stood.  Expecting network numbers to fit in no more than 32 bits is prob���
82     ably naive.
83
844th Berkeley Distribution        May 20, 1996        4th Berkeley Distribution
85