release/man3/getspnam.3

   1 .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl) and
   2 .\" Walter Harms (walter.harms@informatik.uni-oldenburg.de)
   3 .\"
   4 .\" Distributed under GPL
   5 .\"
   6 .\"*******************************************************************
   7 .\"
   8 .\" This file was generated with po4a. Translate the source file.
   9 .\"
  10 .\"*******************************************************************
  11 .TH GETSPNAM 3 2010\-02\-25 GNU "Linux Programmer's Manual"
  12 .SH 名前
  13 getspnam, getspnam_r, getspent, getspent_r, setspent, endspent,fgetspent,
  14 fgetspent_r, sgetspent, sgetspent_r, putspent, lckpwdf, ulckpwdf \- shadow
  15 パスワードファイルのエントリを取得する
  16 .SH 書式
  17 .nf
  18 /* 一般的な shadow パスワードファイル API */
  19 .br
  20 \fB#include <shadow.h>\fP
  21 .sp
  22 \fBstruct spwd *getspnam(const char *\fP\fIname\fP\fB);\fP
  23 .sp
  24 \fBstruct spwd *getspent(void);\fP
  25 .sp
  26 \fBvoid setspent(void);\fP
  27 .sp
  28 \fBvoid endspent(void);\fP
  29 .sp
  30 \fBstruct spwd *fgetspent(FILE *\fP\fIfp\fP\fB);\fP
  31 .sp
  32 \fBstruct spwd *sgetspent(const char *\fP\fIs\fP\fB);\fP
  33 .sp
  34 \fBint putspent(struct spwd *\fP\fIp\fP\fB, FILE *\fP\fIfp\fP\fB);\fP
  35 .sp
  36 \fBint lckpwdf(void);\fP
  37 .sp
  38 \fBint ulckpwdf(void);\fP
  39 .sp
  40 /* GNU 版における拡張 */
  41 .br
  42 \fB#include <shadow.h>\fP
  43 .sp
  44 \fBint getspent_r(struct spwd *\fP\fIspbuf\fP\fB,\fP
  45 .br
  46 \fB        char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
  47 .sp
  48 \fBint getspnam_r(const char *\fP\fIname\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
  49 .br
  50 \fB        char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
  51 .sp
  52 \fBint fgetspent_r(FILE *\fP\fIfp\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
  53 .br
  54 \fB        char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
  55 .sp
  56 \fBint sgetspent_r(const char *\fP\fIs\fP\fB, struct spwd *\fP\fIspbuf\fP\fB,\fP
  57 .br
  58 \fB        char *\fP\fIbuf\fP\fB, size_t \fP\fIbuflen\fP\fB, struct spwd **\fP\fIspbufp\fP\fB);\fP
  59 .fi
  60 .sp
  61 .in -4n
  62 glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
  63 .in
  64 .sp
  65 .ad l
  66 \fBgetspent_r\fP(), \fBgetspnam_r\fP(), \fBfgetspent_r\fP(), \fBsgetspent_r\fP():
  67 .RS 4
  68 _BSD_SOURCE || _SVID_SOURCE
  69 .RE
  70 .ad b
  71 .SH 説明
  72 昔は暗号化されたパスワードをパスワードファイルに 見えるように公開しておいても安全だと考えられていた。 Julianne Frances Haugh は
  73 shadow パスワード・スイートを実装した。 これは暗号化されたパスワードを、root のみが読むことができる shadow パスワード・データベース
  74 (例えば、 ローカルの shadow パスワードファイル \fI/etc/shadow\fP, NIS, LDAP)  に保持する。
  75 .LP
  76 .\" FIXME I've commented out the following for the
  77 .\" moment.  The relationship between PAM and nsswitch.conf needs
  78 .\" to be clearly documented in one place, which is pointed to by
  79 .\" the pages for the user, group, and shadow password functions.
  80 .\" (Jul 2005, mtk)
  81 .\"
  82 .\" This shadow password setup has been superseded by PAM
  83 .\" (pluggable authentication modules), and the file
  84 .\" .I /etc/nsswitch.conf
  85 .\" now describes the sources to be used.
  86 以下で説明する関数は、伝統的なパスワード・データベースに対する 関数に似ている (例えば \fBgetpwnam\fP(3)  や
  87 \fBgetpwent\fP(3)  を参照)。
  88 .LP
  89 \fBgetspnam\fP()  関数は、ユーザ名 \fIname\fP にマッチする shadow パスワード・データベースのエントリを
  90 要素毎に分解し、各要素を格納した構造体へのポインタを返す。
  91 .LP
  92 .\" some systems require a call of setspent() before the first getspent()
  93 .\" glibc does not
  94 \fBgetspent\fP()  関数は shadow パスワード・データベースにおける次のエントリへのポインタを返す。 入力ストリームにおける位置は、
  95 \fBsetspent\fP()  で初期化される。 読み込みが終わった後に、 \fBendspent\fP()  を呼び出すと、リソースを解放できる。
  96 .LP
  97 \fBfgetspent\fP()  関数は \fBgetspent\fP()  に似ているが、 \fBsetspent\fP()
  98 で暗黙のうちにオープンされるストリームではなく、与えられたストリームを使う。
  99 .LP
 100 \fBsgetspent\fP()  関数は与えられた文字列 \fIs\fP を解析し struct \fIspwd\fP に格納する。
 101 .LP
 102 \fBputspent\fP()  関数は与えられた struct \fIspwd\fP \fI*p\fP の内容を shadow
 103 パスワードファイル形式のテキスト行でストリーム \fIfp\fP に書き出す。 空文字列として、 値が NULL の文字列エントリと値が \-1
 104 の数値エントリが 書き出される。
 105 .LP
 106 \fBlckpwdf\fP()  関数は、 shadow パスワード・データベースを 多重同時アクセスから守るためのものである。
 107 この関数はロックの獲得を試み、 成功した場合は 0 を返す。 失敗した場合 (15 秒以内にロックが取得できなかった場合) は \-1 を返す。
 108 \fBulckpwdf\fP()  関数はロックを再び解放する。 shadow パスワードファイルへの直接アクセスから 保護する手段がない点に注意すること。
 109 \fBlckpwdf\fP()  を使うプログラムだけがロックを通知できる。
 110 .LP
 111 .\" Also in libc5
 112 .\" SUN doesn't have sgetspent()
 113 これらの関数はオリジナルの shadow API を構成していた関数であり、 いろいろなシステムで広く利用可能である。
 114 .SS リエントラント版
 115 パスワード・データベースに対するリエントラント版と同じように、 glibc には shadow パスワードファイルに対してリエントラント版がある。
 116 \fBgetspnam_r\fP()  関数は \fBgetspnam\fP()  と似ているが、取得した shadow パスワード構造体を \fIspbuf\fP
 117 が指す領域に格納する。 shadow パスワード構造体は文字列群へのポインタを含み、 これらの文字列群はサイズ \fIbuflen\fP のバッファ
 118 \fIbuf\fP に格納される。 \fI*spbufp\fP には (成功した場合は) 結果へのポインタが格納され、
 119 (エントリが見つからなかった場合またはエラーが起こった場合は)  NULL が格納される。
 120 .LP
 121 関数 \fBgetspent_r\fP(), \fBfgetspent_r\fP(), \fBsgetspent_r\fP()
 122 はそれぞれリエントラントでないバージョンと同様の機能を持つ。
 123 .LP
 124 .\" SUN doesn't have sgetspent_r()
 125 glibc でないシステムにもこれらと同じ名前の関数があるが、 プロトタイプが異なることも多い。
 126 .SS 構造体
 127 shadow パスワード構造体は \fI<shadow.h>\fP で以下のように定義されている:
 128 .sp
 129 .in +4n
 130 .nf
 131 struct spwd {
 132     char *sp_namp;     /* ログイン名 */
 133     char *sp_pwdp;     /* 暗号化されたパスワード */
 134     long  sp_lstchg;   /* 最終更新日
 135                           (1970\-01\-01 00:00:00 +0000 (UTC)) からの日数) */
 136     long  sp_min;      /* 変更が出来るようになるまでの最短日数 */
 137     long  sp_max;      /* 変更をしなくてもよい最長日数 */
 138     long  sp_warn;     /* パスワードが期限切れになる前に
 139                           ユーザに変更の警告を出す日数 */
 140     long  sp_inact;    /* パスワードが期限切れになってから
 141                           アカウントが無効になるまでの日数 */
 142     long  sp_expire;   /* アカウントが無効になる日付
 143                           (1970\-01\-01 00:00:00 +0000 (UTC)) からの日数) */
 144     unsigned long sp_flag;  /* 予約フィールド */
 145 };
 146 .fi
 147 .in
 148 .SH 返り値
 149 ポインタを返す関数は、これ以上エントリがない場合や 処理中にエラーが発生した場合 NULL を返す。 \fIint\fP を返り値として持つ関数は、
 150 成功した場合 0 を返し、失敗した場合 \-1 を返す。
 151 .LP
 152 リエントラント版でない関数では、返り値が静的な領域を指しており、 引き続いてこれらの関数を呼び出した場合に上書きされる可能性がある。
 153 .LP
 154 リエントラント版の関数は、成功した場合に 0 を返す。 エラーの場合は、エラー番号が返される。
 155 .SH エラー
 156 .TP
 157 \fBERANGE\fP
 158 与えられたバッファが小さすぎる。
 159 .SH ファイル
 160 .TP
 161 \fI/etc/shadow\fP
 162 ローカルの shadow パスワード・データベースファイル
 163 .TP
 164 \fI/etc/.pwd.lock\fP
 165 ロックファイル
 166 .LP
 167 インクルードファイル \fI<paths.h>\fP は定数 \fB_PATH_SHADOW\fP を定義している。 これは shadow
 168 パスワードファイルのパス名である。
 169 .SH 準拠
 170 shadow パスワード・データベースと関連 API は POSIX.1\-2001 には記載されていない。しかしながら、多くの他のシステムでも 同様の
 171 API が提供されている。
 172 .SH 関連項目
 173 \fBgetgrnam\fP(3), \fBgetpwnam\fP(3), \fBgetpwnam_r\fP(3), \fBshadow\fP(5)