summaryrefslogtreecommitdiffstats
path: root/man/par.1
blob: b0f0ceeb2123536a2c16a4b17700a97770ef5227 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
.\"
.hys 50
.TH "par" "1" "17 Nov 2001"
.SH NAME
par \- parallel command processing
.SH SYNOPSIS
.B par
[\fB\-diqx\fP]
[\c
.BI \-c\ 
command]
[\c
.BI \-l\ 
logfile]
[\c
.BI \-n\c
 #]
file
[file...]
.SH DESCRIPTION
.B 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 command, unless the 
.B \-c
option was specified, in which case it operates as if the argument to
.B \-c
had followed a colon on the first line.
.PP
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.
.PP
For example, a inputfile whose contents is:
.sp
	: echo {}
.br
	a
.br
	b
.br
	c
.sp
run with
.B par
like so:
.sp
	%par -q inputfile
.sp
will produce the following output (order will vary):
.sp
	b
.br
	a
.br
	c
.PP
The command-line options are as follows:
.PP
.TP
.B \-c
Command to be run on each each of the arguments following the command-line
options, when the first line of the input file(s) begin with a pound-sign
(#).
.\"
.TP
.B \-d
Print debugging information on standard error (stderr).
.\"
.TP
.B \-i
Run commands interactively though (multiple) 
.BR xterm (1)
processes.
.\"
.TP
.B \-l
Prefix of logfile name, as in prefix.N where N is the
.B par
process number ([0..]).
.sp
Default: par.log.<time>.[0..]
.\"
.TP
.B \-n
Number of simultaneous processes.
.sp
Default: 3
.\"
.TP
.B \-q
Quiet mode.  Do not log anything.
.\"
.TP
.B \-x
View par logs in real-time via an 
.BR xterm (1).
.El
.SH FILES
.br
.nf
.\" set tabstop to longest possible filename, plus a wee bit
.ta \w'par.log.1006028679.00  'u
\fIpar.log.T.N\fR Log file; where T is the current time in seconds since the
epoch and N is the par process number ([0..]).
.\"
.\" .SH "SEE ALSO"
.\" .BR expect (1)