[unix-history] / usr / man / man1 / chfn.1

.TH CHFN 1 "17 March 1982 deprecated"
.UC 4
.SH NAME
chfn \- change finger entry
.SH SYNOPSIS
.B chfn
[loginname]
.SH DESCRIPTION
.I Chfn
is used to change information about users.  This information is used
by the finger program, among others.
It consists of the user's
"real life" name, office room number, office phone number, and home
phone number.
.I Chfn
prompts the user for each field.
Included in the prompt is a default value,
which is enclosed between brackets.
The default value is accepted simply by typing <return>.
To enter a blank field,
type the word 'none'.
Below is a sample run:
.IP
.B "Name [Biff Studsworth II]:"
.br
.B "Room number (Exs: 597E or 197C) []:"
521E
.br
.B "Office Phone (Ex: 1632) []:"
1863
.br
.B "Home Phone (Ex: 987532) [5771546]:"
none
.sp
.PP
.I Chfn
allows phone numbers to be entered with or without hyphens.
Because 
.I finger
only knows about UCB extensions,
.I chfn
will insist upon a four digit number (after the hyphens are removed) 
for office phone numbers.
Also, room numbers must be in Evans or Cory;
again, this is because of 
.IR finger .
.PP
It is a good idea to run finger after running
.I chfn
to make sure everything is the way you want it.
.PP
The optional argument
.B loginname
is used to change another person's finger information.
This can only be done by the super-user.
.SH FILES
/etc/passwd, /etc/ptmp
.SH SEE\ ALSO
finger(1), passwd(5)
.SH BUGS
The encoding of the office and extension information is installation dependent.
.PP
For historical reasons, the user's name, etc are stored in the passwd file.
This is a bad place to store the information. 
Rumors are that a data base is being developed to store this information,
but don't hold your breath.
.PP
Because two users may try to write the passwd file at once, a synchronization
method was developed.
On rare occasions, a message that the password file
is "busy" will be printed.
In this case,
.I chfn
sleeps for a while and then tries to write to the passwd file again.
Commit	Line	Data
5d0d5e2f C	1	.TH CHFN 1 "17 March 1982 deprecated"
	2	.UC 4
	3	.SH NAME
	4	chfn \- change finger entry
	5	.SH SYNOPSIS
	6	.B chfn
	7	[loginname]
	8	.SH DESCRIPTION
	9	.I Chfn
	10	is used to change information about users. This information is used
	11	by the finger program, among others.
	12	It consists of the user's
	13	"real life" name, office room number, office phone number, and home
	14	phone number.
	15	.I Chfn
	16	prompts the user for each field.
	17	Included in the prompt is a default value,
	18	which is enclosed between brackets.
	19	The default value is accepted simply by typing <return>.
	20	To enter a blank field,
	21	type the word 'none'.
	22	Below is a sample run:
	23	.IP
	24	.B "Name [Biff Studsworth II]:"
	25	.br
	26	.B "Room number (Exs: 597E or 197C) []:"
	27	521E
	28	.br
	29	.B "Office Phone (Ex: 1632) []:"
	30	1863
	31	.br
	32	.B "Home Phone (Ex: 987532) [5771546]:"
	33	none
	34	.sp
	35	.PP
	36	.I Chfn
	37	allows phone numbers to be entered with or without hyphens.
	38	Because
	39	.I finger
	40	only knows about UCB extensions,
	41	.I chfn
	42	will insist upon a four digit number (after the hyphens are removed)
	43	for office phone numbers.
	44	Also, room numbers must be in Evans or Cory;
	45	again, this is because of
	46	.IR finger .
	47	.PP
	48	It is a good idea to run finger after running
	49	.I chfn
	50	to make sure everything is the way you want it.
	51	.PP
	52	The optional argument
	53	.B loginname
	54	is used to change another person's finger information.
	55	This can only be done by the super-user.
	56	.SH FILES
	57	/etc/passwd, /etc/ptmp
	58	.SH SEE\ ALSO
	59	finger(1), passwd(5)
	60	.SH BUGS
	61	The encoding of the office and extension information is installation dependent.
	62	.PP
	63	For historical reasons, the user's name, etc are stored in the passwd file.
	64	This is a bad place to store the information.
65	Rumors are that a data base is being developed to store this information,
66	but don't hold your breath.
67	.PP
68	Because two users may try to write the passwd file at once, a synchronization
69	method was developed.
70	On rare occasions, a message that the password file
71	is "busy" will be printed.
72	In this case,
73	.I chfn
74	sleeps for a while and then tries to write to the passwd file again.