par(1)par(1)NAME
par - parallel command processing
SYNOPSIS
par [-defiqx] [-c command] [-l logfile] [-n #] [-p #] [file
[file...]]
DESCRIPTION
par takes a list of files to run a command on. The first line of each
file begins with a colon (:) or a pound-sign (#). If a colon, the
remainder of the line is a command to run for each of the subsequent
lines. If a pound-sign, then each subsequent line is a (self-
contained) command, unless the -c option was specified, in which case
it operates as if the argument to -c had followed a colon on the first
line.
In each of the cases where the lines of the file following the first
are not commands (ie: colon or -c), instances of open-close braces ({})
in the command will be replaced by these values.
For example, an inputfile whose contents is:
: echo {}
a
b
c
run with par like so:
%par -q inputfile
will produce the following output (order will vary):
b
a
c
The command-line options are as follows:
-c Command to be run on each of the arguments following the
command-line options, where the first line of the input file(s)
begins with a pound-sign (#).
-d Print debugging information on standard error (stderr). Repeat
the option up to three times for more verbosity.
-e Split args by spaces, rather than using sh -c. Note: -e is
incompatible with the -i option.
-f No input file or STDIN, just run a quantity of the command
specified with -c.
-i Run commands interactively through (multiple) xterm(1)
processes.
-l Prefix of logfile name, as in prefix.N where N is the par
process number ([0..]).
Default: par.log.<time>.[0..]
-n Number of simultaneous processes.
Default: 3
-p N Pause N seconds between running commands.
-q Quiet mode. Omit the typical processing logs and do not create
the log files from -l, instead the children inherit stdout and
stderr from par. -q is mutually exclusive with the -x and -l
options and the option appearing last will take precedence.
-x View par logs in real-time via an xterm(1).
FILES
par.log.T.N Log file; where T is the current time in seconds since the
epoch and N is the par process number ([0..]).
HISTORY
par was ported from the perl version.
15 January 2014 par(1)
