12.7 radctl

Radctl is a control interface to the radiusd daemon. It allows the user running it to query radiusd about various aspects of its work and to issue administrative commands to it. The syntax is

radctl command [args]

where command is a command telling radctl which actions to take, and args are optional arguments to the command. Only one command can be specified per invocation.

The valid commands are as follows:

start [args]

If radiusd is not running already, it is started. When present, args are passed as the command line to the server.

stop

Stops running radiusd.

restart [args]

Stops the server and then starts it again. When present, args are passed as the command line to the server.

reload

Causes the running radiusd server to reread its configuration files.

dumpdb

Tells radiusd to dump its user hash table into the file `radlog/radius.parse'. This can be used for debugging configuration files.

which

Reports the running version of radiusd. This command shows the line of ps(1) describing the running copy of radiusd program. The exact look depends on the version of operating system you are running. Please refer to "man ps" for more detail on ps output.

Here is an example of what radctl which prints on GNU/Linux:

19692 ? 01:53:11 radiusd

Here, first field is the PID of the process, second field (`?') indicates that the running program has detached from the controlling terminal, the third field gives total amount of CPU time used by the program, and, finally, the last field shows the full name under which the command was invoked.