getnetent 子例程

用途

获取网络条目。

标准 C 库 (libc.a)

语法

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

描述

getnetent 子例程是线程安全的。 但是,返回值指向被后续调用覆盖的静态数据。 必须复制此数据以保存以供后续调用使用。

getnetent 子例程通过打开并按顺序读取 /etc/networks 文件来检索网络信息。

getnetent 子例程返回指向 netent 结构的指针,该结构包含 /etc/networks 文件中网络描述行的等效字段。 netent 结构在 netdb.h 文件中定义。

使用 endnetent 子例程来关闭 /etc/networks 文件。

所有包含 getnetent 子例程的应用程序都必须在 _BSD 宏设置为特定值的情况下进行编译。 可接受的值为 43 和 44。 此外,所有套接字应用程序都必须包含 BSD libbsd.a 库。

返回值

成功完成时, getnetent 子例程返回指向 netent 结构的指针。

如果发生错误或到达文件末尾,那么 getnetent 子例程将返回空指针。

文件

描述
/etc/networks 包含官方网络名称。