getnetbyname 子例程

在线编辑

用途

按名称获取网络条目。

库

标准 C 库 (libc.a)

语法

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

描述

getnetbyname 子例程是线程安全的。 但是，该返回值指向由后续调用覆盖的静态数据。 必须复制此数据以进行保存，以供后续调用使用。

getnetbyname 子例程使用 Name 参数作为搜索键从 /etc/networks 文件检索信息。 getnetbyname 子例程从文件的开头开始按顺序搜索 /etc/networks 文件，直到它迂到匹配的网络名或直到它到达文件的结尾。

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

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

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

参数

项 描述
名称 指向包含该网络的名称的字符串。

返回值

成功完成后， getnetbyname 子例程将返回指向 内滕特 结构的指针。

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

文件

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