chilli_query(1)

chilli_query(1) — your General Commands Manual era 💅✨

💖 NAME 💖

chilli_query — Interface into the chilli server 🫶

✨ SYNOPSIS ✨

chilli_query [ -s <unix-socket> ] <command> [<parameters>...]

🦋 DESCRIPTION 🦋

okay so chilli_query is your direct interface into the running chilli server 💅 It hands an administrator the power to see who’s logged in, force a client to be logged out, or force a client to be authorized — admin main character energy, fr fr 👑✨

🎀 Commands 🎀

• list — lists all connected clients (subscribers) and gives you 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, input octets / max input octets, output octets / max output octets, max total octets, status of option swapoctets, bandwidth limitation information, and the original URL. That’s a whole info dump and it ate 💅
• listip <ip-address> — Same as list but for one IP address.
• listmac <mac-address> — Same as list but for one MAC address.
• authorize <parameters> — To explicitly authorize a client, or change the session parameters of an already authorized client, by setting a series of session parameters. Glow-up unlocked 🫶
• listippool — Show the internal IP pool state.
• listgarden — Show the internal walled garden state.
• listradqueue — Show the internal RADIUS queue state.
• addgarden [ ip <ip> | mac <mac> ] data <uamallow-resource> — Add to the dynamic walled garden. When used without the ip or mac option, the entry applies to the global garden. Otherwise, it is session specific only if configured with --enable-sessgarden.
• remgarden [ ip <ip> | mac <mac> ] data <uamallow-resource> — Remove from the dynamic walled garden. When used without the ip or mac option, the entry applies to the global garden. Otherwise, it is session specific only if configured with --enable-sessgarden.
• logout <client-mac-address> — Logs out and releases the DHCP lease of a client explicitly based on the MAC address (gotten from a list command). Bye bestie, lease revoked 💀

🌸 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.
• idletimeout <seconds> — Sets the max idle time of the session.
• maxoctets <number-of-bytes> — Sets the max data (input + output) limit of the session.
• maxinputoctets <number-of-bytes> — Sets the max input data limit of the session.
• maxoutputoctets <number-of-bytes> — Sets the max output 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.

🌈 EXAMPLES 🌈

here’s the vibe in action, bestie:

# 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 me

# chilli_query list
00:0D:XX:XX:XX:XX 10.1.0.3 pass 46c83f70000 1 me 2/0 2/0 http://url.com

# chilli_query logout 00:0D:XX:XX:XX:XX

# chilli_query list | awk '{
    ($5 == 1) {
      print "User " i++
      print " MAC:                    " $1
      print " IP Address:             " $2
      print " Session ID:             " $4
      print " Username:               " $6
      print " Duration / Max:         " $7
      print " Idle / Max:             " $8
      print " Input Octets / Max:     " $9
      print " Output Octets / Max:    " $10
      print " Max Total Octets:       " $11
      print " Using swapoctets:       " $12
      print " % / Max Up Bandwidth:   " $13
      print " % / Max Down Bandwidth: " $14
      print " Original URL:           " $15
    }
  }'
User 1
 MAC:             00-11-XX-XX-XX-XX
 IP Address:      10.1.0.2
 Session ID:      46fd423c00000001
 User URL:        http://www.yahoo.com/
 Duration / Max:  219/0
 Idle / Max:      3/0

🍓 FILES 🍓

• /var/run/chilli/run/chilli.sock — UNIX socket used to daemon communication.

🧚 SEE ALSO 🧚

chilli(8) and chilli.conf(5) — yes, go read the friends too 💖

💜 NOTES 💜

See http://coova.github.io/ for further documentation and community support.

👑 AUTHORS 👑

• David Bird <david@coova.com>
• Copyright (C) 2006-2012 David Bird (Coova Technologies) All rights reserved.
• CoovaChilli is licensed under the GNU General Public License.

Signed with a kiss and a February 2012 timestamp by the chilli_query(1) girlies 💌