]> git.saurik.com Git - apple/system_cmds.git/commitdiff
system_cmds-433.1.tar.gz mac-os-x-1053 mac-os-x-1054 mac-os-x-1055 v433.1
authorApple <opensource@apple.com>
Thu, 13 Mar 2008 00:04:46 +0000 (00:04 +0000)
committerApple <opensource@apple.com>
Thu, 13 Mar 2008 00:04:46 +0000 (00:04 +0000)
at.tproj/Makefile
at.tproj/at.1
atrun.tproj/atrun.8

index f453f00c532e11229a9c6139dc85e743af6bdc2b..cf7e3f7ee462872b183c45808350567aad7aed59 100644 (file)
@@ -8,7 +8,7 @@ MANPAGES = at.1
 PROJECT_HEADERS = privs.h pathnames.h
 
 Extra_CC_Flags = -D__FBSDID=__RCSID -DDAEMON_UID=1 -DDAEMON_GID=1 \
-       -DDEFAULT_AT_QUEUE=\"a\" -DDEFAULT_BATCH_QUEUE=\"b\" \
+       -DDEFAULT_AT_QUEUE='a' -DDEFAULT_BATCH_QUEUE='b' \
        -DPERM_PATH=\"/usr/lib/cron/\" \
        -I/System/Library/Frameworks/System.framework/PrivateHeaders
 
index 5cd496000c9e751bffb8bf9f4ce864343ccdc9f0..1dd6d909f083dadbb2cd819c1245f49bb6ce1880 100644 (file)
@@ -201,52 +201,42 @@ to use
 .Pp
 If neither exists, only the superuser is allowed use of
 .Nm at .
-This is the default configuration.
 .Sh IMPLEMENTATION NOTES
 Note that
 .Nm at
 is implemented through the
-.Xr cron 8
-daemon by calling
+.Xr launchd 8
+daemon periodically invoking
+.Xr atrun 8 ,
+which is disabled by default.
+See 
 .Xr atrun 8
-every five minutes.
-This implies that the granularity of
-.Nm at
-might not be optimal for every deployment.
-If a finer granularity is needed, the system crontab at
-.Pa /etc/crontab
-needs to be changed.
+for information about enabling
+.Nm atrun .
 .Sh OPTIONS
 .Bl -tag -width indent
-.\" ==========
 .It Fl b
 Is an alias for
 .Nm batch .
-.\" ==========
 .It Fl c
 Cat the jobs listed on the command line to standard output.
-.\" ==========
 .It Fl d
 Is an alias for
 .Nm atrm
 (this option is deprecated; use
 .Fl r
 instead).
-.\" ==========
 .It Fl f Ar file
 Read the job from
 .Ar file
 rather than standard input.
-.\" ==========
 .It Fl l
 With no arguments, list all jobs for the invoking user.
 If one or more
 job numbers are given, list only those jobs.
-.\" ==========
 .It Fl m
 Send mail to the user when the job has completed even if there was no
 output.
-.\" ==========
 .It Fl q Ar queue
 Use the specified queue.
 A queue designation consists of a single letter; valid queue designations
@@ -272,10 +262,8 @@ is treated as if it had been submitted to batch at that time.
 If
 .Nm atq
 is given a specific queue, it will only show jobs pending in that queue.
-.\" ==========
 .It Fl r
 Remove the specified jobs.
-.\" ==========
 .It Fl t
 Specify the job time using the \*[Px] time format.
 The argument should be in the form
@@ -286,25 +274,18 @@ The argument should be in the form
 where each pair of letters represents the following:
 .Pp
 .Bl -tag -width indent -compact -offset indent
-.\" ==========
 .It Ar CC
 The first two digits of the year (the century).
-.\" ==========
 .It Ar YY
 The second two digits of the year.
-.\" ==========
 .It Ar MM
 The month of the year, from 1 to 12.
-.\" ==========
 .It Ar DD
 the day of the month, from 1 to 31.
-.\" ==========
 .It Ar hh
 The hour of the day, from 0 to 23.
-.\" ==========
 .It Ar mm
 The minute of the hour, from 0 to 59.
-.\" ==========
 .It Ar SS
 The second of the minute, from 0 to 61.
 .El
@@ -318,7 +299,6 @@ year.
 If the
 .Ar SS
 letter pair is not specified, the value defaults to 0.
-.\" ==========
 .It Fl v
 For
 .Nm atq ,
@@ -327,23 +307,18 @@ shows the time the job will be executed.
 .El
 .Sh FILES
 .Bl -tag -width _ATJOB_DIR/_LOCKFILE -compact
-.\" ==========
 .It Pa _ATJOB_DIR
 directory containing job files
 (/usr/lib/cron/jobs/)
-.\" ==========
 .It Pa _ATJOB_DIR/_LOCKFILE
 job-creation lock file
 (/usr/lib/cron/jobs/...)
-.\" ==========
 .It Pa _ATSPOOL_DIR
 directory containing output spool files
 (/usr/lib/cron/spool/)
-.\" ==========
 .It Pa _PERM_PATH/at.allow
 allow permission control
 (/usr/lib/cron/at.allow)
-.\" ==========
 .It Pa _PERM_PATH/at.deny
 deny permission control
 (/usr/lib/cron/at.deny)
index 2e06d61cee86215498fce6f7ecb012ef2c5bd483..bc81cc0672be4e2aa831ff60420d30c92af3d45f 100644 (file)
 .\"
 .\"    $Id: atrun.8,v 1.1 1999/05/02 04:21:19 wsanchez Exp $
 .\"
-.Dd December 5, 1993
+.Dd March 9, 2008
 .Dt ATRUN 8
-.Os NetBSD 0.9a
+.Os "Mac OS X"
 .Sh NAME
 .Nm atrun
 .Nd run jobs queued for later execution
-.\"
 .Sh SYOPSIS
 .Nm atrun
 .Sh DESCRIPTION
@@ -43,9 +42,21 @@ The
 .Nm atrun
 utility runs commands queued by
 .Xr at 1 .
-It is usually invoked by
-.Xr crond 8
-every ten minutes.
+It is invoked periodically by
+.Xr launchd 8
+as specified in the 
+.Pa com.apple.atrun.plist
+property list.
+By default the property list contains the
+.Em Disabled 
+key set to true, so
+.Nm atrun 
+is never invoked.
+.Pp
+Execute the following command as root to enable
+.Nm atrun :
+.Dl "launchctl load -w /System/Library/LaunchDaemons/com.apple.atrun.plist"
+.Pp
 .Sh FILES
 .Bl -tag -width /var/at/lockfile -compact
 .It Pa /var/at/jobs
@@ -57,21 +68,8 @@ Job-creation lock file.
 .El
 .Sh SEE ALSO
 .Xr at 1 ,
-.Xr crond 8
+.Xr launchd 8
 .Sh AUTHOR
 .Bl -tag
 Thomas Koenig, ig25@rz.uni-karlsruhe.de
 .El
-.Sh BUGS
-The functionality of
-.Nm atrun
-should arguably be merged into
-.Xr crond 8 .
-.Sh CAVEATS
-Because the default configuration causes
-.Nm atrun
-to be invoked every ten minutes,
-commands queued by
-.Xr at 1
-may end up being executed up to nine minutes
-later than would be otherwise expected.