Debian Codegraph @

upstream/mageia-cauldron/man1/cronnext.1

raw
1 .TH CRONNEXT 1 "2017-06-11" "cronie" "User Commands"
2 .SH NAME
3 cronnext \- time of next job cron will execute
4 .SH SYNOPSIS
5 .TP 9
6 .B cronnext
7 [\fB-i \fIusers\fR] [\fB-e \fIusers\fR] [\fB-s\fR]
8 [\fB-a\fR]
9 [\fB-t \fItime\fR] [\fB-q \fItime\fR] [\fB-j \fIcommand\fR]
10 [\fB-l\fR] [\fB-c\fR] [\fB-f\fR] [\fB-h\fR] [\fB-V\fR]
11 [file]...
12 .SH DESCRIPTION
13 Determine the time cron will execute the next job. Without arguments, it
14 prints that time considering all crontabs, in number of seconds since the
15 Epoch, rounded to the minute. This number can be converted into other formats
16 using
17 .BR date (1),
18 like
19 .B date --date @43243254
20
21 The file arguments are optional. If provided,
22 .I cronnext
23 uses them as crontabs instead of the ones installed in the system.
24 .SH OPTIONS
25 .TP
26 .BI "\-i " user,user,user,...
27 Consider only the crontabs of the specified users. Use
28 .B *system*
29 for the system crontab.
30 .TP
31 .BI "\-e " user,user,user,...
32 Do not consider the crontabs of the specified users.
33 .TP
34 .B \-s
35 Do not consider the system crontab, usually the
36 .I /etc/crontab
37 file. The system crontab usually contains the hourly, daily, weekly and
38 monthly crontabs, which might be better dealt with
39 .BR anacron (8).
40 .TP
41 .BI \-a
42 Use the crontabs installed in the system in addition to the ones passed as
43 file arguments. This is implicit if no file is passed.
44 .TP
45 .BI "\-t " time
46 Determine the next job from this time, instead of now. The time is
47 expressed in number of seconds since the Epoch, as obtained for example by
48 .BR "date +%s --date \(dqnow + 2 hours\(dq" ,
49 and is internally rounded to the minute.
50 .TP
51 .BI "\-q " time
52 Do not check jobs over this time, expressed in the same way as in option
53 .BR -t .
54 .TP
55 .BI "\-j " command
56 Only look for jobs that contain \fIcommand\fP as a substring.
57 .TP
58 .B \-l
59 Print the whole entries of the jobs that are the next to be executed by cron.
60 The default is to only print their next time of execution.
61 .TP
62 .B \-c
63 Print every entry in every crontab with the next time it is executed.
64 .TP
65 .B \-f
66 Print all jobs that are executed in the given interval. Requires option
67 \fB-q\fR.
68 .TP
69 .B \-h
70 Print usage output and exit.
71 .TP
72 .B \-V
73 Print version and exit.
74 .SH AUTHOR
75 .MT [email protected]
76 Marco Migliori
77 .ME
78 .SH SEE ALSO
79 .BR cron (8),
80 .BR cron (1),
81 .BR crontab (5),
82 .BR crontab (1),
83 .BR anacron (8),
84 .BR anacrontab (5),
85 .BR atq (1),
86 .BR date (1)