diff options
Diffstat (limited to 'documentation/manual-pages/ja/man3/getservent.3')
-rw-r--r-- | documentation/manual-pages/ja/man3/getservent.3 | 146 |
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 ビットに適合すると期待するのは、たぶん素朴過ぎます。 |