RUN-PARTS(8) System Manager's Manual RUN-PARTS(8)
NAME
run-parts - run scripts or programs in a directory
SYNOPSIS
run-parts [--test] [--verbose] [--debug] [--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 de-
scribed below, found in directory directory. Other files and directo-
ries 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 ex-
tended 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.
OPTIONS
--test print the names of the scripts which would be run, but don't ac-
tually run them.
--list print the names of the all matching files (not limited to exe-
cutables), 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 af-
ter -- 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
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.
Debian 27 Jun 2012 RUN-PARTS(8)
Generated by dwww version 1.15 on Wed Jun 26 05:50:19 CEST 2024.