Print this page
13066 Want crontab -u
Change-ID: I3dc2251dbbcc721aeff25a9dde21a24271c927bc
*** 41,125 ****
.\"
.\"
.\" Copyright 1989 AT&T
.\" 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 "Oct 22, 2019"
.SH NAME
crontab \- user crontab file
.SH SYNOPSIS
.nf
! \fB/usr/bin/crontab\fR [\fIfilename\fR]
.fi
.LP
.nf
! \fB/usr/bin/crontab\fR \fB-e\fR [\fIusername\fR]
.fi
.LP
.nf
! \fB/usr/bin/crontab\fR \fB-l\fR [\fIusername\fR]
.fi
.LP
.nf
- \fB/usr/bin/crontab\fR \fB-r\fR [\fIusername\fR]
- .fi
-
- .LP
- .nf
\fB/usr/xpg4/bin/crontab\fR [\fIfilename\fR]
.fi
.LP
.nf
! \fB/usr/xpg4/bin/crontab\fR \fB-e\fR [\fIusername\fR]
.fi
.LP
.nf
! \fB/usr/xpg4/bin/crontab\fR \fB-l\fR [\fIusername\fR]
.fi
.LP
.nf
- \fB/usr/xpg4/bin/crontab\fR \fB-r\fR [\fIusername\fR]
- .fi
-
- .LP
- .nf
\fB/usr/xpg6/bin/crontab\fR [\fIfilename\fR]
.fi
.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 [\fIusername\fR]
.fi
- .LP
- .nf
- \fB/usr/xpg6/bin/crontab\fR \fB-r\fR [\fIusername\fR]
- .fi
-
.SH DESCRIPTION
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
the standard input if no file is specified, into a directory that holds all
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.
.SS "\fBcrontab\fR Access Control"
Users: Access to \fBcrontab\fR is allowed:
.RS +4
.TP
.ie t \(bu
--- 41,111 ----
.\"
.\"
.\" Copyright 1989 AT&T
.\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
.\" Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
! .\" Copyright 2020 OmniOS Community Edition (OmniOSce) Association.
.\"
! .TH CRONTAB 1 "Aug 20, 2020"
.SH NAME
crontab \- user crontab file
.SH SYNOPSIS
.nf
! \fB/usr/bin/crontab\fR [\fB-u\fR \fIusername\fR] [\fIfilename\fR]
.fi
.LP
.nf
! \fB/usr/bin/crontab\fR \fB{ -e | -l | -r }\fR [\fIusername\fR]
.fi
.LP
.nf
! \fB/usr/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -l | -r }\fR
.fi
.LP
.nf
\fB/usr/xpg4/bin/crontab\fR [\fIfilename\fR]
.fi
.LP
.nf
! \fB/usr/xpg4/bin/crontab\fR \fB{ -e | -l | -r }\fR [\fIusername\fR]
.fi
.LP
.nf
! \fB/usr/xpg4/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -l | -r }\fR
.fi
.LP
.nf
\fB/usr/xpg6/bin/crontab\fR [\fIfilename\fR]
.fi
.LP
.nf
! \fB/usr/xpg6/bin/crontab\fR \fB{ -e | -l | -r }\fR [\fIusername\fR]
.fi
.LP
.nf
! \fB/usr/xpg6/bin/crontab\fR \fB-u\fR \fIusername\fR \fB{ -e | -l | -r }\fR
.fi
.SH DESCRIPTION
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
the standard input if no file is specified, into a directory that holds all
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, or for the user specified
! with the \fB-u\fR option.
.SS "\fBcrontab\fR Access Control"
Users: Access to \fBcrontab\fR is allowed:
.RS +4
.TP
.ie t \(bu
*** 270,280 ****
.SS "\fBcrontab\fR Environment Variables"
The following variables are supported:
.sp
.ne 2
.na
! \fB\fBHOME\fR\fR
.ad
.sp .6
.RS 4n
Allows the user to choose and alternative directory for cron to change
directory to prior to running the command. For example:
--- 256,266 ----
.SS "\fBcrontab\fR Environment Variables"
The following variables are supported:
.sp
.ne 2
.na
! \fBHOME\fR
.ad
.sp .6
.RS 4n
Allows the user to choose and alternative directory for cron to change
directory to prior to running the command. For example:
*** 289,299 ****
.RE
.sp
.ne 2
.na
! \fB\fBSHELL\fR\fR
.ad
.sp .6
.RS 4n
The name of the shell to use to run subsequent commands. For example:
.sp
--- 275,285 ----
.RE
.sp
.ne 2
.na
! \fBSHELL\fR
.ad
.sp .6
.RS 4n
The name of the shell to use to run subsequent commands. For example:
.sp
*** 307,317 ****
.RE
.sp
.ne 2
.na
! \fB\fBTZ\fR\fR
.ad
.sp .6
.RS 4n
Allows the user to choose the timezone in which the \fBcron\fR entries are run.
This effects both the environment of the command that is run and the timing of
--- 293,303 ----
.RE
.sp
.ne 2
.na
! \fBTZ\fR
.ad
.sp .6
.RS 4n
Allows the user to choose the timezone in which the \fBcron\fR entries are run.
This effects both the environment of the command that is run and the timing of
*** 350,360 ****
.SH OPTIONS
The following options are supported:
.sp
.ne 2
.na
! \fB\fB-e\fR\fR
.ad
.RS 6n
Edits a copy of the current user's \fBcrontab\fR file, or creates an empty file
to edit if \fBcrontab\fR does not exist. When editing is complete, the file is
installed as the user's \fBcrontab\fR file.
--- 336,346 ----
.SH OPTIONS
The following options are supported:
.sp
.ne 2
.na
! \fB-e\fR
.ad
.RS 6n
Edits a copy of the current user's \fBcrontab\fR file, or creates an empty file
to edit if \fBcrontab\fR does not exist. When editing is complete, the file is
installed as the user's \fBcrontab\fR file.
*** 374,384 ****
.RE
.sp
.ne 2
.na
! \fB\fB-l\fR\fR
.ad
.RS 6n
Lists the \fBcrontab\fR file for the invoking user. Only root or a user with
the \fBsolaris.jobs.admin\fR authorization can specify a username following the
\fB-l\fR option to list the \fBcrontab\fR file of the specified user.
--- 360,370 ----
.RE
.sp
.ne 2
.na
! \fB-l\fR
.ad
.RS 6n
Lists the \fBcrontab\fR file for the invoking user. Only root or a user with
the \fBsolaris.jobs.admin\fR authorization can specify a username following the
\fB-l\fR option to list the \fBcrontab\fR file of the specified user.
*** 385,403 ****
.RE
.sp
.ne 2
.na
! \fB\fB-r\fR\fR
.ad
.RS 6n
Removes a user's \fBcrontab\fR from the \fBcrontab\fR directory. Only root or a
user with the \fBsolaris.jobs.admin\fR authorization can specify a username
following the \fB-r\fR option to remove the \fBcrontab\fR file of the specified
user.
.RE
.SH EXAMPLES
\fBExample 1 \fRCleaning up Core Files
.sp
.LP
This example cleans up \fBcore\fR files every weekday morning at 3:15 am:
--- 371,401 ----
.RE
.sp
.ne 2
.na
! \fB-r\fR
.ad
.RS 6n
Removes a user's \fBcrontab\fR from the \fBcrontab\fR directory. Only root or a
user with the \fBsolaris.jobs.admin\fR authorization can specify a username
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
.LP
This example cleans up \fBcore\fR files every weekday morning at 3:15 am:
*** 518,528 ****
that affect the execution of \fBcrontab\fR: \fBLANG\fR, \fBLC_ALL\fR,
\fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
.SS "\fB/usr/bin/crontab\fR"
.ne 2
.na
! \fB\fBEDITOR\fR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. This
is overridden by the \fBVISUAL\fR environmental variable. The default editor is
\fBvi\fR(1).
--- 516,526 ----
that affect the execution of \fBcrontab\fR: \fBLANG\fR, \fBLC_ALL\fR,
\fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
.SS "\fB/usr/bin/crontab\fR"
.ne 2
.na
! \fBEDITOR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. This
is overridden by the \fBVISUAL\fR environmental variable. The default editor is
\fBvi\fR(1).
*** 529,549 ****
.RE
.sp
.ne 2
.na
! \fB\fBPATH\fR\fR
.ad
.RS 10n
The \fBPATH\fR in \fBcrontab\fR's environment specifies the search path used to
find the editor.
.RE
.sp
.ne 2
.na
! \fB\fBVISUAL\fR\fR
.ad
.RS 10n
Determine the visual editor to be invoked when the \fB-e\fR option is
specified. If \fBVISUAL\fR is not specified, then the environment variable
\fBEDITOR\fR is used. If that is not set, the default is \fBvi\fR(1).
--- 527,547 ----
.RE
.sp
.ne 2
.na
! \fBPATH\fR
.ad
.RS 10n
The \fBPATH\fR in \fBcrontab\fR's environment specifies the search path used to
find the editor.
.RE
.sp
.ne 2
.na
! \fBVISUAL\fR
.ad
.RS 10n
Determine the visual editor to be invoked when the \fB-e\fR option is
specified. If \fBVISUAL\fR is not specified, then the environment variable
\fBEDITOR\fR is used. If that is not set, the default is \fBvi\fR(1).
*** 550,570 ****
.RE
.SS "\fB/usr/xpg4/bin/crontab\fR"
.ne 2
.na
! \fB\fBEDITOR\fR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. The
default editor is \fB/usr/xpg4/bin/vi\fR.
.RE
.SS "\fB/usr/xpg6/bin/crontab\fR"
.ne 2
.na
! \fB\fBEDITOR\fR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. The
default editor is \fB/usr/xpg6/bin/vi\fR.
.RE
--- 548,568 ----
.RE
.SS "\fB/usr/xpg4/bin/crontab\fR"
.ne 2
.na
! \fBEDITOR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. The
default editor is \fB/usr/xpg4/bin/vi\fR.
.RE
.SS "\fB/usr/xpg6/bin/crontab\fR"
.ne 2
.na
! \fBEDITOR\fR
.ad
.RS 10n
Determine the editor to be invoked when the \fB-e\fR option is specified. The
default editor is \fB/usr/xpg6/bin/vi\fR.
.RE
*** 572,645 ****
.SH EXIT STATUS
The following exit values are returned:
.sp
.ne 2
.na
! \fB\fB0\fR\fR
.ad
.RS 6n
Successful completion.
.RE
.sp
.ne 2
.na
! \fB\fB>0\fR\fR
.ad
.RS 6n
An error occurred.
.RE
.SH FILES
.ne 2
.na
! \fB\fB/etc/cron.d\fR\fR
.ad
.RS 28n
main cron directory
.RE
.sp
.ne 2
.na
! \fB\fB/etc/cron.d/cron.allow\fR\fR
.ad
.RS 28n
list of allowed users
.RE
.sp
.ne 2
.na
! \fB\fB/etc/default/cron\fR\fR
.ad
.RS 28n
contains cron default settings
.RE
.sp
.ne 2
.na
! \fB\fB/etc/cron.d/cron.deny\fR\fR
.ad
.RS 28n
list of denied users
.RE
.sp
.ne 2
.na
! \fB\fB/var/cron/log\fR\fR
.ad
.RS 28n
accounting information
.RE
.sp
.ne 2
.na
! \fB\fB/var/spool/cron/crontabs\fR\fR
.ad
.RS 28n
spool area for \fBcrontab\fR
.RE
--- 570,643 ----
.SH EXIT STATUS
The following exit values are returned:
.sp
.ne 2
.na
! \fB0\fR
.ad
.RS 6n
Successful completion.
.RE
.sp
.ne 2
.na
! \fB>0\fR
.ad
.RS 6n
An error occurred.
.RE
.SH FILES
.ne 2
.na
! \fB/etc/cron.d\fR
.ad
.RS 28n
main cron directory
.RE
.sp
.ne 2
.na
! \fB/etc/cron.d/cron.allow\fR
.ad
.RS 28n
list of allowed users
.RE
.sp
.ne 2
.na
! \fB/etc/default/cron\fR
.ad
.RS 28n
contains cron default settings
.RE
.sp
.ne 2
.na
! \fB/etc/cron.d/cron.deny\fR
.ad
.RS 28n
list of denied users
.RE
.sp
.ne 2
.na
! \fB/var/cron/log\fR
.ad
.RS 28n
accounting information
.RE
.sp
.ne 2
.na
! \fB/var/spool/cron/crontabs\fR
.ad
.RS 28n
spool area for \fBcrontab\fR
.RE