[moira.git] / man / chfn.1

.TH CHFN 1 "1 Feb 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
chfn \- change finger information
.SH SYNOPSIS
.B chfn
[ username ]
.SH DESCRIPTION
This command changes (or installs)
the GECOS information field
associated with
.IR username
(your own name by default).  It also asks for some information not in
the standard GECOS field, such as a nickname and home address.
The GECOS information is the information shown by
.I finger(1).
.PP
When invoked,
.B chfn
displays the current information as default values
while prompting for any changes.
The fields include a user's
``real life'' name, nickname, home address and phone number,
office address and phone number, department and year.
Included in each prompt is a default value,
which is enclosed between brackets.
The default value is accepted simply by typing a carriage
return.  To enter a blank field, the word ``none'' may
be typed.  Below is a sample run:
.IP
.B "Info last changed on 22-mar-1988 15:13:33 by user studley using chfn"
.br
.B "Name [Biff Studsworth II]:"
.br
.B "Nickname [Studley]:"
.br
.B "Home address (Ex: Bemis 304) [New House 4-601]:"
.br
.B "Home phone number (Ex: 4660000) [225-1234]:"
.br
.B "Office address (Exs: 597 Tech Square or 10-256) [E40-300M]:"
E40-358M
.br
.B "Office phone (Ex: 3-1300) []:"
1863
.br
.B "MIT department (Exs: EECS, Biology, Information Services) [VI-3]:"
none
.br
.B "MIT year (Exs: 1989, '91, Faculty, Grad) ['90]:"
'91
.sp
.PP
.I chfn
allows phone numbers to be entered with or without hyphens.
If only four digits are entered for a phone number, and MIT extension
is assumed.  If the Office address ends in "M", it will assume an MIT
room, if it ends in "T", it will assume Tech Square.
.PP
Note that the changes will not show up with
.I finger
until several hours after the database has been changed.
.PP
Users may only change their own information unless they are
SMS database administrators.
.SH AUTHOR
Emanuel 'Jay' Berkenbilt
.SH "SEE ALSO"
sms(1), finger(1)
Commit	Line	Data
76ca8a03	1	.TH CHFN 1 "1 Feb 1988" "Project Athena"
	2	\" RCSID: $Header$
	3	.SH NAME
	4	chfn \- change finger information
	5	.SH SYNOPSIS
	6	.B chfn
	7	[ username ]
	8	.SH DESCRIPTION
	9	This command changes (or installs)
227344f4	10	the GECOS information field
76ca8a03	11	associated with
76ca8a03	12	.IR username
05e591e3	13	(your own name by default). It also asks for some information not in
05e591e3	14	the standard GECOS field, such as a nickname and home address.
76ca8a03	15	The GECOS information is the information shown by
	16	.I finger(1).
	17	.PP
	18	When invoked,
	19	.B chfn
	20	displays the current information as default values
	21	while prompting for any changes.
	22	The fields include a user's
	23	``real life'' name, nickname, home address and phone number,
	24	office address and phone number, department and year.
	25	Included in each prompt is a default value,
	26	which is enclosed between brackets.
	27	The default value is accepted simply by typing a carriage
	28	return. To enter a blank field, the word ``none'' may
	29	be typed. Below is a sample run:
	30	.IP
227344f4	31	.B "Info last changed on 22-mar-1988 15:13:33 by user studley using chfn"
227344f4	32	.br
76ca8a03	33	.B "Name [Biff Studsworth II]:"
	34	.br
	35	.B "Nickname [Studley]:"
	36	.br
	37	.B "Home address (Ex: Bemis 304) [New House 4-601]:"
	38	.br
	39	.B "Home phone number (Ex: 4660000) [225-1234]:"
	40	.br
	41	.B "Office address (Exs: 597 Tech Square or 10-256) [E40-300M]:"
	42	E40-358M
	43	.br
	44	.B "Office phone (Ex: 3-1300) []:"
	45	1863
	46	.br
	47	.B "MIT department (Exs: EECS, Biology, Information Services) [VI-3]:"
	48	none
	49	.br
	50	.B "MIT year (Exs: 1989, '91, Faculty, Grad) ['90]:"
	51	'91
	52	.sp
	53	.PP
	54	.I chfn
	55	allows phone numbers to be entered with or without hyphens.
	56	If only four digits are entered for a phone number, and MIT extension
	57	is assumed. If the Office address ends in "M", it will assume an MIT
	58	room, if it ends in "T", it will assume Tech Square.
	59	.PP
	60	Note that the changes will not show up with
	61	.I finger
	62	until several hours after the database has been changed.
	63	.PP
	64	Users may only change their own information unless they are
	65	SMS database administrators.
30c7d28e	66	.SH AUTHOR
30c7d28e	67	Emanuel 'Jay' Berkenbilt
76ca8a03	68	.SH "SEE ALSO"
227344f4	69	sms(1), finger(1)