203 lines
4.7 KiB
HTML
203 lines
4.7 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of RUN-PARTS</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>RUN-PARTS</H1>
|
|
Section: Maintenance Commands (8)<BR>Updated: 27 Jun 2012<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
run-parts - run scripts or programs in a directory
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<P>
|
|
|
|
<B>run-parts</B>
|
|
|
|
[--test] [--verbose] [--report] [--lsbsysinit] [--regex=RE]
|
|
[--umask=umask] [--arg=argument] [--exit-on-error] [--help]
|
|
[--version] [--list] [--reverse] [--] DIRECTORY
|
|
<P>
|
|
|
|
<B>run-parts</B>
|
|
|
|
-V
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
<B>run-parts</B>
|
|
|
|
runs all the executable files named within constraints described below, found
|
|
in directory
|
|
<I>directory</I>.
|
|
|
|
Other files and directories are silently ignored.
|
|
<P>
|
|
If neither the --lsbsysinit option nor the --regex option is given
|
|
then the names must consist entirely of ASCII upper- and lower-case
|
|
letters, ASCII digits, ASCII underscores, and ASCII minus-hyphens.
|
|
<P>
|
|
If the --lsbsysinit option is given, then the names must not end
|
|
in .dpkg-old or .dpkg-dist or .dpkg-new or .dpkg-tmp, and must
|
|
belong to one or more of the following namespaces: the
|
|
LANANA-assigned namespace (^[a-z0-9]+$); the LSB hierarchical and
|
|
reserved namespaces (^_?([a-z0-9_.]+-)+[a-z0-9]+$);
|
|
and the Debian cron script namespace (^[a-zA-Z0-9_-]+$).
|
|
<P>
|
|
If the --regex option is given, the names must match the custom
|
|
extended regular expression specified as that option's argument.
|
|
<P>
|
|
Files are run in the lexical sort order (according to the C/POSIX
|
|
locale character collation rules) of their names unless the
|
|
--reverse option is given, in which case they are run in the
|
|
opposite order.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><B>--test</B>
|
|
|
|
<DD>
|
|
print the names of the scripts which would be run, but don't actually run
|
|
them.
|
|
<DT id="2"><B>--list</B>
|
|
|
|
<DD>
|
|
print the names of the all matching files (not limited to executables),
|
|
but don't actually run them.
|
|
This option cannot be used with --test.
|
|
<DT id="3"><B>-v, --verbose</B>
|
|
|
|
<DD>
|
|
print the name of each script to stderr before running.
|
|
<DT id="4"><B>--report</B>
|
|
|
|
<DD>
|
|
similar to
|
|
<B>--verbose</B>,
|
|
|
|
but only prints the name of scripts which produce output.
|
|
The script's name is printed to whichever of stdout or stderr the
|
|
script first produces output on.
|
|
<DT id="5"><B>--reverse</B>
|
|
|
|
<DD>
|
|
reverse the scripts' execution order.
|
|
<DT id="6"><B>--exit-on-error</B>
|
|
|
|
<DD>
|
|
exit as soon as a script returns with a non-zero exit code.
|
|
<DT id="7"><B>--lsbsysinit</B>
|
|
|
|
<DD>
|
|
use LSB namespaces instead of classical behavior.
|
|
<DT id="8"><B>--new-session</B>
|
|
|
|
<DD>
|
|
run each script in a separate process session. If you use this option,
|
|
killing run-parts will not kill the currently running script, it will
|
|
run until completion.
|
|
<DT id="9"><B>--regex=</B><I>RE</I>
|
|
|
|
<DD>
|
|
validate filenames against custom extended regular expression
|
|
<I>RE</I>.
|
|
|
|
See the EXAMPLES section for an example.
|
|
<DT id="10"><B>-u, --umask=</B><I>umask</I>
|
|
|
|
<DD>
|
|
sets the umask to
|
|
<I>umask</I>
|
|
|
|
before running the scripts.
|
|
<I>umask</I>
|
|
|
|
should be specified in octal. By default the umask is set to 022.
|
|
<DT id="11"><B>-a, --arg=</B><I>argument</I>
|
|
|
|
<DD>
|
|
pass
|
|
<I>argument</I>
|
|
|
|
to the scripts. Use
|
|
<B>--arg</B>
|
|
|
|
once for each argument you want passed.
|
|
<DT id="12"><B>--</B>
|
|
|
|
<DD>
|
|
specifies that this is the end of the options. Any filename after
|
|
<B>--</B>
|
|
|
|
will be not be interpreted as an option even if it starts with a
|
|
hyphen.
|
|
<DT id="13"><B>-h, --help</B>
|
|
|
|
<DD>
|
|
display usage information and exit.
|
|
<DT id="14"><B>-V, --version</B>
|
|
|
|
<DD>
|
|
display version and copyright and exit.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>EXAMPLES</H2>
|
|
|
|
<P>
|
|
|
|
Print the names of all files in /etc that start with `p' and end with `d':
|
|
<P>
|
|
|
|
run-parts --list --regex '^p.*d$' /etc
|
|
<P>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>COPYRIGHT</H2>
|
|
|
|
<P>
|
|
|
|
Copyright (C) 1994 Ian Jackson.
|
|
<P>
|
|
|
|
Copyright (C) 1996 Jeff Noxon.
|
|
<P>
|
|
|
|
Copyright (C) 1996, 1997, 1998 Guy Maor
|
|
<P>
|
|
|
|
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Clint Adams
|
|
<P>
|
|
<B>run-parts</B>
|
|
|
|
is free software; see the GNU General Public License version 2 or
|
|
later for copying conditions. There is
|
|
<I>no</I>
|
|
|
|
warranty.
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="15"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="16"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="17"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="18"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="19"><A HREF="#lbAF">EXAMPLES</A><DD>
|
|
<DT id="20"><A HREF="#lbAG">COPYRIGHT</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:15 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|