emo/shadow
1
0
Fork 0
Code Issues Pull Requests Packages Releases Activity

[svn-upgrade] Integrating new upstream version, shadow (4.0.14)

Browse Source
This commit is contained in:
nekral-guest
2007-10-07 11:47:11 +00:00
parent 8451bed8b0
commit 24178ad677
502 changed files with 27080 additions and 14708 deletions
Download Patch File Download Diff File Expand all files Collapse all files

106
man/ja/shadow.3
View File

@@ -1,4 +1,4 @@
.\" $Id: shadow.3,v 1.6 2005/04/05 19:08:55 kloczek Exp $
.\" $Id: shadow.3,v 1.7 2005/12/01 20:38:26 kloczek Exp $
.\" Copyright 1989 - 1993, Julianne Frances Haugh
.\" All rights reserved.
.\"
@@ -33,9 +33,9 @@
.\" updated Tue 17 Sep 2002 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
.\"
.TH SHADOW 3
.SH ̾<EFBFBD><EFBFBD>
shadow \- <EFBFBD>Ź沽<EFBFBD><EFBFBD><EFBFBD>줿<EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѥ롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
.SH <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
.SH 名前
shadow \- 暗号化されたパスワードファイル用ルーチン
.SH 書式
.B #include <shadow.h>
.PP
.B struct spwd *getspent();
@@ -61,11 +61,11 @@ shadow \-
.B int lckpwdf();
.PP
.B int ulckpwdf();
.SH <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
.SH 説明
.I shadow
<EFBFBD><EFBFBD> shadow <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
\fI/etc/shadow\fR <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ǥ<EFBFBD><EFBFBD>롣
\fI#include\fR <EFBFBD>ե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ϳ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƥ<EFBFBD><EFBFBD>빽¤<EFBFBD>Τϰʲ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>̤ꡣ
は shadow パスワードファイル
\fI/etc/shadow\fR の内容を操作するルーチンである。
\fI#include\fR ファイルに与えられている構造体は以下の通り。
.sp
struct spwd {
.in +.5i
@@ -91,63 +91,63 @@ struct spwd {
.in \-.5i
}
.PP
<EFBFBD>ƥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ɤΰ<EFBFBD>̣<EFBFBD><EFBFBD>:
各フィールドの意味は:
.sp
sp_namp \- <EFBFBD>̥뽪ü<EFBFBD><EFBFBD><EFBFBD>줿<EFBFBD>桼<EFBFBD><EFBFBD>̾ʸ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ؤΥݥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_namp \- ヌル終端されたユーザ名文字列へのポインタ
.br
sp_pwdp \- <EFBFBD>̥뽪ü<EFBFBD><EFBFBD><EFBFBD>줿<EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʸ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ؤΥݥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_pwdp \- ヌル終端されたパスワード文字列へのポインタ
.br
sp_lstchg \- 1970ǯ1<EFBFBD><EFBFBD>1<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɺǽ<EFBFBD><EFBFBD>ѹ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_lstchg \- 1970年1月1日からパスワード最終変更日時迄の日数
.br
sp_min \- <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѹ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>褦<EFBFBD>ˤʤ<EFBFBD><EFBFBD>ޤǤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_min \- パスワード変更が出来るようになるまでの日数
.br
sp_max \- <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɤ<EFBFBD><EFBFBD>ѹ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ʤ<EFBFBD><EFBFBD>Ƥ<EFBFBD><EFBFBD>ɤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_max \- パスワードを変更しなくても良い日数
.br
sp_warn \- <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڤ<EFBFBD><EFBFBD>ˤʤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ˡ<EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڤ줬<EFBFBD><EFBFBD><EFBFBD>Ť<EFBFBD><EFBFBD>Ƥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݤηٹ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>桼<EFBFBD><EFBFBD><EFBFBD>˽Ф<EFBFBD><EFBFBD><EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_warn \- パスワードが期限切れになる前に、
期限切れが近づいている旨の警告をユーザに出す期間の日数
.br
sp_inact \- <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ڤ<EFBFBD><EFBFBD>ˤʤäƤ<EFBFBD><EFBFBD>顢
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȥ<EFBFBD><EFBFBD><EFBFBD>ǽ<EFBFBD>Ȥʤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѤǤ<EFBFBD><EFBFBD>ʤ<EFBFBD><EFBFBD>ʤ<EFBFBD><EFBFBD>ޤǤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_inact \- パスワードが期限切れになってから、
アカウントが不能となり使用できなくなるまでの日数
.br
sp_expire \- 1970ǯ1<EFBFBD><EFBFBD>1<EFBFBD><EFBFBD><EFBFBD>饢<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ǽ<EFBFBD>Ȥʤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_expire \- 1970年1月1からアカウントが使用不能となる日迄の日数
.br
sp_flag \- <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȥ<EFBFBD><EFBFBD>Ȥ<EFBFBD><EFBFBD>˸<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ͽ<EFBFBD><EFBFBD>
.SH <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
sp_flag \- 将来使うときに向けて予約
.SH 説明
\fBgetspent\fR, \fBgetspname\fR, \fBfgetspent\fR, \fBsgetspent\fR
<EFBFBD>ϡ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>줾<EFBFBD><EFBFBD> \fBstruct spwd\fR <EFBFBD>ؤΥݥ<EFBFBD><EFBFBD>󥿤<EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
\fBgetspent\fR <EFBFBD>ϥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD>뤫<EFBFBD>鼡<EFBFBD>Υ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
\fBfgetspent\fR <EFBFBD>ϻ<EFBFBD><EFBFBD>ꤵ<EFBFBD>줿<EFBFBD><EFBFBD><EFBFBD>ȥ꡼<EFBFBD><EFBFBD>
(<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>񼰤Υե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ȥߤʤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>)
<EFBFBD><EFBFBD><EFBFBD>鼡<EFBFBD>Υ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
\fBsgetspent\fR <EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϤȤ<EFBFBD><EFBFBD><EFBFBD>Ϳ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>줿ʸ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ѥ<EFBFBD><EFBFBD><EFBFBD>
\fBstruct spwd\fR <EFBFBD>ؤΥݥ<EFBFBD><EFBFBD>󥿤<EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
\fBgetspnam\fR <EFBFBD>ϥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>θ<EFBFBD><EFBFBD>ߤΰ<EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
\fBname\fR <EFBFBD>˥ޥå<EFBFBD><EFBFBD><EFBFBD><EFBFBD>륨<EFBFBD><EFBFBD><EFBFBD>ȥ<EFBFBD><EFBFBD><EFBFBD>õ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
は、それぞれ \fBstruct spwd\fR へのポインタを返す。
\fBgetspent\fR はファイルから次のエントリを、
\fBfgetspent\fR は指定されたストリーム
(正しい書式のファイルとみなされる)
から次のエントリを返す。
\fBsgetspent\fR は入力として与えられた文字列を用いて
\fBstruct spwd\fR へのポインタを返す。
\fBgetspnam\fR はファイル中の現在の位置から
\fBname\fR にマッチするエントリを探す。
.PP
\fBsetspent\fR <EFBFBD><EFBFBD>
shadow <EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ؤΥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>򳫻Ϥ<EFBFBD><EFBFBD>뤿<EFBFBD><EFBFBD><EFBFBD>ˡ<EFBFBD>
\fBendspent\fR <EFBFBD>Ͻ<EFBFBD>λ<EFBFBD><EFBFBD><EFBFBD>뤿<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ѥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>롣
\fBsetspent\fR は
shadow パスワードファイルへのアクセスを開始するために、
\fBendspent\fR は終了するために用いられる。
.PP
\fI/etc/shadow\fR <EFBFBD>ե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ф<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¾Ū<EFBFBD>ʥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ݾڤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ˤϡ<EFBFBD>
\fBlckpwdf\fR <EFBFBD>롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> \fBulckpwdf\fR <EFBFBD>롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ѥ<EFBFBD><EFBFBD>롣
\fBlckpwdf\fR <EFBFBD><EFBFBD> \fBpw_lock\fR <EFBFBD><EFBFBD><EFBFBD>Ѥ<EFBFBD><EFBFBD>ƺ<EFBFBD><EFBFBD><EFBFBD> 15 <20>ô֥<C3B4><D6A5>å<EFBFBD><C3A5><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>褦<EFBFBD>Ȥ<EFBFBD><C8A4>롣
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ƺǽ<EFBFBD><EFBFBD><EFBFBD> 15 <20>äλĤ<CEBB><C4A4>δ֡<CEB4>
\fBspw_lock\fR <EFBFBD>ˤ<EFBFBD><EFBFBD>ä<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ܤΥ<EFBFBD><EFBFBD>å<EFBFBD><EFBFBD>򤷤褦<EFBFBD>Ȼ<EFBFBD><EFBFBD><EFBFBD>³<EFBFBD><EFBFBD><EFBFBD>롣
<EFBFBD><EFBFBD> 15 <EFBFBD>ô֤δ֤ˤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>줫<EFBFBD>λ<EFBFBD><EFBFBD>ߤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ԥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϡ<EFBFBD>
\fBlckpwdf\fR <EFBFBD><EFBFBD> \-1 <EFBFBD><EFBFBD><EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Υ<EFBFBD><EFBFBD>å<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 0 <20><><EFBFBD>֤<EFBFBD><D6A4><EFBFBD><EFBFBD>롣
.SH <EFBFBD>֤<EFBFBD><EFBFBD><EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Υ롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϡ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ȥ꤬<EFBFBD>ĤäƤ<EFBFBD><EFBFBD>ʤ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>䡢
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>β<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ǥ<EFBFBD><EFBFBD>顼<EFBFBD><EFBFBD>ȯ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ˤ<EFBFBD> NULL <20><><EFBFBD>֤<EFBFBD><D6A4><EFBFBD>
<EFBFBD>֤<EFBFBD><EFBFBD>ͤ<EFBFBD> \fBint\fR <EFBFBD>Ǥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϡ<EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD> 0 <20>򡢼<EFBFBD><F2A1A2BC>Ԥ<EFBFBD><D4A4><EFBFBD><EFBFBD><EFBFBD> \-1 <20><><EFBFBD>֤<EFBFBD><D6A4><EFBFBD>
.SH <EFBFBD>ٹ<EFBFBD>
shadow<EFBFBD><EFBFBD><EFBFBD>줿<EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD>ɥե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ؤΥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>¤<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Ƥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>Τǡ<EFBFBD>
<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>Υ롼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ϥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѡ<EFBFBD><EFBFBD>桼<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>ѤǤ<EFBFBD><EFBFBD>롣
.SH <EFBFBD>ե<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>
\fI/etc/shadow\fR \- <EFBFBD>Ź沽<EFBFBD><EFBFBD><EFBFBD>줿<EFBFBD>桼<EFBFBD><EFBFBD><EFBFBD>ѥ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
.SH <EFBFBD><EFBFBD>Ϣ<EFBFBD><EFBFBD><EFBFBD><EFBFBD>
\fI/etc/shadow\fR ファイルに対する排他的なアクセスを保証したい場合には、
\fBlckpwdf\fR ルーチンと \fBulckpwdf\fR ルーチンを用いる。
\fBlckpwdf\fR は \fBpw_lock\fR を用いて最大 15 秒間ロックを取得しようとする。
そして最初の 15 秒の残りの間、
\fBspw_lock\fR によって二度目のロックをしようと試み続ける。
計 15 秒間の間にいずれかの試みが失敗した場合は、
\fBlckpwdf\fR は \-1 を返す。
いずれのロックも成功した場合は 0 が返される。
.SH 返り値
これらのルーチンは、エントリが残っていない場合や、
処理の過程でエラーが発生した場合には NULL を返す。
返り値が \fBint\fR であるルーチンは、
成功したら 0 を、失敗したら \-1 を返す。
.SH 警告
shadowされたパスワードファイルへのアクセスは制限されているので、
これらのルーチンはスーパーユーザだけが利用できる。
.SH ファイル
\fI/etc/shadow\fR \- 暗号化されたユーザパスワード
.SH 関連項目
.BR getpwent (3),
.BR shadow (5)
.SH <EFBFBD><EFBFBD><EFBFBD><EFBFBD>
.SH 著者
Julianne Frances Haugh (jockgrrl@ix.netcom.com)