[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
.TP 8
chpobox [ username ]
.TP 8
chpobox [ \-s address | \-S address | \-p ] [ \-u username ]
.SH DESCRIPTION
Your post office box is what determines where you will receive
mail.  It can be of several types: 
.I POP, IMAP, SMTP, SPLIT
or
.IR NONE .

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@MIT.EDU
(where 
.I username
is your own name if you have not specified it on the command line).
It should be used 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@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 split mail between your local post office box and a remote address,
use the
.B -S
option.

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

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

Note that the actual change may take up to a day to 
propogate to the mail hub.

.SH NOTE

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