.\"
.\" chfn.1 -- change your finger information
.\" (c) 1994 by salvatore valente <svalente@athena.mit.edu>
.\"
.\" This program is free software. You can redistribute it and
.\" modify it under the terms of the GNU General Public License.
.\" There is no warranty.
.\"
.TH CHFN 1 "July 2014" "util-linux" "User Commands"
.SH NAME
chfn \- change your finger information
.SH SYNOPSIS
.B chfn
.RB [ \-f
.IR full-name ]
.RB [ \-o
.IR office ]
.RB [ \-p
.IR office-phone ]
.RB [ \-h
.IR home-phone ]
.RB [ \-u ]
.RB [ \-v ]
.RI [ username ]
.SH DESCRIPTION
.B chfn
is used to change your finger information. This information is
stored in the
.I /etc/passwd
file, and is displayed by the
.B finger
program. The Linux
.B finger
command will display four pieces of information that can be changed by
.BR chfn :
your real name, your work room and phone, and your home phone.
.PP
Any of the four pieces of information can be specified on the command
line. If no information is given on the command line,
.B chfn
enters interactive mode.
.PP
In interactive mode,
.B 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.
.PP
.B chfn
supports non-local entries (kerberos, LDAP, etc.\&) if linked with libuser,
otherwise use \fBypchfn\fR, \fBlchfn\fR or any other implementation for
non-local entries.
.SH OPTIONS
.TP
.BR \-f , " \-\-full\-name " \fIfull-name
Specify your real name.
.TP
.BR \-o , " \-\-office " \fIoffice
Specify your office room number.
.TP
.BR \-p , " \-\-office\-phone " \fIoffice-phone
Specify your office phone number.
.TP
.BR \-h , " \-\-home\-phone " \fIhome-phone
Specify your home phone number.
.TP
.BR \-u , " \-\-help"
Display help text and exit.
.TP
.BR \-v , " \-\-version"
Display version information and exit.
.SH "EXIT STATUS"
Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
.SH "SEE ALSO"
.BR finger (1),
.BR passwd (5)
.SH AUTHOR
Salvatore Valente <svalente@mit.edu>
.SH AVAILABILITY
The chfn command is part of the util-linux package and is available from
ftp://ftp.kernel.org/pub/linux/utils/util-linux/.
