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

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.

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

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.