NAME¶

rancid_par - parallel command processing

SYNOPSIS¶

rancid_par [ -dfiqx] [-c  command] [-l  logfile] [-n
#] file [file...]

DESCRIPTION¶

rancid_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 (i.e.: colon or -c), instances of open-close braces ({}) in the command will be replaced by these values. For example, a inputfile whose contents is: : echo {} a b c run with rancid_par like so: %rancid_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).

-f

No 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 rancid_par process number ([0..]).

 

Default: par.log.<time>.[0..]

-n

Number of simultaneous processes.

 

Default: 3

-q

Quiet mode. Do not log anything. -q is mutually exclusive with the -x and -l options and the option appearing last will take precedence.

-x

View rancid_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 rancid_par process number ([0..]).