PEXEC(1) User Commands PEXEC(1)
NAME
pexec - executing commands in parallel
SYNOPSIS
pexec [options] [-c|-m] [--] command [arguments] | 'compound command'
DESCRIPTION
Execute commands or shell scripts in parallel on a single host or on remote hosts using a remote shell.
OPTIONS
General options:
-h, --help
Gives general summary about the command line options.
--long-help
Gives a detailed list of command line options.
--version
Gives some version information about the program.
-s, --shell <shell>
Full path (e.g. /bin/sh) of the shell or interpreter to be used for script execution.
-c, --shell-command
Use the specified shell to interpret the command(s) instead of direct execution.
-m, --multiple-command
Allow multiple individual shell command scripts to be executed in parallel with the variation of the parameters.
-e, --environment <variable>
Name of an environmental variable which is set to the respective parameter before each execution.
-n, --number <number>
The maximal number of processes running simultaneously. The <number> itself can even be a complex specification of remote hosts (see
documentation for more details).
-C, --control <port>
The control port of a hypervisor daemon (full path of a UNIX socket or an INET host specification).
-p, --list <list>
The single-argument form of main parameter list.
-r, --parameters <list>
The multiple-argument form of the main parameter list.
-f, --listfile <file>
The main parameter list file.
-w, --column <index>
The column index from where the parameters should be taken if they are read from a parameter file.
-t, --complete
Threat the whole line as a single parameter if the parameters are read from a file.
-z, --nice
Sets the scheduling priority of pexec and all children (executed processes) to the priority defined by this nice value.
-- A marker after which the command to execute begins.
Redirecting standard input, output and error:
-i, --input <input>
The (optionally formatted) name of the input file which is used for redirecting the standard input.
-o, --output <output>
The (optionally formatted) name of the output file which is used for redirecting the standard output.
-u, --error <output>
The (optionally formatted) name of the output error file, which is used for redirecting the standard error.
-R, --normal-redirection
Equivalent to specifying --output -, --error - and --input /dev/null.
-a, --output-format <format>
The format of the final standard output redirection if the output of all of the processes are gathered into the same file.
-b, --error-format <format>
The same final redirection format for the standard error.
-x, --omit-newlines
Disable automatic newlines after the output and error formats.
Execution using remote hosts:
-g, --remote-shell <remote_shell>
The name or full path of the remote shell to be used for building the tunnel between the local and the peer host(s). Default:
``/usr/bin/ssh''.
-P, --pexec <pexec>
The full path of the pexec program on the remote hosts. If this option is omitted, pexec tries to figure out from the invoking syn-
tax and/or the current path.
-T, --tunnel
Internal use only (pexec will start in tunnel daemon mode).
Remote control, mutual exclusions and atomic command execution:
-y, --bind <port>
This option lets pexec to be remote controlled via INET or UNIX domain sockets.
-E, --pexec-connection-variable <env>
This option overrides the default environment name PEXEC_REMOTE_PORT to the specified value, which is used by the ``-p|--connect
auto'' combination to determine the control socket with which the running pexec instance can be controlled.
-j, --remote
Used to remote control and/or poll the status of other running instances of pexec.
-p, --connect <port>
Remote control port to connect to.
-t, --status
Prints the actual status of the running jobs in a human-readable form.
-l, --lock <mutex>
Locks the specified mutex (if the mutex is not locked by someone else, otherwise it will block until the mutex is released).
-u, --unlock <mutex>
Unlocks the specified mutex.
-m, --mutex <mutex>
Name of the mutex.
-d, --dump <filename>
Dump the content of the given file to standard output, if ``-m|--mutex'' is given, this will be atomic.
-s, --save <filename>
Save the content of standard input to the given file, if ``-m|--mutex'' is given, this will be atomic.
-a, --atomic <command>
Execute the given command. If ``-m|--mutex'' is given, the exectution is going to be atomic with respect to that mutex.
Hypervisor mode:
-H, --hypervisor
Starts pexec in hypervisor mode.
-C, --control <port>
The control port used by the hypervisor.
-l, --load <window>
Use load also to limit the number of simultaneous processes with the specified load average interval (0, 1 or 2, or 1min, 5min or
15min, respectively).
-f, --fifo
First in first out queue processing.
-s, --lifo
Last in first out (stack) queue processing (default).
Logging:
-L, --log <file>
The name of the log file.
-W, --log-level <level>
The logging level.
-V, --verbose
Increase the log level by one.
REPORTING BUGS
Report bugs to <apal@szofi.elte.hu>
COPYRIGHT
Copyright (C) 2007, 2008-2009; Pal, Andras <apal@szofi.elte.hu>
This is free software. You may redistribute copies of it under the terms of the GNU General Public License
<http://www.gnu.org/licenses/gpl.html>. There is NO WARRANTY, to the extent permitted by law.
This software was written by Andras Pal. The core part was written while working for the Hungarian-made Automated Telescope (HAT) project
to make the data processing more easier and therefore find many-many extrasolar planets. See more information about this project:
http://hatnet.hu. Another internal libraries (e.g. numhash.[ch]) were primarily written for other projects.
SEE ALSO
The full documentation for pexec is maintained as a Texinfo manual. If the info and pexec programs are properly installed at your site,
the command
info pexec
should give you access to the complete manual.
pexec 1.0rc8 (2009.07.02) June 2012 PEXEC(1)