diff options
Diffstat (limited to 'usr/src/man/man1/crontab.1')
| -rw-r--r-- | usr/src/man/man1/crontab.1 | 90 |
1 files changed, 45 insertions, 45 deletions
diff --git a/usr/src/man/man1/crontab.1 b/usr/src/man/man1/crontab.1 index c954036653..d48b995045 100644 --- a/usr/src/man/man1/crontab.1 +++ b/usr/src/man/man1/crontab.1 @@ -45,29 +45,24 @@ .\" 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. +.\" Copyright 2020 OmniOS Community Edition (OmniOSce) Association. .\" -.TH CRONTAB 1 "Oct 22, 2019" +.TH CRONTAB 1 "Aug 20, 2020" .SH NAME crontab \- user crontab file .SH SYNOPSIS .nf -\fB/usr/bin/crontab\fR [\fIfilename\fR] +\fB/usr/bin/crontab\fR [\fB-u\fR \fIusername\fR] [\fIfilename\fR] .fi .LP .nf -\fB/usr/bin/crontab\fR \fB-e\fR [\fIusername\fR] +\fB/usr/bin/crontab\fR \fB{ -e | -l | -r }\fR [\fIusername\fR] .fi .LP .nf -\fB/usr/bin/crontab\fR \fB-l\fR [\fB-g\fR] [\fIusername\fR] -.fi - -.LP -.nf -\fB/usr/bin/crontab\fR \fB-r\fR [\fIusername\fR] +\fB/usr/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -g | -l | -r }\fR .fi .LP @@ -77,17 +72,12 @@ crontab \- user crontab file .LP .nf -\fB/usr/xpg4/bin/crontab\fR \fB-e\fR [\fIusername\fR] +\fB/usr/xpg4/bin/crontab\fR \fB{ -e | -g | -l | -r }\fR [\fIusername\fR] .fi .LP .nf -\fB/usr/xpg4/bin/crontab\fR \fB-l\fR [\fB-g\fR] [\fIusername\fR] -.fi - -.LP -.nf -\fB/usr/xpg4/bin/crontab\fR \fB-r\fR [\fIusername\fR] +\fB/usr/xpg4/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -l | -r }\fR .fi .LP @@ -97,17 +87,12 @@ crontab \- user crontab file .LP .nf -\fB/usr/xpg6/bin/crontab\fR \fB-e\fR [\fIusername\fR] -.fi - -.LP -.nf -\fB/usr/xpg6/bin/crontab\fR \fB-l\fR [\fB-g\fR] [\fIusername\fR] +\fB/usr/xpg6/bin/crontab\fR \fB{ -e | -g | -l | -r }\fR [\fIusername\fR] .fi .LP .nf -\fB/usr/xpg6/bin/crontab\fR \fB-r\fR [\fIusername\fR] +\fB/usr/xpg6/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -l | -r }\fR .fi .SH DESCRIPTION @@ -119,7 +104,8 @@ users' crontabs. .sp .LP If \fBcrontab\fR is invoked with \fIfilename\fR, this overwrites an existing -\fBcrontab\fR entry for the user that invokes it. +\fBcrontab\fR entry for the user that invokes it, or for the user specified +with the \fB-u\fR option. .sp .LP Cron supports a merged crontab with entries coming from either the user's @@ -131,6 +117,8 @@ be customized by the user. The dual set of crontab entries is only 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. +.sp +.LP .SS "\fBcrontab\fR Access Control" Users: Access to \fBcrontab\fR is allowed: .RS +4 @@ -285,11 +273,11 @@ The following variables are supported: .sp .ne 2 .na -\fB\fBHOME\fR\fR +\fBHOME\fR .ad .sp .6 .RS 4n -Allows the user to choose and alternative directory for cron to change +Allows the user to choose an alternative directory for cron to change directory to prior to running the command. For example: .sp .in +2 @@ -304,7 +292,7 @@ HOME=/var/tmp .sp .ne 2 .na -\fB\fBSHELL\fR\fR +\fBSHELL\fR .ad .sp .6 .RS 4n @@ -322,7 +310,7 @@ SHELL=/usr/bin/ksh .sp .ne 2 .na -\fB\fBTZ\fR\fR +\fBTZ\fR .ad .sp .6 .RS 4n @@ -365,7 +353,7 @@ The following options are supported: .sp .ne 2 .na -\fB\fB-e\fR\fR +\fB-e\fR .ad .RS 6n Edits a copy of the current user's \fBcrontab\fR file, or creates an empty file @@ -392,7 +380,7 @@ editable. .sp .ne 2 .na -\fB\fB-l\fR\fR +\fB-l\fR .ad .RS 6n Lists the \fBcrontab\fR file for the invoking user. Only root or a user with @@ -419,7 +407,7 @@ also given. .sp .ne 2 .na -\fB\fB-r\fR\fR +\fB-r\fR .ad .RS 6n Removes a user's \fBcrontab\fR from the \fBcrontab\fR directory. Only root or a @@ -428,6 +416,18 @@ following the \fB-r\fR option to remove the \fBcrontab\fR file of the specified user. .RE +.sp +.ne 2 +.na +\fB-u\fR \fIusername\fR +.ad +.RS 6n +Specifies the name of the user whose \fBcrontab\fR is to be replaced, viewed or +modified. This can only be done by root or by a user with the +\fBsolaris.jobs.admin\fR authorization. + +.RE + .SH EXAMPLES \fBExample 1 \fRCleaning up Core Files .sp @@ -552,7 +552,7 @@ that affect the execution of \fBcrontab\fR: \fBLANG\fR, \fBLC_ALL\fR, .SS "\fB/usr/bin/crontab\fR" .ne 2 .na -\fB\fBEDITOR\fR\fR +\fBEDITOR\fR .ad .RS 10n Determine the editor to be invoked when the \fB-e\fR option is specified. This @@ -563,7 +563,7 @@ is overridden by the \fBVISUAL\fR environmental variable. The default editor is .sp .ne 2 .na -\fB\fBPATH\fR\fR +\fBPATH\fR .ad .RS 10n The \fBPATH\fR in \fBcrontab\fR's environment specifies the search path used to @@ -573,7 +573,7 @@ find the editor. .sp .ne 2 .na -\fB\fBVISUAL\fR\fR +\fBVISUAL\fR .ad .RS 10n Determine the visual editor to be invoked when the \fB-e\fR option is @@ -584,7 +584,7 @@ specified. If \fBVISUAL\fR is not specified, then the environment variable .SS "\fB/usr/xpg4/bin/crontab\fR" .ne 2 .na -\fB\fBEDITOR\fR\fR +\fBEDITOR\fR .ad .RS 10n Determine the editor to be invoked when the \fB-e\fR option is specified. The @@ -594,7 +594,7 @@ default editor is \fB/usr/xpg4/bin/vi\fR. .SS "\fB/usr/xpg6/bin/crontab\fR" .ne 2 .na -\fB\fBEDITOR\fR\fR +\fBEDITOR\fR .ad .RS 10n Determine the editor to be invoked when the \fB-e\fR option is specified. The @@ -606,7 +606,7 @@ The following exit values are returned: .sp .ne 2 .na -\fB\fB0\fR\fR +\fB0\fR .ad .RS 6n Successful completion. @@ -615,7 +615,7 @@ Successful completion. .sp .ne 2 .na -\fB\fB>0\fR\fR +\fB>0\fR .ad .RS 6n An error occurred. @@ -624,7 +624,7 @@ An error occurred. .SH FILES .ne 2 .na -\fB\fB/etc/cron.d\fR\fR +\fB/etc/cron.d\fR .ad .RS 28n main cron directory @@ -633,7 +633,7 @@ main cron directory .sp .ne 2 .na -\fB\fB/etc/cron.d/cron.allow\fR\fR +\fB/etc/cron.d/cron.allow\fR .ad .RS 28n list of allowed users @@ -642,7 +642,7 @@ list of allowed users .sp .ne 2 .na -\fB\fB/etc/default/cron\fR\fR +\fB/etc/default/cron\fR .ad .RS 28n contains cron default settings @@ -651,7 +651,7 @@ contains cron default settings .sp .ne 2 .na -\fB\fB/etc/cron.d/cron.deny\fR\fR +\fB/etc/cron.d/cron.deny\fR .ad .RS 28n list of denied users @@ -669,7 +669,7 @@ system spool area for \fBcrontab\fR .sp .ne 2 .na -\fB\fB/var/cron/log\fR\fR +\fB/var/cron/log\fR .ad .RS 28n accounting information @@ -678,7 +678,7 @@ accounting information .sp .ne 2 .na -\fB\fB/var/spool/cron/crontabs\fR\fR +\fB/var/spool/cron/crontabs\fR .ad .RS 28n spool area for \fBcrontab\fR |