From e34d6a2fe844b92ea51e672fcbb6bfe0e930712f Mon Sep 17 00:00:00 2001 From: Apple Date: Thu, 13 Mar 2008 00:04:46 +0000 Subject: [PATCH] system_cmds-433.1.tar.gz --- at.tproj/Makefile | 2 +- at.tproj/at.1 | 39 +++++++-------------------------------- atrun.tproj/atrun.8 | 38 ++++++++++++++++++-------------------- 3 files changed, 26 insertions(+), 53 deletions(-) diff --git a/at.tproj/Makefile b/at.tproj/Makefile index f453f00..cf7e3f7 100644 --- a/at.tproj/Makefile +++ b/at.tproj/Makefile @@ -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 diff --git a/at.tproj/at.1 b/at.tproj/at.1 index 5cd4960..1dd6d90 100644 --- a/at.tproj/at.1 +++ b/at.tproj/at.1 @@ -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) diff --git a/atrun.tproj/atrun.8 b/atrun.tproj/atrun.8 index 2e06d61..bc81cc0 100644 --- a/atrun.tproj/atrun.8 +++ b/atrun.tproj/atrun.8 @@ -29,13 +29,12 @@ .\" .\" $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. -- 2.47.2