Prev: Next: Up: poundctl commands[Contents][Index]


12.1.4 Using poundctl to Inspect and Change Log Levels

The poundctl log command is used to control log level (see Logging) of the running instance of pound or any of its listeners.

poundctl: log [/]
poundctl: log [/]L

Used without arguments (or with ‘/’ as an argument), this command displays global log level. Otherwise, it displays log level for listener L. Notice, that leading slash in the argument is optional.

If the default template is used, the command outputs symbolic name of the log level in use (see log level). In the second form, if the listener L has no specific log level configured (i.e. it uses the log level from the global settings), the name of the log level is followed by the word ‘global’ in parentheses.

poundctl: log / F
poundctl: log [/]L F

The first form sets global log level F. The second form, configures log level F for listener L.

In both forms, F must be a symbolic name of an existing format (either built-in or user-defined), as described in log level.

On success, the command outputs the name of the configured format (F).

poundctl: log -d [/]
poundctl: log -d [/]L

Deletes current log level setting.

In the first form, the global log level is set to ‘null’ (see null built-in format).

In the second form, it removes the log level setting for the listener L, resulting in global log level being used for it.

The output is as described above.


Prev: Next: Up: poundctl commands[Contents][Index]