mirror of
https://git.savannah.gnu.org/git/parallel.git
synced 2024-12-27 07:07:56 +00:00
.reuse | ||
doc | ||
LICENSES | ||
packager | ||
src | ||
testsuite | ||
.gitignore | ||
10seconds_install | ||
aclocal.m4 | ||
bootstrap | ||
CITATION | ||
config.h.in | ||
configure | ||
configure.ac | ||
CREDITS | ||
install-sh | ||
Makefile.am | ||
Makefile.in | ||
missing | ||
NEWS | ||
README |
GNU Parallel https://www.gnu.org/software/parallel/ = Presentation of GNU Parallel = GNU Parallel is a shell tool for executing jobs in parallel using one or more computers. A job can be a single command or a small script that has to be run for each of the lines in the input. The typical input is a list of files, a list of hosts, a list of users, a list of URLs, or a list of tables. A job can also be a command that reads from a pipe. GNU Parallel can then split the input and pipe it into commands in parallel. 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. See the cheat sheet for examples that cover most of the daily usage: www.gnu.org/s/parallel/parallel_cheat.pdf = 10 seconds installation = For security reasons it is recommended you use your package manager to install. But if you cannot do that then you can use this 10 seconds installation. The 10 seconds installation will try to do a full installation; if that fails, a personal installation; if that fails, a minimal installation. $ (wget -O - pi.dk/3 || lynx -source pi.dk/3 || curl pi.dk/3/ || \ fetch -o - http://pi.dk/3 ) > install.sh $ sha1sum install.sh | grep c82233e7da3166308632ac8c34f850c0 12345678 c82233e7 da316630 8632ac8c 34f850c0 $ md5sum install.sh | grep ae3d7aac5e15cf3dfc87046cfc5918d2 ae3d7aac 5e15cf3d fc87046c fc5918d2 $ sha512sum install.sh | grep dfc00d823137271a6d96225cea9e89f533ff6c81f 9c5198d5 31a3b755 b7910ece 3a42d206 c804694d fc00d823 137271a6 d96225ce a9e89f53 3ff6c81f f52b298b ef9fb613 2d3f9ccd 0e2c7bd3 c35978b5 79acb5ca $ bash install.sh This will literally install faster than reading the rest of this document. = Full installation = Full installation of GNU Parallel is as simple as: wget https://ftpmirror.gnu.org/parallel/parallel-20210422.tar.bz2 wget https://ftpmirror.gnu.org/parallel/parallel-20210422.tar.bz2.sig gpg parallel-20210422.tar.bz2.sig bzip2 -dc parallel-20210422.tar.bz2 | tar xvf - cd parallel-20210422 ./configure && make && sudo make install = Personal installation = If you are not root you can add ~/bin to your path and install in ~/bin and ~/share: wget https://ftpmirror.gnu.org/parallel/parallel-20210422.tar.bz2 wget https://ftpmirror.gnu.org/parallel/parallel-20210422.tar.bz2.sig gpg parallel-20210422.tar.bz2.sig bzip2 -dc parallel-20210422.tar.bz2 | tar xvf - cd parallel-20210422 ./configure --prefix=$HOME && make && make install Or if your system lacks 'make' you can simply copy src/parallel src/sem src/niceload src/sql to a dir in your path. = Minimal installation = If you just need parallel and do not have 'make' installed (maybe the system is old or Microsoft Windows): wget https://git.savannah.gnu.org/cgit/parallel.git/plain/src/parallel chmod 755 parallel cp parallel sem mv parallel sem dir-in-your-$PATH/bin/ = Installation on compute servers = If you are developing your script to run on a remote server, that does not have GNU Parallel installed, but you have it installed on you development machine, then you can use `parallel --embed`. parallel --embed > newscript.sh Just edit the last lines of newscript.sh and copy it to the compute server. = Test the installation = After this you should be able to do: parallel -j0 ping -nc 3 ::: qubes-os.org gnu.org freenetproject.org This will send 3 ping packets to 3 different hosts in parallel and print the output when they complete. Watch the intro video for a quick introduction: https://www.youtube.com/playlist?list=PL284C9FF2488BC6D1 Walk through the tutorial (man parallel_tutorial). You command line will love you for it. When using programs that use GNU Parallel to process data for publication please cite: Tange, O. (2021, April 22). GNU Parallel 20210422 ('Ever Given'). Zenodo. https://doi.org/10.5281/zenodo.4710607 Copyright (C) 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021 Ole Tange, http://ole.tange.dk and Free Software Foundation, Inc. = New versions = New versions will be released at: https://ftp.gnu.org/gnu/parallel/ = Dependencies = GNU Parallel should work with a normal full Perl installation. However, if you system has split up Perl into multiple packages then these are the important ones: opkg install perlbase-getopt perlbase-ipc procps-ng-ps perlbase-mime SPDX-FileCopyrightText: 2021 Ole Tange, http://ole.tange.dk and Free Software and Foundation, Inc. SPDX-License-Identifier: GPL-3.0-or-later