rancid_par(1) General Commands Manual rancid_par(1)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..]).
18 December 2007 rancid_par(1)
Check Out this Related Man Page
fsx(8) System Manager's Manual fsx(8)NAME
fsx - file system exerciser
SYNOPSIS
/usr/field/fsx [-h] [-ofile] [-tn] [-fpath] [-pm]
OPTIONS
The fsx options are: Prints the help messages for the fsx command. Saves the output diagnostics in file. Run time in minutes (n). The
default is to run until the process receives a Ctrl/C or a kill -15 pid command. Number (m) of fsx processes to spawn. The maximum is 250;
the default is 20. Path name of directory on file system you wish to test. For example, /mnt or /usr. The default is /usr/field.
DESCRIPTION
The fsx exerciser spawns the background process fsxr, and these two processes exercise a file system by creating, opening, writing, open-
ing, reading, validating, closing, and unlinking a test file. These test files are created in the /usr/field directory (the default)
unless the -fpath option is used.
You can spawn up to 250 (default is 20) fsx processes (fsxr1, fsxr2, ... fsxrn where n is the number of processes spawned). The exerciser
will run until a Ctrl/C or kill -15 pid command is sent to the process.
A logfile for you to examine and then remove is created in the current working directory. If there are errors in the logfile, make sure you
check the syslog file where the driver and kernel error messages are saved.
RESTRICTIONS
If you must run a system exerciser over an NFS link or on a diskless system, there are some restrictions. For exercisers such as fsx(8),
which must write into a file system, the target file system must be writable by root. Also, the directory in which any of the exercisers
are executed must be writable by root because temporary files are written into the current directory. These latter restrictions are some-
times difficult to overcome because often NFS file systems are mounted in a way that prevents root from writing into them. Some of the
restrictions may be overcome by copying fsx and fsxr to another directory and then executing it. Avoid using the fsx exerciser over an NFS
or diskless file system.
Each time you run fsx, it creates a log file. The exerciser allows you to accumulate up to 9 log files. If you run fsx to create a tenth
log file, it exits and displays the following error messages:
fsx: Remove old log files fsx: Can not start report generator, test aborted
When this situation occurs, remove at least one log file and run fsx again.
EXAMPLES
The following example runs 10 fsx processes on /mnt until the process receives a Ctrl/C or kill -15 pid command: % /usr/field/fsx -p10
-f/mnt The following example runs 20 fsx processes on /usr/field for 120 minutes in the background: % /usr/field/fsx -t120 &
SEE ALSO
Commands: cmx(8), diskx(8), memx(8), shmx(8), tapex(8)fsx(8)