system_cmds-433.1.tar.gz

diff --git a/at.tproj/Makefile b/at.tproj/Makefile
index f453f00c532e11229a9c6139dc85e743af6bdc2b..cf7e3f7ee462872b183c45808350567aad7aed59 100644 (file)
--- 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 \
 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
 
        -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 5cd496000c9e751bffb8bf9f4ce864343ccdc9f0..1dd6d909f083dadbb2cd819c1245f49bb6ce1880 100644 (file)
--- 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 .
 .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
 .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
 .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
 .Sh OPTIONS
 .Bl -tag -width indent

-.\" ==========

 .It Fl b
 Is an alias for
 .Nm batch .
 .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 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 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 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 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 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
 .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.
 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 r
 Remove the specified jobs.

-.\" ==========

 .It Fl t
 Specify the job time using the \*[Px] time format.
 The argument should be in the form
 .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
 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 CC
 The first two digits of the year (the century).

-.\" ==========

 .It Ar YY
 The second two digits of the year.
 .It Ar YY
 The second two digits of the year.

-.\" ==========

 .It Ar MM
 The month of the year, from 1 to 12.
 .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 DD
 the day of the month, from 1 to 31.

-.\" ==========

 .It Ar hh
 The hour of the day, from 0 to 23.
 .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 mm
 The minute of the hour, from 0 to 59.

-.\" ==========

 .It Ar SS
 The second of the minute, from 0 to 61.
 .El
 .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.
 If the
 .Ar SS
 letter pair is not specified, the value defaults to 0.

-.\" ==========

 .It Fl v
 For
 .Nm atq ,
 .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
 .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
 directory containing job files
 (/usr/lib/cron/jobs/)

-.\" ==========

 .It Pa _ATJOB_DIR/_LOCKFILE
 job-creation lock file
 (/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 _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.allow
 allow permission control
 (/usr/lib/cron/at.allow)

-.\" ==========

 .It Pa _PERM_PATH/at.deny
 deny permission control
 (/usr/lib/cron/at.deny)
 .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 2e06d61cee86215498fce6f7ecb012ef2c5bd483..bc81cc0672be4e2aa831ff60420d30c92af3d45f 100644 (file)
--- 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 $
 .\"
 .\"
 .\"    $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
 .Dt ATRUN 8

-.Os NetBSD 0.9a
+.Os "Mac OS X"

 .Sh NAME
 .Nm atrun
 .Nd run jobs queued for later execution
 .Sh NAME
 .Nm atrun
 .Nd run jobs queued for later execution

-.\"

 .Sh SYOPSIS
 .Nm atrun
 .Sh DESCRIPTION
 .Sh SYOPSIS
 .Nm atrun
 .Sh DESCRIPTION


@@ -43,9 +42,21 @@ The
 .Nm atrun
 utility runs commands queued by
 .Xr at 1 .
 .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
 .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 ,
 .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 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.