include/pwd.h

   1 /*      $NetBSD: pwd.h,v 1.40 2007/10/18 02:23:37 christos Exp $        */
   2
   3 /*-
   4  * Copyright (c) 1989, 1993
   5  *      The Regents of the University of California.  All rights reserved.
   6  * (c) UNIX System Laboratories, Inc.
   7  * All or some portions of this file are derived from material licensed
   8  * to the University of California by American Telephone and Telegraph
   9  * Co. or Unix System Laboratories, Inc. and are reproduced herein with
  10  * the permission of UNIX System Laboratories, Inc.
  11  *
  12  * Redistribution and use in source and binary forms, with or without
  13  * modification, are permitted provided that the following conditions
  14  * are met:
  15  * 1. Redistributions of source code must retain the above copyright
  16  *    notice, this list of conditions and the following disclaimer.
  17  * 2. Redistributions in binary form must reproduce the above copyright
  18  *    notice, this list of conditions and the following disclaimer in the
  19  *    documentation and/or other materials provided with the distribution.
  20  * 3. Neither the name of the University nor the names of its contributors
  21  *    may be used to endorse or promote products derived from this software
  22  *    without specific prior written permission.
  23  *
  24  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  25  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  26  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  27  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  28  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  29  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  30  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  31  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  32  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  33  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  34  * SUCH DAMAGE.
  35  *
  36  *      @(#)pwd.h       8.2 (Berkeley) 1/21/94
  37  */
  38
  39 /*-
  40  * Portions Copyright(C) 1995, Jason Downs.  All rights reserved.
  41  *
  42  * Redistribution and use in source and binary forms, with or without
  43  * modification, are permitted provided that the following conditions
  44  * are met:
  45  * 1. Redistributions of source code must retain the above copyright
  46  *    notice, this list of conditions and the following disclaimer.
  47  * 2. Redistributions in binary form must reproduce the above copyright
  48  *    notice, this list of conditions and the following disclaimer in the
  49  *    documentation and/or other materials provided with the distribution.
  50  *
  51  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
  52  * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
  53  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
  54  * DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
  55  * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
  56  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
  57  * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
  58  * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  59  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  60  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  61  * SUCH DAMAGE.
  62  */
  63
  64 #ifndef _PWD_H_
  65 #define _PWD_H_
  66
  67 #include <sys/cdefs.h>
  68 #include <sys/featuretest.h>
  69 #include <sys/types.h>
  70
  71 #if defined(_NETBSD_SOURCE) || defined(HAVE_NBTOOL_CONFIG_H)
  72 #define _PATH_PASSWD            "/etc/passwd"
  73 #define _PATH_MASTERPASSWD      "/etc/master.passwd"
  74 #define _PATH_MASTERPASSWD_LOCK "/etc/ptmp"
  75
  76 #define _PATH_PASSWD_CONF       "/etc/passwd.conf"
  77 #define _PATH_PASSWDCONF        _PATH_PASSWD_CONF       /* XXX: compat */
  78 #define _PATH_USERMGMT_CONF     "/etc/usermgmt.conf"
  79
  80 #define _PATH_MP_DB             "/etc/pwd.db"
  81 #define _PATH_SMP_DB            "/etc/spwd.db"
  82
  83 #define _PATH_PWD_MKDB          "/usr/sbin/pwd_mkdb"
  84
  85 #define _PW_KEYBYNAME           '1'     /* stored by name */
  86 #define _PW_KEYBYNUM            '2'     /* stored by entry in the "file" */
  87 #define _PW_KEYBYUID            '3'     /* stored by uid */
  88
  89 #define _PASSWORD_EFMT1         '_'     /* extended DES encryption format */
  90 #define _PASSWORD_NONDES        '$'     /* non-DES encryption formats */
  91
  92 #define _PASSWORD_LEN           128     /* max length, not counting NUL */
  93
  94 #define _PASSWORD_NOUID         0x01    /* flag for no specified uid. */
  95 #define _PASSWORD_NOGID         0x02    /* flag for no specified gid. */
  96 #define _PASSWORD_NOCHG         0x04    /* flag for no specified change. */
  97 #define _PASSWORD_NOEXP         0x08    /* flag for no specified expire. */
  98
  99 #define _PASSWORD_OLDFMT        0x10    /* flag to expect an old style entry */
 100 #define _PASSWORD_NOWARN        0x20    /* no warnings for bad entries */
 101
 102 #define _PASSWORD_WARNDAYS      14      /* days to warn about expiry */
 103 #define _PASSWORD_CHGNOW        -1      /* special day to force password
 104                                          * change at next login */
 105 #endif
 106
 107 struct passwd {
 108         __aconst char *pw_name;         /* user name */
 109         __aconst char *pw_passwd;       /* encrypted password */
 110         uid_t       pw_uid;             /* user uid */
 111         gid_t       pw_gid;             /* user gid */
 112         time_t      pw_change;          /* password change time */
 113         __aconst char *pw_class;        /* user login class */
 114         __aconst char *pw_gecos;        /* general information */
 115         __aconst char *pw_dir;          /* home directory */
 116         __aconst char *pw_shell;        /* default shell */
 117         time_t      pw_expire;          /* account expiration */
 118 };
 119
 120 __BEGIN_DECLS
 121 struct passwd   *getpwuid(uid_t);
 122 struct passwd   *getpwnam(const char *);
 123 #if (_POSIX_C_SOURCE - 0) >= 199506L || (_XOPEN_SOURCE - 0) >= 500 || \
 124     defined(_REENTRANT) || defined(_NETBSD_SOURCE)
 125 int              getpwnam_r(const char *, struct passwd *, char *, size_t,
 126                                 struct passwd **);
 127 int              getpwuid_r(uid_t, struct passwd *, char *, size_t,
 128                                 struct passwd **);
 129 #endif
 130 #if defined(_XOPEN_SOURCE) || defined(_NETBSD_SOURCE)
 131 struct passwd   *getpwent(void);
 132 void             setpwent(void);
 133 void             endpwent(void);
 134 #endif
 135 #if defined(_NETBSD_SOURCE)
 136 int              pw_gensalt(char *, size_t, const char *, const char *);
 137 int              pw_scan(char *, struct passwd *, int *);
 138 int              setpassent(int);
 139 int              getpwent_r(struct passwd *, char *, size_t, struct passwd **);
 140 const char      *user_from_uid(uid_t, int);
 141 int              uid_from_user(const char *, uid_t *);
 142 int              pwcache_userdb(int (*)(int), void (*)(void),
 143                                 struct passwd * (*)(const char *),
 144                                 struct passwd * (*)(uid_t));
 145 #endif
 146 __END_DECLS
 147
 148 #endif /* !_PWD_H_ */