.\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl) and
.\" Walter Harms (walter.harms@informatik.uni-oldenburg.de)
.\"
.\" Distributed under GPL
.\"
.\" Japanese Version Copyright (c) 2004 Yuichi SATO
.\"         all rights reserved.
.\" Translated Fri Aug 20 02:39:09 JST 2004
.\"         by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH GETSPNAM 3  2003-11-15 "Shadow" "Linux Programmer's Manual"
.SH ̾
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>
.sp
.BI "struct spwd *getspnam(const char *" name );
.sp
.B struct spwd *getspent(void);
.sp
.B void setspent(void);
.sp
.B void endspent(void);
.sp
.BI "struct spwd *fgetspent(FILE *" fp );
.sp
.BI "struct spwd *sgetspent(const char *" s );
.sp
.BI "int putspent(struct spwd *" p ", FILE *" fp );
.sp
.B int lckpwdf(void);
.sp
.B int ulckpwdf(void);
.sp
/* GNU Ǥˤĥ */
.br
.BR "#define _SVID_SOURCE" "    /* ޤ _BSD_SOURCE */
.br
.B #include <shadow.h>
.sp
.BI "int getspent_r(struct spwd *" spbuf ,
.br
.BI "        char *" buf ", size_t " buflen ", struct spwd **" spbufp );
.sp
.BI "int getspnam_r(const char *" name ", struct spwd *" spbuf ,
.br
.BI "        char *" buf ", size_t " buflen ", struct spwd **" spbufp );
.sp
.BI "int fgetspent_r(FILE *" fp ", struct spwd *" spbuf ,
.br
.BI "        char *" buf ", size_t " buflen ", struct spwd **" spbufp );
.sp
.BI "int sgetspent_r(const char *" s ", struct spwd *" spbuf ,
.br
.BI "        char *" buf ", size_t " buflen ", struct spwd **" spbufp );
.sp
.fi
.SH 
ΤϰŹ沽줿ѥɤѥɥե
褦˸ƤƤȹͤƤ
Julianne Frances Haugh  shadow ѥɥȤ
ϰŹ沽줿ѥɤroot ΤߤɤळȤǤ
.I /etc/shadow
ݻ롣
.LP
ʲƤ륢롼
.I /etc/passwd
Ф롼˻Ƥ롣
 shadow ѥɤ
PAM (pluggable authentication modules) Ǽؤ뤳ȤǤ롣
ΤȤϡѤ륽ե
.I /etc/nsswitch.conf
˵Ҥ롣
.LP
.B getspnam()
ؿϹ¤ΤؤΥݥ󥿤֤
ι¤Τϡ桼̾
.I name
˥ޥå륨ȥˤĤơ
.I /etc/shadow
ιԤФեɤݻ롣
.LP
.B getspent()
ؿ shadow ѥɥեˤ뼡ΥȥؤΥݥ󥿤֤
ϥȥ꡼ˤ֤ϡ
.B setspent()
ǽ롣
ɤ߹ߤλȡץ
.B endspent()
ƤӽФȤǽˤʤꡢ꥽뤳ȤǤ롣
.\"  getspent() ƤӽФˡ
.\" setspent() ƤӽФʤФʤʤƥ⤢롣
.\" glibc ǤϤɬפʤ
.LP
.B fgetspent()
ؿ
.B getspent()
˻Ƥ뤬
.B setspent()
ǰۤΤ˥ץ󤵤륹ȥ꡼ǤϤʤͿ줿ȥ꡼Ȥ
.LP
.B sgetspent()
ؿͿ줿ʸ
.I s
Ϥstruct spwd ˤ롣
.LP
.B putspent()
ؿͿ줿 struct spwd
.RI * p
Ƥ shadow ѥɥեΥƥȹԤǥȥ꡼
.I fp
˽񤭽Ф
ͤ NULL ʸ󥨥ȥͤ \-1 οͥȥϡ
ʸȤƽ񤭽Ф롣
.LP
.B lckpwdf()
ؿϡ shadow ѥɥǡ١
¿ť뤳ȤտޤƤ롣
δؿϥå褦Ȥ롣
 0 ֤
