1POUNDCTL(8) System Manager's Manual POUNDCTL(8)
2
3
4
6 poundctl - control the pound(8) daemon
7
9 poundctl -c /path/to/socket [-L/-l] [-S/-s] [-B/-b] [-N/-n]
10
12 Poundctl controls various aspects of the operation of the pound(8) pro‐
13 gram.
14
16 Options available:
17
18 -c /path/to/socket
19 The path to the (Unix-domain) socket Pound was configured to
20 listen on for control. Your Pound configuration file must con‐
21 tain the directive Control /path/to/socket for poundctl to work.
22
23 -L/-l n
24 Enable/disable a listener. A disabled listener will stop accept‐
25 ing connection requests.
26
27 -S/-s n m
28 Enable/disable a service. A disabled service will not be used by
29 Pound to answer requests.
30
31 -B/-b n m r
32 Enable/disable a back-end. A disabled back-end will not be
33 passed requests to answer. Note however that existing sessions
34 may still cause requests to be sent their way.
35
36 -N n m k r
37 Add a session to service m in listener n. The session key is k
38 and it points to back-end r.
39
40 -n n m k
41 Remove a session from service m in listener n. The session key
42 is k.
43
44 The parameters n, m and r refer to the number assigned to a particular
45 listener, service and back-end in the listings. A listener number of -1
46 refers by convention to the global context.
47
48 When called without flags poundctl will print out a listing of the
49 Pound internal state.
50
52 Written by Robert Segall, Apsis GmbH.
53
55 Report bugs to <roseg@apsis.ch>.
56
58 Copyright © 2002-2006 Apsis GmbH.
59 This is free software; see the source for copying conditions. There is
60 NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
61 PURPOSE.
62
63
64
65poundctl October 2006 POUNDCTL(8)