aboutsummaryrefslogtreecommitdiff
path: root/documentation/manual-pages/ja/man3/getnetgrent.3
diff options
context:
space:
mode:
Diffstat (limited to 'documentation/manual-pages/ja/man3/getnetgrent.3')
-rw-r--r--documentation/manual-pages/ja/man3/getnetgrent.3130
1 files changed, 130 insertions, 0 deletions
diff --git a/documentation/manual-pages/ja/man3/getnetgrent.3 b/documentation/manual-pages/ja/man3/getnetgrent.3
new file mode 100644
index 0000000000..11e2f0b460
--- /dev/null
+++ b/documentation/manual-pages/ja/man3/getnetgrent.3
@@ -0,0 +1,130 @@
+.\" Copyright (c) 1992, 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.
+.\"
+.\" @(#)getnetgrent.3 8.1 (Berkeley) 6/4/93
+.\"
+.\" $FreeBSD$
+.Dd June 4, 1993
+.Dt GETNETGRENT 3
+.Os
+.Sh 名称
+.Nm getnetgrent ,
+.Nm innetgr ,
+.Nm setnetgrent ,
+.Nm endnetgrent
+.Nd ネットグループデータベースの操作
+.Sh 書式
+.Ft int
+.Fn getnetgrent "char **host" "char **user" "char **domain"
+.Ft int
+.Fn innetgr "const char *netgroup" "const char *host" "const char *user" "const char *domain"
+.Ft void
+.Fn setnetgrent "const char *netgroup"
+.Ft void
+.Fn endnetgrent void
+.Sh 解説
+これらの関数はいずれも、
+.Xr netgroup 5
+に記述されたネットグループデータベースのファイル
+/etc/netgroup
+を操作します。データベースはネットグループの集合を定義しますが、
+ネットグループはぞれぞれ、1 つまたは複数の次のような 3 つ組で構成されます。
+.Bd -literal -offset indent
+(host, user, domain)
+.Ed
+それぞれ、ホスト、ユーザおよびドメインの組み合わせを定義します。
+3 つのフィールドのどれにも、あらゆるストリングに適合する
+`'ワイルドカード' を指定可能です。
+.Pp
+関数
+.Fn getnetgrent
+は、現在のネットグループの次のメンバの、文字列に対する
+3 つのポインタ引数を設定します。文字列ポインタのどれかが
+.Sy (char *)0
+だと、そのフィールドはワイルドカードと見なされます。
+.Pp
+関数
+.Fn setnetgrent
+は現在のネットグループを設定し、
+.Fn endnetgrent
+は現在のネットグループを終了します。
+前の呼び出しとは違うネットグループに対して
+.Fn setnetgrent
+が呼び出された場合、暗黙に
+.Fn endnetgrent
+が実行されます。
+.Fn setnetgrent
+はまた、ネットグループの最初のメンバのオフセットを設定します。
+.Pp
+関数
+.Fn innetgr
+は適合するものがあるかどうか、指定したグループにあるすべての
+フィールドを検索します。
+.Sy host
+.Sy user
+.Sy domain
+引数のどれかが
+.Sy (char *)0
+の場合、そのフィールドは指定されたネットグループメンバのあらゆる
+文字列値に適合します。
+.Sh 戻り値
+関数
+.Fn getnetgrent
+は ``それ以上ネットグループメンバがない'' 場合には 0 を返し、
+その他の場合は 1 を返します。
+関数
+.Fn innetgr
+は、適合するフィールドがあった場合は 1 を、
+その他の場合は 0 を返します。
+関数
+.Fn setnetgrent
+および
+.Fn endnetgrent
+には戻り値がありません。
+.Sh 関連ファイル
+.Bl -tag -width /etc/netgroup -compact
+.It Pa /etc/netgroup
+ネットグループデータベースファイル
+.El
+.Sh 関連項目
+.Xr netgroup 5
+.Sh 互換性
+ネットグループメンバには、他のベンダによる実装との互換性を維持するために
+3 つの文字列フィールドがありますが、
+.Sy domain
+文字列の BSD 内での使用法が明らかではありません。
+.Sh バグ
+関数
+.Fn getnetgrent
+は、動的に割り振られたデータ領域のポインタを返しますが、
+関数
+.Fn endnetgrent
+が呼び出されるとそのデータ領域は解放されます。