.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.10. .TH PEXEC "1" "August 2019" "pexec 1.0rc8 (2009.07.02)" "User Commands" .SH NAME pexec \- executing commands in parallel .SH SYNOPSIS .B pexec [\fI\,options\/\fR] [\fI\,-c|-m\/\fR] [\fI\,--\/\fR] \fI\,command \/\fR[\fI\,arguments\/\fR] \fI\,| 'compound command'\/\fR .SH DESCRIPTION Execute commands or shell scripts in parallel on a single host or on remote hosts using a remote shell. .SH OPTIONS .SS "General options:" .TP \fB\-h\fR, \fB\-\-help\fR Gives general summary about the command line options. .TP \fB\-\-long\-help\fR Gives a detailed list of command line options. .TP \fB\-\-version\fR Gives some version information about the program. .TP \fB\-s\fR, \fB\-\-shell\fR Full path (e.g. \fI\,/bin/sh\/\fP) of the shell or interpreter to be used for script execution. .TP \fB\-c\fR, \fB\-\-shell\-command\fR Use the specified shell to interpret the command(s) instead of direct execution. .TP \fB\-m\fR, \fB\-\-multiple\-command\fR Allow multiple individual shell command scripts to be executed in parallel with the variation of the parameters. .TP \fB\-e\fR, \fB\-\-environment\fR Name of an environmental variable which is set to the respective parameter before each execution. .TP \fB\-n\fR, \fB\-\-number\fR The maximal number of processes running simultaneously. The itself can even be a complex specification of remote hosts (see documentation for more details). .TP \fB\-C\fR, \fB\-\-control\fR The control port of a hypervisor daemon (full path of a UNIX socket or an INET host specification). .TP \fB\-p\fR, \fB\-\-list\fR The single\-argument form of main parameter list. .TP \fB\-r\fR, \fB\-\-parameters\fR The multiple\-argument form of the main parameter list. .TP \fB\-f\fR, \fB\-\-listfile\fR The main parameter list file. .TP \fB\-w\fR, \fB\-\-column\fR The column index from where the parameters should be taken if they are read from a parameter file. .TP \fB\-t\fR, \fB\-\-complete\fR Threat the whole line as a single parameter if the parameters are read from a file. .TP \fB\-z\fR, \fB\-\-nice\fR Sets the scheduling priority of pexec and all children (executed processes) to the priority defined by this nice value. .TP \fB\-\-\fR A marker after which the command to execute begins. .SS "Redirecting standard input, output and error:" .TP \fB\-i\fR, \fB\-\-input\fR The (optionally formatted) name of the input file which is used for redirecting the standard input. .TP \fB\-o\fR, \fB\-\-output\fR The (optionally formatted) name of the output file which is used for redirecting the standard output. .TP \fB\-u\fR, \fB\-\-error\fR The (optionally formatted) name of the output error file, which is used for redirecting the standard error. .TP \fB\-R\fR, \fB\-\-normal\-redirection\fR Equivalent to specifying \fB\-\-output\fR \-, \fB\-\-error\fR \- and \fB\-\-input\fR \fI\,/dev/null\/\fP. .TP \fB\-a\fR, \fB\-\-output\-format\fR The format of the final standard output redirection if the output of all of the processes are gathered into the same file. .TP \fB\-b\fR, \fB\-\-error\-format\fR The same final redirection format for the standard error. .TP \fB\-x\fR, \fB\-\-omit\-newlines\fR Disable automatic newlines after the output and error formats. .SS "Execution using remote hosts:" .TP \fB\-g\fR, \fB\-\-remote\-shell\fR 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''. .TP \fB\-P\fR, \fB\-\-pexec\fR The full path of the pexec program on the remote hosts. If this option is omitted, pexec tries to figure out from the invoking syntax and/or the current path. .TP \fB\-T\fR, \fB\-\-tunnel\fR Internal use only (pexec will start in tunnel daemon mode). .SS "Remote control, mutual exclusions and atomic command execution:" .TP \fB\-y\fR, \fB\-\-bind\fR This option lets pexec to be remote controlled via INET or UNIX domain sockets. .TP \fB\-E\fR, \fB\-\-pexec\-connection\-variable\fR 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. .TP \fB\-j\fR, \fB\-\-remote\fR Used to remote control and/or poll the status of other running instances of pexec. .TP \fB\-p\fR, \fB\-\-connect\fR Remote control port to connect to. .TP \fB\-t\fR, \fB\-\-status\fR Prints the actual status of the running jobs in a human\-readable form. .TP \fB\-l\fR, \fB\-\-lock\fR Locks the specified mutex (if the mutex is not locked by someone else, otherwise it will block until the mutex is released). .TP \fB\-u\fR, \fB\-\-unlock\fR Unlocks the specified mutex. .TP \fB\-m\fR, \fB\-\-mutex\fR Name of the mutex. .TP \fB\-d\fR, \fB\-\-dump\fR Dump the content of the given file to standard output, if ``\-m|\-\-mutex'' is given, this will be atomic. .TP \fB\-s\fR, \fB\-\-save\fR Save the content of standard input to the given file, if ``\-m|\-\-mutex'' is given, this will be atomic. .TP \fB\-a\fR, \fB\-\-atomic\fR Execute the given command. If ``\-m|\-\-mutex'' is given, the exectution is going to be atomic with respect to that mutex. .SS "Hypervisor mode:" .TP \fB\-H\fR, \fB\-\-hypervisor\fR Starts pexec in hypervisor mode. .TP \fB\-C\fR, \fB\-\-control\fR The control port used by the hypervisor. .TP \fB\-l\fR, \fB\-\-load\fR 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). .TP \fB\-f\fR, \fB\-\-fifo\fR First in first out queue processing. .TP \fB\-s\fR, \fB\-\-lifo\fR Last in first out (stack) queue processing (default). .SS "Logging:" .TP \fB\-L\fR, \fB\-\-log\fR The name of the log file. .TP \fB\-W\fR, \fB\-\-log\-level\fR The logging level. .TP \fB\-V\fR, \fB\-\-verbose\fR Increase the log level by one. .SH "REPORTING BUGS" Report bugs to .SH COPYRIGHT Copyright \(co 2007, 2008\-2009; Pal, Andras .PP .br This is free software. You may redistribute copies of it under the terms of the GNU General Public License . There is NO WARRANTY, to the extent permitted by law. .PP 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. .SH "SEE ALSO" The full documentation for .B pexec is maintained as a Texinfo manual. If the .B info and .B pexec programs are properly installed at your site, the command .IP .B info pexec .PP should give you access to the complete manual.