man/pl/pwconv.8

   1 '\" t
   2 .\"     Title: pwconv
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.75.1 <http://docbook.sf.net/>
   5 .\"      Date: 07/24/2009
   6 .\"    Manual: Polecenia Zarządzania Systemem
   7 .\"    Source: Polecenia Zarządzania Systemem
   8 .\"  Language: Polish
   9 .\"
  10 .TH "PWCONV" "8" "07/24/2009" "Polecenia Zarządzania Systemem" "Polecenia Zarządzania Systemem"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAZWA"
  22 pwconv, pwunconv, grpconv, grpunconv \- convert to and from shadow passwords and groups
  23 .SH "SK\(/LADNIA"
  24 .HP \w'\fBpwconv\fR\ 'u
  25 \fBpwconv\fR
  26 .HP \w'\fBpwunconv\fR\ 'u
  27 \fBpwunconv\fR
  28 .HP \w'\fBgrpconv\fR\ 'u
  29 \fBgrpconv\fR
  30 .HP \w'\fBgrpunconv\fR\ 'u
  31 \fBgrpunconv\fR
  32 .SH "OPIS"
  33 .PP
  34 The
  35 \fBpwconv\fR
  36 command creates
  37 \fIshadow\fR
  38 from
  39 \fIpasswd\fR
  40 and an optionally existing
  41 \fIshadow\fR\&.
  42 .PP
  43 The
  44 \fBpwunconv\fR
  45 command creates
  46 \fIpasswd\fR
  47 from
  48 \fIpasswd\fR
  49 and
  50 \fIshadow\fR
  51 and then removes
  52 \fIshadow\fR\&.
  53 .PP
  54 The
  55 \fBgrpconv\fR
  56 command creates
  57 \fIgshadow\fR
  58 from
  59 \fIgroup\fR
  60 and an optionally existing
  61 \fIgshadow\fR\&.
  62 .PP
  63 The
  64 \fBgrpunconv\fR
  65 command creates
  66 \fIgroup\fR
  67 from
  68 \fIgroup\fR
  69 and
  70 \fIgshadow\fR
  71 and then removes
  72 \fIgshadow\fR\&.
  73 .PP
  74 These four programs all operate on the normal and shadow password and group files:
  75 /etc/passwd,
  76 /etc/group,
  77 /etc/shadow, and
  78 /etc/gshadow\&.
  79 .PP
  80 Each program acquires the necessary locks before conversion\&.
  81 \fBpwconv\fR
  82 and
  83 \fBgrpconv\fR
  84 are similar\&. First, entries in the shadowed file which don\'t exist in the main file are removed\&. Then, shadowed entries which don\'t have `x\' as the password in the main file are updated\&. Any missing shadowed entries are added\&. Finally, passwords in the main file are replaced with `x\'\&. These programs can be used for initial conversion as well to update the shadowed file if the main file is edited by hand\&.
  85 .PP
  86
  87 \fBpwconv\fR
  88 will use the values of
  89 \fIPASS_MIN_DAYS\fR,
  90 \fIPASS_MAX_DAYS\fR, and
  91 \fIPASS_WARN_AGE\fR
  92 from
  93 /etc/login\&.defs
  94 when adding new entries to
  95 /etc/shadow\&.
  96 .PP
  97 Likewise
  98 \fBpwunconv\fR
  99 and
 100 \fBgrpunconv\fR
 101 are similar\&. Passwords in the main file are updated from the shadowed file\&. Entries which exist in the main file but not in the shadowed file are left alone\&. Finally, the shadowed file is removed\&. Some password aging information is lost by
 102 \fBpwunconv\fR\&. It will convert what it can\&.
 103 .SH "B\(/LĘDY"
 104 .PP
 105 Errors in the password or group files (such as invalid or duplicate entries) may cause these programs to loop forever or fail in other strange ways\&. Please run
 106 \fBpwck\fR
 107 and
 108 \fBgrpck\fR
 109 to correct any such errors before converting to or from shadow passwords or groups\&.
 110 .SH "CONFIGURATION"
 111 .PP
 112 The following configuration variable in
 113 /etc/login\&.defs
 114 changes the behavior of
 115 \fBgrpconv\fR
 116 and
 117 \fBgrpunconv\fR:
 118 .PP
 119 \fBMAX_MEMBERS_PER_GROUP\fR (number)
 120 .RS 4
 121 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
 122 /etc/group
 123 (with the same name, same password, and same GID)\&.
 124 .sp
 125 The default value is 0, meaning that there are no limits in the number of members in a group\&.
 126 .sp
 127 This feature (split group) permits to limit the length of lines in the group file\&. This is useful to make sure that lines for NIS groups are not larger than 1024 characters\&.
 128 .sp
 129 If you need to enforce such limit, you can use 25\&.
 130 .sp
 131 Note: split groups may not be supported by all tools (even in the Shadow toolsuite)\&. You should not use this variable unless you really need it\&.
 132 .RE
 133 .PP
 134 The following configuration variables in
 135 /etc/login\&.defs
 136 change the behavior of
 137 \fBpwconv\fR:
 138 .PP
 139 \fBPASS_MAX_DAYS\fR (number)
 140 .RS 4
 141 The maximum number of days a password may be used\&. If the password is older than this, a password change will be forced\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
 142 .RE
 143 .PP
 144 \fBPASS_MIN_DAYS\fR (number)
 145 .RS 4
 146 The minimum number of days allowed between password changes\&. Any password changes attempted sooner than this will be rejected\&. If not specified, \-1 will be assumed (which disables the restriction)\&.
 147 .RE
 148 .PP
 149 \fBPASS_WARN_AGE\fR (number)
 150 .RS 4
 151 The number of days warning given before a password expires\&. A zero means warning is given only upon the day of expiration, a negative value means no warning is given\&. If not specified, no warning will be provided\&.
 152 .RE
 153 .SH "PLIKI"
 154 .PP
 155 /etc/login\&.defs
 156 .RS 4
 157 Konfiguracja pakietu shadow\&.
 158 .RE
 159 .SH "ZOBACZ TAKŻE"
 160 .PP
 161 \fBgrpck\fR(8),
 162 \fBlogin.defs\fR(5),
 163 \fBpwck\fR(8)\&.