mirror of
https://git.savannah.gnu.org/git/parallel.git
synced 2024-11-22 05:57:54 +00:00
src/Makefile.am: DISTCLEANFILES updated.
This commit is contained in:
Ole Tange
parent
f7bbe3a5c7
commit
613d34cf89
|
|
@ -111,7 +111,11 @@ niceload.pdf: niceload.pod
|
|||
sem: parallel
|
||||
ln -fs parallel sem
|
||||
|
||||
DISTCLEANFILES =
|
||||
DISTCLEANFILES = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
|
||||
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \
|
||||
parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi \
|
||||
parallel.pdf sem.pdf sql.pdf niceload.pdf parallel_tutorial.pdf
|
||||
|
||||
EXTRA_DIST = parallel sem sql niceload \
|
||||
parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
|
||||
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \
|
||||
|
|
|
|||
|
|
@ -177,7 +177,11 @@ top_srcdir = @top_srcdir@
|
|||
bin_SCRIPTS = parallel sem sql niceload
|
||||
man_MANS = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1
|
||||
doc_DATA = parallel.html sem.html sql.html niceload.html parallel_tutorial.html parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi parallel.pdf sem.pdf sql.pdf niceload.pdf parallel_tutorial.pdf
|
||||
DISTCLEANFILES =
|
||||
DISTCLEANFILES = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
|
||||
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \
|
||||
parallel.texi sem.texi sql.texi niceload.texi parallel_tutorial.texi \
|
||||
parallel.pdf sem.pdf sql.pdf niceload.pdf parallel_tutorial.pdf
|
||||
|
||||
EXTRA_DIST = parallel sem sql niceload \
|
||||
parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
|
||||
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \
|
||||
|
|
@ -511,13 +515,13 @@ sem.1: sem.pod
|
|||
|
||||
sql.1: sql
|
||||
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
|
||||
--section=1 $(srcdir)/sql > $(srcdir)/sql.1 \
|
||||
--section=1 $(srcdir)/sql > $(srcdir)/sql.1n \
|
||||
&& mv $(srcdir)/sql.1n $(srcdir)/sql.1 \
|
||||
|| echo "Warning: pod2man not found. Using old sql.1"
|
||||
|
||||
niceload.1: niceload.pod
|
||||
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \
|
||||
--section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1 \
|
||||
--section=1 $(srcdir)/niceload.pod > $(srcdir)/niceload.1n \
|
||||
&& mv $(srcdir)/niceload.1n $(srcdir)/niceload.1 \
|
||||
|| echo "Warning: pod2man not found. Using old niceload.1"
|
||||
|
||||
|
|
@ -528,7 +532,7 @@ parallel.html: parallel.pod
|
|||
rm -f $(srcdir)/pod2htm*
|
||||
|
||||
# Depending on parallel.html to avoid stupid pod2html race condition
|
||||
parallel_tutorial.html: parallel_tutorial.pod Makefile parallel.html
|
||||
parallel_tutorial.html: parallel_tutorial.pod parallel.html
|
||||
pod2html $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.htmln \
|
||||
&& mv $(srcdir)/parallel_tutorial.htmln $(srcdir)/parallel_tutorial.html \
|
||||
|| echo "Warning: pod2html not found. Using old parallel_tutorial.html"
|
||||
|
|
|
|||
BIN
src/niceload.pdf
BIN
src/niceload.pdf
Binary file not shown.
|
|
@ -8,19 +8,37 @@
|
|||
@node Top
|
||||
@top niceload
|
||||
|
||||
@menu
|
||||
* NAME::
|
||||
* SYNOPSIS::
|
||||
* DESCRIPTION::
|
||||
* OPTIONS::
|
||||
* EXAMPLE@asis{:} See niceload in action::
|
||||
* EXAMPLE@asis{:} Run updatedb::
|
||||
* EXAMPLE@asis{:} Run rsync::
|
||||
* EXAMPLE@asis{:} Ensure enough disk cache::
|
||||
* ENVIRONMENT VARIABLES::
|
||||
* EXIT STATUS::
|
||||
* REPORTING BUGS::
|
||||
* AUTHOR::
|
||||
* LICENSE::
|
||||
* DEPENDENCIES::
|
||||
* SEE ALSO::
|
||||
@end menu
|
||||
|
||||
@node NAME
|
||||
@chapter NAME
|
||||
@anchor{NAME}
|
||||
|
||||
niceload - slow down a program when the load average is above a certain limit
|
||||
|
||||
@node SYNOPSIS
|
||||
@chapter SYNOPSIS
|
||||
@anchor{SYNOPSIS}
|
||||
|
||||
@strong{niceload} [-v] [-h] [-n nice] [-I io] [-L load] [-M mem] [-N]
|
||||
[--sensor program] [-t time] [-s time|-f factor] ( command | -p PID [-p PID ...] )
|
||||
|
||||
@node DESCRIPTION
|
||||
@chapter DESCRIPTION
|
||||
@anchor{DESCRIPTION}
|
||||
|
||||
GNU @strong{niceload} will slow down a program when the load average (or
|
||||
other system activity) is above a certain limit. When the limit is
|
||||
|
|
@ -37,8 +55,8 @@ like this:
|
|||
run 1 second, suspend (3.00-1.00) seconds, run 1 second, suspend
|
||||
(3.00-1.00) seconds, run 1 second, ...
|
||||
|
||||
@node OPTIONS
|
||||
@chapter OPTIONS
|
||||
@anchor{OPTIONS}
|
||||
|
||||
@table @asis
|
||||
@item @strong{-f} @emph{FACTOR}
|
||||
|
|
@ -243,8 +261,8 @@ you know what your are doing.
|
|||
|
||||
@end table
|
||||
|
||||
@node EXAMPLE: See niceload in action
|
||||
@chapter EXAMPLE: See niceload in action
|
||||
@anchor{EXAMPLE: See niceload in action}
|
||||
|
||||
In terminal 1 run: top
|
||||
|
||||
|
|
@ -255,8 +273,8 @@ In terminal 2 run:
|
|||
This will print a '.' every second for 50 seconds and eat a lot of
|
||||
CPU. When the load rises to 1.0 the process is suspended.
|
||||
|
||||
@node EXAMPLE: Run updatedb
|
||||
@chapter EXAMPLE: Run updatedb
|
||||
@anchor{EXAMPLE: Run updatedb}
|
||||
|
||||
Running updatedb can often starve the system for disk I/O and thus result in a high load.
|
||||
|
||||
|
|
@ -264,8 +282,8 @@ Run updatedb but suspend updatedb if the load is above 2.00:
|
|||
|
||||
@strong{niceload -L 2 updatedb}
|
||||
|
||||
@node EXAMPLE: Run rsync
|
||||
@chapter EXAMPLE: Run rsync
|
||||
@anchor{EXAMPLE: Run rsync}
|
||||
|
||||
rsync can just like updatedb starve the system for disk I/O and thus result in a high load.
|
||||
|
||||
|
|
@ -274,8 +292,8 @@ Run rsync but keep load below 3.4. If load reaches 7 sleep for
|
|||
|
||||
@strong{niceload -L 3.4 -f 12 rsync -Ha /home/ /backup/home/}
|
||||
|
||||
@node EXAMPLE: Ensure enough disk cache
|
||||
@chapter EXAMPLE: Ensure enough disk cache
|
||||
@anchor{EXAMPLE: Ensure enough disk cache}
|
||||
|
||||
Assume the program @strong{foo} uses 2 GB files intensively. @strong{foo} will run
|
||||
fast if the files are in disk cache and be slow as a crawl if they are
|
||||
|
|
@ -289,23 +307,23 @@ This will not guarantee that the 2 GB memory will be used for the
|
|||
files for @strong{foo}, but it will stop @strong{foo} if the memory for disk cache
|
||||
is too low.
|
||||
|
||||
@node ENVIRONMENT VARIABLES
|
||||
@chapter ENVIRONMENT VARIABLES
|
||||
@anchor{ENVIRONMENT VARIABLES}
|
||||
|
||||
None. In future versions $NICELOAD will be able to contain default settings.
|
||||
|
||||
@node EXIT STATUS
|
||||
@chapter EXIT STATUS
|
||||
@anchor{EXIT STATUS}
|
||||
|
||||
Exit status should be the same as the command being run (untested).
|
||||
|
||||
@node REPORTING BUGS
|
||||
@chapter REPORTING BUGS
|
||||
@anchor{REPORTING BUGS}
|
||||
|
||||
Report bugs to <bug-parallel@@gnu.org>.
|
||||
|
||||
@node AUTHOR
|
||||
@chapter AUTHOR
|
||||
@anchor{AUTHOR}
|
||||
|
||||
Copyright (C) 2004-11-19 Ole Tange, http://ole.tange.dk
|
||||
|
||||
|
|
@ -314,8 +332,8 @@ Copyright (C) 2005,2006,2006,2008,2009,2010 Ole Tange, http://ole.tange.dk
|
|||
Copyright (C) 2010,2011,2012 Ole Tange, http://ole.tange.dk and Free
|
||||
Software Foundation, Inc.
|
||||
|
||||
@node LICENSE
|
||||
@chapter LICENSE
|
||||
@anchor{LICENSE}
|
||||
|
||||
Copyright (C) 2010,2011,2012 Free Software Foundation, Inc.
|
||||
|
||||
|
|
@ -332,8 +350,13 @@ GNU General Public License for more details.
|
|||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
@menu
|
||||
* Documentation license I::
|
||||
* Documentation license II::
|
||||
@end menu
|
||||
|
||||
@node Documentation license I
|
||||
@section Documentation license I
|
||||
@anchor{Documentation license I}
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this documentation
|
||||
under the terms of the GNU Free Documentation License, Version 1.3 or
|
||||
|
|
@ -341,8 +364,8 @@ any later version published by the Free Software Foundation; with no
|
|||
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
|
||||
Texts. A copy of the license is included in the file fdl.txt.
|
||||
|
||||
@node Documentation license II
|
||||
@section Documentation license II
|
||||
@anchor{Documentation license II}
|
||||
|
||||
You are free:
|
||||
|
||||
|
|
@ -422,14 +445,14 @@ license terms of this work.
|
|||
|
||||
A copy of the full license is included in the file as cc-by-sa.txt.
|
||||
|
||||
@node DEPENDENCIES
|
||||
@chapter DEPENDENCIES
|
||||
@anchor{DEPENDENCIES}
|
||||
|
||||
GNU @strong{niceload} uses Perl, and the Perl modules POSIX, and
|
||||
Getopt::Long.
|
||||
|
||||
@node SEE ALSO
|
||||
@chapter SEE ALSO
|
||||
@anchor{SEE ALSO}
|
||||
|
||||
@strong{parallel}(1), @strong{nice}(1), @strong{uptime}(1)
|
||||
|
||||
|
|
|
|||
BIN
src/parallel.pdf
BIN
src/parallel.pdf
Binary file not shown.
|
|
@ -124,7 +124,7 @@
|
|||
.\" ========================================================================
|
||||
.\"
|
||||
.IX Title "PARALLEL_TUTORIAL 1"
|
||||
.TH PARALLEL_TUTORIAL 1 "2014-06-13" "20140522" "parallel"
|
||||
.TH PARALLEL_TUTORIAL 1 "2014-06-13" "20140613" "parallel"
|
||||
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
|
||||
.\" way too many mistakes in technical documents.
|
||||
.if n .ad l
|
||||
|
|
|
|||
Binary file not shown.
BIN
src/sem.pdf
BIN
src/sem.pdf
Binary file not shown.
48
src/sem.texi
48
src/sem.texi
|
|
@ -8,18 +8,33 @@
|
|||
@node Top
|
||||
@top sem
|
||||
|
||||
@menu
|
||||
* NAME::
|
||||
* SYNOPSIS::
|
||||
* DESCRIPTION::
|
||||
* OPTIONS::
|
||||
* EXAMPLE@asis{:} Gzipping *.log::
|
||||
* EXAMPLE@asis{:} Protecting pod2html from itself::
|
||||
* BUGS::
|
||||
* REPORTING BUGS::
|
||||
* AUTHOR::
|
||||
* LICENSE::
|
||||
* DEPENDENCIES::
|
||||
* SEE ALSO::
|
||||
@end menu
|
||||
|
||||
@node NAME
|
||||
@chapter NAME
|
||||
@anchor{NAME}
|
||||
|
||||
sem - semaphore for executing shell command lines in parallel
|
||||
|
||||
@node SYNOPSIS
|
||||
@chapter SYNOPSIS
|
||||
@anchor{SYNOPSIS}
|
||||
|
||||
@strong{sem} [--fg] [--id <id>] [--timeout <secs>] [-j <num>] [--wait] command
|
||||
|
||||
@node DESCRIPTION
|
||||
@chapter DESCRIPTION
|
||||
@anchor{DESCRIPTION}
|
||||
|
||||
GNU @strong{sem} is an alias for GNU @strong{parallel --semaphore}.
|
||||
|
||||
|
|
@ -33,8 +48,8 @@ Before looking at the options you may want to check out the examples
|
|||
after the list of options. That will give you an idea of what GNU
|
||||
@strong{sem} is capable of.
|
||||
|
||||
@node OPTIONS
|
||||
@chapter OPTIONS
|
||||
@anchor{OPTIONS}
|
||||
|
||||
@table @asis
|
||||
@item @emph{command}
|
||||
|
|
@ -173,8 +188,8 @@ Wait for all commands to complete.
|
|||
|
||||
@end table
|
||||
|
||||
@node EXAMPLE: Gzipping *.log
|
||||
@chapter EXAMPLE: Gzipping *.log
|
||||
@anchor{EXAMPLE: Gzipping *.log}
|
||||
|
||||
Run one gzip process per CPU core. Block until a CPU core becomes
|
||||
available.
|
||||
|
|
@ -187,8 +202,8 @@ available.
|
|||
sem --wait
|
||||
@end verbatim
|
||||
|
||||
@node EXAMPLE: Protecting pod2html from itself
|
||||
@chapter EXAMPLE: Protecting pod2html from itself
|
||||
@anchor{EXAMPLE: Protecting pod2html from itself}
|
||||
|
||||
pod2html creates two files: pod2htmd.tmp and pod2htmi.tmp which it
|
||||
does not clean up. It uses these two files for a short time. But if
|
||||
|
|
@ -201,24 +216,24 @@ time. @strong{sem} running as a mutex will do just that:
|
|||
sem --fg --id pod2html rm -f pod2htmd.tmp pod2htmi.tmp
|
||||
@end verbatim
|
||||
|
||||
@node BUGS
|
||||
@chapter BUGS
|
||||
@anchor{BUGS}
|
||||
|
||||
None known.
|
||||
|
||||
@node REPORTING BUGS
|
||||
@chapter REPORTING BUGS
|
||||
@anchor{REPORTING BUGS}
|
||||
|
||||
Report bugs to <bug-parallel@@gnu.org>.
|
||||
|
||||
@node AUTHOR
|
||||
@chapter AUTHOR
|
||||
@anchor{AUTHOR}
|
||||
|
||||
Copyright (C) 2010,2011,2012,2013 Ole Tange, http://ole.tange.dk and Free
|
||||
Software Foundation, Inc.
|
||||
|
||||
@node LICENSE
|
||||
@chapter LICENSE
|
||||
@anchor{LICENSE}
|
||||
|
||||
Copyright (C) 2010,2011,2012,2013 Free Software Foundation, Inc.
|
||||
|
||||
|
|
@ -235,8 +250,13 @@ GNU General Public License for more details.
|
|||
You should have received a copy of the GNU General Public License
|
||||
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
@menu
|
||||
* Documentation license I::
|
||||
* Documentation license II::
|
||||
@end menu
|
||||
|
||||
@node Documentation license I
|
||||
@section Documentation license I
|
||||
@anchor{Documentation license I}
|
||||
|
||||
Permission is granted to copy, distribute and/or modify this documentation
|
||||
under the terms of the GNU Free Documentation License, Version 1.3 or
|
||||
|
|
@ -244,8 +264,8 @@ any later version published by the Free Software Foundation; with no
|
|||
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
|
||||
Texts. A copy of the license is included in the file fdl.txt.
|
||||
|
||||
@node Documentation license II
|
||||
@section Documentation license II
|
||||
@anchor{Documentation license II}
|
||||
|
||||
You are free:
|
||||
|
||||
|
|
@ -325,14 +345,14 @@ license terms of this work.
|
|||
|
||||
A copy of the full license is included in the file as cc-by-sa.txt.
|
||||
|
||||
@node DEPENDENCIES
|
||||
@chapter DEPENDENCIES
|
||||
@anchor{DEPENDENCIES}
|
||||
|
||||
GNU @strong{sem} uses Perl, and the Perl modules Getopt::Long,
|
||||
Symbol, Fcntl.
|
||||
|
||||
@node SEE ALSO
|
||||
@chapter SEE ALSO
|
||||
@anchor{SEE ALSO}
|
||||
|
||||
@strong{parallel}(1)
|
||||
|
||||
|
|
|
|||
BIN
src/sql.pdf
BIN
src/sql.pdf
Binary file not shown.
Loading…
Reference in a new issue