Contents |
CoovaChilli - chilli_query(1)
NAME
chilli_query - Interface into the chilli server.
SYNOPSIS
chilli_query [ -s <unix-socket> ] list
chilli_query [ -s <unix-socket> ] authorize <parameters>
chilli_query [ -s <unix-socket> ] logout <client-mac-address>
DESCRIPTION
chilli_query is an interface into the running chilli server. It provides an administrator the ability to see who is logged in, to force a client to be logged out, or force a client to be authorized.
Commands:
- list
- To list all connected clients (subscribers) providing the MAC Address, IP Address, internal chilli state (dnat, pass, etc), the session id (used in Acct-Session-ID), authenticated status (1 authorized, 0 not), user-name used during login, duration / max duration, idle time / max idle time, and the original URL.
- authorize <parameters>
- To explicity authorize a client, or change the session parameters of an already authorized client, by setting a series of session parameters.
PARAMETERS
- ip <ip-address>
- Select the session to be authorized by the IP address using this option (may be used with the option below)
- sessionid <session-id>
- Select the session to be authorized by the Session-ID (may be used with the above option)
- username <username>
- Sets the username of the session.
- sessiontimeout <seconds>
- Sets the max session time of the session.
- maxoctets <number-of-bytes>
- Sets the max data limit of the session.
- maxbwup <bandwidth>
- Sets the max up bandwidth of the session.
- maxbwdown <bandwidth>
- Sets the max down bandwidth of the session.
- logout <client-mac-address>
- Logout and releases the DHCP lease of a client explicitly based on the MAC address (gotten from a list command).
EXAMPLES
# chilli_query list 00:0D:XX:XX:XX:XX 10.1.0.3 dnat 46c83f70000 0 - 0/0 0/0 http://url.com
# chilli_query authorize ip 10.1.0.3 sessiontimeout 60 username N
# chilli_query list 00:0D:XX:XX:XX:XX 10.1.0.3 pass 46c83f70000 1 N 2/60 2/0 http://url.com
# chilli_query logout 00:0D:XX:XX:XX:XX
FILES
/usr/local/var/run/chilli.sock
UNIX socket used to daemon communication.
SEE ALSO
NOTES
See http://coova.org/ for further documentation and community support. The original ChilliSpot project homepage is/was at www.chillispot.org.
AUTHORS
David Bird. CoovaChilli and ChilliSpot are licensed under the Gnu Public License.
![[Main Page]](/wiki/skins/common/images/coova.gif)