4BSD/usr/man/cat1/chfn.1

Compare this file to the similar file:
Show the results in this format:




CHFN(1)             UNIX Programmer's Manual              CHFN(1)



NAME
     chfn - change full name of user

SYNOPSIS
     chfn name string

DESCRIPTION
     _C_h_f_n is a command similar to _p_a_s_s_w_d(1) except that it is
     used to change the gcos field of the password file rather
     than the password entry.  Note that the string specified
     will replace the entire gecos field of the specified user.
     If (as on the UCB system) this field contains information in
     addition to the user's full name, this information must be
     included in string or it will be deleted.  Hence chfn can be
     used to fix phone numbers, offices, etc.

     An example use of this command would be

          chfn mark '& Horton,508E,7686,5240633'

     Note that the string must in general be quoted to shield
     blanks and special characters from the shell.  The field
     should consist of the users name, followed by their office
     number, followed by the last 4 digits of their office exten-
     sion and finally their home phone number.  Any of these can
     be omitted.  At UCB, offices can be given as ``508E'' for
     508 Evans, and ``187MC'' for 187M Cory.  There should be no
     spaces in the entry except for those in your name.

     It is a good idea to run _f_i_n_g_e_r(1) on the user before and
     after _c_h_f_n to make sure you have formatted the data
     correctly.

SEE ALSO
     finger(1), passwd(5), chsh(1), passwd(1)

AUTHOR
     Mark Horton

BUGS
     The encoding of the office and extension information is
     installation dependent.

     A new user-information data base is in the works which will
     supplant this program; _c_h_f_n'_s days are numbered.










Printed 11/10/80           deprecated                           1