Set a better default ciphers list if none was specified.
[pound.git] / poundctl.8
1 .TH POUNDCTL "8" "Jan 2010" "poundctl" "System Manager's Manual"
2 .SH NAME
3 poundctl \- control the pound(8) daemon
4 .SH SYNOPSIS
5 .TP
6 .B poundctl \fI-c /path/to/socket\fR [\fI-L/-l\fR] [\fI-S/-s\fR] [\fI-B/-b\fR] [\fI-N/-n\fR] [\fI-H\fR] [\fI-X\fR]
7 .SH DESCRIPTION
8 .PP
9 .B Poundctl
10 controls various aspects of the operation of the
11 .I pound(8)
12 program.
13 .SH OPTIONS
14 Options available:
15 .TP
16 \fB\-c /path/to/socket\fR
17 The path to the (Unix-domain) socket
18 .B Pound
19 was configured to listen on for control. Your
20 .B Pound
21 configuration file must contain the directive
22 .I Control "/path/to/socket"
23 for
24 .B poundctl
25 to work.
26 .TP
27 \fB\-L/-l n\fR
28 Enable/disable a listener. A disabled listener will stop accepting connection
29 requests.
30 .TP
31 \fB\-S/-s n m\fR
32 Enable/disable a service. A disabled service will not be used by
33 .B Pound
34 to answer requests.
35 .TP
36 \fB\-B/-b n m r\fR
37 Enable/disable a back-end. A disabled back-end will not be passed requests to
38 answer. Note however that existing sessions may still cause requests to be
39 sent their way.
40 .TP
41 \fB\-N n m k r\fR
42 Add a session to service m in listener n. The session key is k and it points to
43 back-end r.
44 .TP
45 \fB\-n n m k\fR
46 Remove a session from service m in listener n. The session key is k.
47 .PP
48 The parameters n, m and r refer to the number assigned to a particular listener,
49 service and back-end in the listings. A listener number of -1 refers by convention
50 to the global context.
51 .TP
52 \fB\-H\fR
53 Try to resolve the addresses to symbolic names. Depending on your configuration,
54 this may require an active DNS.
55 .TP
56 \fB\-X\fR
57 Show the results in XML format.
58 .PP
59 When called without flags
60 .B poundctl
61 will print out a listing of the
62 .B Pound
63 internal state.
64 .SH AUTHOR
65 Written by Robert Segall, Apsis GmbH.
66 .SH "REPORTING BUGS"
67 Report bugs to <roseg@apsis.ch>.
68 .SH COPYRIGHT
69 Copyright \(co 2002-2010 Apsis GmbH.
70 .br
71 This is free software; see the source for copying conditions.  There is NO
72 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.