[ Bottom of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 2

getnetent_r Subroutine

Purpose

Gets network entry.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>
int getnetent_r(netent, net_data)

struct netent *netent;
struct netent_data *net_data;

Description

The getnetent_r subroutine retrieves network information by opening and sequentially reading the /etc/networks file. This subroutine internally calls the getnetent subroutine and stores the values in the hostent structure.

The getnetent subroutine overwrites the static data returned in subsequent calls. The getnetent_r subroutine does not. Use the endnetent_r subroutine to close the /etc/networks file.

Parameters

netent Points to the netent structure.
net_data Points to the net_data structure.

Return Values

The function returns a 0 if successful and a -1 if unsuccessful.

Note
If an error occurs or the end of the file is reached, the getnetent_r subroutine returns a -1 to indicate error.

Files

/etc/networks Contains official network names.

Related Information

endnetent_r Subroutine, getnetbyaddr_r Subroutine, getnetbyname_r Subroutine, and setnetent_r Subroutine.

[ Top of Page | Previous Page | Next Page | Contents | Index | Library Home | Legal | Search ]