cancel

 

---

 CANCEL(1)                                               CANCEL(1)
 
 
 
NAME
        cancel - send cancel requests to an LPRng print service
 
SYNOPSIS
        cancel [ -P printer ] [ -D debug-options ]
             [ request-ID...  ]
 
DESCRIPTION
        The  LPRng  lprm  client supports an cancel interface when
        invoked with an cancel program name.  This is  similar  to
        the  ex(1)  and vi(1) programs.  The supported form of the
        cancel command arranges for the named jobs to  be  removed
        from  the specified print queues.  The action is identical
        to that of lprm(1), including the options, with  the  dif­
        ference  that the last argument on the command line can be
        an optional printer name.  If the name does not appear  in
        the  LPRng  printcap database, then the name is assumed to
        be a job identifier.
 
        The format of request-ID should be either  the  identifier
        field value or the job number reported by LPQ.
 
OPTIONS
        -P printer
               printer  name.   The  destination  printer is taken
               from the command line -P printer  value,  then  the
               environment  variables  PRINTER,  LPDEST, NPRINTER,
               NGPRINTER, then first entry in the printcap  infor­
               mation,  and  and finally the default_printer entry
               from the configuration file, and then  the  compile
               time default.
 
        -D debug-options
               Debug options for the program.
 
 OPERANDS
        The following operands are supported by cancel:
 
        ID             A  request ID, as returned by lp.  Specify­
                       ing a request  ID  cancels  the  associated
                       request even if it is currently printing.
 
        printer        A  printer  name  (for  a  complete list of
                       printer names, use lpq).  This  method  may
                       not be supported on all systems, and the -P
                       printer form should be used instead.
 
 ENVIRONMENT
        By default, the destination printer is taken from the com­
        mand  line  printer  value, then the environment variables
        PRINTER, LPDEST, NPRINTER, NGPRINTER, then first entry  in
        the    printcap   information,   and   and   finally   the
        default_printer entry from  the  configuration  file,  and
        then the compile time default.
 
 EXIT STATUS
        The following exit values are returned:
 
        zero (0)       Successful completion.
 
        non-zero (!=0) An error occurred.
 
SEE ALSO
        lpd.conf(5),  lpc(8),  lpd(8), checkpc(8), lpr(1), lpq(1),
        lprm(1), printcap(5), lpd.perms(5), pr(1).
 
 DIAGNOSTICS
        Most of the diagnostics are self explanatory.
        If you are puzzled over the exact cause of failure,
        set the debugging level on (-D5) and run again.
        The debugging information will
        help you to pinpoint the exact cause of failure.
 
 HISTORY
        LPRng is a enhanced printer spooler system with  function­
        ality  similar  to  the  Berkeley LPR software.  The LPRng
        mailing list is lprng@lprng.com; subscribe by sending mail
        to  lprng-request@lprng.com with the word subscribe in the
        body.      The     software     is     available      from
        ftp://ftp.astart.com/pub/LPRng.
 
AUTHOR
        Patrick Powell <papowell@lprng.com>.
 
 
 
                               LPRng                     CANCEL(1)

---