summaryrefslogtreecommitdiffstats
path: root/source/a/dcron/run-parts.8
blob: 74a55492a586367c209b9224c04440ba217b3d30 (plain) (blame)
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
.\" -*- nroff -*-
.ds g \" empty
.ds G \" empty
.\" Like TP, but if specified indent is more than half
.\" the current line-length - indent, use the default indent.
.de Tp
.ie \\n(.$=0:((0\\$1)*2u>(\\n(.lu-\\n(.iu)) .TP
.el .TP "\\$1"
..
.TH RUN-PARTS 8 "05 Aug 2022" "Slackware Version 15.1"
.SH NAME
run-parts \- run scripts found in a directory
.SH SYNOPSIS
.B run-parts [ --list | --test ] <directory>
.LP
.SH DESCRIPTION
.B run-parts
is a utility that will run scripts that are found in a directory.  For example,
it might be useful to create an /etc/cron.daily directory and put scripts in
there for daily cron jobs.  Then
.B run-parts
can be called once a day from root's crontab to run all the scripts found in
/etc/cron.daily:

40 4 * * * run-parts /etc/cron.daily

.B run-parts
automatically skips files with certain suffixes that are generally associated
with backup or extra files.  Any file that ends in one of these will be silently
ignored:  ~ ^ , .bak .new .rpmsave .rpmorig .rpmnew .swp

The execution of files can be allowed or denied by creating file
.B jobs.allow
or
.B jobs.deny
which work similarly to other allow/deny config files. The file must be
created in the specified directory.

Randomization of jobs can be configured in the
.IR /etc/default/run-parts
file. To enable randomization of jobs, set the RANDOMIZE parameter to 1
and set the RANDOM parameter to an integer which determines a random
seed. Additionally, you may configure the RANDOMTIME parameter (again,
by specifying an integer) to provide an additional level of
randomization. Jobs are not randomized when the RANDOM and RANDOMTIME
parameters are set to 0. Values in these two parameters must be set to
1 or larger to provide a good enough randomization.

Randomization of cron jobs can be useful for shared networks, where
multiple cron jobs executed at once can cause spikes in traffic,
especially during daily jobs. With randomized jobs, the workload is
evenly distributed throughout the day.

.TP
.B --list
print names of all files (not limited to executables), but don't run
them. This option can't be used with
.B test
option.
.TP
.B --test
print names of files, which would be run.

.SH EXAMPLE OF CONFIGURATION FILE
.nf
RANDOMIZE=1
RANDOM=4
RANDOMTIME=8
.fi

.SH AUTHOR
Written for Fedora by Marcela Ma■lá■ová, modified slightly for Slackware by
Patrick J. Volkerding <volkerdi@slackware.com>.
.SH "SEE ALSO"
.BR crond(8),
.BR crontab(8).