s5watcher(1)

NAME

s5watcher - A GUI (Graphical User Interface) to monitor socks5 connections

SYNOPSIS
s5watcher

DESCRIPTION
SOCKS5Watcher presents a graphical view of SOCKS5Server connection data. SOCKS5Watcher includes menus, a toolbar, a table window, and a graph window. Using the menu or toolbar commands, users choose the SOCKS5Server for which they want to view connection activity and the activity to view.

SOCKS5WatchAG must be running on the host you monitor.

GETTING STARTED with SOCKS5Watcher
To start SOCKS5Watcher, at the command prompt, type:

    s5watcher

To add a SOCKS5Server to monitor:
    1. Choose the SOCKS5Server menu's Edit command.

    2. Enter the SOCKS5Server name in the Server Name field.

    3. Click Add. SOCKS5Watcher adds the server to the SOCKS5Server menu.

    4. Choose a SOCKS5Server to monitor on the SOCKS5Server menu. SOCKS5Watcher opens the table and graph windows.

To start and stop monitoring:
    To begin monitoring, click the Action menu's Start command or the Toolbar's Start button.

    To stop monitoring, click the Action menu's Stop command or the Toolbar's Stop button.

CUSTOMIZING SOCKS5Watcher
The Options menu commands customize how SOCKS5Watcher presents data in the Graph and Table windows. You can set each of these values for each server:
- the frequency at which SOCKS5Watcher updates graph data
- the number of failed connections for which SOCKS5Watcher
  maintains data
- the types of error messages to include
- the graph data color and style

General Settings
    SOCKS5Watcher filters all error messages, sets the maximum rejected proxies to 50, and sets the update interval to 60 seconds.

    To remove filtering for a type of error message, click the button next to the error type.

    SOCKS5Watcher maintains a list of failed connections. Maximum Rejected Proxies specifies the number of failed connections for which SOCKS5Watcher retains data. Use the View menu's Show Failed command to plot failed connection data.

    To change Maximum Rejected Proxies and the Update Interval, type new values in the fields. SOCKS5Watcher allows values in the range of 1 to 5,000 for Maximum Rejected Proxies, and time interval values in the range 1 - 99,999.

    Click OK to execute changes, Cancel to exit General Settings without changing values, Clear to return values to previous settings.

Table Settings
    SOCKS5Watcher displays all the connection data it records. To remove data from the table, click the button next to the data description.

    Click OK to execute changes, or Cancel to exit the Table Settings box without changing values.

Graph Setting
    The graph legend shows the line style and color for each application type. Use the Graph Settings box to add and remove applications for SOCKS5Watcher to plot, and modify the line style and color for the application data in the graph.

    To add an application, type the application name and port number in the Name and Port fields, and click Add. SOCKS5Watcher adds the application to the list. Click the box next to the application name to add it to the graph. SOCKS5Watcher plots activity for unchecked applications as Others.

    Some UNIX platforms display HTTP applications as Others, or as Web. This is platform-dependent.

    To plot HTTP applications separate from Others, specify HTTP as the application Name and 1080 as the Port. SOCKS5Watcher plots it in the graph.

    To change the line color or style, click the application in the list, and click the color or line style.

    To remove an application from the graph, click the application name in the list and click Delete. You cannot remove SOCKS5Watcher default applications. SOCKS5Watcher default applications and their port numbers include:
        Telnet 23
        Web 80
        FTP 21
        Finger 79
        FTP data 20
        Archie 1525
        Others

Sort By
    The Sort command arranges data in the Table window in the order you select. You can arrange data by Source, Destination, User, Service, Starting Time, or Total Traffic.

    Traffic Unit
        The Traffic Unit command changes the Y-axis on the graph between bytes, Kilobytes, and Megabytes.

    Host Naming
        The Host Naming command displays the SOCKS5Server as a Hostname or as the SOCKS5Server's IP Address.

    Saving Options
        SOCKS5Watcher saves your preferences in the file monitor.ini.

        To save the current settings and cause SOCKS5Watcher to use these settings when it starts during subsequent executions, click the Options menu's Save Option command.

    Other Customizations
        The View menu includes commands to customize the Graph and Table windows. The Table window can display connection information for Active connections or for Failed Connections.

        Click Show Active to display connection information for active SOCKS5Server connections.

        Click Show Failed to display connection information for unsuccessful attempts to connect to the SOCKS5Server you are monitoring.

        The Toolbar command toggles Toolbar display.

REFRESHING the GRAPH
Use the Action menu's Update Now command to refresh the Graph and Table windows with the most recent data.

Click the View menu's Clear Graph command to remove the current graph in the Graph window.

RUNNING THE PROGRAM
Before monitoring a SOCKS5Server, you must add the server using the SOCKS5Server menu's Edit command. After you add the server, choose the server on the SOCKS5Server menu, and click the Action menu's Start command or the Toolbar Start button.

Click the Action menu's Pause command or the Toolbar's Pause button to temporarily stop displaying SOCKS5Server connection data for the server.

Click the Action menu's Stop command or the Toolbar's Stop button to halt the display of SOCKS5Server connection data for the server.

The File menu's print command prints the connection data displayed on the screen to the printer.

Showing and Hiding Values
    Use the View and Options menus to control which values SOCKS5Watcher displays in the Graph and Table windows. See "CUSTOMIZING SOCKS5Watcher" for complete details.

QUITTING SOCKS5Watcher
Choose Exit to close the SOCKS5Watcher.

SEE ALSO
socks5(1), socks5watch(1)

LIMITATIONS
The labels for the Toolbar buttons may display as empty boxes when you use some AIX systems to view the SOCKS5Watcher.

AUTHOR
NWSL SOCKS5 Development Team
Send comments to socks5-comments@socks.nec.com