tizen 2.0
[external/shadow.git] / man / pl / 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.1 <http://docbook.sf.net/>
5 .\"      Date: 07/24/2009
6 .\"    Manual: Polecenia użytkownik\('ow
7 .\"    Source: Polecenia użytkownik\('ow
8 .\"  Language: Polish
9 .\"
10 .TH "CHFN" "1" "07/24/2009" "Polecenia użytkownik\('ow" "Polecenia użytkownik\('ow"
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 chfn \- change real user name and information
23 .SH "SK\(/LADNIA"
24 .HP \w'\fBchfn\fR\ 'u
25 \fBchfn\fR [\-f\ \fIfull_name\fR] [\-r\ \fIroom_no\fR] [\-w\ \fIwork_ph\fR] [\-h\ \fIhome_ph\fR] [\-o\ \fIother\fR] [\fIuser\fR]
26 .SH "OPIS"
27 .PP
28 The
29 \fBchfn\fR
30 command changes user fullname, office number, office extension, and home phone number information for a user\'s account\&. This information is typically printed by
31 \fBfinger\fR(1)
32 and similar programs\&. A normal user may only change the fields for her own account, subject to the restrictions in
33 /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
34 \fB\-o\fR
35 option to change the undefined portions of the GECOS field\&.
36 .PP
37 These fields must not contain any colons\&. Except for the
38 \fIother\fR
39 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
40 \fIother\fR
41 field is used to store accounting information used by other applications\&.
42 .PP
43 If none of the options are selected,
44 \fBchfn\fR
45 operates in an interactive fashion, prompting the user with the current values for all of the fields\&. Enter the new value to change the field, or leave the line blank to use the current value\&. The current value is displayed between a pair of
46 \fB[ ]\fR
47 marks\&. Without options,
48 \fBchfn\fR
49 prompts for the current user account\&.
50 .SH "CONFIGURATION"
51 .PP
52 The following configuration variables in
53 /etc/login\&.defs
54 change the behavior of this tool:
55 .PP
56 \fBCHFN_AUTH\fR (boolean)
57 .RS 4
58 If
59 \fIyes\fR, the
60 \fBchfn\fR
61 program will require authentication before making any changes, unless run by the superuser\&.
62 .RE
63 .PP
64 \fBCHFN_RESTRICT\fR (string)
65 .RS 4
66 This parameter specifies which values in the
67 \fIgecos\fR
68 field of the
69 /etc/passwd
70 file may be changed by regular users using the
71 \fBchfn\fR
72 program\&. It can be any combination of letters
73 \fIf\fR,
74 \fIr\fR,
75 \fIw\fR,
76 \fIh\fR, for Full name, Room number, Work phone, and Home phone, respectively\&. For backward compatibility,
77 \fIyes\fR
78 is equivalent to
79 \fIrwh\fR
80 and
81 \fIno\fR
82 is equivalent to
83 \fIfrwh\fR\&. If not specified, only the superuser can make any changes\&. The most restrictive setting is better achieved by not installing
84 \fBchfn\fR
85 SUID\&.
86 .RE
87 .PP
88 \fBLOGIN_STRING\fR (string)
89 .RS 4
90 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\&.
91 .sp
92 If the string contains
93 \fI%s\fR, this will be replaced by the user\'s name\&.
94 .RE
95 .SH "PLIKI"
96 .PP
97 /etc/login\&.defs
98 .RS 4
99 Konfiguracja pakietu shadow\&.
100 .RE
101 .PP
102 /etc/passwd
103 .RS 4
104 Informacja o kontach użytkownik\('ow\&.
105 .RE
106 .SH "ZOBACZ TAKŻE"
107 .PP
108 \fBchsh\fR(1),
109 \fBlogin.defs\fR(5),
110 \fBpasswd\fR(5)\&.