summaryrefslogtreecommitdiff
path: root/run-parts.8
blob: 8221146a3a73426ac9970d8a18b84ca8f6f7b227 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
.\" Hey, Emacs!  This is an -*- nroff -*- source file.
.\" Build-from-directory and this manpage are Copyright 1994 by Ian Jackson.
.\" Changes to this manpage are Copyright 1996 by Jeff Noxon.
.\" More
.\"
.\" This is free software; see the GNU General Public Licence version 2
.\" or later for copying conditions.  There is NO warranty.
.TH RUN\-PARTS 8 "9 May 2004" "Debian"
.SH NAME
run\-parts \- run scripts or programs in a directory
.SH SYNOPSIS
.PP
.B run\-parts
[\-\-test] [\-\-verbose] [\-\-report] [\-\-lsbsysinit] [\-\-umask=umask]
[\-\-arg=argument] [\-\-exit\-on\-error] [\-\-help] [\-\-version]
[\-\-list] [\-\-reverse] [\-\-] DIRECTORY
.PP
.B run\-parts
\-V
.SH DESCRIPTION
.PP
.B run\-parts
runs all the executable files named within constraints described below, found
in directory
.IR directory .
Other files and directories are silently ignored.

If the \-\-lsbsysinit option is not given then the names must consist
entirely of upper and lower case letters, digits, 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\-z0\-9][a\-z0\-9\-]*$).      

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.

.SS OPTIONS
.TP
.B \-\-test
print the names of the scripts which would be run, but don't actually run
them.
.TP
.B \-\-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.
.TP
.B \-v, \-\-verbose
print the name of each script to stderr before running.
.TP
.B \-\-report
similar to
.BR \-\-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.
.TP
.B \-\-reverse
reverse the scripts' execution order.
.B
.TP
.B \-\-exit\-on\-error
exit as soon as a script returns with a non-zero exit code.
.TP
.B \-\-lsbsysinit
Use LSB namespaces instead of classical behavior.
.TP
.BI "\-u, \-\-umask=" umask
Sets the umask to
.I umask
before running the scripts.
.I umask
should be specified in octal.  By default the umask is set to 022.
.TP
.BI "\-a, \-\-arg=" argument
Pass
.I argument
to the scripts.  Use
.B --arg
once for each argument you want passed.
.TP
.B "\-\-"
Specifies that this is the end of the options.  Any filename after
.B "\-\-"
will be not be interpreted as an option even if it starts with a
hyphen.
.TP
.B \-h, \-\-help
Display usage information and exit.
.TP
.B \-V, \-\-version
Display version and copyright and exit.

.SH COPYRIGHT
.P
Copyright (C) 1994 Ian Jackson.
.P
Copyright (C) 1996 Jeff Noxon.
.P
Copyright (C) 1996, 1997, 1998 Guy Maor
.P
Copyright (C) 2002, 2003, 2004 Clint Adams

.B run\-parts
is free software; see the GNU General Public License version 2 or
later for copying conditions.  There is
.I no
warranty.