File: relay-ctrl-allow.8

package info (click to toggle)
relay-ctrl 2.5-1
  • links: PTS
  • area: contrib
  • in suites: woody
  • size: 104 kB
  • ctags: 52
  • sloc: ansic: 296; makefile: 83
file content (46 lines) | stat: -rw-r--r-- 1,158 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
.TH relay-ctrl-allow 8
.SH NAME
relay-ctrl-allow \- selectively enable smtp relaying
.SH SYNOPSIS
.B relay-ctrl-allow
.I command
[
.I arguments ...
]
.SH DESCRIPTION
.B relay-ctrl-allow
executes
.B relay-ctrl-age
in the background to add a record of the client's IP to the table used
by
.B tcpserver
to control relaying.
It then drops all setuid priviledges and executes the command named on
the command line.
.SH OPTIONS
.TP
.B command
This argument is executed after the IP address has been added to the
spool of addresses.
.SH "RETURN VALUES"
Returns 111 (temporary failure) if any operation fails; otherwise the
exit value is that of the executed program.
.SH ENVIRONMENT
.TP
.B TCPREMOTEIP
.B relay-ctrl-allow
expects that this environment variable is set to the numerical IP
address of the remote host.
.SH "SEE ALSO"
relay-ctrl-age(8),
qmail-pop3d(8),
qmail-popup(8),
tcpserver(1),
tcp-environ(5)
.SH WARNINGS
.B relay-ctrl-allow
will normally need to be installed setuid to whatever user owns the
SMTP rules CDB used by
.B tcpserver
and the relay client rules directory (frequently root), as it will be
executed without permissions to modify either.