scriptreplay: cleanup usage()

[thirdparty/util-linux.git] / login-utils / chfn.1

diff --git a/login-utils/chfn.1 b/login-utils/chfn.1
index bd93449ea1d7f998a44665b2f9f7a62764bb3a1a..c7130c47e084ba5f068ede106736ef3b116eb2e9 100644 (file)
--- a/login-utils/chfn.1
+++ b/login-utils/chfn.1
@@ -6,7 +6,7 @@
 .\"  modify it under the terms of the GNU General Public License.
 .\"  There is no warranty.
 .\"
-.TH CHFN 1 "July 2014" "util-linux" "User Commands"
+.TH CHFN 1 "November 2015" "util-linux" "User Commands"
 .SH NAME
 chfn \- change your finger information
 .SH SYNOPSIS
@@ -69,13 +69,40 @@ Display help text and exit.
 .TP
 .BR \-v , " \-\-version"
 Display version information and exit.
+.SH CONFIG FILE ITEMS
+.B chfn
+reads the
+.IR /etc\:/login.defs (5)
+configuration file.  Note that the configuration file could be
+distributed with another package (e.g. shadow-utils).  The following
+configuration items are relevant for
+.BR chfn (1):
+.PP
+.BI CHFN_RESTRICT " string"
+.RS 4
+Indicate which fields are changeable by \fBchfn\fR.
+
+The boolean setting \fB"yes"\fR means that only the Office, Office Phone and
+Home Phone fields are changeable, and boolean setting \fB"no"\fR means that
+also the Full Name is changeable.
+
+Another way to specify changeable fields is by abbreviations: f = Full Name,
+r = Office (room), w = Office (work) Phone, h = Home Phone.  For example,
+\fBCHFN_RESTRICT "wh"\fR allows changing work and home phone numbers.
+
+If CHFN_RESTRICT is undefined, then all finger information is read-only.
+This is the default.
+.RE
+.PP
 .SH "EXIT STATUS"
 Returns 0 if operation was successful, 1 if operation failed or command syntax was not valid.
 .SH "SEE ALSO"
+.BR chsh (1),
 .BR finger (1),
+.BR login.defs (5),
 .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/.
+https://www.kernel.org/pub/linux/utils/util-linux/.