← Back to branch summary

~ubuntu-branches/ubuntu/vivid/postfix/vivid-proposed

« back to all changes in this revision

Viewing changes to man/man8/proxymap.8

Tags: upstream-2.2.6
Import upstream version 2.2.6

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/man8/proxymap.8
12
12
.SH DESCRIPTION
13
13
.ad
14
14
.fi
15
 
The \fBproxymap\fR server provides read-only table
 
15
The \fBproxymap\fR(8) server provides read-only table
16
16
lookup service to Postfix processes. The purpose
17
17
of the service is:
18
18
.IP \(bu
38
38
The total number of connections is limited by the number of
39
39
proxymap server processes.
40
40
.PP
41
 
The proxymap server implements the following requests:
 
41
The \fBproxymap\fR(8) server implements the following requests:
42
42
.IP "\fBopen\fR \fImaptype:mapname flags\fR"
43
43
Open the table with type \fImaptype\fR and name \fImapname\fR,
44
44
as controlled by \fIflags\fR. The reply includes the \fImaptype\fR
59
59
.nf
60
60
.ad
61
61
.fi
62
 
\fBproxymap\fR servers run under control by the Postfix \fBmaster\fR
 
62
\fBproxymap\fR(8) servers run under control by the Postfix
 
63
\fBmaster\fR(8)
63
64
server.  Each server can handle multiple simultaneous connections.
64
 
When all servers are busy while a client connects, the \fBmaster\fR
65
 
creates a new \fBproxymap\fR server process, provided that the
 
65
When all servers are busy while a client connects, the \fBmaster\fR(8)
 
66
creates a new \fBproxymap\fR(8) server process, provided that the
66
67
process limit is not exceeded.
67
68
Each server terminates after serving at least \fB$max_use\fR clients
68
69
or after \fB$max_idle\fR seconds of idle time.
71
72
.nf
72
73
.ad
73
74
.fi
74
 
The proxymap server opens only tables that are approved via the
 
75
The \fBproxymap\fR(8) server opens only tables that are approved via the
75
76
\fBproxy_read_maps\fR configuration parameter, does not talk to
76
77
users, and can run at fixed low privilege, chrooted or not.
77
78
However, running the proxymap server chrooted severely limits
78
79
usability, because it can open only chrooted tables.
79
80
 
80
 
The proxymap server is not a trusted daemon process, and must
 
81
The \fBproxymap\fR(8) server is not a trusted daemon process, and must
81
82
not be used to look up sensitive information such as user or
82
83
group IDs, mailbox file/directory names or external commands.
 
84
 
 
85
In Postfix version 2.2 and later, the proxymap client recognizes
 
86
requests to access a table for security-sensitive purposes,
 
87
and opens the table directly. This allows the same main.cf
 
88
setting to be used by sensitive and non-sensitive processes.
83
89
.SH DIAGNOSTICS
84
90
.ad
85
91
.fi
87
93
.SH BUGS
88
94
.ad
89
95
.fi
90
 
The proxymap server provides service to multiple clients,
 
96
The \fBproxymap\fR(8) server provides service to multiple clients,
91
97
and must therefore not be used for tables that have high-latency
92
98
lookups.
93
99
.SH "CONFIGURATION PARAMETERS"
95
101
.nf
96
102
.ad
97
103
.fi
98
 
On busy mail systems a long time may pass before proxymap(8) relevant
 
104
On busy mail systems a long time may pass before
 
105
\fBproxymap\fR(8) relevant
99
106
changes to \fBmain.cf\fR are picked up. Use the command
100
107
"\fBpostfix reload\fR" to speed up a change.
101
108
 
102
109
The text below provides only a parameter summary. See
103
 
postconf(5) for more details including examples.
 
110
\fBpostconf\fR(5) for more details including examples.
104
111
.IP "\fBconfig_directory (see 'postconf -d' output)\fR"
105
112
The default location of the Postfix main.cf and master.cf
106
113
configuration files.
121
128
.IP "\fBprocess_name (read-only)\fR"
122
129
The process name of a Postfix command or daemon process.
123
130
.IP "\fBproxy_read_maps (see 'postconf -d' output)\fR"
124
 
The lookup tables that the proxymap(8) server is allowed to access.
 
131
The lookup tables that the \fBproxymap\fR(8) server is allowed to access.
 
132
.SH "SEE ALSO"
 
133
.na
 
134
.nf
 
135
postconf(5), configuration parameters
 
136
master(5), generic daemon options
 
137
.SH "README FILES"
 
138
.na
 
139
.nf
 
140
.ad
 
141
.fi
 
142
Use "\fBpostconf readme_directory\fR" or
 
143
"\fBpostconf html_directory\fR" to locate this information.
 
144
.na
 
145
.nf
 
146
DATABASE_README, Postfix lookup table overview
125
147
.SH "LICENSE"
126
148
.na
127
149
.nf