net_test_com_server(1)

NAME

net_test_com_server - Server which can be used to start the RTPL net performance tests at the current host and report the results to the control script at the caller requested by the rem_net_test_com client

SYNOPSIS

net_test_com_server  [Option [...]]

DESCRIPTION

The script net_test_com_server can be used to start the net performance tests at the current host and report the results to the control script at the caller host. Socket connections to this script may be created by the accompanying rem_net_test_com(1) script which may be invoked, when configured during the package configuration, by the control script at the caller host. Therefore, they may function as an alternative for remote shell commands and daemons such as ssh(1) and sshd(8) or rsh(1) and rshd(8). This may be useful at hosts where access restrictions disallow the usage of a secure or remote shell. The script net_test_com_server may also be used at Windows hosts, where remote shell commands are not so general available.

To make the usage of this script such system independent as possible, no connection with the system user authorisation API will be made. Access restrictions can be based upon connecting hosts. In fact only access from the host running the control script is required. See also the sample configuration file addressed in the FILES section.

Please note that for security reasons the net_test_com_server script can only be used to start the start_netserver(1) and host_net_test(1) commands, residing in the same directory as the net_test_com_server script.

The related start_net_test_com_server(1) command can be used to check if this server runs and it will start the server when this is not the case. Therefore, it is required that the process ID of this server is written to file. See the -pid_file option. The start_net_test_com_server(1) command is intended for periodic checks if this server is stil running, for instance from a crontab(1) file.

OPTIONS

The following options may be specified:

{-help,-?}
Print a usage message and exit.

-debug
Print extra log debug information.

-config_file {ConfigFile,-}
Specify a configuration file to supply the program parameters. They may be given in the format:

Name = Value

where Name is one of the program options without leading -. The Value fields may be spread across multiple lines. No line escape character is used. Lines with spaces and comment text after and including # are ignored. When - is specified, Standard Input will be used. The following variables are substituted by:

$HOME        The home directory of the user.
$PROGRAM The base program name.

-log_file {LogFile,-}
Specify a log file. The same variables as in the -config_file option may be used. When no log file or - is specified, this server will run in the foreground.

-pid_file PIDFile
Specify a file to which the process ID of the daemon server (when used) will be written. The same variables as in the -config_file option may be used. Default no such file will be used.

-allow_host Host
Allow only connections from the specified host. This option may be multiple specified. Default connections from all hosts are allowed.

-port Port
Specify the port where this server listens. The default is: 37373.

FILES

RTPL_Root/lib/sample-net_test_com_server.conf
Sample configuration file. See the comment header in this file for more information. The directory RTPL_Root is the root directory of the installed RTPL package.

SEE ALSO

crontab(1), host_net_test(1), rem_net_test_com(1), rsh(1), rshd(8), ssh(1), sshd(8), start_net_test_com_server(1), start_netserver(1)