1par(1)                      General Commands Manual                     par(1)
2
3
4

NAME

6       par - parallel command processing
7

SYNOPSIS

9       par [-dfiqx] [-c  command] [-l  logfile] [-n #] file [file...]
10

DESCRIPTION

12       par  takes a list of files to run a command on.  The first line of each
13       file begins with a colon (:) or a pound-sign  (#).   If  a  colon,  the
14       remainder  of  the  line is a command to run for each of the subsequent
15       lines.  If  a  pound-sign,  then  each  subsequent  line  is  a  (self-
16       contained)  command,  unless the -c option was specified, in which case
17       it operates as if the argument to -c had followed a colon on the  first
18       line.
19
20       In  each  of  the cases where the lines of the file following the first
21       are not commands (i.e.: colon or -c), instances  of  open-close  braces
22       ({}) in the command will be replaced by these values.
23
24       For example, a inputfile whose contents is:
25
26            : echo {}
27            a
28            b
29            c
30
31       run with par like so:
32
33            %par -q inputfile
34
35       will produce the following output (order will vary):
36
37            b
38            a
39            c
40
41       The command-line options are as follows:
42
43       -c     Command  to  be  run  on  each  of  the  arguments following the
44              command-line options, where the first line of the input  file(s)
45              begins with a pound-sign (#).
46
47       -d     Print debugging information on standard error (stderr).
48
49       -f     No  file  or STDIN, just run a quantity of the command specified
50              with -c.
51
52       -i     Run   commands   interactively   through   (multiple)   xterm(1)
53              processes.
54
55       -l     Prefix  of  logfile  name,  as  in  prefix.N  where N is the par
56              process number ([0..]).
57
58              Default: par.log.<time>.[0..]
59
60       -n     Number of simultaneous processes.
61
62              Default: 3
63
64       -q     Quiet mode.  Do not log anything.  -q is mutually exclusive with
65              the  -x  and  -l options and the option appearing last will take
66              precedence.
67
68       -x     View par logs in real-time via an xterm(1).
69

FILES

71       par.log.T.N Log file; where T is the current time in seconds since the
72       epoch and N is the par process number ([0..]).
73
74
75
76                               18 December 2007                         par(1)
Impressum