Dumsockc stands for socket client for the dumsocks server. This GPL application will connect and send/receive data from/to any dumsocks server. The application also uses the socloc APIs to interface to the socloc server.
Dumsockc is a command line text application. All commands and all common socket codes for socket servers have been implemented by command keywords. The dumsocks server understands only a limited number of command codes. All command codes that the dumsocks server understands have been implemented in the dumsockc client.
Since dumsockc program uses the socloc APIs, you first must create the socloc startup file which should contain a list of suggested socloc servers. The list may be incomplete but at least one entry must describe an active socloc server. The socloc startup file must be located in the current directory when you execute the dumsockc program.
When dumsockc is executed, it will attempt to connect to a socloc server listed in the socloc startup file. The application will then attempt to find a running dumsocks server. Once a proper connection has been established to both servers, the current socloc config list will be obtained from the socloc server. This list will be used to replace the socloc config list loaded from the socloc startup file.
The dumsockc program can maintain two current connections at the same time. One connection is for the socloc server and the other is a connection to the dumsocks server. When commands are issued they could apply to the socloc server or the dumsocks server. Any dumsocks server you wish to communicate with must already be running and registered with the socloc server. The program works by presenting a status line and command prompt. The user then enters a command followed by enter or return. Here is the basic format of the status line:
dumsockc/dh[dp]
Where dh is the current dumsocks server host and dp is the TCP/IP port number. The details of the current socloc server are not part of the status line (although there are commands to obtain the current socloc server details).
Here is a list of all dumsockc commands:
The dumsockc application can be compiled on all stated platforms except DOS where there is no TCP IPC and Mac because I have got around to porting any of the socket code to MacOS. Under the Unix operating system, the dumsockc application can be compiled using the mkdumsockc script.
Here are all of the dumsockc commands in the order that they are presented in the source module :
Syntax : term passwd Used With : dumsocks server Parameters : Name : passwd Description: termination password
This command will attempt to send a termination request to the current dumsocks server. The passwd must exactly match the server termination password (including case). Upon success, this command will cause a socket server to terminate. In order for this command to function properly, the dumsocks server must be able to interpret the common socket code SOCKET_SEND_TERM.
Syntax : status Used With : dumsocks server
This command will send a status request to the current dumsocks server. In order for this command to function properly, the dumsocks server must be able to interpret the common socket code SOCKET_SEND_STATUS.
Syntax : client.log.on [lfname] Used With : dumsockc client Parameters : Name : lfname Description: client log file name
This command will turn dumsockc client logging on. The optional log file name (lfname) can be used to specify a file name. If lfname is not present, the default log file (DUM_LOG_FILE as defined in dumsockc.c) will be used. A check will be made to make sure that client logging is not already on. If client logging is on and you wish to change the log file, you must stop the log first by using the client.log.off command.
Syntax : client.log.off Used With : dumsockc client
This command will turn dumsockc client logging off. A check will be made to make sure that client logging is not already off.
Syntax : client.log.status Used With : dumsockc client
This command will obtain the current client log status (on or off).
Syntax : server.log.on [lfname] Used With : dumsocks server Parameters : Name : lfname Description: server log file name
This command will turn dumsocks server logging on. The optional log file name (lfname) can be used to specify a file name. Remember that the server log file is maintained by the dumsocks server and must be specified in accordance with the server platform. If lfname is not present, the default log file for that server will be used. A check will be made to make sure that server logging is not already on. If server logging is on and you wish to change the log file, you must stop the log first by using the server.log.off command.
Syntax : server.log.off Used With : dumsocks server
This command will turn logging off on the current dumsocks server. A check will be made to make sure that server logging is not already off. In order for this command to function properly, the dumsocks server must be able to interpret the common socket code SOCKET_SEND_LOG_OFF.
Syntax : server.log.status Used With : dumsocks server
This command will obtain the current dumsocks server log status (on or off).
Syntax : socloc.log.on [lfname] Used With : socloc server Parameters : Name : lfname Description: server log file name
This command will turn socloc server logging on. The optional log file name (lfname) can be used to specify a file name. Remember that the server log file is maintained by the socloc server and must be specified in accordance with the server platform. If lfname is not present, the default log file for that server will be used. A check will be made to make sure that server logging is not already on. If server logging is on and you wish to change the log file, you must stop the log first by using the socloc.log.off command. In order for this command to function properly, the socloc server must be able to interpret the common socket code SOCKET_SEND_LOG_ON.
Syntax : socloc.log.off Used With : socloc server
This command will turn logging off on the current socloc server. A check will be made to make sure that server logging is not already off. In order for this command to function properly, the socloc server must be able to interpret the common socket code SOCKET_SEND_LOG_OFF.
Syntax : socloc.log.status Used With : socloc server
This command will obtain the current socloc server log status (on or off). In order for this command to function properly, the socloc server must be able to interpret the common socket code SOCKET_SEND_LOG_STATUS.
Syntax : connect sconnect Used With : dumsocks server Parameters : Name : sconnect Description: connect string
This command will establish a connection to a dumsocks server overriding any current dumsocks server connection. Note that only a connection to a dumsocks server is allowed and therefore, the service parameter of the connect string is not allowed.
Syntax : socloc.get.list Used With : socloc server
This command will obtain the current socloc server socket server list. The list will be displayed on the dumsockc client screen.
Syntax : socloc.config.get.list Used With : socloc server
This command will obtain the current socloc server config list. The list will be displayed on the dumsockc client screen.
Syntax : socloc.get Used With : socloc server
This command will obtain the current socloc server details including the host name, TCP/IP port number and optionally the TCP/IP address. These details are obtained from the main socloc API module.
Syntax : socloc.version Used With : socloc server
This command will obtain the current socloc server version string. In order for this command to function properly, the socloc server must be able to interpret the common socket code SOCKET_SEND_VERSION.
Syntax : version Used With : dumsocks server
This command will obtain the current dumsocks server version string. In order for this command to function properly, the dumsocks server must be able to interpret the common socket code SOCKET_SEND_VERSION.