]>
Commit | Line | Data |
---|---|---|
6dbe3af9 KZ |
1 | .\" |
2 | .\" chfn.1 -- change your finger information | |
3 | .\" (c) 1994 by salvatore valente <svalente@athena.mit.edu> | |
4 | .\" | |
bf967a6c BS |
5 | .\" This program is free software. You can redistribute it and |
6 | .\" modify it under the terms of the GNU General Public License. | |
7 | .\" There is no warranty. | |
6dbe3af9 | 8 | .\" |
1e6a9c18 | 9 | .TH CHFN 1 "November 2015" "util-linux" "User Commands" |
6dbe3af9 KZ |
10 | .SH NAME |
11 | chfn \- change your finger information | |
12 | .SH SYNOPSIS | |
13 | .B chfn | |
3e1dd9e8 PB |
14 | .RB [ \-f |
15 | .IR full-name ] | |
16 | .RB [ \-o | |
17 | .IR office ] | |
b5fff521 | 18 | .RB [ \-p |
3e1dd9e8 PB |
19 | .IR office-phone ] |
20 | .RB [ \-h | |
21 | .IR home-phone ] | |
b5fff521 | 22 | .RB [ \-u ] |
3e1dd9e8 PB |
23 | .RB [ \-v ] |
24 | .RI [ username ] | |
6dbe3af9 KZ |
25 | .SH DESCRIPTION |
26 | .B chfn | |
27 | is used to change your finger information. This information is | |
28 | stored in the | |
29 | .I /etc/passwd | |
30 | file, and is displayed by the | |
31 | .B finger | |
32 | program. The Linux | |
33 | .B finger | |
34 | command will display four pieces of information that can be changed by | |
3e1dd9e8 PB |
35 | .BR chfn : |
36 | your real name, your work room and phone, and your home phone. | |
bf967a6c | 37 | .PP |
6dbe3af9 KZ |
38 | Any of the four pieces of information can be specified on the command |
39 | line. If no information is given on the command line, | |
40 | .B chfn | |
41 | enters interactive mode. | |
bf967a6c | 42 | .PP |
6dbe3af9 KZ |
43 | In interactive mode, |
44 | .B chfn | |
45 | will prompt for each field. At a prompt, you can enter the new information, | |
46 | or just press return to leave the field unchanged. Enter the keyword | |
47 | "none" to make the field blank. | |
bf967a6c BS |
48 | .PP |
49 | .B chfn | |
50 | supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser, | |
51 | otherwise use \fBypchfn\fR, \fBlchfn\fR or any other implementation for | |
52 | non-local entries. | |
6dbe3af9 KZ |
53 | .SH OPTIONS |
54 | .TP | |
b06c1ca6 | 55 | .BR \-f , " \-\-full\-name " \fIfull-name |
6dbe3af9 KZ |
56 | Specify your real name. |
57 | .TP | |
bf967a6c | 58 | .BR \-o , " \-\-office " \fIoffice |
6dbe3af9 KZ |
59 | Specify your office room number. |
60 | .TP | |
b06c1ca6 | 61 | .BR \-p , " \-\-office\-phone " \fIoffice-phone |
6dbe3af9 KZ |
62 | Specify your office phone number. |
63 | .TP | |
b06c1ca6 | 64 | .BR \-h , " \-\-home\-phone " \fIhome-phone |
6dbe3af9 KZ |
65 | Specify your home phone number. |
66 | .TP | |
bf967a6c | 67 | .BR \-u , " \-\-help" |
b4362b6f | 68 | Display help text and exit. |
6dbe3af9 | 69 | .TP |
bf967a6c | 70 | .BR \-v , " \-\-version" |
b4362b6f | 71 | Display version information and exit. |
3e16df15 KZ |
72 | .SH CONFIG FILE ITEMS |
73 | .B chfn | |
74 | reads the | |
46f057ed | 75 | .IR /etc\:/login.defs (5) |
3e16df15 KZ |
76 | configuration file. Note that the configuration file could be |
77 | distributed with another package (e.g. shadow-utils). The following | |
78 | configuration items are relevant for | |
79 | .BR chfn (1): | |
80 | .PP | |
1e6a9c18 | 81 | .BI CHFN_RESTRICT " string" |
3e16df15 KZ |
82 | .RS 4 |
83 | Indicate which fields are changeable by \fBchfn\fR. | |
84 | ||
1e6a9c18 BS |
85 | The boolean setting \fB"yes"\fR means that only the Office, Office Phone and |
86 | Home Phone fields are changeable, and boolean setting \fB"no"\fR means that | |
87 | also the Full Name is changeable. | |
3e16df15 | 88 | |
1e6a9c18 BS |
89 | Another way to specify changeable fields is by abbreviations: f = Full Name, |
90 | r = Office (room), w = Office (work) Phone, h = Home Phone. For example, | |
91 | \fBCHFN_RESTRICT "wh"\fR allows changing work and home phone numbers. | |
3e16df15 | 92 | |
1e6a9c18 BS |
93 | If CHFN_RESTRICT is undefined, then all finger information is read-only. |
94 | This is the default. | |
3e16df15 KZ |
95 | .RE |
96 | .PP | |
97da60c6 KZ |
97 | .SH "EXIT STATUS" |
98 | Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid. | |
6dbe3af9 | 99 | .SH "SEE ALSO" |
3fe5e8ec | 100 | .BR chsh (1), |
6dbe3af9 | 101 | .BR finger (1), |
3fe5e8ec | 102 | .BR login.defs (5), |
6dbe3af9 KZ |
103 | .BR passwd (5) |
104 | .SH AUTHOR | |
105 | Salvatore Valente <svalente@mit.edu> | |
86d62711 | 106 | .SH AVAILABILITY |
601d12fb | 107 | The chfn command is part of the util-linux package and is available from |
d673b74e | 108 | https://www.kernel.org/pub/linux/utils/util-linux/. |