Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / it / 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.2 <http://docbook.sf.net/>
5 .\"      Date: 16/02/2011
6 .\"    Manual: System Management Commands
7 .\"    Source: System Management Commands
8 .\"  Language: Italian
9 .\"
10 .TH "PWCONV" "8" "16/02/2011" "System Management Commands" "System Management Commands"
11 .\" -----------------------------------------------------------------
12 .\" * Define some portability stuff
13 .\" -----------------------------------------------------------------
14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
15 .\" http://bugs.debian.org/507673
16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
18 .ie \n(.g .ds Aq \(aq
19 .el       .ds Aq '
20 .\" -----------------------------------------------------------------
21 .\" * set default formatting
22 .\" -----------------------------------------------------------------
23 .\" disable hyphenation
24 .nh
25 .\" disable justification (adjust text to left margin only)
26 .ad l
27 .\" -----------------------------------------------------------------
28 .\" * MAIN CONTENT STARTS HERE *
29 .\" -----------------------------------------------------------------
30 .SH "NOME"
31 pwconv, pwunconv, grpconv, grpunconv \- convertono a e da password e gruppi shadow\&.
32 .SH "SINOSSI"
33 .HP \w'\fBpwconv\fR\ 'u
34 \fBpwconv\fR
35 .HP \w'\fBpwunconv\fR\ 'u
36 \fBpwunconv\fR
37 .HP \w'\fBgrpconv\fR\ 'u
38 \fBgrpconv\fR
39 .HP \w'\fBgrpunconv\fR\ 'u
40 \fBgrpunconv\fR
41 .SH "DESCRIZIONE"
42 .PP
43 The
44 \fBpwconv\fR
45 command creates
46 \fIshadow\fR
47 from
48 \fIpasswd\fR
49 and an optionally existing
50 \fIshadow\fR\&.
51 .PP
52 The
53 \fBpwunconv\fR
54 command creates
55 \fIpasswd\fR
56 from
57 \fIpasswd\fR
58 and
59 \fIshadow\fR
60 and then removes
61 \fIshadow\fR\&.
62 .PP
63 The
64 \fBgrpconv\fR
65 command creates
66 \fIgshadow\fR
67 from
68 \fIgroup\fR
69 and an optionally existing
70 \fIgshadow\fR\&.
71 .PP
72 The
73 \fBgrpunconv\fR
74 command creates
75 \fIgroup\fR
76 from
77 \fIgroup\fR
78 and
79 \fIgshadow\fR
80 and then removes
81 \fIgshadow\fR\&.
82 .PP
83 Questi quattro programmi agiscono tutti sui file normali e oscurati (shadow) delle password e dei gruppi:
84 /etc/passwd,
85 /etc/group,
86 /etc/shadow
87 e
88 /etc/gshadow\&.
89 .PP
90 Ciascun programma, prima della conversione, acquisisce i lock necessari\&.
91 \fBpwconv\fR
92 e
93 \fBgrpconv\fR
94 sono simili\&. Per prima cosa vengono rimosse le voci nel file oscurato che non esistono nel file principale\&. Quindi vengono aggiornate le voci oscurate che non hanno `x\*(Aq come password nel file principale\&. Vengono aggiunte le eventuali voci oscurate mancanti\&. Infine, le password nel file principale vengono sostituite con `x\*(Aq\&. Questi programmi possono essere usati per le conversioni iniziali cos\(`i come per aggiornare il file oscurato se il file principale viene editato a mano\&.
95 .PP
96
97 \fBpwconv\fR
98 will use the values of
99 \fIPASS_MIN_DAYS\fR,
100 \fIPASS_MAX_DAYS\fR, and
101 \fIPASS_WARN_AGE\fR
102 from
103 /etc/login\&.defs
104 when adding new entries to
105 /etc/shadow\&.
106 .PP
107 Analogamente,
108 \fBpwunconv\fR
109 e
110 \fBgrpunconv\fR
111 sono simili\&. Le password nel file principale vengono aggiornate dal file oscurato\&. Voci che esistono nel file principale ma non nel file oscurato vengono lasciate stare\&. Infine, viene rimosso il file oscurato\&.Alcune informazioni sull\*(Aqinvecchiamento delle password vengono perse da
112 \fBpwunconv\fR\&. Convertir\(`a solo quello che potr\(`a\&.
113 .SH "PROBLEMI"
114 .PP
115 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
116 \fBpwck\fR
117 and
118 \fBgrpck\fR
119 to correct any such errors before converting to or from shadow passwords or groups\&.
120 .SH "CONFIGURATION"
121 .PP
122 The following configuration variable in
123 /etc/login\&.defs
124 changes the behavior of
125 \fBgrpconv\fR
126 and
127 \fBgrpunconv\fR:
128 .PP
129 \fBMAX_MEMBERS_PER_GROUP\fR (number)
130 .RS 4
131 Maximum members per group entry\&. When the maximum is reached, a new group entry (line) is started in
132 /etc/group
133 (with the same name, same password, and same GID)\&.
134 .sp
135 The default value is 0, meaning that there are no limits in the number of members in a group\&.
136 .sp
137 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\&.
138 .sp
139 If you need to enforce such limit, you can use 25\&.
140 .sp
141 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\&.
142 .RE
143 .PP
144 The following configuration variables in
145 /etc/login\&.defs
146 change the behavior of
147 \fBpwconv\fR:
148 .PP
149 \fBPASS_MAX_DAYS\fR (number)
150 .RS 4
151 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)\&.
152 .RE
153 .PP
154 \fBPASS_MIN_DAYS\fR (number)
155 .RS 4
156 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)\&.
157 .RE
158 .PP
159 \fBPASS_WARN_AGE\fR (number)
160 .RS 4
161 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\&.
162 .RE
163 .SH "FILE"
164 .PP
165 /etc/login\&.defs
166 .RS 4
167 Shadow password suite configuration\&.
168 .RE
169 .SH "VEDERE ANCHE"
170 .PP
171 \fBgrpck\fR(8),
172 \fBlogin.defs\fR(5),
173 \fBpwck\fR(8)\&.