[ Previous | Next | Contents | Glossary | Home | Search ]
AIX Version 4.3 Communications Technical Reference, Volume 2

getnetent Subroutine

Purpose

Gets network entry.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>
struct netent *getnetent ( )

Description

Attention: Do not use the getnetent subroutine in a multithreaded environment.

The getnetent subroutine retrieves network information by opening and sequentially reading the /etc/networks file.

The getnetent subroutine returns a pointer to a netent structure, which contains the equivalent fields for a network description line in the /etc/networks file. The netent structure is defined in the netdb.h file.

Use the endnetent subroutine to close the /etc/networks file.

Return Values

Upon successful completion, the getnetent subroutine returns a pointer to a netent structure.

Note: The return value points to static data that is overwritten by subsequent calls.

If an error occurs or the end of the file is reached, the getnetent subroutine returns a null pointer.

Implementation Specifics

The getnetent subroutine is part of Base Operating System (BOS) Runtime.

All applications containing the getnetent subroutine must be compiled with _BSD set to a specific value. Acceptable values are 43 and 44. In addition, all socket applications must include the BSD libbsd.a library.

Files

/etc/networks
                          Contains official network names.

Related Information

The endnetent subroutine, getnetbyaddr subroutine, getnetbyname subroutine, setnetent subroutine.

Sockets Overview in AIX Version 4.3 Communications Programming Concepts.


[ Previous | Next | Contents | Glossary | Home | Search ]