diff options
author | Tar Committer <tar@ocjtech.us> | 2002-01-04 21:31:49 +0000 |
---|---|---|
committer | Tar Committer <tar@ocjtech.us> | 2002-01-04 21:31:49 +0000 |
commit | 9f2402b0d86333f5f7e9d50437036cd3124bde47 (patch) | |
tree | 163861dc0a0052447f838d3674a35870a80026f5 /man/par.1 | |
parent | b0d71377c1854271b4511488422427f73d9473d1 (diff) | |
download | rancid-9f2402b0d86333f5f7e9d50437036cd3124bde47.tar.gz rancid-9f2402b0d86333f5f7e9d50437036cd3124bde47.tar.xz rancid-9f2402b0d86333f5f7e9d50437036cd3124bde47.zip |
Imported from rancid-2.2.tar.gz.rancid-2.2
Diffstat (limited to 'man/par.1')
-rw-r--r-- | man/par.1 | 109 |
1 files changed, 109 insertions, 0 deletions
diff --git a/man/par.1 b/man/par.1 new file mode 100644 index 0000000..b0f0cee --- /dev/null +++ b/man/par.1 @@ -0,0 +1,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) |