.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl) and
.\" Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
+.\" %%%LICENSE_START(GPL_NOVERSION_ONELINE)
.\" Distributed under GPL
+.\" %%%LICENSE_END
+.\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
.\"
.\" Japanese Version Copyright (c) 2004 Yuichi SATO
.\" all rights reserved.
.\" Translated 2004-08-20, Yuichi SATO <ysato444@yahoo.co.jp>
+.\" Updated 2013-03-25, Akihiro MOTOKI <amotoki@gmail.com>
+.\" Updated 2013-07-17, Akihiro MOTOKI <amotoki@gmail.com>
.\"
-.TH GETSPNAM 3 2010-02-25 "GNU" "Linux Programmer's Manual"
+.TH GETSPNAM 3 2015\-01\-22 GNU "Linux Programmer's Manual"
.SH 名前
-getspnam, getspnam_r, getspent, getspent_r, setspent, endspent,fgetspent, fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf \- shadow パスワードファイルのエントリを取得する
+getspnam, getspnam_r, getspent, getspent_r, setspent, endspent,fgetspent,
+fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf \- shadow
+パスワードファイルのエントリーを取得する
.SH 書式
.nf
/* 一般的な shadow パスワードファイル API */
.br
-.B #include <shadow.h>
+\fB#include <shadow.h>\fP
.sp
-.BI "struct spwd *getspnam(const char *" name );
+\fBstruct spwd *getspnam(const char *\fP\fIname\fP\fB);\fP
.sp
-.B struct spwd *getspent(void);
+\fBstruct spwd *getspent(void);\fP
.sp
-.B void setspent(void);
+\fBvoid setspent(void);\fP
.sp
-.B void endspent(void);
+\fBvoid endspent(void);\fP
.sp
-.BI "struct spwd *fgetspent(FILE *" fp );
+\fBstruct spwd *fgetspent(FILE *\fP\fIstream\fP\fB);\fP
.sp
-.BI "struct spwd *sgetspent(const char *" s );
+\fBstruct spwd *sgetspent(const char *\fP\fIs\fP\fB);\fP
.sp
-.BI "int putspent(struct spwd *" p ", FILE *" fp );
+\fBint putspent(const struct spwd *\fP\fIp\fP\fB, FILE *\fP\fIstream\fP\fB);\fP
.sp
-.B int lckpwdf(void);
+\fBint lckpwdf(void);\fP
.sp
-.B int ulckpwdf(void);
+\fBint ulckpwdf(void);\fP
.sp
/* GNU 版における拡張 */
.br
-.B #include <shadow.h>
+\fB#include <shadow.h>\fP
.sp
-.BI "int getspent_r(struct spwd *" spbuf ,
+\fBint getspent_r(struct spwd *\fP\fIspbuf\fP\fB,\fP
.br
-.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp );
+\fB char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
.sp
-.BI "int getspnam_r(const char *" name ", struct spwd *" spbuf ,
+\fBint getspnam_r(const char *\fP\fIname\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
.br
-.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp );
+\fB char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
.sp
-.BI "int fgetspent_r(FILE *" fp ", struct spwd *" spbuf ,
+\fBint fgetspent_r(FILE *\fP\fIstream\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
.br
-.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp );
+\fB char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
.sp
-.BI "int sgetspent_r(const char *" s ", struct spwd *" spbuf ,
+\fBint sgetspent_r(const char *\fP\fIs\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
.br
-.BI " char *" buf ", size_t " buflen ", struct spwd **" spbufp );
+\fB char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
.fi
.sp
.in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7) 参照):
.in
.sp
.ad l
-.BR getspent_r (),
-.BR getspnam_r (),
-.BR fgetspent_r (),
-.BR sgetspent_r ():
+\fBgetspent_r\fP(), \fBgetspnam_r\fP(), \fBfgetspent_r\fP(), \fBsgetspent_r\fP():
.RS 4
_BSD_SOURCE || _SVID_SOURCE
.RE
.ad b
.SH 説明
-昔は暗号化されたパスワードをパスワードファイルに
-見えるように公開しておいても安全だと考えられていた。
-Julianne Frances Haugh は shadow パスワード・スイートを実装した。
-これは暗号化されたパスワードを、root のみが読むことができる
-shadow パスワード・データベース (例えば、
-ローカルの shadow パスワードファイル
-.IR /etc/shadow ,
-NIS, LDAP)
-に保持する。
+昔は暗号化されたパスワードをパスワードファイルに 見えるように公開しておいても安全だと考えられていた。 Julianne Frances Haugh は
+shadow パスワードスイートを実装した。 これは暗号化されたパスワードを、root のみが読むことができる shadow パスワードデータベース
+(例えば、 ローカルの shadow パスワードファイル \fI/etc/shadow\fP, NIS, LDAP) に保持する。
.LP
-以下で説明する関数は、伝統的なパスワード・データベースに対する
-関数に似ている (例えば
-.BR getpwnam (3)
-や
-.BR getpwent (3)
-を参照)。
-.\" FIXME 以下を一時的にコメントアウトした。
-.\" PAM と nsswitch.conf の関係については、ユーザ、グループ、shadow
-.\" パスワードの関数についてのページから参照されるどこかにはっきりと
-.\" 記載しておく必要がある。
+.\" FIXME . I've commented out the following for the
+.\" moment. The relationship between PAM and nsswitch.conf needs
+.\" to be clearly documented in one place, which is pointed to by
+.\" the pages for the user, group, and shadow password functions.
.\" (Jul 2005, mtk)
.\"
-.\" この shadow パスワードの設定は
-.\" PAM (pluggable authentication modules) で取り替えることができる。
-.\" 現在のところ、どの情報源を使用するかは
+.\" This shadow password setup has been superseded by PAM
+.\" (pluggable authentication modules), and the file
.\" .I /etc/nsswitch.conf
-.\" ファイルに記述される。
+.\" now describes the sources to be used.
+以下で説明する関数は、伝統的なパスワードデータベースに対する 関数に似ている (例えば \fBgetpwnam\fP(3) や \fBgetpwent\fP(3)
+を参照)。
.LP
-.BR getspnam ()
-関数は、ユーザ名
-.I name
-にマッチする shadow パスワード・データベースのエントリを
-要素毎に分解し、各要素を格納した構造体へのポインタを返す。
+\fBgetspnam\fP() 関数は、ユーザー名 \fIname\fP にマッチする shadow パスワードデータベースのエントリーを
+要素毎に分解し、各要素を格納した構造体へのポインターを返す。
.LP
-.BR getspent ()
-関数は shadow パスワード・データベースにおける次のエントリへのポインタを返す。
-入力ストリームにおける位置は、
-.BR setspent ()
-で初期化される。
-読み込みが終わった後に、
-.BR endspent ()
-を呼び出すと、リソースを解放できる。
-.\" 最初に getspent() を呼び出す前に、
-.\" setspent() を呼び出さなければならないシステムもある。
-.\" glibc ではその必要がない。
+.\" some systems require a call of setspent() before the first getspent()
+.\" glibc does not
+\fBgetspent\fP() 関数は shadow パスワードデータベースにおける次のエントリーへのポインターを返す。 入力ストリームにおける位置は、
+\fBsetspent\fP() で初期化される。 読み込みが終わった後に、 \fBendspent\fP() を呼び出すと、リソースを解放できる。
.LP
-.BR fgetspent ()
-関数は
-.BR getspent ()
-に似ているが、
-.BR setspent ()
+\fBfgetspent\fP() 関数は \fBgetspent\fP() に似ているが、 \fBsetspent\fP()
で暗黙のうちにオープンされるストリームではなく、与えられたストリームを使う。
.LP
-.BR sgetspent ()
-関数は与えられた文字列
-.I s
-を解析し struct
-.I spwd
-に格納する。
+\fBsgetspent\fP() 関数は与えられた文字列 \fIs\fP を解析し struct \fIspwd\fP に格納する。
.LP
-.BR putspent ()
-関数は与えられた struct
-.I spwd
-.I *p
-の内容を shadow パスワードファイル形式のテキスト行でストリーム
-.I fp
-に書き出す。
-空文字列として、
-値が NULL の文字列エントリと値が \-1 の数値エントリが
-書き出される。
+\fBputspent\fP() 関数は与えられた struct \fIspwd\fP \fI*p\fP の内容を shadow パスワードファイル形式のテキスト行で
+\fIstream\fP に書き出す。 空文字列として、 値が NULL の文字列エントリーと値が \-1 の数値エントリーが 書き出される。
.LP
-.BR lckpwdf ()
-関数は、 shadow パスワード・データベースを
-多重同時アクセスから守るためのものである。
-この関数はロックの獲得を試み、
-成功した場合は 0 を返す。
-失敗した場合 (15 秒以内にロックが取得できなかった場合) は \-1 を返す。
-.BR ulckpwdf ()
-関数はロックを再び解放する。
-shadow パスワードファイルへの直接アクセスから
-保護する手段がない点に注意すること。
-.BR lckpwdf ()
+\fBlckpwdf\fP() 関数は、 shadow パスワードデータベースを 多重同時アクセスから守るためのものである。 この関数はロックの獲得を試み、
+成功した場合は 0 を返す。 失敗した場合 (15 秒以内にロックが取得できなかった場合) は \-1 を返す。 \fBulckpwdf\fP()
+関数はロックを再び解放する。 shadow パスワードファイルへの直接アクセスから 保護する手段がない点に注意すること。 \fBlckpwdf\fP()
を使うプログラムだけがロックを通知できる。
.LP
-これらの関数はオリジナルの shadow API を構成していた関数であり、
-いろいろなシステムで広く利用可能である。
-.\" libc5 でも利用可能である。
-.\" SUN には sgetspent() がない。
+.\" Also in libc5
+.\" SUN doesn't have sgetspent()
+これらの関数はオリジナルの shadow API を構成していた関数であり、 いろいろなシステムで広く利用可能である。
.SS リエントラント版
-パスワード・データベースに対するリエントラント版と同じように、
-glibc には shadow パスワードファイルに対してリエントラント版がある。
-.BR getspnam_r ()
-関数は
-.BR getspnam ()
-と似ているが、取得した shadow パスワード構造体を
-.I spbuf
-が指す領域に格納する。
-shadow パスワード構造体は文字列群へのポインタを含み、
-これらの文字列群はサイズ
-.I buflen
-のバッファ
-.I buf
-に格納される。
-.I *spbufp
-には (成功した場合は) 結果へのポインタが格納され、
-(エントリが見つからなかった場合またはエラーが起こった場合は)
-NULL が格納される。
+パスワードデータベースに対するリエントラント版と同じように、 glibc には shadow パスワードファイルに対してリエントラント版がある。
+\fBgetspnam_r\fP() 関数は \fBgetspnam\fP() と似ているが、取得した shadow パスワード構造体を \fIspbuf\fP
+が指す領域に格納する。 shadow パスワード構造体は文字列群へのポインターを含み、 これらの文字列群はサイズ \fIbuflen\fP のバッファー
+\fIbuf\fP に格納される。 \fI*spbufp\fP には (成功した場合は) 結果へのポインターが格納され、
+(エントリーが見つからなかった場合またはエラーが起こった場合は) NULL が格納される。
.LP
-関数
-.BR getspent_r (),
-.BR fgetspent_r (),
-.BR sgetspent_r ()
+関数 \fBgetspent_r\fP(), \fBfgetspent_r\fP(), \fBsgetspent_r\fP()
はそれぞれリエントラントでないバージョンと同様の機能を持つ。
.LP
-glibc でないシステムにもこれらと同じ名前の関数があるが、
-プロトタイプが異なることも多い。
-.\" SUN には sgetspent_r() がない。
+.\" SUN doesn't have sgetspent_r()
+glibc でないシステムにもこれらと同じ名前の関数があるが、 プロトタイプが異なることも多い。
.SS 構造体
shadow パスワード構造体は \fI<shadow.h>\fP で以下のように定義されている:
.sp
char *sp_namp; /* ログイン名 */
char *sp_pwdp; /* 暗号化されたパスワード */
long sp_lstchg; /* 最終更新日
- (1970-01-01 00:00:00 +0000 (UTC)) からの日数) */
+ (1970\-01\-01 00:00:00 +0000 (UTC)
+ からの日数) */
long sp_min; /* 変更が出来るようになるまでの最短日数 */
long sp_max; /* 変更をしなくてもよい最長日数 */
long sp_warn; /* パスワードが期限切れになる前に
- ユーザに変更の警告を出す日数 */
+ ã\83¦ã\83¼ã\82¶ã\83¼ã\81«å¤\89æ\9b´ã\81®è¦å\91\8aã\82\92å\87ºã\81\99æ\97¥æ\95° */
long sp_inact; /* パスワードが期限切れになってから
アカウントが無効になるまでの日数 */
long sp_expire; /* アカウントが無効になる日付
- (1970-01-01 00:00:00 +0000 (UTC)) からの日数) */
+ (1970\-01\-01 00:00:00 +0000 (UTC)
+ からの日数) */
unsigned long sp_flag; /* 予約フィールド */
};
.fi
.in
.SH 返り値
-ポインタを返す関数は、これ以上エントリがない場合や
-処理中にエラーが発生した場合 NULL を返す。
-\fIint\fP を返り値として持つ関数は、
-成功した場合 0 を返し、失敗した場合 \-1 を返す。
+ポインターを返す関数は、これ以上エントリーがない場合や 処理中にエラーが発生した場合 NULL を返す。 \fIint\fP を返り値として持つ関数は、
+成功した場合 0 を返し、失敗した場合、 \-1 を返し、 \fIerrno\fP にエラーの原因を示す値を設定する。
.LP
-リエントラント版でない関数では、返り値が静的な領域を指しており、
-引き続いてこれらの関数を呼び出した場合に上書きされる可能性がある。
+リエントラント版でない関数では、返り値が静的な領域を指しており、 引き続いてこれらの関数を呼び出した場合に上書きされる可能性がある。
.LP
-リエントラント版の関数は、成功した場合に 0 を返す。
-エラーの場合は、エラー番号が返される。
+リエントラント版の関数は、成功した場合に 0 を返す。 エラーの場合は、エラー番号が返される。
.SH エラー
-.TP
-.B ERANGE
-与えられたバッファが小さすぎる。
+.TP
+\fBEACCES\fP
+呼び出し元が shadow パスワードファイルにアクセスする許可を持っていない。
+.TP
+\fBERANGE\fP
+与えられたバッファーが小さすぎる。
.SH ファイル
-.TP
-.I /etc/shadow
-ã\83ã\83¼ã\82«ã\83«ã\81® shadow ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83»ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\83\95ã\82¡ã\82¤ã\83«
-.TP
-.I /etc/.pwd.lock
+.TP
+\fI/etc/shadow\fP
+ローカルの shadow パスワードデータベースファイル
+.TP
+\fI/etc/.pwd.lock\fP
ロックファイル
.LP
-インクルードファイル
-.I <paths.h>
-は定数
-.B _PATH_SHADOW
-を定義している。
-これは shadow パスワードファイルのパス名である。
+インクルードファイル \fI<paths.h>\fP は定数 \fB_PATH_SHADOW\fP を定義している。 これは shadow
+パスワードファイルのパス名である。
.SH 準拠
-shadow パスワード・データベースと関連 API は POSIX.1-2001
-には記載されていない。しかしながら、多くの他のシステムでも
-同様の API が提供されている。
+shadow パスワードデータベースと関連 API は POSIX.1\-2001 には記載されていない。しかしながら、多くの他のシステムでも 同様の
+API が提供されている。
.SH 関連項目
-.BR getgrnam (3),
-.BR getpwnam (3),
-.BR getpwnam_r (3),
-.BR shadow (5)
+\fBgetgrnam\fP(3), \fBgetpwnam\fP(3), \fBgetpwnam_r\fP(3), \fBshadow\fP(5)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
