]>
Commit | Line | Data |
---|---|---|
295b3979 | 1 | //po4a: entry man manual |
a7574d88 MB |
2 | //// |
3 | chfn.1 -- change your finger information | |
4 | (c) 1994 by salvatore valente <svalente@athena.mit.edu> | |
5 | ||
6 | This program is free software. You can redistribute it and | |
7 | modify it under the terms of the GNU General Public License. | |
8 | There is no warranty. | |
9 | //// | |
10 | = chfn(1) | |
11 | :doctype: manpage | |
f42ed819 | 12 | :man manual: User Commands |
a7574d88 MB |
13 | :man source: util-linux {release-version} |
14 | :page-layout: base | |
15 | :command: chfn | |
16 | ||
17 | == NAME | |
18 | ||
19 | chfn - change your finger information | |
20 | ||
21 | == SYNOPSIS | |
22 | ||
0222a2ca | 23 | *chfn* [*-f* _full-name_] [*-o* _office_] [*-p* _office-phone_] [*-h* _home-phone_] [*-u*] [*-V*] [_username_] |
a7574d88 MB |
24 | |
25 | == DESCRIPTION | |
26 | ||
27 | *chfn* is used to change your finger information. This information is stored in the _/etc/passwd_ file, and is displayed by the *finger* program. The Linux *finger* command will display four pieces of information that can be changed by *chfn*: your real name, your work room and phone, and your home phone. | |
28 | ||
29 | Any of the four pieces of information can be specified on the command line. If no information is given on the command line, *chfn* enters interactive mode. | |
30 | ||
31 | In interactive mode, *chfn* will prompt for each field. At a prompt, you can enter the new information, or just press return to leave the field unchanged. Enter the keyword "none" to make the field blank. | |
32 | ||
33 | *chfn* supports non-local entries (kerberos, LDAP, etc.) if linked with libuser, otherwise use *ypchfn*(1), *lchfn*(1) or any other implementation for non-local entries. | |
34 | ||
35 | == OPTIONS | |
36 | ||
37 | *-f*, *--full-name* _full-name_:: | |
62fde24f | 38 | Specify your real name. |
a7574d88 MB |
39 | |
40 | *-o*, *--office* _office_:: | |
62fde24f | 41 | Specify your office room number. |
a7574d88 MB |
42 | |
43 | *-p*, *--office-phone* _office-phone_:: | |
62fde24f | 44 | Specify your office phone number. |
a7574d88 MB |
45 | |
46 | *-h*, *--home-phone* _home-phone_:: | |
62fde24f | 47 | Specify your home phone number. |
a7574d88 | 48 | |
0222a2ca KZ |
49 | *-u*, *--help*:: |
50 | Display help text and exit. | |
51 | ||
52 | *-V*, *--version*:: | |
53 | Print version and exit. The short options *-V* have been used since version 2.39; old versions use | |
54 | deprecated *-v*. | |
55 | ||
2b2d3172 | 56 | include::man-common/help-version.adoc[] |
a7574d88 MB |
57 | |
58 | == CONFIG FILE ITEMS | |
59 | ||
60 | *chfn* reads the _/etc/login.defs_ configuration file (see *login.defs*(5)). Note that the configuration file could be distributed with another package (e.g., shadow-utils). The following configuration items are relevant for *chfn*: | |
61 | ||
62fde24f | 62 | *CHFN_RESTRICT* _string_:: |
a7574d88 | 63 | |
a7574d88 | 64 | Indicate which fields are changeable by *chfn*. |
62fde24f | 65 | + |
a7574d88 | 66 | The boolean setting *"yes"* means that only the Office, Office Phone and Home Phone fields are changeable, and boolean setting *"no"* means that also the Full Name is changeable. |
62fde24f | 67 | + |
a7574d88 | 68 | Another way to specify changeable fields is by abbreviations: f = Full Name, r = Office (room), w = Office (work) Phone, h = Home Phone. For example, *CHFN_RESTRICT "wh"* allows changing work and home phone numbers. |
62fde24f | 69 | + |
a7574d88 | 70 | If *CHFN_RESTRICT* is undefined, then all finger information is read-only. This is the default. |
a7574d88 MB |
71 | |
72 | == EXIT STATUS | |
73 | ||
74 | Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid. | |
75 | ||
76 | == AUTHORS | |
77 | ||
78 | mailto:svalente@mit.edu[Salvatore Valente] | |
79 | ||
80 | == SEE ALSO | |
81 | ||
82 | *chsh*(1), | |
83 | *finger*(1), | |
84 | *login.defs*(5), | |
85 | *passwd*(5) | |
86 | ||
625e9c61 | 87 | include::man-common/bugreports.adoc[] |
a7574d88 | 88 | |
625e9c61 | 89 | include::man-common/footer.adoc[] |
a7574d88 MB |
90 | |
91 | ifdef::translation[] | |
625e9c61 | 92 | include::man-common/translation.adoc[] |
a7574d88 | 93 | endif::[] |