aboutsummaryrefslogtreecommitdiff
path: root/documentation/manual-pages/ja/man3/getservent.3
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/manual-pages/ja/man3/getservent.3')
-rw-r--r--documentation/manual-pages/ja/man3/getservent.3146
1 files changed, 146 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man3/getservent.3 b/documentation/manual-pages/ja/man3/getservent.3
new file mode 100644
index 0000000000..9811425f44
--- /dev/null
+++ b/documentation/manual-pages/ja/man3/getservent.3
@@ -0,0 +1,146 @@
+.\" Copyright (c) 1983, 1991, 1993
+.\" The Regents of the University of California. All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\" must display the following acknowledgement:
+.\" This product includes software developed by the University of
+.\" California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\" may be used to endorse or promote products derived from this software
+.\" without specific prior written permission.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\" From: @(#)getservent.3 8.3 (Berkeley) 1/12/94
+.\" %FreeBSD: src/lib/libc/net/getservent.3,v 1.7.2.5 2001/12/14 18:33:55 ru Exp %
+.\" $FreeBSD$
+.\"
+.Dd July 9, 1995
+.Dt GETSERVENT 3
+.Os
+.Sh 名称
+.Nm getservent ,
+.Nm getservbyport ,
+.Nm getservbyname ,
+.Nm setservent ,
+.Nm endservent
+.Nd サービスエントリの取得
+.Sh ライブラリ
+.Lb libc
+.Sh 書式
+.In netdb.h
+.Ft struct servent *
+.Fn getservent
+.Ft struct servent *
+.Fn getservbyname "const char *name" "const char *proto"
+.Ft struct servent *
+.Fn getservbyport "int port" "const char *proto"
+.Ft void
+.Fn setservent "int stayopen"
+.Ft void
+.Fn endservent void
+.Sh 解説
+.Fn getservent ,
+.Fn getservbyname
+および
+.Fn getservbyport
+関数はそれぞれ、次に示す構造を持つオブジェクトへのポインタを返します。
+構造体にはネットワークサービスデータベース
+.Pa /etc/services
+にある、行の内訳フィールドが含まれます。
+.Bd -literal -offset indent
+struct servent {
+ char *s_name; /* サービスのオフィシャル名 */
+ char **s_aliases; /* エイリアスリスト */
+ int s_port; /* サービスが常駐するポート */
+ char *s_proto; /* 使用するプロトコル */
+};
+.Ed
+.Pp
+この構造体のメンバは次のとおりです。
+.Bl -tag -width s_aliases
+.It Fa s_name
+サービスのオフィシャル名。
+.It Fa s_aliases
+サービスの別名 (エイリアス) の 0 で終るリスト。
+.It Fa s_port
+サービスが存在するポート番号。
+ポート番号はネットワークバイトオーダで返されます。
+.It Fa s_proto
+サービスとのコンタクト中に使用するプロトコル名。
+.El
+.Pp
+.Fn getservent
+関数は、ファイルの次の行を読み込みます。
+その際、必要ならばファイルをオープンします。
+.Pp
+.Fn setservent
+関数はファイルをオープンしリワインドします。
+.Fa stayopen
+フラグが 0 でなければ、
+.Fn getservbyname
+または
+.Fn getservbyport
+の各呼び出しの後でも、ネットデータベースはクローズされません。
+.Pp
+.Fn endservent
+関数はファイルをクローズします。
+.Pp
+.Fn getservbyname
+および
+.Fn getservbyport
+関数は、適合するプロトコル名またはポート番号
+(これはネットワークバイトオーダで指定されなければなりません)
+が見つかるか、さもなければ
+.Dv EOF
+に達するまで、ファイルを最初から順次検索します。
+プロトコル名が与えられていても (
+.Dv NULL
+でなくても)、検索は適合するプロトコルが見つかるまで続けられます。
+.Sh 関連ファイル
+.Bl -tag -width /etc/services -compact
+.It Pa /etc/services
+.El
+.Sh 診断
+.Dv EOF
+またはエラーの場合、
+Null
+ポインタ
+(0)
+が返ります。
+.Sh 関連項目
+.Xr getprotoent 3 ,
+.Xr services 5
+.Sh 歴史
+.Fn getservent ,
+.Fn getservbyport ,
+.Fn getservbyname ,
+.Fn setservent
+および
+.Fn endservent
+関数は、
+.Bx 4.2
+で登場しました。
+.Sh バグ
+これらの関数は静的データ記憶域を使用します。
+後でこのデータを使用する必要があれば、以後のこれらの関数呼び出しで
+データが上書きされる前に、コピーして保存する必要があります。
+ポート番号がすべて 32 ビットに適合すると期待するのは、たぶん素朴過ぎます。