87 lines
2.3 KiB
Groff
87 lines
2.3 KiB
Groff
.TH CRONNEXT 1 "2017-06-11" "cronie" "User Commands"
|
|
.SH NAME
|
|
cronnext \- time of next job cron will execute
|
|
.SH SYNOPSIS
|
|
.TP 9
|
|
.B cronnext
|
|
[\fB-i \fIusers\fR] [\fB-e \fIusers\fR] [\fB-s\fR]
|
|
[\fB-a\fR]
|
|
[\fB-t \fItime\fR] [\fB-q \fItime\fR] [\fB-j \fIcommand\fR]
|
|
[\fB-l\fR] [\fB-c\fR] [\fB-f\fR] [\fB-h\fR] [\fB-V\fR]
|
|
[file]...
|
|
.SH DESCRIPTION
|
|
Determine the time cron will execute the next job. Without arguments, it
|
|
prints that time considering all crontabs, in number of seconds since the
|
|
Epoch, rounded to the minute. This number can be converted into other formats
|
|
using
|
|
.BR date (1),
|
|
like
|
|
.B date --date @43243254
|
|
|
|
The file arguments are optional. If provided,
|
|
.I cronnext
|
|
uses them as crontabs instead of the ones installed in the system.
|
|
.SH OPTIONS
|
|
.TP
|
|
.BI "\-i " user,user,user,...
|
|
Consider only the crontabs of the specified users. Use
|
|
.B *system*
|
|
for the system crontab.
|
|
.TP
|
|
.BI "\-e " user,user,user,...
|
|
Do not consider the crontabs of the specified users.
|
|
.TP
|
|
.B \-s
|
|
Do not consider the system crontab, usually the
|
|
.I /etc/crontab
|
|
file. The system crontab usually contains the hourly, daily, weekly and
|
|
montly crontabs, which might be better dealt with
|
|
.BR anacron (8).
|
|
.TP
|
|
.BI \-a
|
|
Use the crontabs installed in the system in addition to the ones passed as
|
|
file arguments. This is implicit if no file is passed.
|
|
.TP
|
|
.BI "\-t " time
|
|
Determine the next job from this time, instead of now. The time is
|
|
expressed in number of seconds since the Epoch, as obtained for example by
|
|
.BR "date +%s --date \(dqnow + 2 hours\(dq" ,
|
|
and is internally rounded to the minute.
|
|
.TP
|
|
.BI "\-q " time
|
|
Do not check jobs over this time, expressed in the same way as in option
|
|
.BR -t .
|
|
.TP
|
|
.BI "\-j " command
|
|
Only look for jobs that contain \fIcommand\fP as a substring.
|
|
.TP
|
|
.B \-l
|
|
Print the whole entries of the jobs that are the next to be executed by cron.
|
|
The default is to only print their next time of execution.
|
|
.TP
|
|
.B \-c
|
|
Print every entry in every crontab with the next time it is executed.
|
|
.TP
|
|
.B \-f
|
|
Print all jobs that are executed in the given interval. Requires option
|
|
\fB-q\fR.
|
|
.TP
|
|
.B \-h
|
|
Print usage output and exit.
|
|
.TP
|
|
.B \-V
|
|
Print version and exit.
|
|
.SH AUTHOR
|
|
.MT sgerwk@aol.com
|
|
Marco Migliori
|
|
.ME
|
|
.SH SEE ALSO
|
|
.BR cron (8),
|
|
.BR cron (1),
|
|
.BR crontab (5),
|
|
.BR crontab (1),
|
|
.BR anacron (8),
|
|
.BR anacrontab (5),
|
|
.BR atq (1),
|
|
.BR date (1)
|