1POUNDCTL(8)                 System Manager's Manual                POUNDCTL(8)
2
3
4

NAME

6       poundctl - control the pound(8) daemon
7

SYNOPSIS

9       poundctl -c /path/to/socket [-L/-l] [-S/-s] [-B/-b] [-N/-n] [-H] [-X]
10

DESCRIPTION

12       Poundctl controls various aspects of the operation of the pound(8) pro‐
13       gram.
14

OPTIONS

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       -H     Try to resolve the addresses to  symbolic  names.  Depending  on
49              your configuration, this may require an active DNS.
50
51       -X     Show the results in XML format.
52
53       When  called  without  flags  poundctl  will print out a listing of the
54       Pound internal state.
55

AUTHOR

57       Written by Robert Segall, Apsis GmbH.
58

REPORTING BUGS

60       Report bugs to <roseg@apsis.ch>.
61

63       Copyright © 2002-2010 Apsis GmbH.
64       This is free software; see the source for copying conditions.  There is
65       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
66       PURPOSE.
67
68
69
70poundctl                           Jan 2010                        POUNDCTL(8)
Impressum