Lines Matching +full:at +full:- +full:the +full:- +full:time

1 .\" $OpenBSD: at.1,v 1.59 2024/11/05 16:21:13 sobrado Exp $
8 .\" modification, are permitted provided that the following conditions
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\"    notice, this list of conditions and the following disclaimer.
12 .\" 2. The name of the author(s) may not be used to endorse or promote
16 .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS OR
17 .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19 .\" IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT, INDIRECT,
24 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28 .Dt AT 1
31 .Nm at ,
35 .Nm at
41 .Nm at
50 .Nm at
54 are to be executed at a later time, via the user's shell as
55 specified by the
60 is not set, the shell in the user's password database entry is used
66 The related programs are as follows:
67 .Bl -tag -width Ds
68 .It Nm at
69 Executes commands at a specified time.
73 the load average drops below 1.5, or the value specified in the invocation of
77 The options are as follows:
78 .Bl -tag -width indent
83 Prints the jobs listed on the command line to standard output.
85 Reads the job from
89 Displays the queue of jobs which are currently awaiting execution.
92 argument is specified, only the specified jobs will be displayed.
93 Unless the user is the superuser, only the user's own jobs will be
96 Send mail to the user when the job has completed, even if there was no
99 Uses the specified queue.
109 The
111 queue is the default for
112 .Nm at
113 and the
119 is treated as if it had been submitted to batch at that time.
120 If the user specified the
123 .Nm at
126 Remove the specified job(s) from the
127 .Nm at
130 Specify the job time.
131 The argument should be of the form
137 where the parts of the argument represent the following:
139 .Bl -tag -width Ds -compact -offset indent
162 The default is 0.
165 As well as the
168 .Nm at
172 It accepts times of the form
176 to run a job at a specific time of day
177 (if that time is already past, the next day is assumed).
185 or have a time-of-day suffixed with
189 for running in the morning or the evening.
190 To say what day the job will be run,
191 give a date in the form
192 .Ar \%month-name day
195 or giving a date of the form
204 The year may be given as two or four digits.
205 If the year is given as two digits, it is taken to occur as soon as
206 possible in the future, which may be in the next century \(em
210 The specification of a date must follow the specification of
211 the time of day.
212 A time like
213 .Oo Cm now Oc Cm + Ar count time-units
215 where the time-units can be
223 (the singular forms are also accepted).
225 .Nm at
226 to run the job today or tomorrow,
227 suffix the time with
231 The
236 For example, to run a job at 4pm three days from now, use
237 .Ic at 4pm + 3 days .
238 To run a job at 10:00am on July 31, use
239 .Ic at 10am Jul 31 .
240 To run a job at 1am tomorrow, use
241 .Ic at 1am tomorrow .
242 To run a job at midnight in one week's time, use
243 .Ic at midnight next week .
247 .Nm at
250 commands are read from standard input (or the file specified
251 with the
254 The working directory, the environment (except for the variables
268 and the
270 are retained from the time of invocation.
272 .Nm at
277 shell will retain the current user ID.
278 The user will be mailed standard error and standard output from his
281 .Nm at
284 shell, the owner of the login shell will receive the mail.
286 For non-root users, permission to run
288 is determined by the files
289 .Pa /var/cron/at.allow
291 .Pa /var/cron/at.deny .
295 If the file
296 .Pa /var/cron/at.allow
298 .Nm at .
300 .Pa /var/cron/at.allow
302 .Pa /var/cron/at.deny
305 .Nm at .
306 If neither exists, only the superuser is allowed to run
307 .Nm at .
310 .Pa /var/cron/at.deny
312 This is the default configuration.
314 .Bl -tag -width /var/cron/at.allow -compact
317 .It Pa /var/cron/at.allow
319 .It Pa /var/cron/at.deny
323 The
325 utility exits with one of the following values:
327 .Bl -tag -width Ds -offset indent -compact
342 The
346 utilities are compliant with the
347 .St -p1003.1-2024
350 The
354 and the
359 .St -p1003.1-2024
363 .Qq Cm at -q b -m now .
366 argument, as well as the ability to read from a file
370 and does not send mail to the user
375 .St -p1003.1-2024
377 .Nm at
385 The at.allow/deny mechanism is marked by
386 .St -p1003.1-2024
391 .An -nosplit
392 .Nm at
394 .An Thomas Koenig Aq Mt ig25@rz.uni-karlsruhe.de .
395 The time parsing routines are by
398 .Nm at