1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
|
[comment {-*- tcl -*- doctools manpage}]
[vset PACKAGE_VERSION 0.8]
[manpage_begin processman n [vset PACKAGE_VERSION]]
[keywords {processman}]
[keywords {odie}]
[copyright {2015 Sean Woods <yoda@etoyoc.com>}]
[moddesc {processman}]
[titledesc {Tool for automating the period callback of commands}]
[category System]
[require Tcl "8.5 9"]
[require twapi 3.1]
[require cron 1.1]
[require processman [opt [vset PACKAGE_VERSION]]]
[description]
[para]
The [package processman] package provides a Pure-tcl set of utilities
to manage child processes in a platform-generic nature.
[section Commands]
[list_begin definitions]
[call [cmd ::processman::find_exe] [arg name]]
Locate an executable by the name of [arg name] in the system path. On windows,
also add the .exe extention if not given.
[call [cmd ::processman::kill] [arg id]]
Kill a child process [arg id].
[call [cmd ::processman::kill_all]]
Kill all processes spawned by this program
[call [cmd ::processman::killexe] [arg name]]
Kill a process identified by the executable. On Unix, this triggers a killall.
On windows, [cmd twapi::get_process_ids] is used to map a name one or more IDs,
which are then killed.
[call [cmd ::processman::onexit] [arg id] [arg cmd]]
Arrange to execute the script [arg cmd] when this programe detects that
process [arg id] as terminated.
[call [cmd ::processman::priority] [arg id] [arg level]]
Mark process [arg id] with the priorty [arg level]. Valid levels: low, high, default.
[para]
On Unix, the process is tagged using the [cmd nice] command.
[para]
On Windows, the process is modifed via the [cmd twapi::set_priority_class]
[call [cmd ::processman::process_list]]
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.
[call [cmd ::processman::process_list] [arg id]]
Return true if process [arg id] is still running, false otherwise.
[call [cmd ::processman::spawn] [arg id] [arg cmd] [arg args]]
Start a child process, identified by [arg id]. [arg cmd] is the name
of the command to execute. [arg args] are arguments to pass to that command.
[list_end]
[para]
[vset CATEGORY odie]
[include ../common-text/feedback.inc]
[manpage_end]
|
