Using ndsctlΒΆ
A nodogsplash install includes ndsctl, a separate application which provides some control over a running nodogsplash process by communicating with it over a unix socket. Some command line options:
To print to stdout some information about your nodogsplash process:
/usr/bin/ndsctl status
To print to stdout the list of clients in human readable format:
/usr/bin/ndsctl clients
To print to stdout the list of clients in json format:
/usr/bin/ndsctl json
To print to stdout the details of a particular client in json format (This is particularly useful if called from a FAS or Binauth script.):
/usr/bin/ndsctl json [mac|ip|token]
To block a MAC address, when the MAC mechanism is block:
/usr/bin/ndsctl block MAC
To unblock a MAC address, when the MAC mechanism is block:
/usr/bin/ndsctl unblock MAC
To allow a MAC address, when the MAC mechanism is allow:
/usr/bin/ndsctl allow MAC
To unallow a MAC address, when the MAC mechanism is allow:
/usr/bin/ndsctl unallow MAC
To deauthenticate a currently authenticated user given their IP or MAC address:
/usr/bin/ndsctl deauth IP|MAC
To set the verbosity of logged messages to n:
/usr/bin/ndsctl loglevel n
For more options, run ndsctl -h. (Note that if you want the effect of ndsctl commands to to persist across nodogsplash restarts, you have to edit the configuration file.)