The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::Prun::Scaled - Provides the sprun script as a command line interface to Parallel::ForkManager::Scaled.

VERSION

Version 1.05

SYNOPSYS

    for nr in `seq 1 100`; do echo "echo command #$nr" | sprun

    sprun command_file_to_run_in_parallel

DESCRIPTION

sprun allows you to utilize multiple CPUs for some workloads from the shell more easily.

sprun takes a list of commands (stdin and/or from file(s)) and run the commands in parallel.

sprun is a CLI front end to Paralell::ForkManager::Scaled. It runs commands in parallel while trying to keep the CPUs at a specified level of activity by constantly adjusting the number of running processes.

EXAMPLES

There are also examples available from the command line --help.

Run tkprof against all .trc files in the current directory while attempting to keep the system 75% idle, don't adjust the number of processes unless idle time goes below 74 or above 76, and re-evaluate after each process exits (update frequency = 0).

  for F in *.trc; do echo "tkprof $F ${F%trc}txt"; done | sprun -t 75 -T 2 -u 0

Run all commands in a file (command_file), one line at a time. Manually bound the minimum and maximum number of processes to run and start with 4. Keep the CPU 100% busy (0% idle) and re-evaluate at most every 3 seconds. Ignore any failed processes, but do report to STDOUT any that fail.

  sprun -e -r -m 2 -M 8 -i 4 -u 3 command_file

Test with the dummy_load script included in the contrib/ directory of this distribution:

  for F in `seq 1 100`; do echo "contrib/dummy_load"; done | sprun -v

AUTHOR

Jason McCarver <slam@parasite.cc>

SEE ALSO

App::Prun
Parallel::ForkManager
Parallel::ForkManager::Scaled

REPOSITORY

The mercurial repository for this module may be found here:

  https://bitbucket.org/jmccarv/app-prun-scaled

clone it:

  hg clone https://bitbucket.org/jmccarv/app-prun-scaled

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Jason McCarver

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.