src/Makefile.am: DISTCLEANFILES updated.

This commit is contained in:
Ole Tange 2014-06-13 14:47:44 +02:00
parent f7bbe3a5c7
commit 613d34cf89
10 changed files with 88 additions and 37 deletions

View file

@ -111,7 +111,11 @@ niceload.pdf: niceload.pod
sem: parallel sem: parallel
ln -fs parallel sem 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 \ EXTRA_DIST = parallel sem sql niceload \
parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \ parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \ parallel.html sem.html sql.html niceload.html parallel_tutorial.html \

View file

@ -177,7 +177,11 @@ top_srcdir = @top_srcdir@
bin_SCRIPTS = parallel sem sql niceload bin_SCRIPTS = parallel sem sql niceload
man_MANS = parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 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 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 \ EXTRA_DIST = parallel sem sql niceload \
parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \ parallel.1 sem.1 sql.1 niceload.1 parallel_tutorial.1 \
parallel.html sem.html sql.html niceload.html parallel_tutorial.html \ parallel.html sem.html sql.html niceload.html parallel_tutorial.html \
@ -511,13 +515,13 @@ sem.1: sem.pod
sql.1: sql sql.1: sql
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ 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 \ && mv $(srcdir)/sql.1n $(srcdir)/sql.1 \
|| echo "Warning: pod2man not found. Using old sql.1" || echo "Warning: pod2man not found. Using old sql.1"
niceload.1: niceload.pod niceload.1: niceload.pod
pod2man --release='$(PACKAGE_VERSION)' --center='$(PACKAGE_NAME)' \ 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 \ && mv $(srcdir)/niceload.1n $(srcdir)/niceload.1 \
|| echo "Warning: pod2man not found. Using old niceload.1" || echo "Warning: pod2man not found. Using old niceload.1"
@ -528,7 +532,7 @@ parallel.html: parallel.pod
rm -f $(srcdir)/pod2htm* rm -f $(srcdir)/pod2htm*
# Depending on parallel.html to avoid stupid pod2html race condition # 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 \ pod2html $(srcdir)/parallel_tutorial.pod > $(srcdir)/parallel_tutorial.htmln \
&& mv $(srcdir)/parallel_tutorial.htmln $(srcdir)/parallel_tutorial.html \ && mv $(srcdir)/parallel_tutorial.htmln $(srcdir)/parallel_tutorial.html \
|| echo "Warning: pod2html not found. Using old parallel_tutorial.html" || echo "Warning: pod2html not found. Using old parallel_tutorial.html"

Binary file not shown.

View file

@ -8,19 +8,37 @@
@node Top @node Top
@top niceload @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 @chapter NAME
@anchor{NAME}
niceload - slow down a program when the load average is above a certain limit niceload - slow down a program when the load average is above a certain limit
@node SYNOPSIS
@chapter SYNOPSIS @chapter SYNOPSIS
@anchor{SYNOPSIS}
@strong{niceload} [-v] [-h] [-n nice] [-I io] [-L load] [-M mem] [-N] @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 ...] ) [--sensor program] [-t time] [-s time|-f factor] ( command | -p PID [-p PID ...] )
@node DESCRIPTION
@chapter DESCRIPTION @chapter DESCRIPTION
@anchor{DESCRIPTION}
GNU @strong{niceload} will slow down a program when the load average (or 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 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 run 1 second, suspend (3.00-1.00) seconds, run 1 second, suspend
(3.00-1.00) seconds, run 1 second, ... (3.00-1.00) seconds, run 1 second, ...
@node OPTIONS
@chapter OPTIONS @chapter OPTIONS
@anchor{OPTIONS}
@table @asis @table @asis
@item @strong{-f} @emph{FACTOR} @item @strong{-f} @emph{FACTOR}
@ -243,8 +261,8 @@ you know what your are doing.
@end table @end table
@node EXAMPLE: See niceload in action
@chapter EXAMPLE: See niceload in action @chapter EXAMPLE: See niceload in action
@anchor{EXAMPLE: See niceload in action}
In terminal 1 run: top 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 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. CPU. When the load rises to 1.0 the process is suspended.
@node EXAMPLE: Run updatedb
@chapter 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. 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} @strong{niceload -L 2 updatedb}
@node EXAMPLE: Run rsync
@chapter 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. 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/} @strong{niceload -L 3.4 -f 12 rsync -Ha /home/ /backup/home/}
@node EXAMPLE: Ensure enough disk cache
@chapter 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 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 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 files for @strong{foo}, but it will stop @strong{foo} if the memory for disk cache
is too low. is too low.
@node ENVIRONMENT VARIABLES
@chapter ENVIRONMENT VARIABLES @chapter ENVIRONMENT VARIABLES
@anchor{ENVIRONMENT VARIABLES}
None. In future versions $NICELOAD will be able to contain default settings. None. In future versions $NICELOAD will be able to contain default settings.
@node EXIT STATUS
@chapter EXIT STATUS @chapter EXIT STATUS
@anchor{EXIT STATUS}
Exit status should be the same as the command being run (untested). Exit status should be the same as the command being run (untested).
@node REPORTING BUGS
@chapter REPORTING BUGS @chapter REPORTING BUGS
@anchor{REPORTING BUGS}
Report bugs to <bug-parallel@@gnu.org>. Report bugs to <bug-parallel@@gnu.org>.
@node AUTHOR
@chapter AUTHOR @chapter AUTHOR
@anchor{AUTHOR}
Copyright (C) 2004-11-19 Ole Tange, http://ole.tange.dk 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 Copyright (C) 2010,2011,2012 Ole Tange, http://ole.tange.dk and Free
Software Foundation, Inc. Software Foundation, Inc.
@node LICENSE
@chapter LICENSE @chapter LICENSE
@anchor{LICENSE}
Copyright (C) 2010,2011,2012 Free Software Foundation, Inc. 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 You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. 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 @section Documentation license I
@anchor{Documentation license I}
Permission is granted to copy, distribute and/or modify this documentation Permission is granted to copy, distribute and/or modify this documentation
under the terms of the GNU Free Documentation License, Version 1.3 or 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 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. Texts. A copy of the license is included in the file fdl.txt.
@node Documentation license II
@section Documentation license II @section Documentation license II
@anchor{Documentation license II}
You are free: 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. A copy of the full license is included in the file as cc-by-sa.txt.
@node DEPENDENCIES
@chapter DEPENDENCIES @chapter DEPENDENCIES
@anchor{DEPENDENCIES}
GNU @strong{niceload} uses Perl, and the Perl modules POSIX, and GNU @strong{niceload} uses Perl, and the Perl modules POSIX, and
Getopt::Long. Getopt::Long.
@node SEE ALSO
@chapter SEE ALSO @chapter SEE ALSO
@anchor{SEE ALSO}
@strong{parallel}(1), @strong{nice}(1), @strong{uptime}(1) @strong{parallel}(1), @strong{nice}(1), @strong{uptime}(1)

