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

getnetbyname Subroutine

Purpose

Gets network entry by name.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>
struct netent *getnetbyname (Name)
char *Name;

Description

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

The getnetbyname subroutine retrieves information from the /etc/networks file using the Name parameter as a search key. The getnetbyname subroutine searches the /etc/networks file sequentially from the start of the file until it encounters a matching net name or until it reaches the end of the file.

The getnetbyname 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.

Parameters

Name Points to a string containing the name of the network.

Return Values

Upon successful completion, the getnetbyname 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 getnetbyname subroutine returns a null pointer.

Implementation Specifics

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

All applications containing the getnetbyname 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, getnetent subroutine, setnetent subroutine.

Sockets Overview in AIX Version 4.3 Communications Programming Concepts.


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