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
add an example, a script, a trick and tips
examples
Print the names of all files in /etc that start with āpā and end
with ādā:
run-parts --list --regex '^p.*d$' /etc
source
depends run-parts &&
depends fcron
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.
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.