1*49901277Sschwarze.\" $OpenBSD: atq.1,v 1.7 2015/09/09 21:23:30 schwarze Exp $ 26eb82116Smillert.\" 36eb82116Smillert.\" Copyright (c) 1985, 1990, 1993 46eb82116Smillert.\" The Regents of the University of California. All rights reserved. 56eb82116Smillert.\" 66eb82116Smillert.\" Redistribution and use in source and binary forms, with or without 76eb82116Smillert.\" modification, are permitted provided that the following conditions 86eb82116Smillert.\" are met: 96eb82116Smillert.\" 1. Redistributions of source code must retain the above copyright 106eb82116Smillert.\" notice, this list of conditions and the following disclaimer. 116eb82116Smillert.\" 2. Redistributions in binary form must reproduce the above copyright 126eb82116Smillert.\" notice, this list of conditions and the following disclaimer in the 136eb82116Smillert.\" documentation and/or other materials provided with the distribution. 14f75387cbSmillert.\" 3. Neither the name of the University nor the names of its contributors 156eb82116Smillert.\" may be used to endorse or promote products derived from this software 166eb82116Smillert.\" without specific prior written permission. 176eb82116Smillert.\" 186eb82116Smillert.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 196eb82116Smillert.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 206eb82116Smillert.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 216eb82116Smillert.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 226eb82116Smillert.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 236eb82116Smillert.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 246eb82116Smillert.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 256eb82116Smillert.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 266eb82116Smillert.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 276eb82116Smillert.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 286eb82116Smillert.\" SUCH DAMAGE. 296eb82116Smillert.\" 306eb82116Smillert.\" @(#)atq.1 8.1 (Berkeley) 6/6/93 316eb82116Smillert.\" 32*49901277Sschwarze.Dd $Mdocdate: September 9 2015 $ 336eb82116Smillert.Dt ATQ 1 346eb82116Smillert.Os 356eb82116Smillert.Sh NAME 366eb82116Smillert.Nm atq 37*49901277Sschwarze.Nd display the at(1) job queue 386eb82116Smillert.Sh SYNOPSIS 396eb82116Smillert.Nm atq 406eb82116Smillert.Op Fl cnv 416eb82116Smillert.Op Fl q Ar queue 426eb82116Smillert.Op Ar name ... 436eb82116Smillert.Sh DESCRIPTION 446eb82116Smillert.Nm atq 456eb82116Smillertdisplays the queue of jobs, created by the 466eb82116Smillert.Xr at 1 476eb82116Smillertcommand, which are currently awaiting execution. 486eb82116SmillertUnless the user is the superuser, only the user's own jobs will be displayed. 496eb82116SmillertWith no flags, the queue is sorted in the order that 506eb82116Smillertthe jobs will be executed. 516eb82116Smillert.Pp 526eb82116SmillertThe options are as follows: 536eb82116Smillert.Bl -tag -width "-q queueX" 546eb82116Smillert.It Fl c 556eb82116SmillertSort the queue by the time that the jobs were submitted (created). 566eb82116SmillertBy default, 576eb82116Smillert.Nm 586eb82116Smillertwill sort the queue by the time that the jobs will run. 596eb82116Smillert.It Fl n 606eb82116SmillertOnly print the total number of files that are currently in the queue. 616eb82116Smillert.It Fl q Ar queue 626eb82116SmillertRestrict output to jobs in the specified 636eb82116Smillert.Ar queue . 64c9d13225SmillertA queue designation consists of a single letter. 65c9d13225SmillertValid queue designations range from 666eb82116Smillert.Sy a 676eb82116Smillertto 686eb82116Smillert.Sy z 696eb82116Smillertand 706eb82116Smillert.Sy A 716eb82116Smillertto 726eb82116Smillert.Sy Z . 736eb82116SmillertThe 746eb82116Smillert.Sy c 756eb82116Smillertqueue is the default for 766eb82116Smillert.Xr at 1 776eb82116Smillertand the 786eb82116Smillert.Sy E 796eb82116Smillertqueue for 806eb82116Smillert.Xr batch 1 . 816eb82116SmillertBy default, 826eb82116Smillert.Nm 836eb82116Smillertwill display jobs in all queues. 846eb82116Smillert.It Fl v 856eb82116SmillertJobs that have completed but have not yet been removed are also displayed. 866eb82116Smillert.El 876eb82116Smillert.Pp 886eb82116SmillertIf a name(s) is provided, only those files belonging to that user(s) are 896eb82116Smillertdisplayed. 906eb82116Smillert.Sh FILES 91b7248defSmillert.Bl -tag -width /var/cron/atjobs -compact 92b7248defSmillert.It Pa /var/cron/atjobs 936eb82116Smillertdirectory containing job files 946eb82116Smillert.El 956eb82116Smillert.Sh SEE ALSO 966eb82116Smillert.Xr at 1 , 976eb82116Smillert.Xr atrm 1 , 986eb82116Smillert.Xr cron 8 996eb82116Smillert.Sh HISTORY 1006eb82116SmillertThe 1016eb82116Smillert.Nm 1026eb82116Smillertcommand appeared in 1036eb82116Smillert.Bx 4.3 . 104