# Earthworm Modules:
Stopmodule Overview

(last revised March 1, 2007)

The stopmodule command line utility requests that a Earthworm terminates the particular module associated with the PID (Process ID) you give stopmodule as a parameter. The module should stop itself if it's behaving properly.

The program attaches to earthworm's shared memory region(s) and sets the flag in the header to the given value (pid). This is intended to signal that processid to terminate gracefully.

Startstop will mark this module as "Stop" and statmgr should not restart it. (If startstop is quit, and restarted, and the module you stopped is still in the startstop*d, the stopped module from the previous WILL start up in the new session.)

Warning: On Solaris there's a shell command called "stop". If you accidentally type "stop <pid>" instead of "stopmodule <pid>", Solaris won't be able to stop or restart the module in question. The solution: in a unix command prompt, "kill <pid>", then "restart <pid>", then finally "stopmodule <newpid>"

Module Index | Stopmodule Commands