[fastforward] / fastforward.1

.TH fastforward 1
.SH NAME
fastforward \- forward mail according to a cdb database
.SH SYNOPSIS
in
.BR .qmail-default :
.B | fastforward
[
.B \-nNpPdD
]
.I cdb
.SH DESCRIPTION
.B fastforward
forwards each incoming message
according to instructions in
.I cdb
created by
.BR setforward .

If there is no forwarding instruction in
.I cdb
for the incoming recipient address,
.B fastforward
will bounce the message.

You can override
.B .qmail-default
with a specific
.BR .qmail-\fIrecipient ;
see
.BR dot-qmail (5).

Warning to system administrators:
Messages do not reach
.B ~alias/.qmail-default
unless they are controlled by the
.B alias
user.
See
.BR qmail-getpw (8).

.B SECURITY WARNING:
If
.I cdb
includes instructions pointing to a mailing list owned by another user,
that user gains some amount of control over
.BR fastforward 's
behavior.
In particular, he can force
.B fastforward
to open any file that you can access,
and to read any world-readable file that you own,
even if the file is in a world-inaccessible directory.
.SH "OPTIONS"
.TP 5
.B \-n
No delivery.
.B fastforward
will print a description of its actions,
but will not actually read or forward a message.
.TP
.B \-N
(Default.)
Forward a message as usual.
.TP
.B \-p
Pass through.
If
.B fastforward
does not find the recipient in
.IR cdb ,
it exits 0,
giving the message to further commands in
.BR .qmail-default .
If
.B fastforward
finds the recipient,
it forwards the message and exits 99,
so that further commands are skipped.
.TP
.B \-P
(Default.)
Do not pass through.
If
.B fastforward
finds the recipient,
it forwards the message and exits 0.
Otherwise it bounces the message.
.TP
.B \-d
Use
.B $DEFAULT@$HOST
as the recipient address, or
.B $EXT@$HOST
if
.B $DEFAULT
is not set.
.TP
.B \-D
(Default.)
Use
.B $RECIPIENT
as the recipient address.
.SH VERSION
This is
.B fastforward
0.51.
The
.B fastforward
home page is
.BR http://pobox.com/~djb/fastforward.html .
.SH "SEE ALSO"
newaliases(1),
printforward(1),
setforward(1),
dot-qmail(5),
qmail-command(8),
qmail-local(8),
qmail-getpw(8)
Commit	Line	Data
8d5530c4 MW	1	.TH fastforward 1
	2	.SH NAME
	3	fastforward \- forward mail according to a cdb database
	4	.SH SYNOPSIS
	5	in
	6	.BR .qmail-default :
	7	.B \| fastforward
	8	[
	9	.B \-nNpPdD
	10	]
	11	.I cdb
	12	.SH DESCRIPTION
	13	.B fastforward
	14	forwards each incoming message
	15	according to instructions in
	16	.I cdb
	17	created by
	18	.BR setforward .
	19
	20	If there is no forwarding instruction in
	21	.I cdb
	22	for the incoming recipient address,
	23	.B fastforward
	24	will bounce the message.
	25
	26	You can override
	27	.B .qmail-default
	28	with a specific
	29	.BR .qmail-\fIrecipient ;
	30	see
	31	.BR dot-qmail (5).
	32
	33	Warning to system administrators:
	34	Messages do not reach
	35	.B ~alias/.qmail-default
	36	unless they are controlled by the
	37	.B alias
	38	user.
	39	See
	40	.BR qmail-getpw (8).
	41
	42	.B SECURITY WARNING:
	43	If
	44	.I cdb
	45	includes instructions pointing to a mailing list owned by another user,
	46	that user gains some amount of control over
	47	.BR fastforward 's
	48	behavior.
	49	In particular, he can force
	50	.B fastforward
	51	to open any file that you can access,
	52	and to read any world-readable file that you own,
	53	even if the file is in a world-inaccessible directory.
	54	.SH "OPTIONS"
	55	.TP 5
	56	.B \-n
	57	No delivery.
	58	.B fastforward
	59	will print a description of its actions,
	60	but will not actually read or forward a message.
	61	.TP
	62	.B \-N
	63	(Default.)
	64	Forward a message as usual.
65	.TP
66	.B \-p
67	Pass through.
68	If
69	.B fastforward
70	does not find the recipient in
71	.IR cdb ,
72	it exits 0,
73	giving the message to further commands in
74	.BR .qmail-default .
75	If
76	.B fastforward
77	finds the recipient,
78	it forwards the message and exits 99,
79	so that further commands are skipped.
80	.TP
81	.B \-P
82	(Default.)
83	Do not pass through.
84	If
85	.B fastforward
86	finds the recipient,
87	it forwards the message and exits 0.
88	Otherwise it bounces the message.
89	.TP
90	.B \-d
91	Use
92	.B $DEFAULT@$HOST
93	as the recipient address, or
94	.B $EXT@$HOST
95	if
96	.B $DEFAULT
97	is not set.
98	.TP
99	.B \-D
100	(Default.)
101	Use
102	.B $RECIPIENT
103	as the recipient address.
104	.SH VERSION
105	This is
106	.B fastforward
107	0.51.
108	The
109	.B fastforward
110	home page is
111	.BR http://pobox.com/~djb/fastforward.html .
112	.SH "SEE ALSO"
113	newaliases(1),
114	printforward(1),
115	setforward(1),
116	dot-qmail(5),
117	qmail-command(8),
118	qmail-local(8),
119	qmail-getpw(8)