FAXRM(1)                     General Commands Manual                    FAXRM(1)

       faxrm - remove a HylaFAX job or document from a server

       faxrm [ -a ] [ -d ] [ -v ] [ -h hostname ] id...

       faxrm removes one or more jobs or documents from a HylaFAX server.  If a
       job that is to be removed is being processed by a server, it is first

       An id is either a number that identifies a job (default) or, if the -d
       option is specified, a document pathname.  Job identifiers are printed by
       sendfax(1) when jobs are queued for transmission; they can also be
       displayed with faxstat(1).  The names of documents associated with
       outbound jobs can be seen by supplying the -f option to faxstat.
       Documents in the receive queue can be viewed with the -r option to

       Unprivileged users can only remove jobs or documents that they own.
       Clients with administrative privileges can remove any job or document
       (see the -a option below).  The user name may be specified by the FAXUSER
       environment variable.

       -a        Use administrative privileges; faxrm will prompt for the
                 password to set administrative privileges.

       -d        Interpret each id as a document pathname.  If a pathname does
                 not begin with ``/'' then faxrm automatically prepends

       -h host   Contact the server at the specified host.  The host may be
                 either a symbolic name or a network address.  If no server is
                 specified then If no -h option is supplied, faxrm uses the
                 FAXSERVER environment variable to identify the HylaFAX server
                 to contact.  If this variable is not set, then faxrm checks for
                 a setting in the configuration files (first in the per-user
                 file and then in the system-wide file).  If all of the above
                 fails, then faxrm attempts to contact a server on the machine
                 where it is run.

       -v        Trace the protocol messages to and from the server.

       faxrm reads configuration information from the file
       /usr/lib/fax/hyla.conf and then from the file ~/.hylarc.  Configuration
       files follow the conventions described in hylafax-client(1).  The
       following configuration parameters are recognized:
       Tag               Type       Default      Description
       Host              string     localhost    host to contact for service
       PassiveMode       boolean    false        whether or not to use passive mode
       Port              integer    4559         port to use in contacting server
       Protocol          string     tcp          protocol to use in contacting server
       Verbose           boolean    No           whether or not to enable protocol tracing

       The configuration parameters are explained below:

       Host      The host to contact for service.  (Equivalent to the -h

                 Whether or not to use passive mode in communication with the

       Port      The network port to contact for service.  (Equivalent to the -h

       Protocol  The name of the communication protocol to use when contacting a
                 server.  (Equivalent to the FAXSERVICE environment variable.)

       Verbose   Control protocol tracing.  (Equivalent to the -v option.)

       Job %s removed.  A confirmation that the job was successfully removed
       from the sendq directory.

       Job %s removed (from doneq).  A confirmation that the job was
       successfully removed from the done directory; the directory where jobs
       are placed once they are finished.

       %s removed.  A confirmation that the document was successfully deleted
       from the server.

       hylafax-client(1), sendfax(1), faxalter(1), faxstat(1), hfaxd(8C)

                                  May 12, 1996                          FAXRM(1)