Chapter Contents

Previous

Next
getnetent

getnetent



Gets the Next Network Information Structure

Portability: UNIX compatible


SYNOPSIS
DESCRIPTION
RETURN VALUE
CAUTION
PORTABILITY
IMPLEMENTATION
RELATED FUNCTIONS


SYNOPSIS

#include <netdb.h>

struct netent *getnetent(void);


DESCRIPTION

Given a network name, getnetent returns a pointer to the next network entry in the netent structure as defined in <netdb.h> . The source of the data in this structure is the network file, that is, a file with the same format as the /etc/networks file on a UNIX operating system. Refer to <netdb.h> for details on the netent structure.

Refer to Search Logic for information on the logic used to determine the location of the network file.


RETURN VALUE

If getnetent succeeds, it returns a pointer to the netent structure. A null pointer indicates an error occurred or there were no more network entries.


CAUTION

The value that getnetent returns points to a static structure within the library. You must copy the information from this structure before you make further getnetbyname , getnetbyaddr , or getnetent calls.


PORTABILITY

getnetent is portable to other environments, including most UNIX systems, that implement BSD sockets.


IMPLEMENTATION

getnetent is ported directly from the BSD UNIX Socket Library.


RELATED FUNCTIONS

getnetbyaddr , getnetbyname , setnetent , endnetent


Chapter Contents

Previous

Next

Top of Page

Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.