endnetent Subroutine

Purpose

Closes the /etc/networks file.

Library

Standard C Library (libc.a)

Syntax

#include <netdb.h>

void endnetent ( )

Description

The endnetent subroutine closes the /etc/networks file. Calls made to the getnetent, getnetbyaddr, or getnetbyname subroutine open the /etc/networks file.

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

Return Values

If a previous setnetent subroutine has been performed and the StayOpen parameter does not equal 0, then the endnetent subroutine will not close the /etc/networks file. Also, the setnetent subroutine does not indicate that it closed the file. A second setnetent subroutine has to be issued with the StayOpen parameter equal to 0 in order for a following endnetent subroutine to succeed. If this is not done, the /etc/networks file must be closed with the exit subroutine.

Examples

To close the /etc/networks file, type:

endnetent();

Files