[ Main Table Of Contents | Table Of Contents | Keyword Index | Categories | Modules | Applications ]
NAME
processman - Tool for automating the period callback of commands
Table Of Contents
SYNOPSIS
package require Tcl 8.5 9
package require twapi 3.1
package require cron 1.1
package require processman ?0.8?
::processman::find_exe name
::processman::kill id
::processman::kill_all
::processman::killexe name
::processman::onexit id cmd
::processman::priority id level
::processman::process_list
::processman::process_list id
::processman::spawn id cmd args
DESCRIPTION
The processman package provides a Pure-tcl set of utilities to manage child processes in a platform-generic nature.
Commands
-
Locate an executable by the name of name in the system path. On windows, also add the .exe extention if not given.
-
Kill a child process id.
-
Kill all processes spawned by this program
-
Kill a process identified by the executable. On Unix, this triggers a killall. On windows, twapi::get_process_ids is used to map a name one or more IDs, which are then killed.
-
Arrange to execute the script cmd when this programe detects that process id as terminated.
::processman::priority id level
Mark process id with the priorty level. Valid levels: low, high, default.
On Unix, the process is tagged using the nice command.
On Windows, the process is modifed via the twapi::set_priority_class
-
Return a list of processes that have been triggered by this program, as well as a boolean flag to indicate if the process is still running.
-
Return true if process id is still running, false otherwise.
::processman::spawn id cmd args
Start a child process, identified by id. cmd is the name of the command to execute. args are arguments to pass to that command.
Bugs, Ideas, Feedback
If you find errors in this document or bugs or problems with the package it describes, or if you want to suggest improvements for the documentation or the package, please use the Tcllib Trackers and specify odie as the category.
When proposing code changes, please provide unified diffs, i.e the output of diff -u.
Note further that attachments are strongly preferred over inlined patches. Attachments can be made by going to the Edit form of the ticket immediately after its creation, and then using the left-most button in the secondary navigation bar.
KEYWORDS
CATEGORY
System
COPYRIGHT
Copyright © 2015 Sean Woods