Manpages

名 前

getprotoent_r, getprotobyname_r, getprotobynumber_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);

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

getprotoent_r(), getprotobyname_r(), getprotobynumber_r():

_BSD_SOURCE || _SVID_SOURCE

説 明

関 数 getprotoent_r(), getprotobyname_r(), getprotobynumber_r() は 、 そ れ ぞ れ getprotoent(3), getprotobyname(3), getprotobynumber(3) の リ エ ン ト ラ ン ト 版 で あ る 。 protoent 構 造 体 の 返 し 方 と 、 関 数 呼 び 出 し 時 の 引 き 数 と 返 り 値 が 異 な る 。 こ の マ ニ ュ ア ル ペ ー ジ で は 、 リ エ ン ト ラ ン ト で な い 関 数 と の 違 い だ け を 説 明 す る 。 こ れ ら の 関 数 は 、 関 数 の 結 果 と し て 静 的 に 割 り 当 て ら れ た protoent 構 造 体 へ の ポ イ ン タ ー を 返 す の で は な く 、 protoent 構 造 体 を result_buf が 指 す 場 所 に コ ピ ー す る 。 配 列 buf は 、 返 さ れ る protoent 構 造 体 が 指 す 文 字 列 フ ィ ー ル ド を 格 納 す る の に 使 用 さ れ る (リ エ ン ト ラ ン ト で な い 関 数 の 場 合 は 、 こ れ ら の 文 字 列 は 静 的 な 領 域 に 格 納 さ れ る )。 こ の 配 列 の 大 き さ は buflen で 指 定 さ れ る 。 buf が 小 さ す ぎ る 場 合 、 関 数 呼 び 出 し は エ ラ ー ERANGE で 失 敗 し 、 呼 び 出 し 側 で は も っ と 大 き な バ ッ フ ァ ー で 再 度 呼 び 出 す 必 要 が あ る (ほ と ん ど の ア プ リ ケ ー シ ョ ン で は 、 長 さ 1024 バ イ ト の バ ッ フ ァ ー で 十 分 な は ず で あ る )。 関 数 呼 び 出 し で プ ロ ト コ ル レ コ ー ド の 取 得 に 成 功 す る と 、 *result は result_buf を 指 す よ う に 設 定 さ れ る 。 そ れ 以 外 の 場 合 は *result に NULL が 設 定 さ れ る 。

返 り 値

成 功 す る と 、 こ れ ら の 関 数 は 0 を 返 す 。 エ ラ ー の 場 合 、 「 エ ラ ー 」 の 節 の リ ス ト に あ る 正 の エ ラ ー 番 号 の い ず れ か を 返 す 。 エ ラ ー の 場 合 、 レ コ ー ド が 見 つ か ら な か っ た 場 合 (getprotobyname_r(), getprotobyaddr_r()) や こ れ 以 上 レ コ ー ド が な い 場 合 (getprotoent_r())、 result に は NULL が 設 定 さ れ る 。

エ ラ ー

準 拠

こ れ ら の 関 数 は GNU に よ る 拡 張 で あ る 。 他 の シ ス テ ム に も 同 様 の 名 前 の 関 数 が 存 在 す る 場 合 が あ る が 、 通 常 は 関 数 の 引 き 数 が 異 な る 。

例

以 下 の プ ロ グ ラ ム は 、 getprotobyname_r() を 使 っ て 、 最 初 の コ マ ン ド ラ イ ン 引 き 数 で 指 定 さ れ た 名 前 の プ ロ ト コ ル の レ コ ー ド を 取 得 す る 。 二 番 目 の コ マ ン ド ラ イ ン 引 き 数 (整 数 値 ) が 指 定 さ れ た 場 合 は 、 そ の 値 が buflen の 初 期 値 と し て 使 用 さ れ る 。 getprotobyname_r() が エ ラ ー ERANGE で 失 敗 す る と 、 プ ロ グ ラ ム は よ り 大 き な バ ッ フ ァ ー サ イ ズ で 再 度 getprotobyname_r を 呼 び 出 す 。 下 記 の シ ェ ル の セ ッ シ ョ ン は 、 実 行 例 を 示 し て い る 。

$ ./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 プ ロ グ ラ ム の ソ ー ス

#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];
char **p;

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

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

if (buflen > MAX_BUF) {
printf("Exceeded buffer limit (%d)\n", 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\n");
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)\n", MAX_BUF);
exit(EXIT_FAILURE); } } }
while (s == ERANGE);

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

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

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

exit(EXIT_SUCCESS); }

関 連 項 目

getprotoent(3), protocols(5)

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。