Return to getservent.3 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man3

Annotation of 43BSDTahoe/man/man3/getservent.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983 Regents of the University of California.
                      2: .\" All rights reserved.  The Berkeley software License Agreement
                      3: .\" specifies the terms and conditions for redistribution.
                      4: .\"
                      5: .\"    @(#)getservent.3n       6.3 (Berkeley) 5/19/86
                      6: .\"
                      7: .TH GETSERVENT 3N "May 19, 1986"
                      8: .UC 5
                      9: .SH NAME
                     10: getservent, getservbyport, getservbyname, setservent, endservent \- get service entry
                     11: .SH SYNOPSIS
                     12: .nf
                     13: .ft B
                     14: #include <netdb.h>
                     15: .PP
                     16: .ft B
                     17: struct servent *getservent()
                     18: .PP
                     19: .ft B
                     20: struct servent *getservbyname(name, proto)
                     21: char *name, *proto;
                     22: .PP
                     23: .ft B
                     24: struct servent *getservbyport(port, proto)
                     25: int port; char *proto;
                     26: .PP
                     27: .ft B
                     28: setservent(stayopen)
                     29: int stayopen
                     30: .PP
                     31: .ft B
                     32: endservent()
                     33: .fi
                     34: .SH DESCRIPTION
                     35: .IR Getservent ,
                     36: .IR getservbyname ,
                     37: and
                     38: .I getservbyport
                     39: each return a pointer to an object with the
                     40: following structure
                     41: containing the broken-out
                     42: fields of a line in the network services data base,
                     43: .IR /etc/services .
                     44: .RS
                     45: .PP
                     46: .nf
                     47: struct servent {
                     48:        char    *s_name;        /* official name of service */
                     49:        char    **s_aliases;    /* alias list */
                     50:        int     s_port;         /* port service resides at */
                     51:        char    *s_proto;       /* protocol to use */
                     52: };
                     53: .ft R
                     54: .ad
                     55: .fi
                     56: .RE
                     57: .PP
                     58: The members of this structure are:
                     59: .TP \w's_aliases'u+2n
                     60: s_name
                     61: The official name of the service.
                     62: .TP \w's_aliases'u+2n
                     63: s_aliases
                     64: A zero terminated list of alternate names for the service.
                     65: .TP \w's_aliases'u+2n
                     66: s_port
                     67: The port number at which the service resides.
                     68: Port numbers are returned in network byte order.
                     69: .TP \w's_aliases'u+2n
                     70: s_proto
                     71: The name of the protocol to use when contacting the
                     72: service.
                     73: .PP
                     74: .I Getservent
                     75: reads the next line of the file, opening the file if necessary.
                     76: .PP
                     77: .I Setservent
                     78: opens and rewinds the file.  If the
                     79: .I stayopen
                     80: flag is non-zero,
                     81: the net data base will not be closed after each call to 
                     82: .I getservbyname
                     83: or .IR getservbyport .
                     84: .PP
                     85: .I Endservent
                     86: closes the file.
                     87: .PP
                     88: .I Getservbyname
                     89: and
                     90: .I getservbyport
                     91: sequentially search from the beginning
                     92: of the file until a matching
                     93: protocol name or
                     94: port number is found,
                     95: or until EOF is encountered.
                     96: If a protocol name is also supplied (non-NULL),
                     97: searches must also match the protocol.
                     98: .SH FILES
                     99: /etc/services
                    100: .SH "SEE ALSO"
                    101: getprotoent(3N), services(5)
                    102: .SH DIAGNOSTICS
                    103: Null pointer
                    104: (0) returned on EOF or error.
                    105: .SH BUGS
                    106: All information
                    107: is contained in a static area
                    108: so it must be copied if it is
                    109: to be saved.  Expecting port
                    110: numbers to fit in a 32 bit
                    111: quantity is probably naive.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.