GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
SQTOP(1) FreeBSD General Commands Manual SQTOP(1)

sqtop
display active client connections for Squid

sqtop [options]

sqtop displays information about currently active client connections for a Squid proxy in a convenient way.

Without options, sqtop tries to connect to a Squid proxy listening at 127.0.0.1 using port 3128.

Display a brief help text.
host (-h host)
Squid proxy host. Defaults to 127.0.0.1.
port (-p port)
Squid proxy port. Defaults to 3128.
password (-P password)
Squid proxy cachemgr_passwd.
hostlist (-H hostlist)
Comma-separated list of client IP addresses (CIDR notation is supported) to query the Squid proxy for. Hostnames are silently ignored.
userlist (-u userlist)
Comma-separated list of Squid usernames to list active connections for.
(-b)
Display brief per-connection information, omits URLs.
(-d)
Display detailed information (size, username and average speed) for each URL in each connection.
(-f)
Display full details (size, username, average speed, delay pool and elapsed time) for each URL in each connection.
(-z)
Display zero values instead of silently omitting them.
Don't compact the display of multiple occurrences of the same URL in a single connection.
(-o)
Disable interactive mode, just print statistics once to stdout.
seconds (-r seconds)
Set the refresh-interval for interactive mode.
Don't do hostname lookups.
Don't strip domain part of hostname.

If built with support for ncurses(3), sqtop defaults to running in interactive mode, occupying the whole screen, unless the --once option was specified on the command line.

Information about the Squid server currently connected to, the version of sqtop used, as well as eventual error messages are shown at the top of the display.

The bottom of the display keeps various aggregates, including current and average speed, the total number of hosts connected and the total number of connections.

Any option given on the command line can be changed from within interactive mode by pressing the key corresponding to its respective short option character.

In addition to the options given on the command line, sqtop recognizes the following keys when in interactive mode:

Search for literal substrings in hosts, usernames or URLs. Regular expressions are not parsed, currently.
Stop refreshing.
Scroll display.
Toggle displayed level of detail for the currently selected entry.
Display the help screen, including current settings for options, where applicable.
Compact long urls to fit them on one line.
Toggle mode of display for speed detail between current and average, current only and average only.
Toggle connection sort order between size, current speed, average speed and max time.
Toggle hosts showing mode between host name only, host ip only, both ip and host name.
Quit sqtop

List all currently active connections in interacive mode from 192.168.2.0/24 and 172.18.118.10 to a Squid proxy running at mysquid.example.com, port 8080 using ZePasswd as cachemgr_passwd:
$ sqtop -h mysquid.example.com -port 8080 -p ZePasswd -H 192.168.2.0/24,172.18.118.10

The sqtop utility exits 0 on success, and >0 if an error occurs.

The Squid homepage at: http://www.squid-cache.org.

The sqtop homepage at: https://github.com/paleg/sqtop.

sqtop was written by Oleg Palij <o.palij@gmail.com>.

This man page was originally written by Marco Steinbach <coco@executive-computing.de>.

September 18, 2010

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.