efax [ 옵션 ] [ -t 번호 [ 화일... ] ]
옵션의 의미는 다음과 같다:
전송될 페이지는 각각 그룹 3 (G3) 압축을 사용하는 TIFF 형식으로 변환되어야 한다. 수신된 페이지 또한 이 형식으로 저장된다. 아래의 예제 섹션에서는 이 화일을 만들고 보고 출력하기 위하여 efix 또는 다른 프로그램을 어떻게 사용하는지 보여줄 것이다.
efax는 텍스트, T.4 (그룹 3), PBM, TIFF( G3 또는 비압축 상태 )등 efix(1)가 받아들이는 화일 형식을 읽는다. efax는 화일의 내용을 보고 화일 형태를 자동으로 판별한다. TIFF는 이미지 해상도에 대한 정보를 가지고 있으므로 권장한다. 텍스트 또는 멀티 페이지 TIFF를 보낼 때는 헤더의 페이지 번호가 틀릴 수 있다. 왜냐하면 페이지 번호는 화일명의 갯수로 처리되기 때문이다.
운영체제는 프로토콜 타임아웃을 피하기 위해 짧은 반응 시간을 제공할 수 있어야 한다. 클래스 2 모뎀의 경우 지연시간이 1, 2 초를 넘어선 안된다.
클래스 1 모뎀을 사용하는 경우 프로그램은 어떤 이벤트에 대하여 55 밀리 초 이내로 반응해야 한다. 이보다 긴 지연이 발생하면 팩스 프로토콜이 실패할 수 있다. ( DCS와 TCF 또는 RTC와 MPS 사이에서 ) 따라서 클래스 1 은 수신 자료에 대하여 55 밀리초 이내에 반응할 수 없는 시스템에서는 사용할 수 없다. 특히 몇몇 지능형 시리얼 카드 또는 터미널 서버의 경우 클래스 1 작동에 지장을 줄 만한 지연을 유발하기도 한다.
운영체제는 일정한 (보통 9600 bps) 전송률로 끊김없이 모뎀으로부터 디스크 화일로 저장할 수 있도록 충분한 저수준 버퍼링을 지원해야 한다. 팩스 프로토콜은 양자 간의 흐름 제어를 제공하지 않기 때문에 수신 중의 흐름 제어 성능은 모뎀의 버퍼량에 의해 제한된다. 이는 100 바이트 미만일 수 있다. Efax는 수신 중 흐름 제어를 사용하지 않는다.
"그룹"이란 팩스 머신 또는 팩스 모뎀 사이에 팩스를 전송하는데 사용하는 프로토콜을 말한다. Efax는 표준 그룹 3 프로토콜을 지원한다. "클래스"란 컴퓨터가 팩스 모뎀을 제어할 때 사용하는 프로토콜을 말한다. Efax는 클래스 1, 2 팩스 모뎀을 지원한다. 클래스 2.0 지원은 아직 테스트되지 않았다.
대부분의 팩스 모뎀은 팩스 모드의 경우 XON/XOFF 흐름 제어를 사용한다. 이런 형태의 흐름 제어는 팩스의 경우 거의 부하를 주지 않는다. 많은 모뎀들은 팩스 모드에서 믿음직하지 못한 하드웨어 (RTS/CTS) 제어를 지원한다. efax는 XON/XOFF와 하드웨어 흐름 제어 모두 지원한다.
몇몇 모뎀은 약 1k 바이트의 시리얼 버퍼를 갖고 있는 경우도 있으나 많은 저가형 모뎀은 약 100 바이트 정도의 버퍼를 가지고 있을 뿐이며 팩스 전송시 오버런이 일어날 가능성을 갖는다.
몇몇 모뎀은 각각의 명령 사이에 efax가 사용하는 기본값인 100 밀리초 이상의 지연 시간을 필요로 한다. 만약 지연시간이 너무 짧다면 명령이 제대로 반향되지 않거나 타임아웃 또는 제대로 반응하지 않는다. 한 번 이상의 -oz 옵션을 사용하여 모뎀 초기화 명령 사이의 지연시간을 늘리고 모뎀 명령의 반향을 없애기 위해 E0 모뎀 초기화 명령을 사용하라.
기본적으로 efax는 클래스 2 모뎀으로부터 팩스를 받을 때 모뎀의 자료 전송 시작에 대하여 DC2 를 전송한다. 몇몇 구식 모뎀은 대신 XON 을 필요로 하기도 한다. 이런 모뎀의 경우 DC2 신호는 에러 메세지를 내거나 프로그램의 타임아웃을 유발한다. 이 때는 -ox 옵션을 사용하라.
몇몇 구식 클래스 2 모뎀 ( 예를 들어 몇 가지 인텔 모델 )은 팩스를 전송할 때 모뎀에게 자료 전달을 시작하도록 하기 위해 DC2 또는 XON을 보내지 않는다. 2 초 후 efax는 경고 메세지를 출력하고 어찌 되었든 전송을 시작한다.
극소수의 클래스 2 모뎀은 자료를 전송받을 때 비트 순서 (MSB에서 LSB로)를 바꾸지 않는다. 이런 경우 수신된 화일을 보거나 출력하면 엉뚱한 결과를 얻게 될 것이다. 이 때는 -or 옵션을 사용하라.
몇몇 저가 "9600 bps" 팩스 모뎀은 오로지 9600 bps로만 전송하고 수신 속도는 4800 bps로 제한하고 있다.
다음과 같은 클래스 1 모뎀이 efax와 잘 작동한다고 알려져 있다: AT&T DataPort, Cardinal Digital Fax Modem (14400), Digicom Scout+, Motorola Lifestyle 28.8, Motorola Power 28.8, QuickComm Spirit II, Smartlink 9614AV-Modem, Supra Faxmodem 144LC, USR Courier V.32bis Terbo, USR Sportster (V.32 and V.34), Zoom AFC 2.400, Zoom VFX14.4V.
다음과 같은 클래스 2 모뎀이 efax와 잘 작동한다고 알려져 있다: 14k4 Amigo Communion fax/modem, Adtech Micro Systems 14.4 Fax/modem, askey modem type 1414VQE, AT&T DataPort, ATT/Paradyne, AT&T Paradyne PCMCIA, Boca modem, BOCA M1440E, Crosslink 9614FH faxmodem, FuryCard DNE 5005, GVC 14.4k internal, Intel 14.4 fax modem, Megahertz 14.4, ,Microcom DeskPorte FAST ES 28.8, Motorola UDS FasTalk II, MultiTech 1432MU, Practical Peripherals PM14400FXMT, Supra V32bis, Telebit Worldblazer, TKR DM-24VF+, Twincom 144/DFi, ViVa 14.4/Fax modem, Vobis Fax-Modem (BZT-approved), Zoom VFX14.4V, ZyXEL U-1496E[+], ZyXEL Elite 2864I.
필수적인 모뎀 초기화 명령은 efax에 의해 이뤄진다. 추가 명령은 명령행 인수로 주어질 수 있다. 모뎀은 자세한( 텍스트 형식으로 ) 결과 코드를 출력하도록 설정되어야 한다. 다음 명령이 그런 설정과 관련되어 있으며 모뎀 초기화시 efax에 의해 보내진다.
다음 명령이 유용할 수 있다:
지역 하드웨어, 소프트웨어의 기능은 콤마로 구분하는 8 개의 숫자로 된 문자열로 설정한다:
vr,br,wd,ln,df,ec,bf,st
설명은 다음과 같다:
적절한 기능 문자열이 제시되어야 한다는 사실이 중요하다.
팩스를 수신할 때는 vr, wd, ln 과 기능 문자열 필드를 여러분의 디스플레이 소프트웨어가 지원하는 최대치로 놓아야한다.
팩스를 송신할 때는 efax가 이미지 화일 헤더로부터 vr를 결정하고 wd과 ln 필드는 이미지 화일의 포맷을 보여줘야 한다.
수신 팩스 머신이 고해상도를 지원하지 않으면(vr=1) efax는 스캔 라인을 합쳐 해상도를 줄인다. 수신 팩스 머신이 이미지 폭을 지원하지 않으면 알맞게 크기를 채우거나 잘라낸다. 대부분의 팩스 머신은 ln를 2 까지 지원한다. wd값이 0 아닌 값을 지원하는 팩스는 거의 없다.
efax는 전송 시 각 이미지의 위에 빈 스캔 줄을 추가한다. 이 부분은 페이지 헤더를 위한 공간이지만 이미지의 크기를 늘리게 된다. ( 기본값으로 약 0.1 인치 또는 2.5 mm의 빈 줄이 추가된다 )
헤더는 페이지 꼭대기의 처음 스캔 줄에 찍힌다. 보통 날짜, 시간, 송신인, 수신인 ID, 페이지 번호와 장수를 포함한다. 헤더를 없앨 수는 없고 빈 줄로 할 수 있다.
헤더를 생성하는 기본 폰트는 12x24 픽셀로 조정되는 내장 8x16 픽셀 폰트이다. ( 약 9 포인트 크기 )
efax와 efix는 폰트를 지정하는 -f 옵션을 가지고 있다는 것을 기억하라. efIx는 텍스트-팩스 전환 시 텍스트 출력을 위해 폰트를 사용한다. ( "팩스 생성" 과정) 반면 efAx는 헤더 출력을 위해 사용한다. ( "팩스 전송" 과정 )
세션 기록은 표춘 에러에 쓰여진다. 그 화면은 -v 옵션으로 선택된 프로그램의 메세지이다. 총 소요시간과 분, 초가 각 메세지 앞에 출력된다. 모뎀 반응과 함께 출력되는 시간은 밀리초 단위이다.
다음과 같은 에러 코드를 반환한다:
팩스 (G3) 화일 만들기
텍스트 화일을 TIFF-G3 형식으로 변환할 때는 efix 프로그램을 사용하면 된다. 예를 들어 다음 명령은 letter라는 텍스트 화일을 letter.001, letter.002 등의 화일로 변환한다:
efix -nletter.%03d <letter
efix 프로그램은 서두나 서명 등을 생성하기 위하여 이미지에 비트맵을 삽입할 수 있도록 해준다.
고스트스크립트의 tiffg3 드라이버를 가지고 포스트스크립트 화일로부터 TIFF-G3 형식의 팩스 화일을 만들 수 있다. 예를 들면 다음과 같다:
gs -q -sDEVICE=tiffg3 -dNOPAUSE \
-sOutputFile=letter.%03d letter.ps </dev/null
letter.ps 라는 포스트스크립트 화일을 고해상도(vr=1) G3 팩스 이미지 화일 letter.001, letter.002, ... 로 변환한다.
The images should have margins of at least 1/2 inch (1 cm) since 이미지는 최소한 1/2 인치( 1 cm )의 테두리를 가져야 하는데 팩스 표준에서는 폭 196.6 mm, 높이 281.5 mm ( 폭 7.7 인치, 높이 11.1 인치 )의 중앙부를 출력하기 때문이다.
팩스 화일 출력하기
HP-PCL 프린터 또는 포스트스크립트 장치에 출력하기 위해서는 efix를 사용한다. 예를 들어 수신된 팩스를 300 dpi로 포스트스크립트 프린터에 출력하려면 다음과 같이 명령한다:
efix -ops -r300 -s1.5 <reply.001 | lpr
수많은 이미지 형식 간의 변환을 위해서는 Portable Bit Map (pbm) 꾸러미를 사용하기도 한다. 예를 들어 수신된 이미지, reply.001 을 약 2/3 크기로 HP 레이져젯에서 출력하려면 다음과 같이 한다:
efix -opbm reply.001 | pbmtolj -resolution 300 | lpr
팩스 화일 보내기
다음 예는 톤 다이얼링으로 222-2222에 전화를 걸고 TIFF/G3 화일 letter.001과 letter.002, 2 페이지를 /dev/cua1 장치에 연결된 클래스 1 팩스모뎀을 통해 팩스 전송한다.
efax -d /dev/cua1 -o1 \
-t T222-2222 letter.001 letter.002
수동 수신
efax로 하여금 즉시 전화를 받고 팩스 수신을 하도록 할 수 있다. 팩스인지 음성인지 수동으로 답신해야 할 필요가 있을 때 사용한다.
예를 들어 다음 명령은 /dev/ttyS1 장치에 연결된 클래스 2 팩스 모뎀으로 하여금 전화를 받고 팩스를 수신하도록 한다. 수신된 팩스는 reply.001, reply.002, ... 등의 화일명으로 저장된다. 모뎀은 자기 자신을 "555 1212" 라고 알리며 14.4 kbps (br=5)로 고 또는 저해상도로 팩스를 수신한다.
efax -d /dev/ttyS1 -or -l "555 1212" \ -c 1,5 -r reply
자동 수신
-w 옵션은 팩스 수신을 시작하기 전에 모뎀으로부터 문자가 전달되기를 기다리게 만든다( 즉 팩스 송신이 오는 상태 ) n 회 전화벨이 울리고 나서 통화에 응하려면 -w 옵션과 -iS0=n 옵션을 사용하라. 다음 예는 4 번 벨이 울리면 팩스 모드에서 전화를 받도록 하며 수신된 팩스를 수신 날짜와 시간에 맞는 화일명으로 저장하게 한다.
efax -d /dev/ttyb -or -w -iS0=4 2>&1 >> fax.in.log
모뎀을 전화걸기와 함께 사용하기
모뎀 장치는 UUCP 장치 잠금 프로토콜을 사용하는 프로그램들 사이에 공유될 수 있다. ( 커밋, uucico, efax, cu 등 )
efax는 -x 옵션을 통해 하나 이상의 UUCP 잠금 화일명이 주어지면 모뎀 장치를 열기 전에 모뎀을 잠근다. 잠금 화일명은 보통 /usr/spool/uucp/LCK..dev인데 dev은 잠그고자 하는 /dev 디렉토리 장치화일명이다. ( 역자 주 : 리눅스에서는 /var/spool/uucp/LCK..dev )
-s (공유) 옵션이 사용되면 다른 프로그램이 그 동안 사용할 수 있도록 전화를 기다리는 동안은 잠금 화일을 지운다.
efax는 팩스를 기다리는 동안 다른 프로그램이 모뎀이 사용하고 있음을 감지하면 종료 코드값을 1을 가지고 종료한다. 그 다음 efax 프로세스는 모뎀을 초기화하고 다시 팩스를 기다리기 시작하기 전에 다른 프로그램이 종료하기를 기다린다.
UUCP 잠금 화일이 아닌 다른 방식의 장치 잠금 기법을 사용하는 프로그램은 이러한 무작위 방식을 이용할 수 없다. 왜냐하면 그 장치는 efax에게 그대로 열릴 수 있기 때문이다. 이런 경우 다른 프로그램을 실행하기에 앞서 efax 프로세스를 죽여야 한다. ( 즉 "팩스 종료" )
efax가 팩스를 기다리는 동안 모뎀은 팩스 모드에서 수신 대기하도록 해두면서 잠금 화일을 제거한다. SLIP이나 PPP 프로그램이 자신의 잠금화일을 설정하면서 모뎀 포트를 차지하면 efax는 더 이상 모뎀에 명령을 보낼 수 없다. 물론 재설정도 불가능하다. 다라서 다른 프로그램들은 시작시 자료 모드로 돌아가기 위해 모뎀을 재설정해야 한다. 여러분의 SLIP, PPP 채트 스크립트 앞에 재설정 명령을 추가하라. (send ATZ expect OK)
팩스와 데이터 요청을 받아들이기
많은 모뎀들은 -j+FAE=1 ( 클래스 1 의 경우 ) 또는 -jFAA=1( 클래스 2.[0]의 경우 ) 초기화 문자열을 사용함으로써 자동 데이터/팩스 응답 모드를 가질 수 있다. 이런 응답 기능 ( 데이터 또는 팩스 )은 모뎀의 반응을 보고 알 수 있다.
몇몇 모뎀들은 제한된 자동 응답 기능( 예. 특정 보드율에서만 작동하거나 클래스 2 모드에서만 작동 )을 갖거나 아예 갖고 있지 않다. 이 경우 우선 데이타 모드로 응답하기 위하여 -i+FCLASS=0 초기화 문자열을 사용하고 첫번째 시도가 실패하면 끊기를 위해 -oa를 사용한 후 다시 팩스 모드를 시도한다. 이 방법은 여러분의 전화 시스템이 걸려오는 전화를 끊기 전에 여러분이 끊기를 시도한 후 몇 초 기다리는 경우에만 될 것이다.
-g 옵션이 사용되면 옵션 인수가 데이터 접속 요청이 감지되었을 때 쉘 명령으로 실행될 것이다. 보통 이 명령은 getty(8)를 실행한다. 이 프로그램은 회선 끊기를 행하거나 잠금 화일을 만들지 않도록 모뎀이 이미 받기 상태이며 잠금 화일이 있다는 것을 예상할 수 있어야 한다. 주의할 것은 모뎀이 DCE-DCE ( 모뎀-모뎀, 예를 들어 CONNECT 14400 )속도를 보고하지 않고 DCE-DTE (모뎀-컴퓨터, 예를 들어 CONNECT 38400 ) 속도를 보고하도록 설정되어 있어야 한다. 많은 모뎀의 경우 -iW0 옵션을 사용하면 된다.
다음 명령은 efax로 하여금 두번째 벨이 울리면 /dev/cua1으로 걸려온 전화에 응답하도록 한다. 이 장치는 두 개의 서로 다른 장치 화일로 잠겨질 것이지만
/dev/cua1 on the second ring. This device will be locked using two different lock files but these lock files will be removed while waiting for incoming calls (-s). If a data call is detected, the getty program will be run to initialize the terminal driver and start a login(1) process. Received fax files will be stored using names like Dec02-12.32.33.001, in the /usr/spool/fax/incoming directory and the log file will be appended to /usr/spool/fax/faxlog.cua1.
efax -d /dev/cua1 -j '+FAA=1' \ -x /var/spool/uucp/LCK..cua1 \ -x /var/spool/uucp/LCK..ttyS1 \ -g "exec /sbin/getty -h /dev/cua1 %d" \ -iS0=2 -w -s \ -r "/var/spool/fax/incoming/%b%d-%H.%I.%S" \ >> /var/spool/fax/faxlog.cua1 2>&1
Note that adaptive answer of either type will not work for all callers. For some data calls the duration of the initial data-mode answer may be too short for the initial handshaking to complete. In other cases this duration may be so long that incoming fax calls will time out before efax switches to fax mode. In addition, some calling fax modems mistake data-mode answering tones for fax signaling tones and initiate fax negotiation too soon. If you use software adaptive answer you can reduce the value of the initial data-mode answer (set by TO_DATAF in efax.c) to get more reliable fax handshaking or increase it for more reliable data handshaking. However, if you need to provide reliable fax and data service to all callers you should use separate phone numbers for the two types of calls.
When a call is answered the modem goes on-line with the computer-to-modem baud rate fixed at the speed used for the most recent AT command. When efax is waiting for a fax or data call it sets the interface speed to 19200 bps since this is the speed required for fax operation. This prevents full use of 28.8kbps modem capabilities.
efax can answer all incoming calls if you place an entry for efax in /etc/inittab (for SysV-like systems) or /etc/ttytab (for BSD-like systems). The init(8) process will run a new copy of efax when the system boots up and whenever the previous process terminates. The inittab or ttytab entry should invoke efax by running the fax script with an answer argument.
For example, placing the following line in /etc/inittab (and running "kill -1 1") will make init run the fax script with argument answer every time previous process terminates (and init is in runlevel 4 or 5).
s1:45:respawn:/bin/sh /usr/bin/fax answer
For BSD-like systems, a line such as the following in /etc/ttytab will have the same effect:
ttya "/usr/local/bin/fax answer" unknown off
You should protect the fax script and configuration files against tampering since init will execute them as a privileged (root) process. If you will be allowing data calls via getty and login you should ensure that your system is reasonably secure (e.g. that all user id's have secure passwords).
If efax exec()'s getty properly but you get a garbled login prompt then there is probably a mismatch between the two ends of the serial link between the modem and the computer. First, check the efax log file to make sure the modem's CONNECT response reported the serial port speed (e.g. 19200), not the modem-modem speed (e.g. 14400). Next, check the getty options and/or configuration files (e.g. /etc/gettydefs) for that particular baud rate. Then run getty manually with the same arguments and verify the port settings using ``stty </dev/XXX''. Note that you'll probably want to enable hardware flow control for data connections (-h for agetty, CRTSCTS for getty_ps).
A few programs won't work properly when efax is set up to answer calls because they don't create lock files. You can put the shell script ``wrapper'' below around such programs to make them work properly. Change BIN and LOCKF to suit.
#!/bin/sh
BIN=/bin/badprogram
LOCKF=/var/spool/uucp/LCK..cua1
if [ -f $LOCKF ]
then
echo lock file $LOCKF exists
exit 1
else
printf "%10d $$ >$LOCKF
$BIN $*
rm $LOCKF
fi
You can add a "fax" printer to the lpr print spooler that will fax out a document using efax instead of printing it. This allows a network server running efax to send faxes on behalf of other machines, including non-Unix clients. In the following steps use the directories specified in the fax script if they are different than /usr/bin and /var/spool/fax (FAXDIR). To set up a fax printer:
(1) Create a link to the fax script called ``faxlpr'' so the fax script can determine when it is being invoked from the print spooler:
ln -s /usr/bin/fax /usr/bin/faxlpr
(2) Edit /etc/printcap and add an entry such as:
fax:lp=/dev/null:sd=/var/spool/fax:if=/usr/bin/faxlpr
to define a printer called "fax". Print files will be spooled to the /var/spool/fax (sd=) directory and then piped to the /usr/bin/faxlpr filter (if=).
(3) Create and/or set the permissions on the fax spool directory. For example:
mkdir /var/spool/fax chmod ugo=rwx /var/spool/fax
You should now be able to send a fax using the lpr interface by using a command such as:
lpr -P fax -J "555 1212" file.ps
where the -J option is used to specify the phone number or alias to be dialed.
Note that if more than one file is given on the command line they will be concatenated before being passed to "fax send". TIFF-G3, Postscript or PBM files must therefore be sent one file at a time although the TIFF and Postscript file may contain multiple pages. Only multiple text files can be sent in one command. Page breaks in text files can be marked with form-feed characters. Files will be converted and sent at the default (high) resolution.
You can use lpq(1) to check the fax queue, lprm(1) to remove fax jobs and lpc(8) to control the spooler. In each case use the -Pfax option to specify the fax ``printer.'' A log file will be mailed to the user when the fax is sent.
You should also be able to send a fax from any networked computer that has lpr-compatible remote printing software and that allows you to set the job name (-J option) to an arbitrary string. Such software is available for most computers.
See the lpd(8) and printcap(5) man pages for information on the print spooler and for restricting access by host name (/etc/host.lpd) or by user group (the `rg' printcap entry).
Double check the configuration setup in the first part of the fax script.
Run the "fax test" script to check the modem's responses to various commands. The results will be displayed at the end of the test. Some ERROR responses from the modem should be expected since most modems don't implement all the possible commands.
If efax hangs when trying to open the modem device (typically ttyX), the device is either already in use by another process (e.g. getty) or it requires the carrier detect line to be true before it can be opened. Many systems define an alternate device name for the same physical device (typically cuaX) that can be opened even if carrier is not present or other programs are already using it.
If modem responses are being lost or generated at random, another processes (e.g. getty or an efax auto-answer process) may be trying to use the same device at the same time. Using lock files (-x options) can often resolve this problem.
Check the response to the "AT+FCLASS=?" command to make sure your modem supports the Class (1, 2 or 2.0) that you have selected. If you have a Class 1 modem, check the response to the "AT+FRM=?" command to verify the speeds supported (e.g. a response of "24,48" would mean only 2400 and 4800 bps are supported). For Class 2 modems check the response to the "AT+FDCC=?" command to make sure the modem supports the capabilities you have selected (see CAPABILITIES above).
Attempt to send a fax. Check that the modem starts making the calling signal (CNG, a 0.5 second beep every 3 seconds) as soon as it's finished dialing. This shows the modem is in fax mode. You may need to use the option -iM2L3 to monitor the phone line (see the SPKR string in the fax script).
Listen to the answering fax machine and check that it sends the answering signal (CED, a 3 second beep) when it answers followed by "warbling" sounds (DIS frames) every 3 seconds. If you hear a continuous signal instead (tones or noise), then you've connected to a data modem instead.
Your modem should now send back another warble (DCS frame) immediately followed by 1.5 seconds of noise (a channel check). If everything is OK, the receiving end will send another warble (CFR frame) and your modem will start to send data. If you have an external modem check its LEDs. If flow control is working properly the modem's send data (SD) LED will turn off periodically while the fax data is sent.
When the transmission completes, check the message showing the line count and the average bit rate.
Low line counts (under 1000 for a letter size image) or the warning "fax output buffer overflow" when sending indicate that the image data format is incorrect. Check the file being sent using the "fax view" command.
If you get the error message ``flow control did not work'' then flow control was not active. This usually results in a garbled transmission and the receiving machine may reject the page, abort the call, print a distorted or blank image and/or hang up.
Most modems enable XON/XOFF flow control when fax mode is enabled. Check the output of the fax test command for the flow control settings in fax mode (typically &K4 or \Q1). If they are incorrect you can use -j commands to enable flow control.
The warning "characters received while sending" or an <XOFF> character appearing after the transmission means that the operating system ignored the modem's XOFF flow control character. Ensure that you are not running other programs such as getty or pppd at the same time as efax since they will turn off xon/xoff flow control.
If you cannot get flow control to work properly then enable ``virtual flow control'' with the -of option.
Check that the remote machine confirms reception with a +FTPS:1 response (Class 2) or an MCF frame (Class 1).
For Class 2 modems, the error message "abnormal call termination (code nn)" indicates that the modem detected an error and hung up. The modem's manual may give an explanation for the error number nn.
Many companies advertise services that will fax back information on their products. These can be useful for testing fax reception.
The message "run length buffer overflow" when receiving indicates an error with the image data format -- make sure you are using the -or option with Class 2 modems.
If efax should display the message "can't happen (<details>)" please send a bug report to the author.
Finally, don't play "option bingo," if you can't resolve the problem save the output of the fax test command to a file (e.g. fax test >test.out) and send it along with a verbose log of the failed session to the address below. If you don't get a response in a reasonable time try the mailing list described below.
A mailing list has been set up to support users of efax and related software. To subscribe, send e-mail to efax-request@renaissoft.com with the word "subscribe" in the subject field. After subscribing you can post to the mailing list by sending your post to efax@renaissoft.com.
Wimsey Information Services provides an anonymous FTP site for efax at ftp://ftp.wimsey.com/pub/efax/. Bug reports and patches will be posted here.
For Linux Systems
An independent package, Qfax, uses efax to provide fax services for multiuser Linux systems through a mail-to-fax gateway. It is available by anonymous ftp from sunsite.unc.edu as /pub/Linux/apps/comm/fax/qfax1.0.tar.gz. Another program, g3vga, can be used to provide fax preview with VGA displays. Also available from sunsite.unc.edu.
For Amiga Systems
A port of an early version of efax for the Amiga is available as a component of a shareware voice mail package, AVM, distributed by Al Villarica (rvillari@cat.syr.edu).
Efax was written by Ed Casas. Please send comments or bug reports to edc@cce.com.
Please mention the operating system, the type of the modem used and include a copy of a verbose session log that demonstrates the problem. Without the verbose log it's usually impossible to diagnose problems. Please do not send fax image files.
Many people have helped with the development of efax by providing encouragement, suggestions, bug reports and fixes, by doing pre-release testing and by developing related software.
A very incomplete list includes: Michele Bergonzoni, John Conover, Mitchum DSouza, Bradley Dale, Dirk Eddelbuettel, Debbe Gervin, Juha Heinanen, Jim Hitzel, Jamie Honan, Michael Huehne, Lester Ingber, Sarantos Kapidakis, Al Knudson, Ken Land, Ulrich Lauther, Robert J. LeBlanc, Derek Lee, Charles H. Lindsey, Norm Matloff, Mark Montague, Michele Bergonzoni, Jose' M. Piquer, Munagala V. S. Ramanath, Markus Regnet, Adam J. Richter, Stewart C. Russel, Lal Sanjay, Bogdan Urma, Al Villarica, and Brian White.
Yggdrasil and SuSE have provided complementary copies of their Linux CD-ROMs. Their support is gratefully acknowledged.
efax is copyright 1993 -- 1996 Ed Casas. It may be used, copied and modified under the terms of the GNU Public License.
Although efax has been tested it may have errors that will prevent it from working correctly on your system. Some of these errors may cause serious problems including loss of data and interruptions to telephone service.
Dennis Bodson et. al., "FAX: Digital Facsimile Technology and Applications", Second Edition. Artech House, Boston. 1992.
CCITT Recommendation T.4, "Standardization of Group 3 Facsimile Apparatus for Document Transmission". 1988.
CCITT Recommendation T.30, "Procedures for Document Facsimile Transmission in the General Switched Telephone Network". 1988
The above CCITT (now ITU-T) standards could be downloaded from gopher://info.itu.ch although this service seems to have been discontinued and it is now necessary to order printed copies.
Documentation on Class 1 and Class 2 fax commands as implemented by Rockwell are available from http://www.tokyo.rockwell.com/ref/reference.html.
The pbm utilities can be obtained by ftp from wuarchive.wustl.edu in /graphics/graphics/packages/NetPBM/netpbm-1mar1994.tar.gz.
Ghostscript can be obtained from any GNU archive site.
fax(1), efix(1), pbm(5), g3topbm(1), gs(1), init(8), inittab(5), ttytab(5), printcap(5), lpd(8), printf(3), strftime(3).
Can't read TIFF files with more than 1 strip
Class 1 operation may fail if the program can't respond to certain data received from the modem within 55 milliseconds.
May fail if multitasking delays cause the received data to overflow the computer's serial device buffer or if an under-run of transmit data exceeds 5 seconds.
Polling and Class 2.0 are not well tested.
Does not support 2-D coding, ECM, or BFT.