sneak/ppss
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Edited wiki page through web user interface.

Browse Source
This commit is contained in:
Louwrentius 2010-07-19 08:07:14 +00:00
parent 033698f102
commit 185c0a6280
1 changed files with 31 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
wiki/Manual1.wiki
View File

@ -30,16 +30,7 @@ If PPSS is executed with -h, more options are displayed.
{{{ {{{
bash-3.2$ ./ppss.sh -h bash-3.2$ ./ppss.sh -h
Usage ./ppss [ options ]
|P|P|S|S| Distributed Parallel Processing Shell Script 2.40
PPSS is a Bash shell script that executes commands in parallel on a set
of items, such as files in a directory, or lines in a file.
This short summary only discusses options for stand-alone mode. for a
complete listing of all options, run PPSS with the options --help
Usage ./ppss.sh [ options ]
--command | -c Command to execute. Syntax: '<command> ' including the single quotes. --command | -c Command to execute. Syntax: '<command> ' including the single quotes.
Example: -c 'ls -alh '. It is also possible to specify where an item Example: -c 'ls -alh '. It is also possible to specify where an item
@ -49,29 +40,56 @@ Usage ./ppss.sh [ options ]
are fed as an argument to the command that has been specified with -c. are fed as an argument to the command that has been specified with -c.
--sourcefile | -f Each single line of the supplied file will be fed as an item to the --sourcefile | -f Each single line of the supplied file will be fed as an item to the
command that has been specified with -c. command that has been specified with -c. Read input from stdin with
-f -
--config | -C If the mode is config, a config file with the specified name will be --config | -C If the mode is config, a config file with the specified name will be
generated based on all the options specified. In the other modes. generated based on all the options specified. In the other modes.
this option will result in PPSS reading the config file and start this option will result in PPSS reading the config file and start
processing items based on the settings of this file. processing items based on the settings of this file.
--enable-ht | -j Enable hyperthreading. Is disabled by default. --disable-ht | -j Disable hyper threading. Is enabled by default.
--log | -l Sets the name of the log file. The default is ppss-log.txt. --log | -l Sets the name of the log file. The default is ppss-log.txt.
--processes | -p Start the specified number of processes. Ignore the number of available --processes | -p Start the specified number of processes. Ignore the number of available
CPUs. CPUs.
--quiet | -q Shows no output except for a progress indication using percents.
--delay | -D Adds an initial random delay to the start of all parallel jobs to spread --delay | -D Adds an initial random delay to the start of all parallel jobs to spread
the load. The delay is only used at the start of all 'threads'. the load. The delay is only used at the start of all 'threads'.
--daemon Daemon mode. Do not exit after items are professed, but keep looking
for new items and process them. Read the manual how to use this!
--interval Specifies the polling interval when running in daemon mode. Polls every
x seconds for new items to process.
--file-age When not using inotify in daemon mode, specify how many seconds must
have passed before a file may be processed to prevent files being
processed while being written to.
--enable-input-lock When PPSS is run in daemon mode, create a directory INPUT_LOCK to
signal that items are processed and may not be touched by PPSS.
Once this directory is removed, PPSS will start processing items.
--disable-inotify If for some reason, inotify must not be used, use this option to disable
usage of inotify. Regular polling will be used.
--no-recursion|-r By default, recursion of directories is enabled when the -d option is
used. If this is not prefered, this can be disabled with this option
Only files within the specified directory will be processed.
--help Extended help, including options for distributed mode and Amazon EC2.
Example: encoding some wav files to mp3 using lame: Example: encoding some wav files to mp3 using lame:
./ppss.sh -d /path/to/wavfiles -c 'lame ' ./ppss -d /path/to/wavfiles -c 'lame '
Extended usage: use --help Extended usage: use --help
}}} }}}
A detailed explanation based on examples will follow. A detailed explanation based on examples will follow.