Initial commit for Tizen
[profile/extras/shadow-utils.git] / man / it / chfn.1
1 '\" t
2 .\"     Title: chfn
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: User Commands
7 .\"    Source: User Commands
8 .\"  Language: Italian
9 .\"
10 .TH "CHFN" "1" "16/02/2011" "User Commands" "User 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 chfn \- change real user name and information
32 .SH "SINOSSI"
33 .HP \w'\fBchfn\fR\ 'u
34 \fBchfn\fR [\-f\ \fIfull_name\fR] [\-r\ \fIroom_no\fR] [\-w\ \fIwork_ph\fR] [\-h\ \fIhome_ph\fR] [\-o\ \fIother\fR] [\fIuser\fR]
35 .SH "DESCRIZIONE"
36 .PP
37 The
38 \fBchfn\fR
39 command changes user fullname, office number, office extension, and home phone number information for a user\*(Aqs account\&. This information is typically printed by
40 \fBfinger\fR(1)
41 and similar programs\&. A normal user may only change the fields for her own account, subject to the restrictions in
42 /etc/login\&.defs\&. (The default configuration is to prevent users from changing their fullname\&.) The superuser may change any field for any account\&. Additionally, only the superuser may use the
43 \fB\-o\fR
44 option to change the undefined portions of the GECOS field\&.
45 .PP
46 These fields must not contain any colons\&. Except for the
47 \fIother\fR
48 field, they should not contain any comma or equal sign\&. It is also recommended to avoid non\-US\-ASCII characters, but this is only enforced for the phone numbers\&. The
49 \fIother\fR
50 field is used to store accounting information used by other applications\&.
51 .PP
52 Se nessuna delle opzioni \(`e selezionata,
53 \fBchfn\fR
54 opera in maniera interattiva, chiedendo all\*(Aqutente il valore da impostare per ogni campo\&. Inserire un nuovo valore per sostituire il contenuto attuale, oppure lasciare la linea vuota per non cambiarlo\&. Il valore attuale \(`e mostrato tra le parentesi
55 \fB[ ]\fR\&. Senza alcuna opzione,
56 \fBchfn\fR, chiede l\*(Aqaccount sul quale operare\&.
57 .SH "CONFIGURATION"
58 .PP
59 The following configuration variables in
60 /etc/login\&.defs
61 change the behavior of this tool:
62 .PP
63 \fBCHFN_AUTH\fR (boolean)
64 .RS 4
65 If
66 \fIyes\fR, the
67 \fBchfn\fR
68 program will require authentication before making any changes, unless run by the superuser\&.
69 .RE
70 .PP
71 \fBCHFN_RESTRICT\fR (string)
72 .RS 4
73 This parameter specifies which values in the
74 \fIgecos\fR
75 field of the
76 /etc/passwd
77 file may be changed by regular users using the
78 \fBchfn\fR
79 program\&. It can be any combination of letters
80 \fIf\fR,
81 \fIr\fR,
82 \fIw\fR,
83 \fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility,
84 \fIyes\fR
85 is equivalent to
86 \fIrwh\fR
87 and
88 \fIno\fR
89 is equivalent to
90 \fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing
91 \fBchfn\fR
92 SUID\&.
93 .RE
94 .PP
95 \fBLOGIN_STRING\fR (string)
96 .RS 4
97 The string used for prompting a password\&. The default is to use "Password: ", or a translation of that string\&. If you set this variable, the prompt will no be translated\&.
98 .sp
99 If the string contains
100 \fI%s\fR, this will be replaced by the user\*(Aqs name\&.
101 .RE
102 .SH "FILE"
103 .PP
104 /etc/login\&.defs
105 .RS 4
106 Shadow password suite configuration\&.
107 .RE
108 .PP
109 /etc/passwd
110 .RS 4
111 informazioni sugli account utente\&.
112 .RE
113 .SH "VEDERE ANCHE"
114 .PP
115 \fBchsh\fR(1),
116 \fBlogin.defs\fR(5),
117 \fBpasswd\fR(5)\&.