For people who live life in the parallel lane.
If you use xargs and tee today you will find GNU parallel very easy to use as GNU parallel is written to have the same options as xargs. If you write loops in shell, you will find GNU parallel may be able to replace most of the loops and make them run faster by running several jobs in parallel.
GNU parallel makes sure output from the commands is the same output as you would get had you run the commands sequentially. This makes it possible to use output from GNU parallel as input for other programs.
For each line of input GNU parallel will execute command with the line as arguments. If no command is given, the line of input is executed. Several lines will be run in parallel. GNU parallel can often be used as a substitute for xargs or cat | bash.
Downloading GNU Parallel
GNU parallel can be found on the main GNU ftp server: http://ftp.gnu.org/gnu/parallel/ (via HTTP) and ftp://ftp.gnu.org/gnu/parallel/ (via FTP). It can also be found on the GNU mirrors; please use a mirror if possible.
Official packages exist for:
- Ubuntu Quantal (https://launchpad.net/ubuntu/quantal/i386/parallel/20120422-1).
- Debian Squeeze-backport (http://packages.debian.org/squeeze-backports/parallel), Wheezy (http://packages.debian.org/wheezy/parallel), and Sid (http://packages.debian.org/sid/parallel).
- Gentoo (http://packages.gentoo.org/package/sys-process/parallel).
- FreeBSD (http://www.freshports.org/sysutils/parallel/).
- Fedora (https://apps.fedoraproject.org/packages/parallel).
- CERN Centos 7 (http://linuxsoft.cern.ch/cern/centos/7/cern/x86_64/repoview/parallel.html).
- Arch Linux (http://www.archlinux.org/packages/community/any/parallel/).
- Alpine Linux (http://alpinelinux.org/apk/main/x86/parallel).
- OpenBSD (http://ftp.openbsd.org/ports/sysutils/parallel/).
- NetBSD (http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/parallel/parallel/README.html).
- DragonFlyBSD (ftp://ftp.dragonflybsd.org/dports/dragonfly%3A3.8%3Ax86%3A64/LATEST/All/).
- OpenSUSE (http://software.opensuse.org/package/gnu_parallel).
- Mandriva (http://rpm.pbone.net/index.php3/stat/4/idpl/14460936/dir/mandriva_2009/com/parallel-20100822-1mdv2009.1.i586.rpm.html).
- Alt Linux (http://sisyphus.ru/ru/srpm/parallel).
- Mageia Linux (http://mageia.madb.org/package/show/application/0/name/parallel).
- MacOS FINK (http://pdb.finkproject.org/pdb/package.php/parallel).
- MacOS Homebrew (https://github.com/mxcl/homebrew/blob/master/Library/Formula/parallel.rb).
- Zero install (http://git.savannah.gnu.org/cgit/parallel.git/tree/packager/0install).
- Solaris 11.2beta (https://blogs.oracle.com/alanc/entry/solaris_11_2_changes_to).
Community maintained packages:
- Untested .rpm packages for CentOS, Fedora, Mandriva, RedHat, and SUSE and .debs for Debian, xUbuntu (https://build.opensuse.org/package/show?package=parallel&project=home%3Atange).
- Sun Freeware (http://ftp.sunet.se/pub/vendor/sun/freeware/SOURCES/).
- AIX (http://www.perzl.org/aix/index.php?n=Main.Parallel).
Just like other GNU software GNU parallel has documentation available online:
- You can get a brief summary by running parallel --help.
- You can get GNU parallel's man page by running man parallel.
- env_parallel's man page can be found by running man env_parallel.
- You can get GNU parallel's tutorial by running man parallel_tutorial.
Some short videos displaying the most common usage are available at: http://www.youtube.com/playlist?list=PL284C9FF2488BC6D1.
The history of GNU parallel can be found at http://www.gnu.org/software/parallel/history.html.
When using GNU parallel for a publication please cite as per
The discussion list <firstname.lastname@example.org>, is used to discuss development and enhancement requests, as well as bug reports. Your bug report should always include:
- The output of parallel --version. If you are not running the latest released version you should specify why you believe the problem is not fixed in that version.
- A complete example that others can run that shows the problem. A combination of seq, cat, echo, and sleep can reproduce most errors. If you example requires large files, see if you can use make them by something like seq 1000000 > file.
Development of GNU parallel, and GNU in general, is a volunteer effort, and you can contribute. For information, please read How to help GNU. If you'd like to get involved, it's a good idea to join the discussion mailing list (see above).
- Test releases
- Trying the latest test release (when available) is always appreciated. Test releases of GNU parallel can be found at http://alpha.gnu.org/gnu/parallel/ (via HTTP) and ftp://alpha.gnu.org/gnu/parallel/ (via FTP).
- For development sources, bug and patch trackers, and other information, please see the GNU parallel project page at savannah.gnu.org.
- GNU parallel is currently being maintained by Ole Tange (http://ole.tange.dk). Please use the mailing lists for contact.
You can show your support for GNU parallel using our merchandise.
GNU parallel is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
When using GNU parallel for a publication please cite:
O. Tange (2011): GNU Parallel - The Command-Line Power Tool, ;login: The USENIX Magazine, February 2011:42-47.