<?xml version="1.0" encoding="UTF-8"?>
<!--
Copyright (c) 1990 - 1994, Julianne Frances Haugh
- Copyright (c) 2007 - 2008, Nicolas François
+ Copyright (c) 2007 - 2011, Nicolas François
All rights reserved.
Redistribution and use in source and binary forms, with or without
<!ENTITY LOGIN_STRING SYSTEM "login.defs.d/LOGIN_STRING.xml">
<!-- SHADOW-CONFIG-HERE -->
]>
-
<refentry id='chfn.1'>
<!-- $Id$ -->
<refmeta>
<refsynopsisdiv id='synopsis'>
<cmdsynopsis>
<command>chfn</command>
- <arg choice='opt'>-f <replaceable>full_name</replaceable></arg>
- <arg choice='opt'>-r <replaceable>room_no</replaceable></arg>
- <arg choice='opt'>-w <replaceable>work_ph</replaceable></arg>
- <arg choice='opt'>-h <replaceable>home_ph</replaceable></arg>
- <arg choice='opt'>-o <replaceable>other</replaceable></arg>
- <arg choice='opt'><replaceable>user</replaceable></arg>
+ <arg choice='opt'>
+ <replaceable>options</replaceable>
+ </arg>
+ <arg choice='opt'>
+ <replaceable>LOGIN</replaceable>
+ </arg>
</cmdsynopsis>
</refsynopsisdiv>
<title>DESCRIPTION</title>
<para>
The <command>chfn</command> command changes user fullname,
- office number, office extension, and home phone number information
+ office room number, office phone number, and home phone number information
for a user's account. This information is typically printed by
<citerefentry><refentrytitle>finger</refentrytitle><manvolnum>1</manvolnum>
</citerefentry> and similar programs. A normal user may only change
store accounting information used by other applications.
</para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <para>
+ The options which apply to the <command>chfn</command> command are:
+ </para>
+ <variablelist remap='IP'>
+ <varlistentry>
+ <term>
+ <option>-f</option>, <option>--full-name</option> <replaceable>FULL_NAME</replaceable>
+ </term>
+ <listitem>
+ <para>Change the user's full name.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-h</option>, <option>--home-phone</option> <replaceable>HOME_PHONE</replaceable>
+ </term>
+ <listitem>
+ <para>Change the user's home phone number.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-o</option>, <option>--other</option> <replaceable>OTHER</replaceable>
+ </term>
+ <listitem>
+ <para>
+ Change the user's other GECOS information. This field is used to
+ store accounting information used by other applications, and can
+ be changed only by a superuser.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-r</option>, <option>--room</option> <replaceable>ROOM_NUMBER</replaceable>
+ </term>
+ <listitem>
+ <para>Change the user's room number.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-u</option>, <option>--help</option>
+ </term>
+ <listitem>
+ <para>Display help message and exit.</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term>
+ <option>-w</option>, <option>--work-phone</option> <replaceable>WORK_PHONE</replaceable>
+ </term>
+ <listitem>
+ <para>Change the user's office phone number.</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
<para>
If none of the options are selected, <command>chfn</command>
operates in an interactive fashion, prompting the user with the
* Copyright (c) 1989 - 1994, Julianne Frances Haugh
* Copyright (c) 1996 - 2000, Marek Michałkiewicz
* Copyright (c) 2001 - 2006, Tomasz Kłoczko
- * Copyright (c) 2007 - 2008, Nicolas François
+ * Copyright (c) 2007 - 2011, Nicolas François
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
#include <signal.h>
#include <stdio.h>
#include <sys/types.h>
+#include <getopt.h>
#ifdef WITH_SELINUX
#include <selinux/selinux.h>
#include <selinux/av_permissions.h>
/* local function prototypes */
static void fail_exit (int code);
-static void usage (void);
+static /*@noreturn@*/void usage (int status);
static bool may_change_field (int);
static void new_fields (void);
static char *copy_field (char *, char *, char *);
/*
* usage - print command line syntax and exit
*/
-static void usage (void)
+static /*@noreturn@*/void usage (int status)
{
- if (amroot) {
- fprintf (stderr,
- _("Usage: %s [-f full_name] [-r room_no] "
- "[-w work_ph]\n"
- "\t[-h home_ph] [-o other] [user]\n"), Prog);
- } else {
- fprintf (stderr,
- _("Usage: %s [-f full_name] [-r room_no] "
- "[-w work_ph] [-h home_ph]\n"), Prog);
- }
- exit (E_USAGE);
+ FILE *usageout = (E_SUCCESS != status) ? stderr : stdout;
+ (void) fprintf (usageout,
+ _("Usage: %s [options] [LOGIN]\n"
+ "\n"
+ "Options:\n"),
+ Prog);
+ (void) fputs (_(" -f, --full-name FULL_NAME change user's full name\n"), usageout);
+ (void) fputs (_(" -h, --home-phone HOME_PHONE change user's home phone number\n"), usageout);
+ (void) fputs (_(" -o, --other OTHER_INFO change user's other GECOS information\n"), usageout);
+ (void) fputs (_(" -r, --room ROOM_NUMBER change user's room number\n"), usageout);
+ (void) fputs (_(" -u, --help display this help message and exit\n"), usageout);
+ (void) fputs (_(" -w, --work-phone WORK_PHONE change user's office phone number\n"), usageout);
+ (void) fputs ("\n", usageout);
+ exit (status);
}
/*
*/
static void process_flags (int argc, char **argv)
{
- int flag; /* flag currently being processed */
+ int c; /* flag currently being processed */
+ static struct option long_options[] = {
+ {"full-name", required_argument, NULL, 'f'},
+ {"home-phone", required_argument, NULL, 'h'},
+ {"other", required_argument, NULL, 'o'},
+ {"room", required_argument, NULL, 'r'},
+ {"help", no_argument, NULL, 'u'},
+ {"work-phone", required_argument, NULL, 'w'},
+ {NULL, 0, NULL, '\0'}
+ };
/*
* The remaining arguments will be processed one by one and executed
* environment and must agree with the real UID. Also, the UID will
* be checked for any commands which are restricted to root only.
*/
- while ((flag = getopt (argc, argv, "f:r:w:h:o:")) != EOF) {
- switch (flag) {
+ while ((c = getopt_long (argc, argv, "f:h:o:r:uw:",
+ long_options, NULL)) != -1) {
+ switch (c) {
case 'f':
if (!may_change_field ('f')) {
fprintf (stderr,
hflg = true;
STRFCPY (homeph, optarg);
break;
- case 'r':
- if (!may_change_field ('r')) {
+ case 'o':
+ if (!amroot) {
fprintf (stderr,
_("%s: Permission denied.\n"), Prog);
exit (E_NOPERM);
}
- rflg = true;
- STRFCPY (roomno, optarg);
+ oflg = true;
+ STRFCPY (slop, optarg);
break;
- case 'o':
- if (!amroot) {
+ case 'r':
+ if (!may_change_field ('r')) {
fprintf (stderr,
_("%s: Permission denied.\n"), Prog);
exit (E_NOPERM);
}
- oflg = true;
- STRFCPY (slop, optarg);
+ rflg = true;
+ STRFCPY (roomno, optarg);
break;
+ case 'u':
+ usage (E_SUCCESS);
+ /*@notreached@*/break;
case 'w':
if (!may_change_field ('w')) {
fprintf (stderr,
STRFCPY (workph, optarg);
break;
default:
- usage ();
+ usage (E_USAGE);
}
}
}
projects / thirdparty / shadow.git / commitdiff
