FAXRM(1)FAXRM(1)NAMEfaxrm - remove a HylaFAX job or document from a server
SYNOPSISfaxrm [ -a ] [ -d ] [ -v ] [ -h hostname ] id...
DESCRIPTIONfaxrm 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 aborted.
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 out
bound jobs can be seen by supplying the -f option to faxs_
tat. Documents in the receive queue can be viewed with
the -r option to faxstat.
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).
OPTIONS-a Use administrative privileges; faxrm will prompt
for the password to set administrative privi
leges.
-d Interpret each id as a document pathname. If a
pathname does not begin with ``/'' then faxrm
automatically prepends ``/docq/''.
-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 configu
ration 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.
CONFIGURATION PARAMETERSfaxrm reads configuration information from the file ${LIB
DATA}/hyla.conf and then from the file ~/.hylarc. Config
uration 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
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 option.)
Port The network port to contact for service.
(Eqvuialent to the -h option.)
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.)
DIAGNOSTICS
Job %s removed. A confirmation that the job was success
fully 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 success
fully deleted from the server.
SEE ALSOhylafax-client(1), sendfax(1), faxalter(1), faxstat(1),
hfaxd(${MANNUM1_8})
May 12, 1996 FAXRM(1)