fc733ebccd
This section is based on catpages contributed by Mainichi Communications, Inc. Translated by: MYCOM team Converted by: Japanese Online Manual Project <man-jp@jp.FreeBSD.ORG> Submitted by: Kazuo Horikawa <k-horik@yk.rim.or.jp>
237 lines
5.9 KiB
Groff
237 lines
5.9 KiB
Groff
.\" Copyright (c) 1988, 1991, 1993
|
|
.\" The Regents of the University of California. All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 1. Redistributions of source code must retain the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer.
|
|
.\" 2. Redistributions in binary form must reproduce the above copyright
|
|
.\" notice, this list of conditions and the following disclaimer in the
|
|
.\" documentation and/or other materials provided with the distribution.
|
|
.\" 3. All advertising materials mentioning features or use of this software
|
|
.\" must display the following acknowledgement:
|
|
.\" This product includes software developed by the University of
|
|
.\" California, Berkeley and its contributors.
|
|
.\" 4. Neither the name of the University nor the names of its contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
|
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
|
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
.\" SUCH DAMAGE.
|
|
.\"
|
|
.\" From: @(#)getpwent.3 8.2 (Berkeley) 12/11/93
|
|
.\"
|
|
.Dd September 20, 1994
|
|
.Dt GETPWENT 3
|
|
.Os
|
|
.Sh ̾¾Î
|
|
.Nm getpwent ,
|
|
.Nm getpwnam ,
|
|
.Nm getpwuid ,
|
|
.Nm setpassent ,
|
|
.Nm setpwent ,
|
|
.Nm endpwent
|
|
.Nd ¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¤òÁàºî
|
|
.Sh ½ñ¼°
|
|
.Fd #include <sys/types.h>
|
|
.Fd #include <pwd.h>
|
|
.Ft struct passwd *
|
|
.Fn getpwent void
|
|
.Ft struct passwd *
|
|
.Fn getpwnam "const char *login"
|
|
.Ft struct passwd *
|
|
.Fn getpwuid "uid_t uid"
|
|
.Ft int
|
|
.Fn setpassent "int stayopen"
|
|
.Ft void
|
|
.Fn setpwent void
|
|
.Ft void
|
|
.Fn endpwent void
|
|
.Sh ²òÀâ
|
|
¤³¤ì¤é¤Î´Ø¿ô¤Ï¡¢
|
|
.Xr passwd 5
|
|
¤Ëµ½Ò¤µ¤ì¤¿¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë¤ò
|
|
Áàºî¤·¤Þ¤¹¡£¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î³Æ¥¨¥ó¥È¥ê¤Ï¡¢¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë
|
|
.Aq Pa pwd.h
|
|
¤Ë¤¢¤ë
|
|
¹½Â¤ÂÎ
|
|
.Ar passwd
|
|
¤Ë¤è¤Ã¤ÆÄêµÁ¤µ¤ì¤Þ¤¹¡£¼¡¤Î¤È¤ª¤ê¤Ç¤¹¡£
|
|
.Bd -literal -offset indent
|
|
struct passwd {
|
|
char *pw_name; /* ¥æ¡¼¥¶Ì¾ */
|
|
char *pw_passwd; /* °Å¹æ²½¥Ñ¥¹¥ï¡¼¥É */
|
|
uid_t pw_uid; /* ¥æ¡¼¥¶ uid */
|
|
gid_t pw_gid; /* ¥æ¡¼¥¶ gid */
|
|
time_t pw_change; /* ¥Ñ¥¹¥ï¡¼¥É¤ÎÊѹ¹»þ´ü */
|
|
char *pw_class; /* ¥æ¡¼¥¶¥¢¥¯¥»¥¹¥¯¥é¥¹ */
|
|
char *pw_gecos; /* ¥Ï¥Í¥¦¥¨¥ë¥í¥°¥¤¥ó¾ðÊó */
|
|
char *pw_dir; /* ¥Û¡¼¥à¥Ç¥£¥ì¥¯¥È¥ê */
|
|
char *pw_shell; /* ¥Ç¥Õ¥©¥ë¥È¤Î¥·¥§¥ë */
|
|
time_t pw_expire; /* ¥¢¥«¥¦¥ó¥È͸ú´ü¸Â */
|
|
int pw_fields; /* ÆâÉô : ½¼¤Æ¤ó¥Õ¥£¡¼¥ë¥É */
|
|
};
|
|
.Ed
|
|
.Pp
|
|
´Ø¿ô
|
|
.Fn getpwnam
|
|
¤ÏÍ¿¤¨¤é¤ì¤¿¥í¥°¥¤¥ó̾¤ò¡¢
|
|
.Fn getpwuid
|
|
¤ÏÍ¿¤¨¤é¤ì¤¿¥æ¡¼¥¶
|
|
uid
|
|
¤ò¡¢¤½¤ì¤¾¤ì¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ç¸¡º÷¤·¡¢¾ï¤ËºÇ½é¤Ë½Ð²ñ¤Ã¤¿
|
|
¥¨¥ó¥È¥ê¤òÊÖ¤·¤Þ¤¹¡£
|
|
.Pp
|
|
.Fn getpwent
|
|
´Ø¿ô¤Ï¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¤ò½ç¼¡Æɤ߹þ¤ß¤Þ¤¹¡£¥æ¡¼¥¶¤Î´°Á´
|
|
¥ê¥¹¥È¤ò½èÍý¤·¤¿¤¤¥×¥í¥°¥é¥à¸þ¤¤Ç¤¹¡£
|
|
.Pp
|
|
.Fn setpassent
|
|
´Ø¿ô¤Ï
|
|
2 ¤Ä¤ÎÌÜŪ¤ò¿ë¹Ô¤·¤Þ¤¹¡£¤Þ¤º
|
|
.Fn getpwent
|
|
¤Ë¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎºÇ½é¤Ø
|
|
``rewind'' (¥ê¥ï¥¤¥ó¥É)
|
|
¤µ¤»¤Þ¤¹¡£¤µ¤é¤Ë
|
|
.Fa stayopen
|
|
¤¬¥¼¥í
|
|
¤Ç¤Ê¤±¤ì¤Ð¡¢¥Õ¥¡¥¤¥ëµ½Ò»Ò¤ò¥ª¡¼¥×¥ó¤·¤¿¤Þ¤Þ¤Ë¤·¤Þ¤¹¡£¤³¤ì¤é¥ë¡¼¥Á¥ó
|
|
¤¹¤Ù¤Æ¤Î°Ê¸å¤Î¥¢¥¯¥»¥¹¤¬¡¢¤³¤Î¤¿¤á¤¤ï¤á¤Æ¹â®²½¤µ¤ì¤Þ¤¹¡£
|
|
(¤¿¤À¤·
|
|
.Fn getpwent
|
|
¤Î¾ì¹ç¡¢¥Ç¥Õ¥©¥ë¥È¤Çµ½Ò»Ò¤ò¥¯¥í¡¼¥º¤·¤Ê¤¤¤Î¤Ç¸å¼Ô¤Îµ¡Ç½À¤Ï
|
|
ÉÔÍפǤ¹¡£)
|
|
.Pp
|
|
¥×¥í¥°¥é¥à¼Â¹ÔÃæ¤Ë¹¹¿·¤µ¤ì¤ë¤È¥Ç¡¼¥¿¥Ù¡¼¥¹¤¬¸Å¤¯¤Ê¤ë¤Î¤Ç¡¢Ä¹»þ´Ö¼Â¹Ô
|
|
¥×¥í¥°¥é¥à¤Ç¥Õ¥¡¥¤¥ëµ½Ò»Ò¤ò¥ª¡¼¥×¥ó¤·¤¿¤Þ¤Þ¤Ë¤¹¤ë¤³¤È¤Ï´í¸±¤Ç¤¹¡£
|
|
.Pp
|
|
.Fn setpwent
|
|
´Ø¿ô¤Ï¡¢°ú¿ô¥¼¥í¤ò»ý¤Ä
|
|
.Fn setpassent
|
|
¤ÈƱ¤¸¤Ç¤¹¡£
|
|
.Pp
|
|
.Fn endpwent
|
|
´Ø¿ô¤Ï¡¢¥ª¡¼¥×¥ó¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¤ò¤¹¤Ù¤Æ¥¯¥í¡¼¥º¤·¤Þ¤¹¡£
|
|
.Pp
|
|
¤³¤ì¤é¤Î¥ë¡¼¥Á¥ó¤Ï¡¢¥Ñ¥¹¥ï¡¼¥É¥Õ¥¡¥¤¥ë¤ò
|
|
``shadow'' (¥·¥ã¥É¥¦)
|
|
¤¹¤ëÌÜŪ¤Ç
|
|
½ñ¤«¤ì¤Þ¤·¤¿¡£¤¿¤È¤¨¤Ð¡¢°Å¹æ²½¥Ñ¥¹¥ï¡¼¥É¤Ë¥¢¥¯¥»¥¹¤Ç¤¤ë¥×¥í¥°¥é¥à¤¬
|
|
¸ÂÄê¤Ç¤¤ë¤è¤¦¤Ë¤Ç¤¹¡£¤¿¤È¤¨¤Ð¡¢¤³¤ì¤é¤ò¸Æ¤Ó½Ð¤¹½èÍý¤Î
|
|
uid
|
|
¤¬Í¸ú¤Ê
|
|
0 ¤Ê¤é¤Ð¥Ñ¥¹¥ï¡¼¥É¤òÊÖ¤·¡¢¤½¤Î¾¤Î¾ì¹ç¤Ï¹½Â¤ÂΤΥѥ¹¥ï¡¼¥É¥Õ¥£¡¼¥ë¥É¤Ë¡¢
|
|
¥¹¥È¥ê¥ó¥°
|
|
.Ql *
|
|
¤ò¼¨¤·¤ÆÊÖ¤·¤Þ¤¹¡£
|
|
.Sh YP/NIS ¤ÎÁê¸ßºîÍÑ
|
|
.Xr yp 4
|
|
¥Ñ¥¹¥ï¡¼¥É
|
|
¥Ç¡¼¥¿¥Ù¡¼¥¹¤¬»ÈÍѲÄǽ¤Ê¾ì¹ç¡¢¥í¡¼¥«¥ë¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë
|
|
Í׵ᤵ¤ì¤¿¥Ñ¥¹¥ï¡¼¥É¥¨¥ó¥È¥ê¤¬¸«ÉÕ¤«¤é¤Ê¤¤¤È¡¢
|
|
.Fn getpwnam
|
|
¤ª¤è¤Ó
|
|
.Fn getpwuid
|
|
´Ø¿ô¤Ï¤½¤ì¤¾¤ì¡¢
|
|
YP
|
|
¥Þ¥Ã¥×
|
|
.Dq Li passwd.byname
|
|
¤ª¤è¤Ó
|
|
.Dq Li passwd.byuid
|
|
¤ò»ÈÍѤ·¤Þ¤¹¡£
|
|
.Xr passwd 5
|
|
¤Çµ½Ò¤µ¤ì¤¿¤È¤ª¤ê¤ËÁ´ÂΥޥåפ¬»ÈÍѲÄǽ¤Ê¤é¤Ð¡¢
|
|
.Fn getpwent
|
|
´Ø¿ô¤Ï
|
|
YP
|
|
¥Þ¥Ã¥×
|
|
.Dq Li passwd.byname
|
|
¤òÄ̤ê¤Þ¤¹¡£
|
|
.Sh Ìá¤êÃÍ
|
|
´Ø¿ô
|
|
.Fn getpwent
|
|
¡¢
|
|
.Fn getpwnam
|
|
¤ª¤è¤Ó
|
|
.Fn getpwuid
|
|
¤Ï¡¢¤¤¤º¤ì¤âÀ®¸ù¤¹¤ë¤È¡¢
|
|
passwd
|
|
¹½Â¤ÂΤÎ͸ú¤Ê¥Ý¥¤¥ó¥¿¤òÊÖ¤·¤Þ¤¹¡£¥¨¥ó¥É¥ª¥Ö¥Õ¥¡¥¤¥ë¤ËÅþ㤹¤ë¤«
|
|
¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï¡¢
|
|
null
|
|
¥Ý¥¤¥ó¥¿¤¬ÊÖ¤ê¤Þ¤¹¡£
|
|
.Fn setpassent
|
|
´Ø¿ô¤Ï¼ºÇÔ¤·¤¿
|
|
¾ì¹ç¤Ï
|
|
0 ¤ò¡¢À®¸ù¤·¤¿¾ì¹ç¤Ï
|
|
1 ¤òÊÖ¤·¤Þ¤¹¡£
|
|
.Fn endpwent
|
|
¤ª¤è¤Ó
|
|
.Fn setpwent
|
|
´Ø¿ô¤ÎÌá¤êÃͤϤ¢¤ê¤Þ¤»¤ó¡£
|
|
.Sh ´ØÏ¢¥Õ¥¡¥¤¥ë
|
|
.Bl -tag -width /etc/master.passwd -compact
|
|
.It Pa /etc/pwd.db
|
|
°ÂÁ´¤Ç¤Ï¤Ê¤¤¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
|
|
.It Pa /etc/spwd.db
|
|
°ÂÁ´¤Ê¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
|
|
.It Pa /etc/master.passwd
|
|
¸½ºß¤Î¥Ñ¥¹¥ï¡¼¥É¥Õ¥¡¥¤¥ë
|
|
.It Pa /etc/passwd
|
|
Version 7
|
|
·Á¼°¤Î¥Ñ¥¹¥ï¡¼¥É¥Õ¥¡¥¤¥ë
|
|
.El
|
|
.Sh ´ØÏ¢¹àÌÜ
|
|
.Xr getlogin 2
|
|
¡¢
|
|
.Xr getgrent 3
|
|
¡¢
|
|
.Xr yp 4
|
|
¡¢
|
|
.Xr passwd 5
|
|
¡¢
|
|
.Xr pwd_mkdb 8
|
|
¡¢
|
|
.Xr vipw 8
|
|
.Sh Îò»Ë
|
|
.Fn getpwent
|
|
¡¢
|
|
.Fn getpwnam
|
|
¡¢
|
|
.Fn getpwuid
|
|
¡¢
|
|
.Fn setpwent
|
|
¤ª¤è¤Ó
|
|
.Fn endpwent
|
|
´Ø¿ô¤Ï¡¢
|
|
.At v7
|
|
¤ÇºÇ½é¤Ë¼è¤êÆþ¤ì¤é¤ì¤Þ¤·¤¿¡£
|
|
.Fn setpassent
|
|
´Ø¿ô¤Ï
|
|
.Bx 4.3-Reno
|
|
¤ÇºÇ½é¤Ë¼è¤êÆþ¤ì¤é¤ì¤Þ¤·¤¿¡£
|
|
.Sh ¸ß´¹À
|
|
ÂåÂإѥ¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¤Îµ¬³Ê¤òµö¤·¤¿Îò»ËŪ¤Ê´Ø¿ô
|
|
.Xr setpwfile 3
|
|
¤Ï¡¢
|
|
¤³¤ì¤Þ¤ÇÈóÆñ¤µ¤ì¤Æ¤¤Þ¤·¤¿¤¬¡¢¤â¤Ï¤ä»ÈÍѤǤ¤Þ¤»¤ó¡£
|
|
.Sh ¥Ð¥°
|
|
´Ø¿ô
|
|
.Fn getpwent
|
|
¡¢
|
|
.Fn getpwnam
|
|
¤ª¤è¤Ó
|
|
.Fn getpwuid
|
|
¤Ï¡¢¤½¤ì¤¾¤ì¤Î·ë²Ì¤òÆâÉô¤Î
|
|
ÀÅŪ¥ª¥Ö¥¸¥§¥¯¥È¤Ë»Ä¤·¡¢¤½¤Î¥ª¥Ö¥¸¥§¥¯¥È¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤·¤Þ¤¹¡£¸å¤Ë³¤¯Æ±¤¸
|
|
´Ø¿ô¤Î¸Æ¤Ó½Ð¤·¤Ï¡¢¤³¤ÎƱ¤¸¥ª¥Ö¥¸¥§¥¯¥È¤ò²þÊѤ·¤Þ¤¹¡£
|