1par(1) General Commands Manual par(1)
2
3
4
6 par - parallel command processing
7
9 par [-dfiqx] [-c command] [-l logfile] [-n #] file [file...]
10
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
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)