-1

Transmit facsimile documents using 1-D MR compression.
By default (Fx will use the optimal compression scheme supported
by the transmitting modem and receiving facsimile device.

-2

Transmit facsimile documents using 2-D MR compression, if possible.
By default (Fx will use the optimal compression scheme supported
by the transmitting modem and receiving facsimile device.

-3

Transmit facsimile documents using 2-D MMR compression, if possible.
By default (Fx will use the optimal compression scheme supported
by the transmitting modem and receiving facsimile device.

-a time

Schedule transmission up to one year in advance at the indicated
time .
Time
is specified in the format:
``[HH:MM [AM|PM]|now] [+ N
period
|
month
DD |
dayofweek
]'' where
month
can be Jan(uary), Feb(ruary), Mar(ch), Apr(il), May, Jun(e), Jul(y),
Aug(ust), Sep(tember), Oct(ober), Nov(ember), or Dec(ember);
period
can be minute(s), hour(s), day(s), week(s), or month(s);
dayofweek
can be Mon(day), Tue(sday), Wed(nesday), Thu(rsday), Fri(day),
Sat(urday), Sun(day);
e.g. ``now + 30 minutes'' to schedule transmission
30 minutes in the future.  Trailing information in the
time
field (such as YYYY) is ignored.
By default,
sendfax
schedules facsimile for immediate delivery.  Time should be given
in the user's local time.

-A

Archive the job on the server according to the
bin/archive script when the job is done.

-b speed

Transmit facsimile documents using a signalling rate that is
constrained to be at least
speed
bits/second.
If the specified speed is greater than the transmitting modem
or receiver is capable of, it is reduced to the highest possible
speed both devices support.
If a negotiated signalling rate greater than or equal to
speed
cannot be negotiated then the job is aborted.
Possible speeds are: 2400, 4800, 7200, 9600, 12000, 14400, 16800,
19200, 21600, 24000, 26400, 28800, 31200, and 33600.
By default (Fx will use the fastest possible rate supported by
the transmitting modem and receiving facsimile device.

-B speed

Try to transmit facsimile documents using the
desired signalling rate.
Possible speeds are: 2400, 4800, 7200, 9600, 12000, 14400, 16800,
19200, 21600, 24000, 26400, 28800, 31200, and 33600.
If the specified speed is greater than the transmitting modem
or receiver is capable of, it is reduced to the highest possible
speed both devices support.
By default (Fx will use the fastest possible rate supported by
the transmitting modem and receiving facsimile device (unless
restricted by other server configuration); this
option can be used to reduce the speed.
Note that international calls are frequently more reliable when
transmissions are restricted to 9600 bits/second.

-c comments

Pass
comments
to the
faxcover(1)
program for inclusion in the comments field of any generated
cover page.

-C file

Pass
file
to the
faxcover(1)
program for use as the cover page template.

-D

Enable notification by electronic mail when the
facsimile has been delivered.
By default (Fx will notify the submitter only if there is
a problem with a job.

-d destination

Create a job to transmit the supplied documents to
a facsimile machine at the indicated
destination .
If the
destination
is of the form ``user@phone-number#subaddress'' then any
cover page will show user as the intended receipient, and the
remote system will be supplied the subaddress value (i.e. for routing)
provided that the sending modem and the receiving system support it.

-E

Disable use of the Error Correction Mode (ECM)
when transmitting page data. Setting ECM to false
will limit the maximum speed to 14400 bps.
By default (Fx will attempt to use ECM when both
the trasmitting modem and receiving device support it.
Note that international calls are sometimes faster when
ECM is disabled.
Beware also that some modems and/or facsimile devices do not
properly implement ECM causing transmission failures.

-f from

Use
from
as the identity of the facsimile sender.
Otherwise the sender is the user that invoked
sendfax .
The sender is an account name to which the (Fx software
should direct notification messages.
The
from
identity may be a fullblown ``From:'' line, e.g.
e.g. ``Joe Blow <joe@foo.com>''
and ``joe@foo.com (Joe Blow)'' are acceptable.
If no host-part is specified in the
from
string the local hostname is used.
This option is useful when
sendfax
is invoked on behalf of another user, such as in the implementation
of an electronic mail to fax gateway.

-F format

Use the specified
format
when imaging tag lines on outgoing pages.
Consult the description of the
TagLineFormat parameter in
hylafax-config (5F)
for an explanation of how to construct a format string.
Note that many locales require that proper identification
appear on all transmitted facsimile; when using this facility
one should always include proper identification (e.g. a phone
number) in the imaged taglines.

-h \fR[\fPmodem\fR@]\fPhost\fR[\fP:port\fR]\fP

Force the jobs to be processed on a specific
host
and, optionally, using a particular
modem .
The
host
may be either a symbolic name or a network address.
If no
-h option is supplied,
sendfax
uses the
FAXSERVER
environment variable to identify the (Fx server to
which the jobs should be directed.
If no server is specified then
sendfax
attempts to contact a server on the local host.
If no modem is specified, the job will be submitted to any
available modem.

-i identifier

Use the
identifier
string in any notification messages instead of the usual job
identifier number.
This option is useful for applications that cross reference
notification messages against job submissions.

-I time

If a job must be requeued because of a communication failure schedule
the retry according to the specified
time .
Times are given in seconds.
Minutes, hours, and days can be specified with
``min'', ``hour'', and ``day'' suffixes, respectively.
By default (Fx reschedules jobs using retry times that depend on
the manner in which the job failed; this interface permits a user to
override this algorithm and specify a single fixed retry time for all
communication failures.

-k time

Kill the job if it does not complete in the indicated
time .
The
time
is specifed using notation identical to the
-a option.
Note that the
time
is relative to the time of the initial time-to-send.
The default kill time is ``now + 3 hours'' (three hours from the time
the job is first processed).
To retry for an hour, ``now +1 hour'' could be used.

-l

Transmit the facsimile at a vertical resolution of
98 lines/inch; otherwise known as low resolution.

-m

Transmit the facsimile at a vertical resolution of
196 lines/inch; otherwise known as medium resolution
or fine mode.

-M mst

Transmit facsimile documents using the specified
minimum scanline time.
Possible times are: 0ms, 5ms, 10ms2, 10ms, 20ms2, 20ms, 40ms2, and 40ms.
If the specified time is less than the transmitting modem
or receiver is capable of, it is increased to the lowest possible
time both devices support.
By default (Fx will use the lowest possible time supported by
the transmitting modem and receiving facsimile device (unless
restricted by other server configuration).
This option is mostly useful for debugging.

-n

Suppress the automatic generation of a cover page for
subsequent facsimile.
Note that polling requests do not receive a cover page unless they
are combined with the transmission of one or more files.

-N

Do not notify the sender by electronic mail when the
facsimile has been delivered or requeued.

-p

Poll each destination for any available documents.
If a poll request is made together with document transmission, the
poll operation is done after the documents are transmitted.
Documents received by polling are returned to the sender by
electronic mail.

-P priority

Assign the specified scheduling
priority
to subsequent jobs.
A priority is an integer value in the range [0-255].
Lower values result in higher priority processing.
By default, each job is assigned 127 for an initial scheduling priority.
If a job's priority is greater than bulk faxes then the
job's priority is raised (numerically lowered) for each
failed attempt to transmit so that retransmit attempts
are done ahead of newly submitted jobs.
In the case of bulk faxes (numerically higher than 190), then the
job's priority is lowered (numerically raised) for each failed
attempt to transmit so that the whole of the bulk-queued jobs
will be attempted before any are retried.
The
priority
may also be specified as one of the following symbolic names:
default
or
normal
(127),
bulk
or
junk
(191),
high
(63).

-R

Enable notification by electronic mail when the
facsimile has been delivered and when it is requeued for retransmission.
By default (Fx will notify the submitter only if there is
a problem with a job.

-r regarding

Pass
regarding
to the
faxcover(1)
program as the value of the ``Re:'' field of any generated cover page.

-s size

Set the page size to use for the transmitted facsimile.
Facsimile are normally imaged with a system-default page size
(usually letter-size pages, 8.5" by 11", for sites in North America).
Alternate page sizes are specified symbolically using either
the name or abbreviation of an entry in the
pagesizes (5F)
database; e.g.
a3
(ISO A3),
a4
(ISO A4),
a5
(ISO A5),
a6
(ISO A6),
b4
(ISO B4),
na-let
(North American Letter),
us-leg
(American Legal),
us-led
(American Ledger),
us-exe
(American Executive),
jp-let
(Japanese Letter),
and
jp-leg
(Japanese Legal).
Comparisons are case-insensitive and any match of a
substring of the full page-size name is sufficient; e.g. ``legal'' would
match ``American Legal''.
Note that it may not be permissible to image into the
full page area; the guaranteed reproducible area for a page is
typically inset.
Also, note that while arbitrary page sizes can be specified through
the page size database,
only a limited set of page dimensions are supported by the
Group 3 facsimile protocol.
Thus if an odd-size facsimile is submitted for transmission
it may not be possible to determine if it can be sent
until the fax server establishes communication
with the remote facsimile machine.

-t tries

Make no more than
tries
attempts to send the facsimile.
By default, (Fx will terminate a job if
3 consecutive attempts to send a particular page fail, or
it appears the receiver is not a facsimile machine.
Otherwise (Fx places no limit on the
number
of attempts to send a facsimile, instead terminating a job
if it is not completed within a
"kill time"
timeout interval.
Note that a try
is a call in which carrier is established and the facsimile
protocol is commenced; this is contrasted with a call
attempt that might have failed because the line was busy.
Use ``-1'' to indicate that no
tries
value should be specified to the server.

-T maxdials

Make no more than
maxdials
calls in attempting to send the facsimile.  By default, HylaFAX will
redial 12 times before killing a job.
Use ``-1'' to indicate that no
maxdials
value should be specified to the server.

-U voice-no

Pass
voice-no
to the
faxcover(1)
program as the sender's voice number.

-V voice-no

Pass
voice-no
to the
faxcover(1)
program as the destination person's voice number.

-w

Wait for the job to complete before ending the sendfax session.
If this option is used, the sendfax process will not terminate until
the job is completed.

-W fax-no

Pass
fax-no
to the
faxcover(1)
program as the sender's fax number.

-x company

Pass
company
to the
faxcover(1)
program as the destination company name.

-X company

Pass
company
to the
faxcover(1)
program as the sender's company name.

-y location

Pass
location
to the
faxcover(1)
program as the destination company's location.

-Y location

Pass
location
to the
faxcover(1)
program as the sender's company location.

-z filename

Read destinations from
filename
which contains a list of the destinations formatted identically as
destinations for the
-d option, one per line.  Usage of this option is similar to the
-d option and may be done in conjunction with other
-d and
-z options.

-v

Print information on the standard output
about each conversion and cover sheet
generation operation it does.
If
-v is specified twice, the protocol between
sendfax
and the
hfaxd
server process that does the submission work on the
remote machine is also displayed.

Tag Type Default Description


AutoCoverPage boolean Yes automatically generate cover page


ChopThreshold float 3.0 page chopping threshold


CoverCmd string see below pathname of cover sheet program


Cover-Comments string - cover page comments string


Cover-Company(S1 string - cover page to-company name string


Cover-Location(S1 string - cover page to-company location string


Cover-Regarding string - cover page regarding string


Cover-Template string - cover page template filename


Cover-Voice(S1 string - cover page to-voice number string


Cover-From-Company(S1 string - cover page from-company string


Cover-From-Location(S1 string - cover page from-location string


Cover-From-Voice(S1 string - cover page from-voice number string


Cover-From-Fax(S1 string - cover page from-fax number string


DateFormat string - cover page date format string


DesiredEC boolean - desired use of ECM


DesiredMST string - desired minimum scanling time to use


DesiredSpeed integer - desired signalling rate to use


DialRules string see below file containing dialstring rules


From string - sender's identity


HRes float 204. horizontal resolution


Host string localhost host to contact for service


KillTime string - time to expire job


MailAddr string - mail address for notification messages


MaxDials integer 12 times to retry dialing


MaxTries integer 3 times to retry transmission


MinSpeed integer - minimum acceptable signalling rate


Modem string - modem to use on server


Notify string none control email notification


PageChop string default control page chop handling


PageLength float - page length in millimeters


PageSize string default page size by name


PageWidth float - page width in millimeters


Port integer 4559 port to use in contacting server


Priority string default job scheduling priority


Protocol string tcp protocol to use in contacting server


RetryTime string - delay between failed attempts to send


SendTime string - time to send job


TagLine string - tagline format string


TypeRules string see below file containing file typing rules


VRes float 98. vertical resolution


Verbose boolean No whether or not to enable protocol tracing


 

  


 The configuration parameters are explained below.


Certain configuration parameters, notably those for setting strings


on automatically generated cover pages, are defined mainly for use


by other (Fx programs that share common code used by


  sendfax .

 
    AutoCoverPage 
 Control whether or not a cover page is automatically generated


for each job.


(Equivalent to the


  -n option.)


 
 
    ChopThreshold 
 The amount of white space, in inches, that must be present at the bottom


of a page before (Fx will attempt to truncate the page transmission.


 
 
    CoverCmd 
 The absolute pathname of the program to use to generate cover pages.


The default cover sheet program is 


  /usr/bin/faxcover .

 
 
 
    Cover-Comments 
 The comments string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-Company 
 The to-company name string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-Location 
 The to-company location string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-Regarding 
 The regarding string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-Template 
 The absolute pathname of a cover sheet template file to use


in auto-generating cover pages.


 
 
    Cover-Voice 
 The to-voice number string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-From-Company 
 The from-company name string to pass to the cover sheet program


when auto-generating cover pages.


 
 
    Cover-From-Location 
 The from-location string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-From-Voice 
 The from-voice number string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    Cover-From-Fax 
 The from-fax number string to pass to the cover sheet program when


auto-generating cover pages.


 
 
    DateFormat 
 The 


  strftime(3) 

 format string to pass to the cover page command when auto-generating


cover pages.


 
 
    DesiredEC 
 Whether or not to request the use of the optional


Error Correct Mode (ECM) when transmitting facsimile.


(Equivalent to the


  -E option.)


 
 
    DesiredMST 
 The desired minimum scanline time to use when transmitting facsimile.


(Equivalent to the


  -M option.)


 
 
    DesiredSpeed 
 The desired signalling rate to the use when transmitting facsimile.


(Equivalent to the


  -B option.)


 
 
    DialRules 
 The name of the file containing the dialstring processing rules to


when preparing an externally visible representation of the dialstring


(e.g. to strip credit card numbers).


By default this is /usr/share/fax/dialrules.


 
 
    From 
 The sender's identity.


(Equivalent to the


  -f option.)


 
 
    Host 
 The host to contact for service.


(Equivalent to the


  -h option.)


 
 
    HRes 
 The horizontal resolution to use when transmitting facsimile.


(NB: this currently has no effect.)


 
 
    KillTime 
 The expiration time to assign to each job.


(Equivalent to the


  -k option.)


 
 
    MailAddr 
 The electronic mail address to direct notification messages from the


server.


If this string is specified without an ``@hostname'' part then the


local hostname will automatically be appended.


(Equivalent to the


  -f option.)


 
 
    MaxDials 
 The maximum number of times to dial the phone for each job.


(Equivalent to the


  -T option.)


 
 
    MaxTries 
 The maximum number of times to retry sending a job.


(Equivalent to the


  -t option.)


 
 
    MinSpeed 
 The minimum acceptable signalling rate to use when transmitting facsimile.


(Equivalent to the


  -b option.)


 
 
    Modem 
 The modem to use on the server.


(Equivalent to the


  -h option.)


 
 
    Notify 
 Control the email notification messages from the server.


This string may be one of ``done'', ``none'', ``requeued'' or ``default''


with an optionally preceding ``when '' (e.g. ``when done'').


Note that ``when requeued'' implies ``when done''.


(Equivalent to the


  -D ,

   -R ,

 and


  -N options.)


 
 
    PageChop 
 Control page chop handling when transmitting facsimile.


This string may be one of ``none'', ``all'', or ``last' to have


no pages chopped, all pages chopped, or only the last page chopped;


respectively.


Page chopping is controlled by the 


  ChopThreshold parameter.


 
 
    PageLength 
 Set the transmitted page length in millimeters.


 
 
    PageSize 
 Set the page dimensions according to an entry in the


  pagesizes (5F)

 database.


(Equivalent to the


  -s option.)


 
 
    PageWidth 
 Set the transmitted page width in millimeters.


 
 
    Port 
 The network port to contact for service.


(Eqvuialent to the


  -h option.)


 
 
    Priority 
 The scheduling priority to assign to each job.


(Equivalent to the


  -P option.)


 
 
    Protocol 
 The name of the communication protocol to use when contacting a server.


(Equivalent to the


  FAXSERVICE environment variable.)


 
 
    RetryTime 
 The time to delay between job retries due to a communication failure.


(Equivalent to the


  -I option.)


 
 
    SendTime 
 The time to send jobs.


(Equivalent to the


  -a option.)


 
 
    TagLine 
 The tagline format string to use when transmitting facsimile.


(Equivalent to the


  -F option.)


 
 
    TypeRules 
 The name of the file containing file type conversion rules.


By default this is /usr/share/fax/typerules.


 
 
    Verbose 
 Control protocol tracing.


(Equivalent to the


  -vv option.)


 
 
    VRes 
 Set the vertical resolution in lines/inch


to use when transmitting facsimile.


(Equivalent to the


  -m and


  -l options.)


 
 

~/.hylarc	per-user configuration file
/usr/share/fax/hyla.conf	system-wide configuration file
/usr/share/fax/sendfax.conf	system-wide configuration file
/usr/share/fax/typerules	file type and conversion rules
/usr/share/fax/pagesizes	page size database
/usr/share/fax/dialrules	optional client dialstring rules
/usr/bin/faxcover	for generating cover sheets
/usr/sbin/textfmt	for converting text to PostScript
/usr/sbin/sgi2fax	for converting SGI RGB images
/var/spool/fax/tmp/sndfaxXXXXXX	temporary files