[moira.git] / man / chpobox.1

.TH CHPOBOX 1 "5 Feb 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
chpobox \- change where user receives mail
.SH SYNOPSIS
.B chpobox
[-s address][-p][-u username]
.SH DESCRIPTION
This command sets and displays the mailbox currently assigned to
.IR username
(your own name by default).
If neither the
.B -s
or the
.B -p
option is given, the current mailbox will be displayed.  
The
.B -s
option will attempt to set the user's mailbox to the specified address.
The 
.B -p
flag will set the user's mailbox to the last Post Office server it was
using if the mailbox is now a foreign address.
.PP
A mailbox address is of the form
.I string@hostname,
where the string is usually the username, and the hostname is the name
of the machine the user wishes to receive mail on.
.B chpobox
will determine if the mailbox is of type POP, LOCAL, or FOREIGN based
on information in the SMS database, and then make the appropriate
change in the SMS database.

It will not allow a user to have more than one mailbox of any type.
The actual change will not take place on the mail hub for several hours.
Users may only change their own information unless they are
SMS database administrators.

When a mailbox is stored in the central database, any host mentioned
will have it's name canonicalized to a standard form.  If for some
reason you don't want to have the hostname canonicalized, put
.B just the hostname
in double-quotes.  For example, the command
.nf
.nj
	chpobox -s jrhacker@\\"lcs.mit.edu\\"
.fi
will not be canonicalized to jrhacker@ptt.lcs.mit.edu, as it would
otherwise.  Also note that the double-quotes were preceded by
backslashes to get them past the shell.
.SH "SEE ALSO"
sms(1),
SMS Section of the Project Athena Technical Plan.
Commit	Line	Data
76ca8a03	1	.TH CHPOBOX 1 "5 Feb 1988" "Project Athena"
	2	\" RCSID: $Header$
	3	.SH NAME
	4	chpobox \- change where user receives mail
	5	.SH SYNOPSIS
	6	.B chpobox
227344f4	7	[-s address][-p][-u username]
76ca8a03	8	.SH DESCRIPTION
227344f4	9	This command sets and displays the mailbox currently assigned to
76ca8a03	10	.IR username
	11	(your own name by default).
	12	If neither the
227344f4	13	.B -s
76ca8a03	14	or the
227344f4	15	.B -p
	16	option is given, the current mailbox will be displayed.
	17	The
	18	.B -s
	19	option will attempt to set the user's mailbox to the specified address.
	20	The
	21	.B -p
	22	flag will set the user's mailbox to the last Post Office server it was
	23	using if the mailbox is now a foreign address.
	24	.PP
76ca8a03	25	A mailbox address is of the form
	26	.I string@hostname,
	27	where the string is usually the username, and the hostname is the name
	28	of the machine the user wishes to receive mail on.
76ca8a03	29	.B chpobox
	30	will determine if the mailbox is of type POP, LOCAL, or FOREIGN based
	31	on information in the SMS database, and then make the appropriate
	32	change in the SMS database.
b45bc46f	33
227344f4	34	It will not allow a user to have more than one mailbox of any type.
227344f4	35	The actual change will not take place on the mail hub for several hours.
76ca8a03	36	Users may only change their own information unless they are
76ca8a03	37	SMS database administrators.
b45bc46f	38
	39	When a mailbox is stored in the central database, any host mentioned
	40	will have it's name canonicalized to a standard form. If for some
	41	reason you don't want to have the hostname canonicalized, put
	42	.B just the hostname
	43	in double-quotes. For example, the command
	44	.nf
	45	.nj
	46	chpobox -s jrhacker@\\"lcs.mit.edu\\"
	47	.fi
	48	will not be canonicalized to jrhacker@ptt.lcs.mit.edu, as it would
	49	otherwise. Also note that the double-quotes were preceded by
	50	backslashes to get them past the shell.
76ca8a03	51	.SH "SEE ALSO"
227344f4	52	sms(1),
76ca8a03	53	SMS Section of the Project Athena Technical Plan.