summaryrefslogtreecommitdiff
path: root/usr/src/man
diff options
context:
space:
mode:
Diffstat (limited to 'usr/src/man')
-rw-r--r--usr/src/man/man1/crontab.158
-rw-r--r--usr/src/man/man3m/Makefile401
2 files changed, 435 insertions, 24 deletions
diff --git a/usr/src/man/man1/crontab.1 b/usr/src/man/man1/crontab.1
index 5a83c44530..c954036653 100644
--- a/usr/src/man/man1/crontab.1
+++ b/usr/src/man/man1/crontab.1
@@ -45,12 +45,12 @@
.\" Copyright (c) 2011, Joyent, Inc. All Rights Reserved
.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
+.\" Copyright 2019 OmniOS Community Edition (OmniOSce) Association.
.\"
-.TH CRONTAB 1 "Mar 6, 2017"
+.TH CRONTAB 1 "Oct 22, 2019"
.SH NAME
crontab \- user crontab file
.SH SYNOPSIS
-.LP
.nf
\fB/usr/bin/crontab\fR [\fIfilename\fR]
.fi
@@ -111,7 +111,6 @@ crontab \- user crontab file
.fi
.SH DESCRIPTION
-.LP
The \fBcrontab\fR utility manages a user's access with \fBcron\fR (see
\fBcron\fR(1M)) by copying, creating, listing, and removing \fBcrontab\fR
files. If invoked without options, \fBcrontab\fR copies the specified file, or
@@ -133,7 +132,6 @@ of interest to system-defined users such as \fBroot\fR. Except where
otherwise explicitly indicated, all variants of the \fBcrontab\fR command
act only on the editable crontab files found in \fB/var/spool/cron/crontabs\fR.
.SS "\fBcrontab\fR Access Control"
-.LP
Users: Access to \fBcrontab\fR is allowed:
.RS +4
.TP
@@ -188,7 +186,6 @@ The rules for \fBallow\fR and \fBdeny\fR apply to \fBroot\fR only if the
.LP
The \fBallow\fR/\fBdeny\fR files consist of one user name per line.
.SS "\fBcrontab\fR Entry Format"
-.LP
A \fBcrontab\fR file consists of lines of six fields each. The fields are
separated by spaces or tabs. The first five are integer patterns that specify
the following:
@@ -208,10 +205,16 @@ day of the week (0\(mi6 with 0=Sunday).
.LP
Each of these patterns can be either an asterisk (meaning all legal values) or
a list of elements separated by commas. An element is either a number or two
-numbers separated by a minus sign (meaning an inclusive range). Time specified
-here is interpreted in the currently active timezone. At the top of the crontab
-file this is the timezone which is set system-wide in /etc/default/init. A user
-can add a line such as:
+numbers separated by a hyphen (meaning an inclusive range).
+.LP
+A range or asterisk can optionally be followed by a step value as
+\fI/<number>\fR. For example, \fI2\(mi59/3\fR can be used in the minutes field
+to specify every three minutes starting at 2 past the hour, or \fI*/2\fR in
+the hours field means every two hours.
+.LP
+Time specified here is interpreted in the currently active timezone. At the top
+of the crontab file this is the timezone which is set system-wide in
+/etc/default/init. A user can add a line such as:
.sp
.in +2
.nf
@@ -278,7 +281,6 @@ environment variables are set to match those that are in effect in the
If you do not redirect the standard output and standard error of your commands,
any generated output or errors are mailed to you.
.SS "\fBcrontab\fR Environment Variables"
-.LP
The following variables are supported:
.sp
.ne 2
@@ -350,7 +352,6 @@ The lines that are not setting these environment variables are the same as
crontab entries that conform to the UNIX standard and are described elsewhere
in this man page.
.SS "Setting \fBcron\fR Jobs Across Timezones"
-.LP
The default timezone of the \fBcron\fR daemon sets the system-wide timezone for
\fBcron\fR entries. This, in turn, is by set by default system-wide using
\fB/etc/default/init\fR.
@@ -360,7 +361,6 @@ If some form of \fBdaylight savings\fR or \fBsummer/winter time\fR is in
effect, then jobs scheduled during the switchover period could be executed
once, twice, or not at all.
.SH OPTIONS
-.LP
The following options are supported:
.sp
.ne 2
@@ -429,7 +429,6 @@ user.
.RE
.SH EXAMPLES
-.LP
\fBExample 1 \fRCleaning up Core Files
.sp
.LP
@@ -490,7 +489,33 @@ example:
would run a command only on Mondays.
.LP
-\fBExample 4 \fRUsing Environment Variables
+\fBExample 4 \fRUsing step values:
+.sp
+.LP
+This example runs a job every hour during the night and every 3 hours during
+working hours.
+
+.sp
+.in +2
+.nf
+\fB0 8-18/3,19-7 * * *\fR
+.fi
+.in -2
+.sp
+
+.LP
+and to run a job every 2 minutes, use:
+
+.sp
+.in +2
+.nf
+\fB*/2 * * * *\fR
+.fi
+.in -2
+.sp
+
+.LP
+\fBExample 5 \fRUsing Environment Variables
.sp
.LP
The following entries take advantage of \fBcrontab\fR support for certain
@@ -521,7 +546,6 @@ Korn shell. The file concludes with \fBTZ\fR, \fBHOME\fR, and \fBSHELL\fR
entries that return those variable to their default values.
.SH ENVIRONMENT VARIABLES
-.LP
See \fBenviron\fR(5) for descriptions of the following environment variables
that affect the execution of \fBcrontab\fR: \fBLANG\fR, \fBLC_ALL\fR,
\fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
@@ -578,7 +602,6 @@ default editor is \fB/usr/xpg6/bin/vi\fR.
.RE
.SH EXIT STATUS
-.LP
The following exit values are returned:
.sp
.ne 2
@@ -662,7 +685,6 @@ spool area for \fBcrontab\fR
.RE
.SH ATTRIBUTES
-.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.SS "\fB/usr/bin/crontab\fR"
@@ -698,12 +720,10 @@ Interface Stability Standard
.TE
.SH SEE ALSO
-.LP
\fBatq\fR(1), \fBatrm\fR(1), \fBauths\fR(1), \fBed\fR(1), \fBsh\fR(1),
\fBvi\fR(1), \fBcron\fR(1M), \fBsu\fR(1M), \fBauth_attr\fR(4),
\fBattributes\fR(5), \fBenviron\fR(5), \fBstandards\fR(5)
.SH NOTES
-.LP
If you inadvertently enter the \fBcrontab\fR command with no arguments, do not
attempt to get out with Control-d. This removes all entries in your
\fBcrontab\fR file. Instead, exit with Control-c.
diff --git a/usr/src/man/man3m/Makefile b/usr/src/man/man3m/Makefile
index e1eae9138d..ccc8660142 100644
--- a/usr/src/man/man3m/Makefile
+++ b/usr/src/man/man3m/Makefile
@@ -124,20 +124,411 @@ MANFILES = acos.3m \
trunc.3m \
y0.3m
-MANLINKS= fesetenv.3m \
+MANLINKS = acosf.3m \
+ acoshf.3m \
+ acoshl.3m \
+ acosl.3m \
+ asinf.3m \
+ asinhf.3m \
+ asinhl.3m \
+ asinl.3m \
+ atan2f.3m \
+ atan2l.3m \
+ atanf.3m \
+ atanhf.3m \
+ atanhl.3m \
+ atanl.3m \
+ cabsf.3m \
+ cabsl.3m \
+ cacosf.3m \
+ cacoshf.3m \
+ cacoshl.3m \
+ cacosl.3m \
+ cargf.3m \
+ cargl.3m \
+ casinf.3m \
+ casinhf.3m \
+ casinhl.3m \
+ casinl.3m \
+ catanf.3m \
+ catanhf.3m \
+ catanhl.3m \
+ catanl.3m \
+ cbrtf.3m \
+ cbrtl.3m \
+ ccosf.3m \
+ ccoshf.3m \
+ ccoshl.3m \
+ ccosl.3m \
+ ceilf.3m \
+ ceill.3m \
+ cexpf.3m \
+ cexpl.3m \
+ cimagf.3m \
+ cimagl.3m \
+ clogf.3m \
+ clogl.3m \
+ conjf.3m \
+ conjl.3m \
+ copysignf.3m \
+ copysignl.3m \
+ cosf.3m \
+ coshf.3m \
+ coshl.3m \
+ cosl.3m \
+ cpowf.3m \
+ cpowl.3m \
+ cprojf.3m \
+ cprojl.3m \
+ crealf.3m \
+ creall.3m \
+ csinf.3m \
+ csinhf.3m \
+ csinhl.3m \
+ csinl.3m \
+ csqrtf.3m \
+ csqrtl.3m \
+ ctanf.3m \
+ ctanhf.3m \
+ ctanhl.3m \
+ ctanl.3m \
+ erfcf.3m \
+ erfcl.3m \
+ erff.3m \
+ erfl.3m \
+ exp2f.3m \
+ exp2l.3m \
+ expf.3m \
+ expl.3m \
+ expm1f.3m \
+ expm1l.3m \
+ fabsf.3m \
+ fabsl.3m \
+ fdimf.3m \
+ fdiml.3m \
+ fegetprec.3m \
+ fesetenv.3m \
fesetexceptflag.3m \
fesetround.3m \
+ fex_get_handling.3m \
+ fex_get_log.3m \
+ fex_get_log_depth.3m \
+ fex_getexcepthandler.3m \
+ fex_log_entry.3m \
+ fex_set_log_depth.3m \
+ fex_setexcepthandler.3m \
+ floorf.3m \
+ floorl.3m \
+ fmaf.3m \
+ fmal.3m \
+ fmaxf.3m \
+ fmaxl.3m \
+ fminf.3m \
+ fminl.3m \
+ fmodf.3m \
+ fmodl.3m \
+ frexpf.3m \
+ frexpl.3m \
+ gamma.3m \
+ gamma_r.3m \
+ gammaf.3m \
+ gammaf_r.3m \
+ gammal.3m \
+ gammal_r.3m \
+ hypotf.3m \
+ hypotl.3m \
+ ilogbf.3m \
+ ilogbl.3m \
+ j0f.3m \
+ j0l.3m \
+ j1.3m \
+ j1f.3m \
+ j1l.3m \
+ jn.3m \
+ jnf.3m \
+ jnl.3m \
+ ldexpf.3m \
+ ldexpl.3m \
+ lgamma_r.3m \
+ lgammaf.3m \
+ lgammaf_r.3m \
+ lgammal.3m \
+ lgammal_r.3m \
+ llrintf.3m \
+ llrintl.3m \
+ llroundf.3m \
+ llroundl.3m \
+ log10f.3m \
+ log10l.3m \
+ log1pf.3m \
+ log1pl.3m \
+ log2f.3m \
+ log2l.3m \
+ logbf.3m \
+ logbl.3m \
+ logf.3m \
+ logl.3m \
+ lrintf.3m \
+ lrintl.3m \
+ lroundf.3m \
+ lroundl.3m \
+ modff.3m \
+ modfl.3m \
nanf.3m \
- nanl.3m
+ nanl.3m \
+ nearbyintf.3m \
+ nearbyintl.3m \
+ nextafterf.3m \
+ nextafterl.3m \
+ nexttoward.3m \
+ nexttowardf.3m \
+ nexttowardl.3m \
+ powf.3m \
+ powl.3m \
+ remainderf.3m \
+ remainderl.3m \
+ remquof.3m \
+ remquol.3m \
+ rintf.3m \
+ rintl.3m \
+ roundf.3m \
+ roundl.3m \
+ scalbf.3m \
+ scalbl.3m \
+ scalblnf.3m \
+ scalblnl.3m \
+ scalbn.3m \
+ scalbnf.3m \
+ scalbnl.3m \
+ significandf.3m \
+ significandl.3m \
+ sincosf.3m \
+ sincosl.3m \
+ sinf.3m \
+ sinhf.3m \
+ sinhl.3m \
+ sinl.3m \
+ sqrtf.3m \
+ sqrtl.3m \
+ tanf.3m \
+ tanhf.3m \
+ tanhl.3m \
+ tanl.3m \
+ tgammaf.3m \
+ tgammal.3m \
+ truncf.3m \
+ truncl.3m \
+ y0f.3m \
+ y0l.3m \
+ y1.3m \
+ y1f.3m \
+ y1l.3m \
+ yn.3m \
+ ynf.3m \
+ ynl.3m
+acosf.3m := LINKSRC = acos.3m
+acoshf.3m := LINKSRC = acosh.3m
+acoshl.3m := LINKSRC = acosh.3m
+acosl.3m := LINKSRC = acos.3m
+asinf.3m := LINKSRC = asin.3m
+asinhf.3m := LINKSRC = asinh.3m
+asinhl.3m := LINKSRC = asinh.3m
+asinl.3m := LINKSRC = asin.3m
+atan2f.3m := LINKSRC = atan2.3m
+atan2l.3m := LINKSRC = atan2.3m
+atanf.3m := LINKSRC = atan.3m
+atanhf.3m := LINKSRC = atanh.3m
+atanhl.3m := LINKSRC = atanh.3m
+atanl.3m := LINKSRC = atan.3m
+cabsf.3m := LINKSRC = cabs.3m
+cabsl.3m := LINKSRC = cabs.3m
+cacosf.3m := LINKSRC = cacos.3m
+cacoshf.3m := LINKSRC = cacosh.3m
+cacoshl.3m := LINKSRC = cacosh.3m
+cacosl.3m := LINKSRC = cacos.3m
+cargf.3m := LINKSRC = carg.3m
+cargl.3m := LINKSRC = carg.3m
+casinf.3m := LINKSRC = casin.3m
+casinhf.3m := LINKSRC = casinh.3m
+casinhl.3m := LINKSRC = casinh.3m
+casinl.3m := LINKSRC = casin.3m
+catanf.3m := LINKSRC = catan.3m
+catanhf.3m := LINKSRC = catanh.3m
+catanhl.3m := LINKSRC = catanh.3m
+catanl.3m := LINKSRC = catan.3m
+cbrtf.3m := LINKSRC = cbrt.3m
+cbrtl.3m := LINKSRC = cbrt.3m
+ccosf.3m := LINKSRC = ccos.3m
+ccoshf.3m := LINKSRC = ccosh.3m
+ccoshl.3m := LINKSRC = ccosh.3m
+ccosl.3m := LINKSRC = ccos.3m
+ceilf.3m := LINKSRC = ceil.3m
+ceill.3m := LINKSRC = ceil.3m
+cexpf.3m := LINKSRC = cexp.3m
+cexpl.3m := LINKSRC = cexp.3m
+cimagf.3m := LINKSRC = cimag.3m
+cimagl.3m := LINKSRC = cimag.3m
+clogf.3m := LINKSRC = clog.3m
+clogl.3m := LINKSRC = clog.3m
+conjf.3m := LINKSRC = conj.3m
+conjl.3m := LINKSRC = conj.3m
+copysignf.3m := LINKSRC = copysign.3m
+copysignl.3m := LINKSRC = copysign.3m
+cosf.3m := LINKSRC = cos.3m
+coshf.3m := LINKSRC = cosh.3m
+coshl.3m := LINKSRC = cosh.3m
+cosl.3m := LINKSRC = cos.3m
+cpowf.3m := LINKSRC = cpow.3m
+cpowl.3m := LINKSRC = cpow.3m
+cprojf.3m := LINKSRC = cproj.3m
+cprojl.3m := LINKSRC = cproj.3m
+crealf.3m := LINKSRC = creal.3m
+creall.3m := LINKSRC = creal.3m
+csinf.3m := LINKSRC = csin.3m
+csinhf.3m := LINKSRC = csinh.3m
+csinhl.3m := LINKSRC = csinh.3m
+csinl.3m := LINKSRC = csin.3m
+csqrtf.3m := LINKSRC = csqrt.3m
+csqrtl.3m := LINKSRC = csqrt.3m
+ctanf.3m := LINKSRC = ctan.3m
+ctanhf.3m := LINKSRC = ctanh.3m
+ctanhl.3m := LINKSRC = ctanh.3m
+ctanl.3m := LINKSRC = ctan.3m
+erfcf.3m := LINKSRC = erfc.3m
+erfcl.3m := LINKSRC = erfc.3m
+erff.3m := LINKSRC = erf.3m
+erfl.3m := LINKSRC = erf.3m
+exp2f.3m := LINKSRC = exp2.3m
+exp2l.3m := LINKSRC = exp2.3m
+expf.3m := LINKSRC = exp.3m
+expl.3m := LINKSRC = exp.3m
+expm1f.3m := LINKSRC = expm1.3m
+expm1l.3m := LINKSRC = expm1.3m
+fabsf.3m := LINKSRC = fabs.3m
+fabsl.3m := LINKSRC = fabs.3m
+fdimf.3m := LINKSRC = fdim.3m
+fdiml.3m := LINKSRC = fdim.3m
+fegetprec.3m := LINKSRC = fesetprec.3m
fesetenv.3m := LINKSRC = fegetenv.3m
-
fesetexceptflag.3m := LINKSRC = fegetexceptflag.3m
-
fesetround.3m := LINKSRC = fegetround.3m
-
+fex_get_handling.3m := LINKSRC = fex_set_handling.3m
+fex_get_log.3m := LINKSRC = fex_set_log.3m
+fex_get_log_depth.3m := LINKSRC = fex_set_log.3m
+fex_getexcepthandler.3m := LINKSRC = fex_set_handling.3m
+fex_log_entry.3m := LINKSRC = fex_set_log.3m
+fex_set_log_depth.3m := LINKSRC = fex_set_log.3m
+fex_setexcepthandler.3m := LINKSRC = fex_set_handling.3m
+floorf.3m := LINKSRC = floor.3m
+floorl.3m := LINKSRC = floor.3m
+fmaf.3m := LINKSRC = fma.3m
+fmal.3m := LINKSRC = fma.3m
+fmaxf.3m := LINKSRC = fmax.3m
+fmaxl.3m := LINKSRC = fmax.3m
+fminf.3m := LINKSRC = fmin.3m
+fminl.3m := LINKSRC = fmin.3m
+fmodf.3m := LINKSRC = fmod.3m
+fmodl.3m := LINKSRC = fmod.3m
+frexpf.3m := LINKSRC = frexp.3m
+frexpl.3m := LINKSRC = frexp.3m
+gamma.3m := LINKSRC = lgamma.3m
+gamma_r.3m := LINKSRC = lgamma.3m
+gammaf.3m := LINKSRC = lgamma.3m
+gammaf_r.3m := LINKSRC = lgamma.3m
+gammal.3m := LINKSRC = lgamma.3m
+gammal_r.3m := LINKSRC = lgamma.3m
+hypotf.3m := LINKSRC = hypot.3m
+hypotl.3m := LINKSRC = hypot.3m
+ilogbf.3m := LINKSRC = ilogb.3m
+ilogbl.3m := LINKSRC = ilogb.3m
+j0f.3m := LINKSRC = j0.3m
+j0l.3m := LINKSRC = j0.3m
+j1.3m := LINKSRC = j0.3m
+j1f.3m := LINKSRC = j0.3m
+j1l.3m := LINKSRC = j0.3m
+jn.3m := LINKSRC = j0.3m
+jnf.3m := LINKSRC = j0.3m
+jnl.3m := LINKSRC = j0.3m
+ldexpf.3m := LINKSRC = ldexp.3m
+ldexpl.3m := LINKSRC = ldexp.3m
+lgamma_r.3m := LINKSRC = lgamma.3m
+lgammaf.3m := LINKSRC = lgamma.3m
+lgammaf_r.3m := LINKSRC = lgamma.3m
+lgammal.3m := LINKSRC = lgamma.3m
+lgammal_r.3m := LINKSRC = lgamma.3m
+llrintf.3m := LINKSRC = llrint.3m
+llrintl.3m := LINKSRC = llrint.3m
+llroundf.3m := LINKSRC = llround.3m
+llroundl.3m := LINKSRC = llround.3m
+log10f.3m := LINKSRC = log10.3m
+log10l.3m := LINKSRC = log10.3m
+log1pf.3m := LINKSRC = log1p.3m
+log1pl.3m := LINKSRC = log1p.3m
+log2f.3m := LINKSRC = log2.3m
+log2l.3m := LINKSRC = log2.3m
+logbf.3m := LINKSRC = logb.3m
+logbl.3m := LINKSRC = logb.3m
+logf.3m := LINKSRC = log.3m
+logl.3m := LINKSRC = log.3m
+lrintf.3m := LINKSRC = lrint.3m
+lrintl.3m := LINKSRC = lrint.3m
+lroundf.3m := LINKSRC = lround.3m
+lroundl.3m := LINKSRC = lround.3m
+modff.3m := LINKSRC = modf.3m
+modfl.3m := LINKSRC = modf.3m
nanf.3m := LINKSRC = nan.3m
nanl.3m := LINKSRC = nan.3m
+nearbyintf.3m := LINKSRC = nearbyint.3m
+nearbyintl.3m := LINKSRC = nearbyint.3m
+nextafterf.3m := LINKSRC = nextafter.3m
+nextafterl.3m := LINKSRC = nextafter.3m
+nexttoward.3m := LINKSRC = nextafter.3m
+nexttowardf.3m := LINKSRC = nextafter.3m
+nexttowardl.3m := LINKSRC = nextafter.3m
+powf.3m := LINKSRC = pow.3m
+powl.3m := LINKSRC = pow.3m
+remainderf.3m := LINKSRC = remainder.3m
+remainderl.3m := LINKSRC = remainder.3m
+remquof.3m := LINKSRC = remquo.3m
+remquol.3m := LINKSRC = remquo.3m
+rintf.3m := LINKSRC = rint.3m
+rintl.3m := LINKSRC = rint.3m
+roundf.3m := LINKSRC = round.3m
+roundl.3m := LINKSRC = round.3m
+scalbf.3m := LINKSRC = scalb.3m
+scalbl.3m := LINKSRC = scalb.3m
+scalblnf.3m := LINKSRC = scalbln.3m
+scalblnl.3m := LINKSRC = scalbln.3m
+scalbn.3m := LINKSRC = scalbln.3m
+scalbnf.3m := LINKSRC = scalbln.3m
+scalbnl.3m := LINKSRC = scalbln.3m
+significandf.3m := LINKSRC = significand.3m
+significandl.3m := LINKSRC = significand.3m
+sincosf.3m := LINKSRC = sincos.3m
+sincosl.3m := LINKSRC = sincos.3m
+sinf.3m := LINKSRC = sin.3m
+sinhf.3m := LINKSRC = sinh.3m
+sinhl.3m := LINKSRC = sinh.3m
+sinl.3m := LINKSRC = sin.3m
+sqrtf.3m := LINKSRC = sqrt.3m
+sqrtl.3m := LINKSRC = sqrt.3m
+tanf.3m := LINKSRC = tan.3m
+tanhf.3m := LINKSRC = tanh.3m
+tanhl.3m := LINKSRC = tanh.3m
+tanl.3m := LINKSRC = tan.3m
+tgammaf.3m := LINKSRC = tgamma.3m
+tgammal.3m := LINKSRC = tgamma.3m
+truncf.3m := LINKSRC = trunc.3m
+truncl.3m := LINKSRC = trunc.3m
+y0f.3m := LINKSRC = y0.3m
+y0l.3m := LINKSRC = y0.3m
+y1.3m := LINKSRC = y0.3m
+y1f.3m := LINKSRC = y0.3m
+y1l.3m := LINKSRC = y0.3m
+yn.3m := LINKSRC = y0.3m
+ynf.3m := LINKSRC = y0.3m
+ynl.3m := LINKSRC = y0.3m
.KEEP_STATE:
generated by cgit v1.2.3 (git 2.39.1) at 2024-11-27 08:19:28 +0000