PWB1/usr/man/man1/flog.1

.tr ~
.tr $%
.if n .ds D " -- \"
.if t .ds D _
.tr @|
.if n .tr #-
.if t .tr #\-
.de SP
.if n .ul
[\fB#\\$1\fP\\c
.if n .ul 0
\\$2\\$3
..
.de B
.if n .ul
.ft B
\\$1\\c
.if n .ul 0
.ft P
\\$2
..
.de SF
.if n .ul
[\fB#\\$1\fP]
.if n .ul 0
..
.de DT
.hc ^
^\fB.\|.\|.\fP
.hc
..
.de AR
.s1
.lp +10 5
\fB#\\$1\\fP	\\$2 \\$3 \\$4 \\$5 \\$6 \\$7 \\$8 \\$9
..
.de FI
.s1
.lp +30 30
\\$1	\\$2
.i0
..
.ds F) \fB\s-2FILES\s+2\fP
.de I
.if n .ul
\fI\\$1\fP\c
.if \\n(.$-1 \^\c
.if n .ul 0
\\$2\\$3\\$4\\$5\\$6\\$7\\$8\\$9
..
.de FG
.s1
.lp +20 7
.if t \fB\\$1\fP\\$2\t\\$3
.if n \\$1_\\$2\t\\$3
..
.if n .ds )Q '
.if n .ds )G `
.if t .ds )Q \\(aa
.if t .ds )G \\(ga
.if t .ds )S \\|
.th FLOG I 4/1/77
.sh NAME
flog \- speed up a process
.sh SYNOPSIS
.na
.bd flog
.SP l n ]
.SP a m ]
.SF u
process-id
.DT
.ad
.sh DESCRIPTION
.I Flog
is used to stimulate an improvement in the performance of a process
that is already in execution.
.s1
The
.I process-id
is the process number of the process that is to be
disciplined.
.s1
The value
.I n
of the
.bd l
keyletter argument
is the
flagellation constant,
i.e., the number of
.I lashes
to be administered per minute.
If this argument is omitted, the default is 17,
which is the most random random number.
.s1
The value
.I m
of the
.bd a
keyletter argument is the number of times the
inducement to speed up is to be
.I "administered."
If this argument is omitted, the default is one,
which is based on the possibility that after
.I that
the process will rectify its behavior of its own volition.
.s1
The presence of the
.bd u
keyletter argument indicates that
.I flog
is to be
.I unmerciful
in its actions.
This nullifies the effects of the other keyletter arguments.
It is recommended that
this option be used only on extremely stubborn processes,
as its over-use may have detrimental effects.
.sh FILES
.I Flog
will read the file
.I /have/mercy
for any entry containing the process-id of the
process being speeded-up.
The file can contain whatever
supplications are deemed necessary, but, of course, these will
be totally ignored if the
.bd u
keyletter argument is supplied.
.sh "SEE ALSO"
On Improving Process Performance by the Administration of Corrective Stimulation,
.I CACM ,
vol. 4, 1657, pp. 356-654.
.sh DIAGNOSTICS
If a named process does not exist,
.I flog
replies ``flog you'' on the standard output.
If
.I flog
.it kill\^\c
(II)s
the process, which usually happens when the
.bd u
keyletter argument is supplied, it writes ``rip,'' followed by the
process-id of the deceased, on the standard output.
.sh BUGS
Spurious supplications for mercy by the process being
flogged sometimes wind up on the standard output, rather than in
.I "/shut/up."