Name:: bsProxy - BotSense IP Proxy Server.

Synopsis:: bsProxy [OPTIONS] bsProxy –version bsProxy –help

Description:

The BotSense Proxy Server bsProxy provides an IP interace to any proxied (pseudo) device. The bsProxy is multi-threaded by device to optimize client responsiveness. For each (pseudo) device, there must exist a dynamically linked library that bsProxy will load to service the device-specific request, plus a client side library or enabled application to initiate the request and receive the responses. The two ends typically, but are not required to, communicate through a set of RoadNarrows NetMsgs defined network messages.

The Message Exchange Patterns (MEP) supported by bsProxy are:

client request - server response
server output streaming (e.g. video).

Options:

Mandatory arguments to long options are also mandatory for short options.

Server

-i, --interface=[addr][:port]

Server passive socket interface. The server will listen on this interface to accept new incoming connection requests. This options can be specified multiple times to define multiple listen interfaces. For each interface instance > 1 specified, bsProxy will fork-exec a copy of itself, servicing that interface.
DEFAULT: :9195

-L, --libpath=dir

Add library directory path to search for dynamic linked library plugins. This option can be specified multiple times to to build a list of search paths.

Logging

-l level, --log=level

Set logging threshold level. All logging events with priority ≤ level will be logged. All others will be ignored. Error events are always logged. The level is one of:

'off' or 0	Disable all logging.
'error' or 1	Enable error logging.
'diag1' or 2	Enable diagnostics 1 logging.
'diag2' or 3	Enable diagnostics 2 logging.
'diag3' or 4	Enable diagnostics 3 logging. The libSkewlZone library logs at this level
'diag4' or 5	Enable diagnostics 4 logging.
'diag5' or 6	Enable diagnostics 5 logging.
>6	Enable user-defined logging.

DEFAULT: off

--logfile=file

Set log output file to file. Special file names are:

'stderr'	log to standard error.
'stdout'	log to standard output.

DEFAULT: stderr

Information

--help

Display command help and exit.

--version

Output version information and exit.

Examples:

# Example 1
# Start bsProxy in the foreground using defaults and listening to all enabled
# IP interfaces.
$
$  bsProxy --log=diag1
BSPROXY: Diag1: bsProxy.c[888] BotSense IP Proxy Server bsProxy_9195 started
BSPROXY: Diag1: bsProxy.c[504] bsProxy_9195: Listening on interface 9195
BSPROXY: Diag1: bsProxyThread.c[518] Service Thread "#SERVER" created.
$

# Example 2
# Start bsProxy in background listening on a specific interface, with a 
# list of user project library search directories, and with diagnostic
# logging streamed to the given file.
$
$  bsProxy --interface=192.168.1.32:49900 -L/workspace/bob/lib \
              -L/workspace/alice/lib --logfile=/workspace/log/log1.txt &
$