mirror of
https://git.savannah.gnu.org/git/parallel.git
synced 2024-12-22 20:57:53 +00:00
Documentation update.
This commit is contained in:
Ole Tange
parent
95ecf18d0c
commit
7bab1b45bc
|
|
@ -209,9 +209,9 @@ from:tange@gnu.org
|
|||
to:parallel@gnu.org, bug-parallel@gnu.org
|
||||
stable-bcc: Jesse Alama <jessealama@fastmail.fm>
|
||||
|
||||
Subject: GNU Parallel 20191022 ('Driving IT') released <<[stable]>>
|
||||
Subject: GNU Parallel 20191122 ('Berlin/Morales') released <<[stable]>>
|
||||
|
||||
GNU Parallel 20191022 ('Driving IT') <<[stable]>> has been released. It is available for download at: http://ftpmirror.gnu.org/parallel/
|
||||
GNU Parallel 20191122 ('') <<[stable]>> has been released. It is available for download at: http://ftpmirror.gnu.org/parallel/
|
||||
|
||||
<<No new functionality was introduced so this is a good candidate for a stable release.>>
|
||||
|
||||
|
|
@ -221,30 +221,14 @@ See https://www.gnu.org/software/parallel/10-years-anniversary.html
|
|||
|
||||
Quote of the month:
|
||||
|
||||
I've said it before: The command line program GNU Parallel is a godsend.
|
||||
-- Jo Chr. Oterhals @oterhals@twitter
|
||||
|
||||
New in this release:
|
||||
|
||||
* --tee will use --output-error=warn-nopipe if supported by tee.
|
||||
* GNU Parallel was presented at Driving IT. Slides:
|
||||
|
||||
* GNU Parallel will be presented at Driving IT 2019: https://ida.dk/arrangementer-og-kurser/konferencer/driving-it/tools
|
||||
https://blog.naderman.de/2019/11/14/restarting-supervisord-processes-in-parallel/
|
||||
|
||||
* UMN Duluth: Job parallelization with task arrays and GNU parallel https://www.msi.umn.edu/tutorials/umn-duluth-job-parallelization-task-arrays-and-gnu-parallel
|
||||
|
||||
* Genome updater uses GNU Parallel https://github.com/pirovc/genome_updater
|
||||
|
||||
* Using GNU-Parallel for bioinformatics https://www.danielecook.com/using-gnu-parallel-for-bioinformatics/
|
||||
|
||||
* Speeding up PostgreSQL ETL pipeline with the help of GODS https://cfengine.com/company/blog-detail/speeding-up-postgresql-etl-pipeline-with-the-help-of-gods/
|
||||
|
||||
* Runing linux commands in parallel https://dev.to/voyeg3r/runing-linux-commands-in-parallel-4ff8
|
||||
|
||||
* Research Computing University of Colorado Boulder contains an intro to GNU Parallel https://readthedocs.org/projects/curc/downloads/pdf/latest/
|
||||
|
||||
* 如何使用Parallel在Shell中并行执行命令https://www.myfreax.com/gnu-parallel/
|
||||
|
||||
* 如何测试 Amazon Elastic File System https://aws.amazon.com/cn/blogs/china/how-to-test-drive-amazon-elastic-file-system/
|
||||
* https://www.reddit.com/r/DataHoarder/comments/dsgmhc/parallel_archiving_techniques/
|
||||
|
||||
* Bug fixes and man page updates.
|
||||
|
||||
|
|
|
|||
11
src/parallel
11
src/parallel
|
|
@ -1193,7 +1193,7 @@ sub nindex($$) {
|
|||
# until one is empty and a new block is passed
|
||||
if(@robin_queue) {
|
||||
# Rotate queue once so new blocks get a fair chance
|
||||
# to be given to another block
|
||||
# to be given to another slot
|
||||
push @robin_queue, shift @robin_queue;
|
||||
} else {
|
||||
# Make a queue to spread the blocks evenly
|
||||
|
|
@ -1950,7 +1950,7 @@ sub parse_options(@) {
|
|||
# If you want GNU Parallel to be maintained in the future keep
|
||||
# this line.
|
||||
citation_notice();
|
||||
# Seriously: YOU will be harming free software by removing the
|
||||
# Seriously: *You* will be harming free software by removing the
|
||||
# notice. You make it harder to justify spending time developing
|
||||
# it. If you *do* remove the line, please email
|
||||
# hallofshame@tange.dk if you want to avoid being put in a hall of
|
||||
|
|
@ -8291,7 +8291,7 @@ sub non_blocking_write($) {
|
|||
if (!defined($rv) && $! == ::EAGAIN()) {
|
||||
# would block - but would have written
|
||||
$something_written = 0;
|
||||
# avoid triggering auto expanding block
|
||||
# avoid triggering auto expanding block size
|
||||
$Global::no_autoexpand_block ||= 1;
|
||||
} elsif ($self->{'block_pos'}+$rv != $self->{'block_length'}) {
|
||||
# incomplete write
|
||||
|
|
@ -9174,6 +9174,10 @@ sub remote_cleanup($) {
|
|||
}
|
||||
|
||||
sub exitstatuswrapper(@) {
|
||||
# Input:
|
||||
# @shellcode = shell code to execute
|
||||
# Returns:
|
||||
# shell script that returns current status after executing @shellcode
|
||||
if($Global::cshell) {
|
||||
return ('set _EXIT_status=$status; ' .
|
||||
join(" ",@_).
|
||||
|
|
@ -9185,7 +9189,6 @@ sub exitstatuswrapper(@) {
|
|||
}
|
||||
}
|
||||
|
||||
|
||||
sub workdir($) {
|
||||
# Returns:
|
||||
# the workdir on a remote machine
|
||||
|
|
|
|||
|
|
@ -2847,6 +2847,7 @@ Exit if the size (see the B<-s> option) is exceeded.
|
|||
|
||||
=back
|
||||
|
||||
|
||||
=head1 EXAMPLE: Working as xargs -n1. Argument appending
|
||||
|
||||
GNU B<parallel> can work similar to B<xargs -n1>.
|
||||
|
|
@ -3992,7 +3993,13 @@ then the obvious solution would be this, but it B<does not work>:
|
|||
It does not work because the command is dequoted by B<ssh> twice where
|
||||
as GNU B<parallel> only expects it to be dequoted once.
|
||||
|
||||
So instead put this in B<~/.ssh/config>:
|
||||
You can use a bash function and have GNU B<parallel> quote the command:
|
||||
|
||||
jumpssh() { ssh -A jumphost ssh $(parallel --shellquote ::: "$@"); }
|
||||
export -f jumpssh
|
||||
parallel --ssh jumpssh -S host1 echo ::: this works
|
||||
|
||||
Or you can instead put this in B<~/.ssh/config>:
|
||||
|
||||
Host host1 host2 host3
|
||||
ProxyCommand ssh jumphost.domain nc -w 1 %h 22
|
||||
|
|
@ -4224,6 +4231,25 @@ To run 100 processes simultaneously do:
|
|||
As there is not a I<command> the jobs will be evaluated by the shell.
|
||||
|
||||
|
||||
=head1 EXAMPLE: Call program with FASTA sequence
|
||||
|
||||
FASTA files have the format:
|
||||
|
||||
>Sequence name1
|
||||
sequence
|
||||
sequence continued
|
||||
>Sequence name2
|
||||
sequence
|
||||
sequence continued
|
||||
more sequence
|
||||
|
||||
To call B<myprog> with the sequence as argument run:
|
||||
|
||||
cat file.fasta |
|
||||
parallel --pipe -N1 --recstart '>' --rrs \
|
||||
'read a; echo Name: "$a"; myprog $(tr -d "\n")'
|
||||
|
||||
|
||||
=head1 EXAMPLE: Processing a big file using more CPUs
|
||||
|
||||
To process a big file or some output you can use B<--pipe> to split up
|
||||
|
|
@ -5248,8 +5274,11 @@ A copy of the full license is included in the file as cc-by-sa.txt.
|
|||
=head1 DEPENDENCIES
|
||||
|
||||
GNU B<parallel> uses Perl, and the Perl modules Getopt::Long,
|
||||
IPC::Open3, Symbol, IO::File, POSIX, and File::Temp. For remote usage
|
||||
it also uses rsync with ssh.
|
||||
IPC::Open3, Symbol, IO::File, POSIX, and File::Temp.
|
||||
|
||||
For B<--csv> it uses the Perl module Text::CSV.
|
||||
|
||||
For remote usage it uses B<rsync> with B<ssh>.
|
||||
|
||||
|
||||
=head1 SEE ALSO
|
||||
|
|
|
|||
Loading…
Reference in a new issue