.\" 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 2004-08-20, Yuichi SATO <ysato444@yahoo.co.jp>
.\"
.TH GETSPNAM 3  2008-07-09 "GNU" "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
.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 );
.fi
.sp
.in -4n
glibc εǽޥ׷
.RB ( feature_test_macros (7)
):
.in
.sp
.ad l
.BR getspent_r (),
.BR getspnam_r (),
.BR fgetspent_r (),
.BR sgetspent_r ():
_BSD_SOURCE || _SVID_SOURCE
.ad b
.SH 
ΤϰŹ沽줿ѥɤѥɥե
褦˸ƤƤȹͤƤ
Julianne Frances Haugh  shadow ѥɡȤ
ϰŹ沽줿ѥɤroot ΤߤɤळȤǤ
shadow ѥɡǡ١ (㤨С
 shadow ѥɥե
.IR /etc/shadow ,
NIS, LDAP)
ݻ롣
.LP
ʲؿϡŪʥѥɡǡ١Ф
ؿ˻Ƥ (㤨
.BR getpwnam (3)

.BR getpwent (3)
򻲾)
.\" FIXME ʲŪ˥ȥȤ
.\" PAM  nsswitch.conf δطˤĤƤϡ桼롼סshadow
.\" ѥɤδؿˤĤƤΥڡ黲ȤɤˤϤä
.\" ܤƤɬפ롣
.\" (Jul 2005, mtk)
.\"
.\"  shadow ѥɤ
.\" PAM (pluggable authentication modules) Ǽؤ뤳ȤǤ롣
.\" ߤΤȤɤξ󸻤Ѥ뤫
.\" .I /etc/nsswitch.conf
.\" ե˵Ҥ롣
.LP
.BR getspnam ()
ؿϡ桼̾
.I name
˥ޥå shadow ѥɡǡ١Υȥ
ʬ򤷡ǤǼ¤ΤؤΥݥ󥿤֤
.LP
.BR getspent ()
ؿ shadow ѥɡǡ١ˤ뼡ΥȥؤΥݥ󥿤֤
ϥȥ꡼ˤ֤ϡ
.BR setspent ()
ǽ롣
ɤ߹ߤäˡ
.BR endspent ()
ƤӽФȡ꥽Ǥ롣
.\" ǽ getspent() ƤӽФˡ
.\" setspent() ƤӽФʤФʤʤƥ⤢롣
.\" glibc ǤϤɬפʤ
.LP
.BR fgetspent ()
ؿ
.BR getspent ()
˻Ƥ뤬
.BR setspent ()
ǰۤΤ˥ץ󤵤륹ȥ꡼ǤϤʤͿ줿ȥ꡼Ȥ
.LP
.BR sgetspent ()
ؿͿ줿ʸ
.I s
Ϥ struct
.I spwd
˳Ǽ롣
.LP
.BR putspent ()
ؿͿ줿 struct
.I spwd
.I *p
Ƥ shadow ѥɥեΥƥȹԤǥȥ꡼
.I fp
˽񤭽Ф
ʸȤơ
ͤ NULL ʸ󥨥ȥͤ \-1 οͥȥ꤬
񤭽Ф롣
.LP
.BR lckpwdf ()
ؿϡ shadow ѥɡǡ١
¿Ʊ뤿ΤΤǤ롣
δؿϥåγߡ
 0 ֤
Ԥ (15 ð˥åǤʤä)  \-1 ֤
.BR ulckpwdf ()
ؿϥåƤӲ롣
shadow ѥɥեؤľܥ
ݸʤʤդ뤳ȡ
.BR lckpwdf ()
ȤץåΤǤ롣
.LP
δؿϥꥸʥ shadow API ƤؿǤꡢ
ʥƥǹѲǽǤ롣
.\" libc5 ǤѲǽǤ롣
.\" SUN ˤ sgetspent() ʤ
.SS ꥨȥ
ѥɡǡ١ФꥨȥǤƱ褦ˡ
glibc ˤ shadow ѥɥեФƥꥨȥǤ롣
.BR getspnam_r ()
ؿ
.BR getspnam ()
ȻƤ뤬 shadow ѥɹ¤Τ
.I spbuf
ؤΰ˳Ǽ롣
shadow ѥɹ¤Τʸ󷲤ؤΥݥ󥿤ޤߡ
ʸ󷲤ϥ
.I buflen
ΥХåե
.I buf
˳Ǽ롣
.I *spbufp
ˤ () ̤ؤΥݥ󥿤Ǽ졢
(ȥ꤬Ĥʤäޤϥ顼ä)
NULL Ǽ롣
.LP
ؿ
.BR getspent_r (),
.BR fgetspent_r (),
.BR sgetspent_r ()
Ϥ줾ꥨȥȤǤʤСƱͤεǽġ
.LP
glibc Ǥʤƥˤ⤳Ʊ̾δؿ뤬
ץȥפۤʤ뤳Ȥ¿
.\" SUN ˤ sgetspent_r() ʤ
.SS ¤
shadow ѥɹ¤Τ \fI<shadow.h>\fP ǰʲΤ褦Ƥ:
.sp
.in +4n
.nf
struct spwd {
    char *sp_namp;     /* ̾ */
    char *sp_pwdp;     /* Ź沽줿ѥ */
    long  sp_lstchg;   /* ǽ (1970ǯ11) */
    long  sp_min;      /* ѹ褦ˤʤޤǤκû */
    long  sp_max;      /* ѹ򤷤ʤƤ褤Ĺ */
    long  sp_warn;     /* ѥɤڤˤʤ
                          桼ѹηٹФ */
    long  sp_inact;    /* ѥɤڤˤʤäƤ
                          Ȥ̵ˤʤޤǤ */
    long  sp_expire;   /* Ȥ̵ˤʤ
                          (1970ǯ11) */
    unsigned long sp_flag;  /* ͽե */
};
.fi
.in
.SH ֤
ݥ󥿤֤ؿϡʾ奨ȥ꤬ʤ
˥顼ȯ NULL ֤
\fIint\fP ֤ͤȤƻĴؿϡ
 0 ֤Ԥ \-1 ֤
.LP
ꥨȥǤǤʤؿǤϡ֤ͤŪΰؤƤꡢ
³ƤδؿƤӽФ˾񤭤ǽ롣
.LP
ꥨȥǤδؿϡ 0 ֤
顼ξϡ顼ֹ椬֤롣
.SH 顼
.TP
.B ERANGE
Ϳ줿Хåե롣
.SH ե
.TP
.I /etc/shadow
 shadow ѥɡǡ١ե
.TP
.I /etc/.pwd.lock
åե
.LP
󥯥롼ɥե
.I <paths.h>

.B _PATH_SHADOW
Ƥ롣
 shadow ѥɥեΥѥ̾Ǥ롣
.SH 
shadow ѥɡǡ١ȴϢ API  POSIX.1-2001
ˤϵܤƤʤʤ顢¿¾ΥƥǤ
Ʊͤ API 󶡤Ƥ롣
.SH Ϣ
.BR getgrnam (3),
.BR getpwnam (3),
.BR getpwnam_r (3),
.BR shadow (5)