1processman(n)                     processman                     processman(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       processman - Tool for automating the period callback of commands
9

SYNOPSIS

11       package require Tcl  8.5
12
13       package require twapi  3.1
14
15       package require cron  1.1
16
17       package require processman  ?0.6?
18
19       ::processman::find_exe name
20
21       ::processman::kill id
22
23       ::processman::kill_all
24
25       ::processman::killexe name
26
27       ::processman::onexit id cmd
28
29       ::processman::priority id level
30
31       ::processman::process_list
32
33       ::processman::process_list id
34
35       ::processman::spawn id cmd args
36
37______________________________________________________________________________
38

DESCRIPTION

40       The  processman  package provides a Pure-tcl set of utilities to manage
41       child processes in a platform-generic nature.
42

COMMANDS

44       ::processman::find_exe name
45              Locate an executable by the name of name in the system path.  On
46              windows, also add the .exe extention if not given.
47
48       ::processman::kill id
49              Kill a child process id.
50
51       ::processman::kill_all
52              Kill all processes spawned by this program
53
54       ::processman::killexe name
55              Kill a process identified by the executable. On Unix, this trig‐
56              gers a killall.  On windows, twapi::get_process_ids is  used  to
57              map a name one or more IDs, which are then killed.
58
59       ::processman::onexit id cmd
60              Arrange  to  execute  the  script cmd when this programe detects
61              that process id as terminated.
62
63       ::processman::priority id level
64              Mark process id with the priorty level. Valid levels: low, high,
65              default.
66
67              On Unix, the process is tagged using the nice command.
68
69              On  Windows,  the  process  is modifed via the twapi::set_prior‐
70              ity_class
71
72       ::processman::process_list
73              Return a list of processes that have been triggered by this pro‐
74              gram,  as  well  as a boolean flag to indicate if the process is
75              still running.
76
77       ::processman::process_list id
78              Return true if process id is still running, false otherwise.
79
80       ::processman::spawn id cmd args
81              Start a child process, identified by id. cmd is the name of  the
82              command to execute. args are arguments to pass to that command.
83

BUGS, IDEAS, FEEDBACK

85       This  document,  and the package it describes, will undoubtedly contain
86       bugs and other problems.  Please report such in the  category  odie  of
87       the  Tcllib  Trackers  [http://core.tcl.tk/tcllib/reportlist].   Please
88       also report any ideas for enhancements you may have for either  package
89       and/or documentation.
90
91       When proposing code changes, please provide unified diffs, i.e the out‐
92       put of diff -u.
93
94       Note further that  attachments  are  strongly  preferred  over  inlined
95       patches.  Attachments  can  be  made  by  going to the Edit form of the
96       ticket immediately after its creation, and  then  using  the  left-most
97       button in the secondary navigation bar.
98

KEYWORDS

100       odie, processman
101

CATEGORY

103       System
104
106       Copyright (c) 2015 Sean Woods <yoda@etoyoc.com>
107
108
109
110
111tcllib                                0.6                        processman(n)
Impressum