courierfax(8)
NAME
courierfax - Send faxes via E-mail
SYNOPSIS
sendmail [5558888@fax] sendmail [5558888@fax-lowres] sendmail [5558888@fax-ignore] sendmail [5558888@fax-cover]
DESCRIPTION
The courierfax module (if enabled by the system administrator) sends
E-mail messages by fax. Addressing an E-mail message to the address
5558888@fax faxes a printed copy of the message to the specified phone
number.
The ability to send faxes may be restricted, or not available. The
E-mail message may be a MIME-formatted message. All attachments are
concatenated and sent together in a single fax transmission.
courierfax only knows how to handle certain kinds of attached.
Obviously, trying to fax a voice .mp3 attaching is not going to work.
courierfax knows how to handle plain text, Postscript, and PDF MIME
attachments. courierfax might also know what to do with other kinds of
attachment, depending on some optional software installed by the system
administrator. courierfax may also be able to read GIF, PNG, and JPEG
images.
Note
Color images are converted to black-and-white.
Images are faxed with one image per fax page (limiting image sizes to
about 1600x2200).
The message will be returned as undeliverable if courierfax doesn't
know how to handle a MIME attachment. If the first MIME section in the
E-mail message is plain text, the text appears on the fax cover page.
The sender/recipient information for the cover page is taken from the
message's headers.
The default courierfax configuration tries to resend the fax for up to
eight hours, after which the message is returned as undeliverable. The
message will also be returned as undeliverable if the fax transmission
is interrupted. The return bounce will state how many pages were
successfully transmitted.
"@fax" may also be followed by additional keywords that specify extra
options:
-lowres
Send a low-resolution fax.
-ignore
Ignore any attachment types that courierfax doesn't understand.
-cover
Send a cover page only. This is useful in limited situations, with
something like this in a dot-courier(5)[1] file:
./Maildir
! 5552222@fax-cover
This .courier file faxes the contents of a message, sans any
attachments, immediately upon receipt in addition to saving the
message in the mailbox.
FAX TRANSMISSION RECEIPT
The sender will receive a fax transmission receipt if the sender requests an ESMTP delivery status notification. This is the -N option to sendmail(8)[2]: sendmail -Nsuccess 5556666@fax <messagefile When using other mail software, consult the mail software's documentation for instructions on requesting ESMTP delivery status notifications.
ADDITIONAL DIALING OPTIONS
courierfax configurations that are generated by the webadmin tool for
North American environments usually restrict phone numbers to a
standardized ten-digit telephone number, so that the fax address is
always <aaabbbcccc@fax>, and courierfax silently performs any needed
conversion to dial the number (such as adding "1" or dropping the local
areacode).
It is also possible to reconfigure courierfax so that it accepts any
telephone string and dials it without any preprocessing. If so, the
address may contain any combination of digits, letters "A", "B", "C",
and "D", representing the four extra dialing tones not normally
accessible from most telephone keypads, the symbols "*" and "#", or the
following characters:
W
Most faxmodems pause and wait for a secondary dialtone, before
dialing the rest of the number.
-
The dash is replaced by a comma in the dialing string. A comma
results in most faxmodems pausing for two or three seconds before
dialing the rest of the number. It is not possible to enter a comma
directly, because commas are used to separate multiple E-mail
addresses. Use dashes instead of commas in the dialing string.
courierfax replaces all dashes with commas before dialing the
faxmodem.
+
Similarly, courierfax replaces all pluses with "@" characters
before dialing. An "@" characters results in most faxmodems waiting
for the line to be silent for five seconds before dialing the rest
of the number. It is not possible to enter a "@" directly as part
of the telephone number itself, for the obvious reasons. Use pluses
instead of "@"s in the dialing string. courierfax replaces all
pluses with "@" before dialing the faxmodem.
CONFIGURATION
The slightly arcane configuration file, /etc/courier/faxrc, sets up which dialing strings are valid. The default configuration file contains judicious comments that explain all the parameters, and what they do. The default configuration file disables courierfax by rejecting all telephone numbers. The file must be edited in accordance with the embedded instructions, in order to enable faxing. Using webadmin is highly recommended. Upon demand, webadmin will install a suitable configuration file for the North American numbering plan, that receives all telephone numbers as ten-digit numbers, and adds any required long distance prefix, or removes the local area code, as appropriate. Or, webadmin will install a bare-bones configuration file that dials any requested phone number, without any editing or transformation.
BUGS
There is no good way to sleep until a modem lock is released, so we poll every minute.
SEE ALSO
courier(8)[3].
AUTHOR
Sam Varshavchik
Author
NOTES
1. dot-courier(5)
[set $man.base.url.for.relative.links]/dot-courier.html
2. sendmail(8)
[set $man.base.url.for.relative.links]/sendmail.html
3. courier(8)
[set $man.base.url.for.relative.links]/courier.html
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
