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

Item	Description
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

Item	Description
/etc/networks	Contains official network names.