-
Notifications
You must be signed in to change notification settings - Fork 19
/
pmonitor.html
143 lines (104 loc) · 3.99 KB
/
pmonitor.html
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
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
<!-- Creator : groff version 1.22.2 -->
<!-- CreationDate: Thu Jul 9 16:41:43 2015 -->
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta name="generator" content="groff -Thtml, see www.gnu.org">
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<meta name="Content-Style" content="text/css">
<style type="text/css">
p { margin-top: 0; margin-bottom: 0; vertical-align: top }
pre { margin-top: 0; margin-bottom: 0; vertical-align: top }
table { margin-top: 0; margin-bottom: 0; vertical-align: top }
h1 { text-align: center }
</style>
<title>PMONITOR</title>
</head>
<body>
<h1 align="center">PMONITOR</h1>
<a href="#NAME">NAME</a><br>
<a href="#SYNOPSIS">SYNOPSIS</a><br>
<a href="#DESCRIPTION">DESCRIPTION</a><br>
<a href="#OPTIONS">OPTIONS</a><br>
<a href="#AUTHOR">AUTHOR</a><br>
<a href="#REPORTING BUGS">REPORTING BUGS</a><br>
<a href="#SEE ALSO">SEE ALSO</a><br>
<hr>
<h2>NAME
<a name="NAME"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">pmonitor
− monitor a job’s progress</p>
<h2>SYNOPSIS
<a name="SYNOPSIS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>pmonitor
−c</b> <i>command</i> | <b>−f</b> <i>file</i> |
<b>−p</b> <i>pid</i> [<b>-i</b> <i>interval</i>]</p>
<h2>DESCRIPTION
<a name="DESCRIPTION"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">The
<i>pmonitor</i> command will display the progress of a
process as a percentage. It does this by examining the
process’s open files, and calculating the ratio
between the position of the file’s seek pointer offset
and the file length. For processes that process files in a
sequential fashion, such as file compression and database
import, this ratio can be translated to the percentage of
the job that has been completed.</p>
<p style="margin-left:11%; margin-top: 1em">The command may
produce no output, if a process does not hold any open files
with a non-zero seek offset.</p>
<h2>OPTIONS
<a name="OPTIONS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><b>−c</b>,
<b>−−command</b>=<i>COMMAND</i></p>
<p style="margin-left:22%;">Monitor the progress through
the files opened by the specified running command. The
command can be specified through (part) of its name (e.g.
<i>gzip</i>), or through a regular expression if the
argument starts with a <tt>/</tt>. See the documentation of
the <i>lsof</i>(1) <b>−c</b> option regarding the
rules and flags associated with the use of regular
expressions.</p>
<p style="margin-left:11%;"><b>−f</b>,
<b>−−file</b>=<i>FILE</i></p>
<p style="margin-left:22%;">Monitor a process’s
progress through its processing of the specified file.</p>
<p style="margin-left:11%;"><b>−p</b>,
<b>−−pid</b>=<i>PID</i></p>
<p style="margin-left:22%;">Monitor the progress of the
process with the specified process id <i>PID</i>.</p>
<p style="margin-left:11%;"><b>−i</b>,
<b>−−interval</b>=<i>INTERVAL</i></p>
<p style="margin-left:22%;">Repeat the output every
<i>INTERVAL</i> seconds.</p>
<p style="margin-left:11%;"><b>−h</b>,
<b>−−help</b></p>
<p style="margin-left:22%;">Display the program’s
usage information and exit.</p>
<h2>AUTHOR
<a name="AUTHOR"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Diomidis
Spinellis — <http://www.spinellis.gr></p>
<h2>REPORTING BUGS
<a name="REPORTING BUGS"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em">Visit the
utility’s <i>GitHub</i> page at
<https://github.com/dspinellis/pmonitor>. Fixes and
improvements are accepted through pull requests.</p>
<h2>SEE ALSO
<a name="SEE ALSO"></a>
</h2>
<p style="margin-left:11%; margin-top: 1em"><i>lsof</i>(1),</p>
<p style="margin-left:11%; margin-top: 1em">The
<i>pmonitor</i> command is modelled after a similar facility
that was available on the Permin-Elmer/Concurrent OS32.</p>
<hr>
</body>
</html>