RUN\-PARTS

Section: Maintenance Commands (8)
Updated: 27 Jun 2012
Page Index

NAME

run-parts - run scripts or programs in a directory

SYNOPSIS

run-parts [--test] [--verbose] [--report] [--lsbsysinit] [--regex=RE] [--umask=umask] [--arg=argument] [--exit-on-error] [--help] [--version] [--list] [--reverse] [--] DIRECTORY

run-parts -V

DESCRIPTION

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 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.

OPTIONS

--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.
--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.

EXAMPLES

Print the names of all files in /etc that start with `p' and end with `d':

run-parts --list --regex '^p.*d$' /etc

COPYRIGHT

run-parts is free software; see the GNU General Public License version 2 or later for copying conditions. There is no warranty.