]> git.ipfire.org Git - thirdparty/util-linux.git/blob - login-utils/chfn.1
Merge branch 'docs-dir' of https://github.com/kerolasa/lelux-utiliteetit
[thirdparty/util-linux.git] / login-utils / chfn.1
1 .\"
2 .\" chfn.1 -- change your finger information
3 .\" (c) 1994 by salvatore valente <svalente@athena.mit.edu>
4 .\"
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.
8 .\"
9 .\" $Author: faith $
10 .\" $Revision: 1.1 $
11 .\" $Date: 1995/03/12 01:29:16 $
12 .\"
13 .TH CHFN 1 "July 2009" "util-linux" "User Commands"
14 .SH NAME
15 chfn \- change your finger information
16 .SH SYNOPSIS
17 .B chfn
18 .RB [ \-f
19 .IR full-name ]
20 .RB [ \-o
21 .IR office ]
22 ,RB [ \-p
23 .IR office-phone ]
24 .RB [ \-h
25 .IR home-phone ]
26 .BR \-u ]
27 .RB [ \-v ]
28 .RI [ username ]
29 .SH DESCRIPTION
30 .B chfn
31 is used to change your finger information. This information is
32 stored in the
33 .I /etc/passwd
34 file, and is displayed by the
35 .B finger
36 program. The Linux
37 .B finger
38 command will display four pieces of information that can be changed by
39 .BR chfn :
40 your real name, your work room and phone, and your home phone.
41
42 .B chfn
43 is used to change local entries only. Use ypchfn, lchfn or any other
44 implementation for non-local entries.
45 .SS COMMAND LINE
46 Any of the four pieces of information can be specified on the command
47 line. If no information is given on the command line,
48 .B chfn
49 enters interactive mode.
50 .SS INTERACTIVE MODE
51 In interactive mode,
52 .B chfn
53 will prompt for each field. At a prompt, you can enter the new information,
54 or just press return to leave the field unchanged. Enter the keyword
55 "none" to make the field blank.
56 .SH OPTIONS
57 .TP
58 .BI "\-f, \-\-full-name " full-name
59 Specify your real name.
60 .TP
61 .BI "\-o, \-\-office " office
62 Specify your office room number.
63 .TP
64 .BI "\-p, \-\-office-phone " office-phone
65 Specify your office phone number.
66 .TP
67 .BI "\-h, \-\-home-phone " home-phone
68 Specify your home phone number.
69 .TP
70 .B "\-u, \-\-help"
71 Print a usage message and exit.
72 .TP
73 .B "-v, \-\-version"
74 Print version information and exit.
75 .SH "SEE ALSO"
76 .BR finger (1),
77 .BR passwd (5)
78 .SH AUTHOR
79 Salvatore Valente <svalente@mit.edu>
80 .SH AVAILABILITY
81 The chfn command is part of the util-linux package and is available from
82 ftp://ftp.kernel.org/pub/linux/utils/util-linux/.