Version 2 (modified by et, 7 years ago) (diff)


Earthworm StartstopPipeConsole

(last revised 28 October 2014)

Note: To add StartstopPipeConsole functionality to Earthworm v7.7 and earlier use the patch file The patch zip-file may be unpacked on top of an existing Earthworm installation.

Readme for StartstopPipeConsole

Functionality implemented by: Eric Thomas, ISTI

The StartstopPipeConsole tool provides a way to interact with the 'startstop' process using a console window. This is useful on Windows installations with 'startstop' service installed, where the service is otherwise difficult to access. In the "startstop_nt.d" configuration file used by the 'startstop' service, the 'PipeName' entry should set to "EarthwormStartstopPipe" (or a 'PipeName' entry should not be specified). For more information on the 'startstop' service see the "Earthworm Windows Startstop Service" documentation.

To run the StartstopPipeConsole program, open a Command Prompt and enter StartstopPipeConsole. The program sends a message to the 'startstop' service requesting that a pipe-console be started. For the message to get through (via an operating-system pipe), administrator-level user access is required. The StartstopPipeConsole program will request this access when it is run. If the pipe-console startup is successful, the StartstopPipeConsole program window may then be used to interact with the 'startstop' service. Only one instance of a StartstopPipeConsole may be active at a time (any previous instance will be terminated). Earthworm programs (such as "status", "pau", "sniffring", etc) may be run in the StartstopPipeConsole.

To stop a StartstopPipeConsole, enter the command "exit". If a program is actively generating output (i.e., "sniffring"), it may be terminated by hitting Ctrl-C.