Ԥ (15 ð˥åǤʤä)  \-1 ֤
.B ulckpwdf()
ؿϥåƤӲ롣
shadow ѥɥեؤľܥ
ݸʤʤդ뤳ȡ
.B lckpwdf()
ȤץåΤǤ롣
.LP
ꥸʥ shadow API 뤳Υ롼󤬤ä
Υ롼ϤʥƥѲǽǤ롣
.\" libc5 ǤѲǽǤ롣
.\" SUN ˤ sgetspent() ʤ
.SS ꥨȥ
ѥɥեˤĤƤΡ֥ꥨȥȡץ롼Ʊ褦ˡ
glibc ˤ (shadow ѥɥեˤĤƤ) ꥨȥǤ⤢롣
.B getspnam_r()
ؿ
.B getspnam()
ȻƤ뤬 shadow ѥɹ¤Τ
.I spbuf
ǻؤΰ˳Ǽ롣
shadow ѥɹ¤Τʸ󷲤ؤΥݥ󥿤ޤߡ
ʸ󷲤ϥ
.I buflen
ΥХåե
.I buf
˳Ǽ롣
.RI * spbufp
ˤ () ̤ؤΥݥ󥿤Ǽ졢
(ȥ꤬Ĥʤäޤϥ顼ä)
NULL Ǽ롣
.LP
ؿ
.BR getspent_r() ,
.BR fgetspent_r() ,
.B sgetspent_r()
 (: ΰ
.B getspman_r()
) Ƥ롣
.LP
glibc Ǥʤƥˤ⤳Ʊ̾δؿ뤬
ץȥפۤʤ뤳Ȥ¿
.\" SUN ˤ sgetspent_r() ʤ
.SS ¤
shadow ѥɹ¤Τ \fI<shadow.h>\fP ǰʲΤ褦Ƥ:
.sp
.nf
struct spwd {
    char *sp_namp;         /* ̾ */
    char *sp_pwdp;         /* Ź沽줿ѥ */
    long sp_lstchg;        /* ǽ */
    long sp_min;           /* ѹ褦ˤʤޤǤκû */
    long sp_max;           /* ѹ򤷤ʤƤ褤Ĺ */
    long sp_warn;          /* ѥɤڤˤʤ
                              桼ѹηٹФ */
    long sp_inact;         /* ѥɤڤˤʤäƤ
                              Ȥ̵ˤʤޤǤ */
    long sp_expire;        /* 1970-01-01 饢Ȥ
                              ̵ˤʤޤǤ */
    unsigned long sp_flag; /* ͽ󤵤Ƥ */
};
.fi
.SH ֤
Υȥ꤬ʤ硢ޤϽ˥顼ȯ硢
롼 NULL ֤
\fBint\fR ֤ͤȤƻĥ롼ϡ
 0 ֤Ԥ -1 ֤
.LP
ꥨȥǤǤʤؿǤϡ֤ͤŪΰؤƤꡢ
³ƤδؿƤӽФ˾񤭤ǽ롣
.LP
ꥨȥǤδؿϡ 0 ֤
顼ξϡ顼֤ͤ롣
.SH 顼
.TP
.B ERANGE
Ϳ줿Хåե롣
.SH ե
.TP
.I /etc/shadow
shadow ѥɥǡ١ե
.TP
.I /etc/.pwd.lock
åե
.LP
󥯥롼ɥե
.I <paths.h>
 _PATH_SHADOW Ƥ롣
 shadow ѥɥեΥѥ̾Ǥ롣
.SH Ϣ
.BR getgrnam (3),
.BR getpwnam (3),
.BR getpwnam_r (3),
.BR shadow (5)