Binary file not shown.

View file

@ -124,7 +124,7 @@
.\" ======================================================================== .\" ========================================================================
.\" .\"
.IX Title "PARALLEL_TUTORIAL 1" .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 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents. .\" way too many mistakes in technical documents.
.if n .ad l .if n .ad l

Binary file not shown.

Binary file not shown.

View file

@ -8,18 +8,33 @@
@node Top @node Top
@top sem @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 @chapter NAME
@anchor{NAME}
sem - semaphore for executing shell command lines in parallel sem - semaphore for executing shell command lines in parallel
@node SYNOPSIS
@chapter SYNOPSIS @chapter SYNOPSIS
@anchor{SYNOPSIS}
@strong{sem} [--fg] [--id <id>] [--timeout <secs>] [-j <num>] [--wait] command @strong{sem} [--fg] [--id <id>] [--timeout <secs>] [-j <num>] [--wait] command
@node DESCRIPTION
@chapter DESCRIPTION @chapter DESCRIPTION
@anchor{DESCRIPTION}
GNU @strong{sem} is an alias for GNU @strong{parallel --semaphore}. 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 after the list of options. That will give you an idea of what GNU
@strong{sem} is capable of. @strong{sem} is capable of.
@node OPTIONS
@chapter OPTIONS @chapter OPTIONS
@anchor{OPTIONS}
@table @asis @table @asis
@item @emph{command} @item @emph{command}
@ -173,8 +188,8 @@ Wait for all commands to complete.
@end table @end table
@node EXAMPLE: Gzipping *.log
@chapter EXAMPLE: Gzipping *.log @chapter EXAMPLE: Gzipping *.log
@anchor{EXAMPLE: Gzipping *.log}
Run one gzip process per CPU core. Block until a CPU core becomes Run one gzip process per CPU core. Block until a CPU core becomes
available. available.
@ -187,8 +202,8 @@ available.
sem --wait sem --wait
@end verbatim @end verbatim
@node EXAMPLE: Protecting pod2html from itself
@chapter 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 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 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 sem --fg --id pod2html rm -f pod2htmd.tmp pod2htmi.tmp
@end verbatim @end verbatim
@node BUGS
@chapter BUGS @chapter BUGS
@anchor{BUGS}
None known. None known.
@node REPORTING BUGS
@chapter REPORTING BUGS @chapter REPORTING BUGS
@anchor{REPORTING BUGS}
Report bugs to <bug-parallel@@gnu.org>. Report bugs to <bug-parallel@@gnu.org>.
@node AUTHOR
@chapter AUTHOR @chapter AUTHOR
@anchor{AUTHOR}
Copyright (C) 2010,2011,2012,2013 Ole Tange, http://ole.tange.dk and Free Copyright (C) 2010,2011,2012,2013 Ole Tange, http://ole.tange.dk and Free
Software Foundation, Inc. Software Foundation, Inc.
@node LICENSE
@chapter LICENSE @chapter LICENSE
@anchor{LICENSE}
Copyright (C) 2010,2011,2012,2013 Free Software Foundation, Inc. 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 You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. 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 @section Documentation license I
@anchor{Documentation license I}
Permission is granted to copy, distribute and/or modify this documentation Permission is granted to copy, distribute and/or modify this documentation
under the terms of the GNU Free Documentation License, Version 1.3 or 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 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. Texts. A copy of the license is included in the file fdl.txt.
@node Documentation license II
@section Documentation license II @section Documentation license II
@anchor{Documentation license II}
You are free: 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. A copy of the full license is included in the file as cc-by-sa.txt.
@node DEPENDENCIES
@chapter DEPENDENCIES @chapter DEPENDENCIES
@anchor{DEPENDENCIES}
GNU @strong{sem} uses Perl, and the Perl modules Getopt::Long, GNU @strong{sem} uses Perl, and the Perl modules Getopt::Long,
Symbol, Fcntl. Symbol, Fcntl.
@node SEE ALSO
@chapter SEE ALSO @chapter SEE ALSO
@anchor{SEE ALSO}
@strong{parallel}(1) @strong{parallel}(1)

Binary file not shown.