Scroll to navigation

POUNDCTL(8) System Manager's Manual POUNDCTL(8)

NAME

poundctl - control the pound(8) daemon

SYNOPSIS

DESCRIPTION

Poundctl controls various aspects of the operation of the pound(8) program.

OPTIONS

Options available:

The path to the (Unix-domain) socket Pound was configured to listen on for control. Your Pound configuration file must contain the directive Control /path/to/socket for poundctl to work.
Enable/disable a listener. A disabled listener will stop accepting connection requests.
Enable/disable a service. A disabled service will not be used by Pound to answer requests.
Enable/disable a back-end. A disabled back-end will not be passed requests to answer. Note however that existing sessions may still cause requests to be sent their way.
Add a session to service m in listener n. The session key is k and it points to back-end r.
Remove a session from service m in listener n. The session key is k.

The parameters n, m and r refer to the number assigned to a particular listener, service and back-end in the listings. A listener number of -1 refers by convention to the global context.

Try to resolve the addresses to symbolic names. Depending on your configuration, this may require an active DNS.
Show the results in XML format.

When called without flags poundctl will print out a listing of the Pound internal state.

AUTHOR

Written by Robert Segall, Apsis GmbH.

REPORTING BUGS

Report bugs to <roseg@apsis.ch>.

COPYRIGHT

Copyright © 2002-2010 Apsis GmbH.
This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Jan 2010 poundctl