share/man/man1/atrm.1

   1 '\" te
   2 .\" Copyright 1989 AT&T
   3 .\" Copyright (c) 1985 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution.
   4 .\" Copyright (c) 2007 Sun Microsystems, Inc., All Rights Reserved.
   5 .TH ATRM 1 "Jul 16, 2007"
   6 .SH NAME
   7 atrm \- remove jobs spooled by at or batch
   8 .SH SYNOPSIS
   9 .LP
  10 .nf
  11 \fBatrm\fR [\fB-afi\fR] [ [\fIjob\fR \fI#\fR] [\fIuser\fR]...]
  12 .fi
  13
  14 .SH DESCRIPTION
  15 .sp
  16 .LP
  17 The \fBatrm\fR utility removes delayed-execution jobs that were created with
  18 the \fBat\fR(1) command, but have not yet executed. The list of these jobs and
  19 associated job numbers can be displayed by using \fBatq\fR(1).
  20 .sp
  21 .LP
  22 \fBatrm\fR removes each job-number you specify, and/or all jobs belonging to
  23 the user you specify, provided that you own the indicated jobs.
  24 .sp
  25 .LP
  26 You can only remove jobs belonging to other users if you have
  27 \fBsolaris.jobs.admin\fR privileges.
  28 .SH OPTIONS
  29 .sp
  30 .LP
  31 The following options are supported:
  32 .sp
  33 .ne 2
  34 .na
  35 \fB\fB-a\fR\fR
  36 .ad
  37 .RS 6n
  38 All. Removes all unexecuted jobs that were created by the current user. If
  39 invoked by the privileged user, the entire queue is flushed.
  40 .RE
  41
  42 .sp
  43 .ne 2
  44 .na
  45 \fB\fB-f\fR\fR
  46 .ad
  47 .RS 6n
  48 Force. All information regarding the removal of the specified jobs is
  49 suppressed.
  50 .RE
  51
  52 .sp
  53 .ne 2
  54 .na
  55 \fB\fB-i\fR\fR
  56 .ad
  57 .RS 6n
  58 Interactive. \fBatrm\fR asks if a job should be removed. If the response is
  59 affirmative, the job is removed.
  60 .RE
  61
  62 .SH FILES
  63 .sp
  64 .ne 2
  65 .na
  66 \fB\fB/var/spool/cron/atjobs\fR\fR
  67 .ad
  68 .RS 26n
  69 Spool area for \fBat\fR jobs
  70 .RE
  71
  72 .SH ENVIRONMENT VARIABLES
  73 .sp
  74 .LP
  75 See \fBenviron\fR(5) for descriptions of the following environment variables
  76 that affect the execution of \fBatrm\fR: \fBLANG\fR, \fBLC_ALL\fR,
  77 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
  78 .sp
  79 .LP
  80 Affirmative responses are processed using the extended regular expression
  81 defined for the \fByesexpr\fR keyword in the \fBLC_MESSAGES\fR category of the
  82 user's locale. The locale specified in the \fBLC_COLLATE\fR category defines
  83 the behavior of ranges, equivalence classes, and multi-character collating
  84 elements used in the expression defined for \fByesexpr\fR. The locale specified
  85 in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
  86 bytes of text data a characters, the behavior of character classes used in the
  87 expression defined for the \fByesexpr\fR. See \fBlocale\fR(5)
  88 .SH SEE ALSO
  89 .sp
  90 .LP
  91 \fBat\fR(1), \fBatq\fR(1), \fBauths\fR(1), \fBcron\fR(8), \fBauth_attr\fR(4),
  92 \fBattributes\fR(5), \fBenviron\fR(5), \fBlocale\fR(5)