INFO(5F)INFO(5F)NAMEinfo - remote device capability database
DESCRIPTION
The info subdirectory in the HylaFAX spooling area holds
information about the capabilities and status of devices
that have been called. One file exists for each device,
with the filename created from the remote device's fully-
qualified phone number. Files have a simple ASCII format.
Each line is of the form
[&]tag: value
where a tag identifies a capability and a value is either
a string, number, or boolean value. An optional ``&'' at
the front of the line indicates that the tag's value is
locked down and should not be updated by the server. This
facility is useful for restricting the capabilities used
with a particular machine.
The following items are recorded:
Tag Type Description
calledBefore boolean device has previously answered at this number
dialFailures number count of consecutive failed dial operations
lastDialFailure string reason for last failed dial operation
lastSendFailure string reason for last failed send attempt
maxPageWidth number maximum page width in pixels
maxPageLength number maximum page length in millimeters
maxSignallingRate string maximum signalling rate (bits/sec) to use
minScanlineTime string minimum scanline time
pagerMaxMsgLength number length of longest allowed text message
pagerPassword string password string send to service provider
pagerSetupCmds string commands for setting up modem for a specific service provider
pagerTTYParity string parity & # bits configuration for IXO/TAP communication
pageSource string parameter to tell the paging central who we are
pagingProtocol string protocol (IXO or UCP) for this provider
remoteCSI string remote device Called Subscriber Identification
sendFailures number count of consecutive failed send attempts
supportsHighRes boolean accepts 196 line/inch images
supports2DEncoding boolean accepts Group 2D encoding
supportsPostScript boolean accepts Adobe POSTSCRIPT transfer protocol
The HylaFAX scheduler, faxq(8C), uses the information
stored in this directory when deciding if a call should be
placed and when preparing documents for transmission. If
a remote device's capabilities are known, then document
preparation is constrained and/or optimized according to
the capabilities. Otherwise, documents are prepared with-
out regard for the remote device's capabilities and if a
capability mismatch is encountered the session is termi-
nated and the documents are reformatted using the newly
discovered capabilities.
The calledBefore item is used by faxsend to decide whether
or not to redial a phone number when encountering certain
errors. For example, if a dialing command results in a
February 10, 1996 1
INFO(5F)INFO(5F)
``NO CARRIER'' result, then the number will not be retried
unless the number has previously been dialed successfully.
The minScanlineTime item indicates the minimum scanline
time parameter used for facsimile transmissions. Accept-
able values are: ``0ms'', ``5ms'', ``10ms/5ms'', ``10ms'',
``20ms/10ms'', ``20ms'', ``40ms/20ms'', and ``40ms''.
(Values of the form X/Y mean to use X for 98 lpi images
and Y for 196 lpi images.)
The pagerTTYParity item specifies the communication param-
eters to use when communicating with the IXO/TAP service
provider. Acceptable values are: ``even'' (7 bits, even
parity), ``odd'' (7 bits, odd parity), and ``none'' (8
bits, no parity). If nothing is specified then ``even''
is used per the standard.
The pagerMaxMsgLength, pagerPassword, and pagerTTYParity
items can be setup according to the requirements of a
pager service provider; they typically are locked down so
that their values are not lost during updates.
The pagerSetupCmds can be used to define AT commands for
setting up the modem for a specific service provider.
This value overwrites the settings defined in config(5F).
The pageSource parameter can be used to tell the paging
central who we are. It usually contains a SMS answerable
mobile number. It is only used for the UCP part of send-
page(8C). Note: This parameter should be used from user-
land sendpage(1) and will be removed later.
The pagingProtocol defines which protocol, UCP or IXO,
should be used to send the message to the service
provider. It defaults to ``ixo''; for UCP set ``ucp''.
NOTES
faxsend, pagesend, and faxq automatically create and
update entries in the info directory, as required.
The data in this directory is simply a cache of remote
capabilities and, except for locked down items, can be
safely purged at any time. The faxcron(8C) script, for
example, periodically purges unlocked entries in this
directory that have not been accessed in 30 days.
SEE ALSOfaxcron(8C), faxq(8C), faxsend(8C), pagesend(8C),
cinfo(5F), config(5F)
February 10, 1996 2
