faxrm − remove a Hyla FAX job or document from a server |
faxrm [ −a ] [ −d ] [ −v ] [ −h hostname ] id... |
faxrm removes one or more jobs or documents from a Hyla FAX 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 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 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). 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 ‘‘/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 Hyla FAX 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 ${LIBDATA}/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 option.) |
PassiveMode |
Whether or not to use passive mode in communication with the server. |
Port |
The network port to contact for service. (Equivalent 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.) |
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(1m) |