侧边栏壁纸
博主头像
noerror

虚灵不寐,众理具而万事出。

  • 累计撰写 238 篇文章
  • 累计创建 9 个标签
  • 累计收到 2 条评论
标签搜索

目 录CONTENT

文章目录

getprotoent_r函数用法详解

noerror
2022-11-09 / 0 评论 / 0 点赞 / 31 阅读 / 933 字 / 正在检测是否收录...

getprotoent_r函数用法详解

getprotoent_r函数简介

  • 头文件包含
#include <netdb.h>
  • 函数定义
int getprotoent_r(struct protoent * result_buf , char * buf ,
                size_t  buflen , struct protoent ** result );
int getprotobyname_r(const char * name ,
                struct protoent * result_buf , char * buf ,
                size_t  buflen , struct protoent ** result );
int getprotobynumber_r(int  proto ,
                struct protoent * result_buf , char * buf ,
                size_t  buflen , struct protoent ** result );

getprotoent_r函数常见使用错误

  • 编译错误
    warning: implicit declaration of function ‘getprotoent_r’ [-Wimplicit-function-declaration]
    解决办法:包含头文件
#include <netdb.h>

getprotoent_r函数详细描述

getprotoent_r () getprotobyname_r ()和getprotobynumber_r ()函数分别是getprotoent (3) getprotobyname (3)和getprotobynumber (3)的可重入等价物。它们的不同之处在于返回protoent结构的方式,以及调用签名和返回值的函数。本手册页只描述了与不可重入函数的区别。
这些函数不返回指向静态分配的protoent结构的指针作为函数结果,而是将该结构复制到result_buf 所指向的位置
buf数组用于存储返回的protoent结构所指向的字符串字段。(不可重入函数在静态存储中分配这些字符串。)此数组的大小在buflen 中指定。如果buf太小,则调用失败,错误为ERANGE ,调用方必须使用更大的缓冲区重试。(对于大多数应用程序,长度为1024字节的缓冲区应该足够了。)
如果函数调用成功获得协议记录,则*result被设置为指向result_buf ;,否则,*result被设置为NULL。

getprotoent_r函数返回值

成功后,这些函数返回0。出错时,它们返回错误中列出的正错误号之一。
出错时,记录未找到( getprotobyname_r () getprotobynumber_r ())或输入( getprotoent_r ()) result的结尾设置为空。

getprotoent_r函数错误码

  • ENOENT ( getprotoent_r ())数据库中没有更多记录。
  • ERANGE buf太小。使用更大的缓冲区(和增加的buflen ))重试

getprotoent_r函数使用举例

下面的程序使用getprotobyname_r ()检索其第一个命令行参数中命名的协议的协议记录。如果提供了第二个(整数)命令行参数,它将用作buflen ;的初始值。如果getprotobyname_r ()失败并出现错误ERANGE ,程序将使用更大的缓冲区重试。以下shell会话显示了几个示例运行:

" ./a.out tcp 1"
ERANGE! Retrying with larger buffer
getprotobyname_r() returned: 0 (success)  (buflen=78)
p_name=tcp; p_proto=6; aliases=TCP
" ./a.out xxx 1"
ERANGE! Retrying with larger buffer
getprotobyname_r() returned: 0 (success)  (buflen=100)
Call failed/record not found

Program source&

#define _GNU_SOURCE
#include <ctype.h>
#include <netdb.h>
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
#include <string.h>

#define MAX_BUF 10000

int
main(int argc, char *argv[])
{
   int buflen, erange_cnt, s;
   struct protoent result_buf;
   struct protoent *result;
   char buf[MAX_BUF];

   if (argc < 2) {
       printf("Usage: %s proto\-name [buflen]\en", argv[0]);
       exit(EXIT_FAILURE);
   }

   buflen = 1024;
   if (argc > 2)
       buflen = atoi(argv[2]);

   if (buflen > MAX_BUF) {
       printf("Exceeded buffer limit (%d)\en", MAX_BUF);
       exit(EXIT_FAILURE);
   }

   erange_cnt = 0;
   do {
       s = getprotobyname_r(argv[1], &result_buf,
                    buf, buflen, &result);
       if (s == ERANGE) {
           if (erange_cnt == 0)
               printf("ERANGE! Retrying with larger buffer\en");
           erange_cnt++;

           /* Increment a byte at a time so we can see exactly
              what size buffer was required */

           buflen++;

           if (buflen > MAX_BUF) {
               printf("Exceeded buffer limit (%d)\en", MAX_BUF);
               exit(EXIT_FAILURE);
           }
       }
   } while (s == ERANGE);

   printf("getprotobyname_r() returned: %s  (buflen=%d)\en",
           (s == 0) ? "0 (success)" : (s == ENOENT) ? "ENOENT" :
           strerror(s), buflen);

   if (s != 0 || result == NULL) {
       printf("Call failed/record not found\en");
       exit(EXIT_FAILURE);
   }

   printf("p_name=%s; p_proto=%d; aliases=",
               result_buf.p_name, result_buf.p_proto);
   for (char **p = result_buf.p_aliases; *p != NULL; p++)
       printf("%s ", *p);
   printf("\en");

   exit(EXIT_SUCCESS);
}
0

评论区