run-parts - run scripts or programs in a directory
run-parts [--test] [--verbose] [--debug] [--report] [--lsbsysinit]
[--regex=RE] [--umask=umask] [--arg=argument] [--exit-on-error] [--help]
[--version] [--list] [--reverse] [--] DIRECTORY
run-parts -V
run-parts runs all the executable files named within constraints
described below, found in directory
directory. Other files and
directories are silently ignored.
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.
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_-]+$).
If the --regex option is given, the names must match the custom extended regular
expression specified as that option's argument.
Files are run sequentially 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.
- --test
- print the names of the scripts which would be run, but
don't actually run them.
- --list
- 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.
- -v, --verbose
- print the name of each script to stderr before
running.
- --report
- similar to --verbose, 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.
- -d, --debug
- print to stderr which scripts get selected for running and
which don't.
- --reverse
- reverse the scripts' execution order.
- --exit-on-error
- exit as soon as a script returns with a non-zero exit
code.
- --lsbsysinit
- use LSB namespaces instead of classical behavior.
- --new-session
- 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.
-
--regex=RE
- validate filenames against custom extended regular
expression RE. See the EXAMPLES section for an example.
-
-u, --umask=umask
- sets the umask to umask before running the scripts.
umask should be specified in octal. By default the umask is set to
022.
-
-a, --arg=argument
- pass argument to the scripts. Use --arg once
for each argument you want passed.
- --
- specifies that this is the end of the options. Any filename
after -- will be not be interpreted as an option even if it starts
with a hyphen.
- -h, --help
- display usage information and exit.
- -V, --version
- display version and copyright and exit.
Print the names of all files in /etc that start with `p' and end with `d':
run-parts --list --regex '^p.*d$' /etc
Copyright (C) 1994 Ian Jackson.
Copyright (C) 1996 Jeff Noxon.
Copyright (C) 1996, 1997, 1998 Guy Maor
Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Clint Adams
run-parts is free software; see the GNU General Public License version 2
or later for copying conditions. There is
no warranty.