dwww Home | Manual pages | Find package

RUN-PARTS(8)                                                      RUN-PARTS(8)

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  direc-
       tories are silently ignored.

       If neither the --lsbsysinit option nor the --regex option is given then
       the names must consist entirely of upper and lower case  letters,  dig-
       its, underscores, and 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 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  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.

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

Debian                            9 Aug 2009                      RUN-PARTS(8)

Generated by dwww version 1.11.3 on Fri Oct 24 12:15:55 CEST 2014.