silence-parallel

A tool to run commands in parallel

https://github.com/dansm-5/silence-parallel

Repository

A tool to run commands in parallel

README

                Silence Parallel

This is a fork of GNU Parallel. It offers the the addition of not being
constantly annoyed by not have run the citation sub command.

The rationale behind this change is that it is not nice to force people
to type will cite when using a program for simple personal use or keeping
track of the number of times that you have use the program for personal
purposes.

This forks offers a parallel command which is silent. It won't count you
how many times you use it and it won't bother you constantly with logs
about citing nor require you to type "will cite" as a friendly program must do.
Other than that this fork remains fully compatible with the original with the
mayor difference that the "--citation" flag results in a NOOP instead of
ignoring other arguments or options.
However, if you intend to use the program for academic purposes,
you should follow the will of the author and cite the original project.
This is a great tool which deserves support and maybe one day the upstream
will make the program more friendly and this fork won't be needed.

This fork does not offer the 10 second install. Instead you should be able
to copy the required files from this repository and place them in your path.
> cp src/parallel src/sem src/sql src/niceload /directory/in/your/path
Or follow the instructions in this file below.

If you do prefer to use the original project but you don't want to be
forced to type "will cite", here some tips to use original parallel.

- Use the "--will-cite" argument flag which will silence logs for a single execution.
- Create a "will-cite" file in parallel home where parallel home is one of the following:
    - PARALLEL_HOME environment variable
    - $HOME/.parallel
  You can run something like this:
  "mkdir -p ~/.parallel && touch ~/.parallel/will-cite".
  Optionally if you already used parallel, you can remove the file
  "runs-without-willing-to-cite" and free some precious 4KiB from your storage.


			     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 51621b7f1ee103c00783aae4ef9889f8
    12345678 51621b7f 1ee103c0 0783aae4 ef9889f8
    $ md5sum install.sh | grep 62eada78703b5500241b8e50baf62758
    62eada78 703b5500 241b8e50 baf62758
    $ sha512sum install.sh | grep c0206a65dc86f2bb6bbdf1a2bc96bc6d067
    160d3159 9480cf5c a101512f 150b7ac0 206a65dc 86f2bb6b bdf1a2bc 96bc6d06
    7f8237c2 0964b67f bccf8a93 332528fa 11e5ab43 2a6226a6 ceb197ab 7f03c061
    $ 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-20250722.tar.bz2
    wget https://ftpmirror.gnu.org/parallel/parallel-20250722.tar.bz2.sig
    gpg parallel-20250722.tar.bz2.sig
    bzip2 -dc parallel-20250722.tar.bz2 | tar xvf -
    cd parallel-20250722
    ./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-20250722.tar.bz2
    wget https://ftpmirror.gnu.org/parallel/parallel-20250722.tar.bz2.sig
    gpg parallel-20250722.tar.bz2.sig
    bzip2 -dc parallel-20250722.tar.bz2 | tar xvf -
    cd parallel-20250722
    ./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. (2025, July 22). GNU Parallel 20250722 ('Fordow').
    Zenodo. https://doi.org/10.5281/zenodo.16289600

Copyright (C) 2007-2022 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-2022 Ole Tange, http://ole.tange.dk and Free Software and Foundation, Inc.
SPDX-License-Identifier: GPL-3.0-or-later

Owner

Citation (CITATION)

When using programs that use GNU Parallel to process data for publication please cite:

@book{tange_ole_2018_1146014,
      author       = {Tange, Ole},
      title        = {GNU Parallel 2018},
      publisher    = {Ole Tange},
      month        = Mar,
      year         = 2018,
      ISBN         = {9781387509881},
      doi          = {10.5281/zenodo.1146014},
      url          = {https://doi.org/10.5281/zenodo.1146014}
}

(Feel free to use \nocite{tange_ole_2018_1146014})

Or:

  O. Tange (2018): GNU Parallel 2018, Mar 2018, ISBN 9781387509881,
  DOI https://doi.org/10.5281/zenodo.11460

This helps funding further development.

SPDX-FileCopyrightText: 2021-2022 Ole Tange, http://ole.tange.dk and Free Software and Foundation, Inc.
SPDX-License-Identifier: GFDL-1.3-or-later
SPDX-License-Identifier: CC-BY-SA-4.0

GitHub Events