1 .\" Hey, Emacs! This is an -*- nroff -*- source file.
2 .\" Build-from-directory and this manpage are Copyright 1994 by Ian Jackson.
3 .\" Changes to this manpage are Copyright 1996 by Jeff Noxon.
6 .\" This is free software; see the GNU General Public Licence version 2
7 .\" or later for copying conditions. There is NO warranty.
8 .TH RUN\-PARTS 8 "27 Jun 2012" "Debian"
10 run\-parts \- run scripts or programs in a directory
14 [\-\-test] [\-\-verbose] [\-\-report] [\-\-lsbsysinit] [\-\-regex=RE]
15 [\-\-umask=umask] [\-\-arg=argument] [\-\-exit\-on\-error] [\-\-help]
16 [\-\-version] [\-\-list] [\-\-reverse] [\-\-] DIRECTORY
23 runs all the executable files named within constraints described below, found
26 Other files and directories are silently ignored.
28 If neither the \-\-lsbsysinit option nor the \-\-regex option is given
29 then the names must consist entirely of ASCII upper- and lower-case
30 letters, ASCII digits, ASCII underscores, and ASCII minus-hyphens.
32 If the \-\-lsbsysinit option is given, then the names must not end
33 in rpm backups (.rpmsave, .rpmnew, .rpmorig), and must
34 belong to one or more of the following namespaces: the
35 LANANA-assigned namespace (^[a\-z0\-9]+$); the LSB hierarchical and
36 reserved namespaces (^_?([a\-z0\-9_.]+\-)+[a\-z0\-9]+$);
37 and the Debian cron script namespace (^[a\-zA-Z0\-9_\-]+$).
39 If the \-\-regex option is given, the names must match the custom
40 extended regular expression specified as that option's argument.
42 Files are run in the lexical sort order (according to the C/POSIX
43 locale character collation rules) of their names unless the
44 \-\-reverse option is given, in which case they are run in the
50 print the names of the scripts which would be run, but don't actually run
54 print the names of the all matching files (not limited to executables),
55 but don't actually run them. This option cannot be used with --test.
58 print the name of each script to stderr before running.
63 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.
66 reverse the scripts' execution order.
68 .B \-\-exit\-on\-error
69 exit as soon as a script returns with a non-zero exit code.
72 use LSB namespaces instead of classical behavior.
75 run each script in a separate process session. If you use this option,
76 killing run-parts will not kill the currently running script, it will
80 validate filenames against custom extended regular expression
82 See the EXAMPLES section for an example.
84 .BI "\-u, \-\-umask=" umask
87 before running the scripts.
89 should be specified in octal. By default the umask is set to 022.
91 .BI "\-a, \-\-arg=" argument
96 once for each argument you want passed.
99 specifies that this is the end of the options. Any filename after
101 will be not be interpreted as an option even if it starts with a
105 display usage information and exit.
108 display version and copyright and exit.
112 Print the names of all files in /etc that start with `p' and end with `d':
114 run-parts \-\-list \-\-regex \[aq]^p.*d$\[aq] /etc
118 Copyright (C) 1994 Ian Jackson.
120 Copyright (C) 1996 Jeff Noxon.
122 Copyright (C) 1996, 1997, 1998 Guy Maor
124 Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 Clint Adams
127 is free software; see the GNU General Public License version 2 or
128 later for copying conditions. There is