man/cancel.man

   1 .\"
   2 .\" "$Id$"
   3 .\"
   4 .\"   cancel man page for the Common UNIX Printing System (CUPS).
   5 .\"
   6 .\"   Copyright 1997-2006 by Easy Software Products.
   7 .\"
   8 .\"   These coded instructions, statements, and computer programs are the
   9 .\"   property of Easy Software Products and are protected by Federal
  10 .\"   copyright law.  Distribution and use rights are outlined in the file
  11 .\"   "LICENSE.txt" which should have been included with this file.  If this
  12 .\"   file is missing or damaged please contact Easy Software Products
  13 .\"   at:
  14 .\"
  15 .\"       Attn: CUPS Licensing Information
  16 .\"       Easy Software Products
  17 .\"       44141 Airport View Drive, Suite 204
  18 .\"       Hollywood, Maryland 20636 USA
  19 .\"
  20 .\"       Voice: (301) 373-9600
  21 .\"       EMail: cups-info@cups.org
  22 .\"         WWW: http://www.cups.org
  23 .\"
  24 .TH cancel 1 "Common UNIX Printing System" "12 February 2006" "Easy Software Products"
  25 .SH NAME
  26 cancel - cancel jobs
  27 .SH SYNOPSIS
  28 .B cancel
  29 [ -E ] [ -U
  30 .I username
  31 ] [ -a ] [ -h
  32 .I hostname[:port]
  33 ] [ -u
  34 .I username
  35 ] [
  36 .I id
  37 ] [
  38 .I destination
  39 ] [
  40 .I destination-id
  41 ]
  42 .SH DESCRIPTION
  43 \fIcancel\fR cancels existing print jobs. The \fI-a\fR option will remove
  44 all jobs from the specified destination.
  45 .SH OPTIONS
  46 The following options are recognized by \fIlp\fR:
  47 .TP 5
  48 -E
  49 .br
  50 Forces encryption when connecting to the server.
  51 .TP 5
  52 -U username
  53 .br
  54 Specifies the username to use when connecting to the server.
  55 .TP 5
  56 -a
  57 .br
  58 Cancel all jobs on the named destination, or all jobs on all
  59 destinations if none is provided.
  60 .TP 5
  61 -h hostname[:port]
  62 .br
  63 Chooses an alternate server.
  64 .TP 5
  65 -u username
  66 .br
  67 Cancels jobs owned by \fIusername\fR.
  68 .SH COMPATIBILITY
  69 Unlike the System V printing system, CUPS allows printer names to
  70 contain any printable character except SPACE, TAB, "/", or "#".
  71 Also, printer and class names are \fInot\fR case-sensitive.
  72 .SH NOTES
  73 Administrators wishing to prevent unauthorized cancellation of
  74 jobs via the \fI-u\fR option should require authentication for
  75 Cancel-Jobs operations in \fIcupsd.conf(5)\fR.
  76 .SH SEE ALSO
  77 \fIlp(1)\fR, \fIlpmove(8)\fR, \fIlpstat(1)\fR,
  78 .br
  79 http://localhost:631/help
  80 .SH COPYRIGHT
  81 Copyright 1997-2006 by Easy Software Products, All Rights Reserved.
  82 .\"
  83 .\" End of "$Id$".
  84 .\"