xref: /openbsd-src/usr.bin/at/atrm.1 (revision 49901277148c8c417470e0c914cdf22624441888)
1*49901277Sschwarze.\"	$OpenBSD: atrm.1,v 1.8 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.\"     @(#)atrm.1	8.1 (Berkeley) 6/6/93
316eb82116Smillert.\"
32*49901277Sschwarze.Dd $Mdocdate: September 9 2015 $
336eb82116Smillert.Dt ATRM 1
346eb82116Smillert.Os
356eb82116Smillert.Sh NAME
366eb82116Smillert.Nm atrm
37*49901277Sschwarze.Nd remove jobs spooled by at(1)
386eb82116Smillert.Sh SYNOPSIS
396eb82116Smillert.Nm atrm
406eb82116Smillert.Op Fl afi
4144057b83Sjmc.Oo
4244057b83Sjmc.Op Ar job
4344057b83Sjmc.Op Ar name
4444057b83Sjmc.Ar ...
4544057b83Sjmc.Oc
466eb82116Smillert.Sh DESCRIPTION
476eb82116Smillert.Nm atrm
486eb82116Smillertremoves jobs that were created with the
496eb82116Smillert.Xr at 1
506eb82116Smillertcommand.
516eb82116Smillert.Pp
526eb82116SmillertThe options are as follows:
536eb82116Smillert.Bl -tag -width Ds
546eb82116Smillert.It Fl a
556eb82116SmillertRemove all jobs belonging to the user invoking
566eb82116Smillert.Nm atrm .
576eb82116SmillertIf the user is the superuser, remove all jobs.
586eb82116Smillert.It Fl f
596eb82116SmillertAll information regarding the removal of the specified jobs is suppressed.
606eb82116Smillert.It Fl i
616eb82116Smillert.Nm atrm
626eb82116Smillertasks whether a job should be removed.
636eb82116SmillertIf the user responds with
646eb82116Smillert.Ql y ,
656eb82116Smillertthe job will be removed.
666eb82116Smillert.El
676eb82116Smillert.Pp
686eb82116SmillertIf one or more
696eb82116Smillert.Ar job
706eb82116Smillertids are specified,
716eb82116Smillert.Nm atrm
726eb82116Smillertattempts to remove only those
73a68e7ae1Smillert.Ar job Ns s.
746eb82116Smillert.Pp
756eb82116SmillertIf one or more user names are specified, all jobs belonging to those users
766eb82116Smillertare removed.
776eb82116SmillertOnly the superuser may remove other users' jobs.
786eb82116Smillert.Sh FILES
79b7248defSmillert.Bl -tag -width /var/cron/atjobs -compact
80b7248defSmillert.It Pa /var/cron/atjobs
816eb82116Smillertdirectory containing job files
826eb82116Smillert.El
836eb82116Smillert.Sh SEE ALSO
846eb82116Smillert.Xr at 1 ,
856eb82116Smillert.Xr atq 1 ,
866eb82116Smillert.Xr cron 8
876eb82116Smillert.Sh HISTORY
886eb82116SmillertThe
896eb82116Smillert.Nm
906eb82116Smillertcommand appeared in
916eb82116Smillert.Bx 4.3 .
92