[moira.git] / man / chpobox.1

.TH CHPOBOX 1 "5 Feb 1988" "Project Athena"
\" RCSID: $Header$
.SH NAME
chpobox \- change address at which user receives mail
.SH SYNOPSIS
.B chpobox 
[
.B username
]

or

.B chpobox
[ \-s 
.B address
] [ \-p ] [ -u 
.B username 
]

.SH DESCRIPTION
Your post office box is what determines where you will receive
mail.  It can be of two types: 
.I POP,
which is what you have by default, or 
.I SMTP
which allows you to specify an alternate address for your mail.

In the first use of this command, the post office box of the
user whose name corresponds to the single argument
.I username
(or your own name if 
.I username
is not specified) is displayed.

In the second use, this command sets the 
actual address that will receive mail sent to 
.I username@ATHENA.MIT.EDU
(where 
.I username
is your own name if you have not specified it on the command line).
It should be if you want to change where you will 
receive mail.  

The 
.I chpobox 
command is used instead of the file
.I .forward,
which would be used with standard UNIX mail. 

In order to change the address that receives mail sent to 
.I username@ATHENA.MIT.EDU,
use the 
.B -s
option.  Specifically, to reroute your mail to
the address 
.I name@host,
you would issue the command

.nf
.nj
chpobox -s name@host.
.fi

To restore your post office box to its original Athena default,
use the 
.B -p
flag.  This will set your mailbox to the last post office server
it was using.
.PP

Only one of 
.B -p
or
.B -s
may be used at a time.

Note that the actual change will not take place on the mail hub
for several hours.  

Regular users may change and retrieve information about only
their own post office boxes.  Moira database administrators can
change or retrieve information about any user's post office box,
specifying the user with the
.B -u
option.

.SH NOTE

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
moira(1),

Moira 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
8f474dac	4	chpobox \- change address at which user receives mail
76ca8a03	5	.SH SYNOPSIS
8f474dac	6	.B chpobox
	7	[
	8	.B username
	9	]
	10
	11	or
	12
76ca8a03	13	.B chpobox
8f474dac	14	[ \-s
	15	.B address
	16	] [ \-p ] [ -u
	17	.B username
	18	]
	19
76ca8a03	20	.SH DESCRIPTION
8f474dac	21	Your post office box is what determines where you will receive
	22	mail. It can be of two types:
	23	.I POP,
	24	which is what you have by default, or
	25	.I SMTP
	26	which allows you to specify an alternate address for your mail.
	27
	28	In the first use of this command, the post office box of the
	29	user whose name corresponds to the single argument
	30	.I username
	31	(or your own name if
	32	.I username
	33	is not specified) is displayed.
	34
	35	In the second use, this command sets the
	36	actual address that will receive mail sent to
	37	.I username@ATHENA.MIT.EDU
	38	(where
	39	.I username
	40	is your own name if you have not specified it on the command line).
	41	It should be if you want to change where you will
	42	receive mail.
	43
227344f4	44	The
8f474dac	45	.I chpobox
	46	command is used instead of the file
	47	.I .forward,
	48	which would be used with standard UNIX mail.
	49
	50	In order to change the address that receives mail sent to
	51	.I username@ATHENA.MIT.EDU,
	52	use the
	53	.B -s
	54	option. Specifically, to reroute your mail to
	55	the address
	56	.I name@host,
	57	you would issue the command
	58
	59	.nf
	60	.nj
	61	chpobox -s name@host.
	62	.fi
	63
	64	To restore your post office box to its original Athena default,
	65	use the
227344f4	66	.B -p
8f474dac	67	flag. This will set your mailbox to the last post office server
8f474dac	68	it was using.
227344f4	69	.PP
b45bc46f	70
8f474dac	71	Only one of
	72	.B -p
	73	or
	74	.B -s
	75	may be used at a time.
	76
	77	Note that the actual change will not take place on the mail hub
	78	for several hours.
	79
	80	Regular users may change and retrieve information about only
	81	their own post office boxes. Moira database administrators can
	82	change or retrieve information about any user's post office box,
	83	specifying the user with the
	84	.B -u
	85	option.
	86
	87	.SH NOTE
b45bc46f	88
	89	When a mailbox is stored in the central database, any host mentioned
	90	will have it's name canonicalized to a standard form. If for some
	91	reason you don't want to have the hostname canonicalized, put
	92	.B just the hostname
	93	in double-quotes. For example, the command
	94	.nf
	95	.nj
	96	chpobox -s jrhacker@\\"lcs.mit.edu\\"
	97	.fi
	98	will not be canonicalized to jrhacker@ptt.lcs.mit.edu, as it would
	99	otherwise. Also note that the double-quotes were preceded by
	100	backslashes to get them past the shell.
8f474dac	101
	102	.SH SEE ALSO
	103	moira(1),
	104
	105	Moira Section of the Project Athena Technical Plan.