summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat
-rw-r--r--components/utilities/ZMODEM/RBSB.C24
-rw-r--r--components/utilities/ZMODEM/RZ.1269
-rw-r--r--components/utilities/ZMODEM/RZ.C1104
-rw-r--r--components/utilities/ZMODEM/RZ.H77
-rw-r--r--components/utilities/ZMODEM/SZ.1336
-rw-r--r--components/utilities/ZMODEM/SZ.C1168
-rw-r--r--components/utilities/ZMODEM/ZM.C480
-rw-r--r--components/utilities/ZMODEM/ZMODEM.DOC2056
-rw-r--r--components/utilities/ZMODEM/ZMODEM.H107
9 files changed, 0 insertions, 5621 deletions
diff --git a/components/utilities/ZMODEM/RBSB.C b/components/utilities/ZMODEM/RBSB.C
deleted file mode 100644
index 2a1394e273..0000000000
--- a/components/utilities/ZMODEM/RBSB.C
+++ /dev/null
@@ -1,24 +0,0 @@
-/* -rev 05-12-86
- * mode function and most of the rest of the system dependent
- * stuff for rb.c and sb.c This file is #included so the includer
- * can set parameters such as HOWMANY.
- */
-
-int iofd = 0; /* File descriptor for ioctls & reads */
-
-/*
- * mode(n)
- * 2: set a cbreak, XON/XOFF control mode if using Pro-YAM's -g option
- * 1: save old tty stat, set raw mode
- * 0: restore original tty mode
- */
-int mode(int n)
-{
- return 0;
-}
-
-int sendbrk()
-{
- //ioctl(iofd, TCSBRK, 0);
- return 0;
-}
diff --git a/components/utilities/ZMODEM/RZ.1 b/components/utilities/ZMODEM/RZ.1
deleted file mode 100644
index a0869b8c36..0000000000
--- a/components/utilities/ZMODEM/RZ.1
+++ /dev/null
@@ -1,269 +0,0 @@
-'\" Revision Level
-'\" Last Delta 05-19-86
-.TH RZ 1 OMEN
-.SH NAME
-rb, rz \- XMODEM, YMODEM, ZMODEM (Batch) file receive
-.SH SYNOPSIS
-.B rz
-.RB [\- "\ 1bquv" ]
-.br
-.B rb
-.RB [\- "\ 1bquv" ]
-.br
-.B rz
-.RB [\- "\ 1bcquv" ]
-.I file
-.br
-.RB [ \- ][ v ] rzCOMMAND
-.SH DESCRIPTION
-This program uses error correcting protocol to receive
-files over a serial port from a variety of programs running under
-PC-DOS, CP/M,
-.SM Unix,
-and other operating systems.
-
-The first form of
-.B rz
-(Receive Batch)
-receives files with ZMODEM batch protocol.
-If the sending program does not support ZMODEM,
-.B rz
-steps down to YMODEM protocol
-after 50 seconds.
-This delay can be eliminated by calling the program as
-.I rb .
-
-.B Rb
-accepts either standard 128 byte sectors or
-1024 byte sectors
-(YAM
-.B -k
-option).
-The user should determine experimentally
-the conditions under which use of 1k blocks
-actually improves throughput without causing
-problems.
-
-Normally, the file contents are converted to
-.SM Unix
-conventions by stripping carriage returns and all characters
-beginning with Control Z (CP/M end of file).
-If the raw pathname ends in
-".A",
-".ARC",
-".CCC",
-".CL",
-".CMD",
-".COM",
-".CRL",
-".DAT",
-".DIR",
-".EXE",
-".O",
-".OBJ",
-".OVL",
-".PAG",
-".REL",
-".SAV",
-".SUB",
-".SWP",
-".SYS",
-".TAR",
-".UTL",
-".a",
-".o",
-".tar",
-or if the first packet contains
-data that suggest a binary file
-(parity bits or characters in the range 000 to 006 before the first ^Z),
-or if the file mode is transmitted and the 0100000
-bit is set, that file will be received in binary mode anyway.
-Otherwise,
-if the raw pathname ends in .MSG, or .TXT, an existing file will
-be appended to rather than replaced.
-
-If extended file information (file length, etc.)
-is received,
-the file length controls the number of bytes written to
-the output dataset (YMODEM only),
-and the modify time and file mode
-(iff non zero)
-are set accordingly.
-
-If no extended file information is received,
-slashes in the pathname are changed to underscore,
-and any trailing period in the pathname is eliminated.
-This conversion is useful for files received from CP/M systems.
-Normally, each file name is converted to lower case
-unless it contains one or more lower case letters.
-
-
-The second form of
-.B rz
-receives a single
-.I file
-with XMODEM protocol.
-The user must supply the file name to both sending and receiving programs.
-
-
-The third form of
-.B rz
-is invoked as
-.B rzCOMMAND
-(with an optional leading \- as generated by login(1)).
-For each received file,
-rz will pipe the file to ``COMMAND filename''
-where filename is the name of the transmitted file
-with the file contents as standard input.
-
-Each file transfer is acknowledged when COMMAND exits with 0 status.
-A non zero exit status terminates transfers.
-
-A typical use for this form is
-.I rzrmail
-which calls rmail(1)
-to post mail to the user specified by the transmitted file name.
-For example, sending the file "caf" from a PC-DOS system to
-.I rzrmail
-on a
-.SM Unix
-system
-would result in the contents of the DOS file "caf" being mailed to user "caf".
-
-On some
-.SM Unix
-systems, the login directory must contain a link to
-COMMAND as login sets SHELL=rsh which disallows absolute
-pathnames.
-If invoked with a leading ``v'',
-.B rz
-will report progress to LOGFILE.
-The following entry works for
-.SM Unix
-3.0:
-.ce
-rzrmail::5:1::/bin:/usr/local/rzrmail
-If the SHELL environment variable includes
-.I "rsh"
-or
-.I "rksh"
-(restricted shell),
-rz will not accept absolute pathnames
-or references to a parent directory,
-will not modify an existing file, and
-removes any files received in error.
-
-If
-.B rz
-is invoked with stdout and stderr to different datasets,
-Verbose is set to 2, causing frame by frame progress reports
-to stderr.
-This may be disabled with the
-.B q
-option.
-
-.PP
-The meanings of the available options are:
-.PP
-.PD 0
-.TP
-.B 1
-Use file descriptor 1 for ioctls and reads (Unix only).
-By default, file descriptor 0 is used.
-This option allows
-.B rz
-to be used with the
-.I cu
-~$
-command.
-.TP
-.B b
-Transfer all files in binary
-(tell it like it is)
-mode.
-This option disables file append.
-.TP
-.B c
-Request 16 bit CRC
-(XMODEM file transfers default to 8 bit checksum).
-Batch transfers use 16 bit CRC.
-.TP
-.B D
-Output file data to /dev/null; for testing.
-.TP
-.B q
-Quiet suppresses verbosity.
-.TP
-.B v
-Verbose
-causes a list of file
-names to be appended to
-/tmp/rzlog .
-More v's generate more output.
-.TP
-.B u
-Retain upper case letters in file names.
-.PD
-.SH EXAMPLES
-.ne 6
-.RE
-(Pro-YAM command)
-.RS
-.I <ALT-2>
-.br
-YAM Command:
-.I "sz *.h *.c"
-.br
-(This automatically invokes
-.I rz
-on the connected system.)
-.RE
-.SH SEE ALSO
-ZMODEM.DOC,
-YMODEM.DOC,
-IMP(CP/M),
-cu(1),
-Professional-YAM manual,
-sz(omen),
-usq(omen),
-undos(omen)
-
-Compile time options required
-for various operating systems are described in the
-source file.
-.SH BUGS
-Pathnames are restricted to 127 characters.
-In XMODEM single file mode, the pathname given on the command line
-is still processed as described above.
-The CR/LF to NL translation merely deletes CR\'s;
-undos(omen) performs a more intelligent translation.
-.SH "VMS VERSION"
-Some of the #includes with file names enclosed with angle brackets <>
-may need to have the angle brackets changed to "", or vice versa.
-
-The VMS version does not set binary mode according to the incoming
-file type.
-Non binary file processing consists of stripping all characters beginning
-with CPMEOF (^Z).
-
-The VMS version does not set the file time.
-
-At high speeds,
-VMS sometimes loses incoming characters, resulting in retries
-and degradation of throughput.
-
-The mysterious
-VMS C Standard I/O Package and RMS may interact to modify
-file contents unexpectedly.
-
-The VMS version does not support invocation as
-.B rzCOMMAND .
-ZMODEM has not yet been implemented on the VMS version.
-.SH "ZMODEM CAPABILITIES"
-.B Rz
-supports incoming ZMODEM binary (-b), ASCII (-a), and append (-+)
-requests, and ZMODEM command execution.
-.SH FILES
-rz.c, rbsb.c, zm.c, zmodem.h source files.
-
-/tmp/rzlog stores debugging output generated with -vv option.
diff --git a/components/utilities/ZMODEM/RZ.C b/components/utilities/ZMODEM/RZ.C
deleted file mode 100644
index fdc1ae247d..0000000000
--- a/components/utilities/ZMODEM/RZ.C
+++ /dev/null
@@ -1,1104 +0,0 @@
-#define VERSION "1.03 05-18-86"
-#define PUBDIR "/usr/spool/uucppublic"
-
-/*% cc -DNFGVMIN -K -O % -o rz; size rz
- *
- * rz.c By Chuck Forsberg
- *
- * cc -O rz.c -o rz USG (3.0) Unix
- * cc -O -DV7 rz.c -o rz Unix V7, BSD 2.8 - 4.3
- *
- * ln rz rb For either system
- *
- * ln rz /usr/bin/rbrmail For remote mail. Make this the
- * login shell. rbrmail then calls
- * rmail(1) to deliver mail.
- *
- * Unix is a trademark of Western Electric Company
- *
- * A program for Unix to receive files and commands from computers running
- * Professional-YAM, PowerCom, YAM, IMP, or programs supporting XMODEM.
- * rz uses Unix buffered input to reduce wasted CPU time.
- *
- * Iff the program is invoked by rzCOMMAND, output is piped to
- * "COMMAND filename"
- *
- * Some systems (Venix, Coherent, Regulus) may not support tty raw mode
- * read(2) the same way as Unix. ONEREAD must be defined to force one
- * character reads for these systems. Added 7-01-84 CAF
- *
- * Alarm signal handling changed to work with 4.2 BSD 7-15-84 CAF
- *
- * NFGVMIN Added 1-13-85 CAF for PC-AT Xenix systems where c_cc[VMIN]
- * doesn't seem to work (even though it compiles without error!).
- *
- * USG UNIX (3.0) ioctl conventions courtesy Jeff Martin
- */
-#define zperr vfile
-
-#include "rtthread.h"
-#include "finsh.h"
-#include "shell.h"
-#include"rtdef.h"
-#include <dfs.h>
-#include <dfs_file.h>
-#include <dfs_posix.h>
-
-
-#define OK 0
-#define FALSE 0
-#define TRUE 1
-#define ERROR (-1)
-
-#define HOWMANY 133
-int Zmodem=0; /* ZMODEM protocol requested */
-int Nozmodem = 0; /* If invoked as "rb" */
-unsigned Baudrate;
-#include "rbsb.c" /* most of the system dependent stuff here */
-
-
-int fout;
-
-/*
- * Routine to calculate the free bytes on the current file system
- * ~0 means many free bytes (unknown)
- */
-long getfree()
-{
- return(~0L); /* many free bytes ... */
-}
-
-char *Extensions[] = {
-".A",
-".ARC",
-".CCC",
-".CL",
-".CMD",
-".COM",
-".CRL",
-".DAT",
-".DIR",
-".EXE",
-".O",
-".OBJ",
-".OVL",
-".PAG",
-".REL",
-".SAV",
-".SUB",
-".SWP",
-".SYS",
-".TAR",
-".UTL",
-".a",
-".arc",
-".com",
-".dat",
-".o",
-".obj",
-".ovl",
-".sys",
-".tar",
-""
-};
-
-/* Ward Christensen / CP/M parameters - Don't change these! */
-#define ENQ 005
-#define CAN ('X'&037)
-#define XOFF ('s'&037)
-#define XON ('q'&037)
-#define SOH 1
-#define STX 2
-#define EOT 4
-#define ACK 6
-#define NAK 025
-#define CPMEOF 032
-#define WANTCRC 0103 /* send C not NAK to get crc not checksum */
-#define TIMEOUT (-2)
-#define ERRORMAX 5
-#define RETRYMAX 5
-#define WCEOT (-10)
-#define SECSIZ 128 /* cp/m's Magic Number record size */
-#define PATHLEN 257 /* ready for 4.2 bsd ? */
-#define KSIZE 1024 /* record size with k option */
-#define UNIXFILE 0x8000 /* happens to the the S_IFREG file mask bit for stat */
-
-int Lastrx;
-int Crcflg;
-int Firstsec;
-int Eofseen; /* indicates cpm eof (^Z) has been received */
-int errors;
-int Restricted=0; /* restricted; no /.. or ../ in filenames */
-int Badclose = 0; /* Error on last close */
-#define ONEREAD 1
-#ifdef ONEREAD
-/* Sorry, Regulus and some others don't work right in raw mode! */
-int Readnum = 1; /* Number of bytes to ask for in read() from modem */
-#else
-int Readnum = KSIZE; /* Number of bytes to ask for in read() from modem */
-#endif
-
-#define DEFBYTL 2000000000L /* default rx file size */
-long Bytesleft; /* number of bytes of incoming file left */
-long Modtime; /* Unix style mod time for incoming file */
-short Filemode; /* Unix style mode for incoming file */
-char Pathname[PATHLEN];
-char *Progname; /* the name by which we were called */
-
-int Batch=0;
-int Wcsmask=0377;
-int Topipe=0;
-int MakeLCPathname=TRUE; /* make received pathname lower case */
-int Verbose=0;
-int Quiet=0; /* overrides logic that would otherwise set verbose */
-int Nflag = 0; /* Don't really transfer files */
-int Rxbinary=FALSE; /* receive all files in bin mode */
-int Thisbinary; /* current file is to be received in bin mode */
-int Blklen; /* record length of received packets */
-char secbuf[KSIZE];
-char linbuf[KSIZE];
-int Lleft=0; /* number of characters in linbuf */
-
-char zconv; /* ZMODEM file conversion request */
-char zmanag; /* ZMODEM file management request */
-char ztrans; /* ZMODEM file transport request */
-
-
-int purgeline(void);
-unsigned short int updcrc(int c, int crc);
-int procheader(char *name);
-int report(int sct);
-int tryz(void);
-int rzfiles(void);
-int rzfile(void);
-int closeit(void);
-int zmputs(char *s);
-int ackbibi(void);
-int wcreceive(int argc, char **argp);
-int wcrxpn(char *rpn);
-int wcrx(void);
-int wcgetsec(char *rxbuf, int maxtime);
-int readline(int timeout);
-int putsec(char *buf, int n);
-int sendline(int c);
-int xsendline(int c);
-int log(const char *s,...);
-int bttyout(int c);
-int flushmo(void);
-int canit(void);
-int sys2(char *s);
-int exec2(char *s);
-
-#include "zm.c"
-
-
-/* called by signal interrupt or terminate to clean things up */
-int bibi(int n)
-{
- if (Zmodem)
- zmputs(Attn);
- canit();
- mode(0);
- return 0;
-}
-
-int zrmain(void)
-{
- if (wcreceive(0, 0)==ERROR) {
- canit();
- zperr("received error,exit\n");
- return 1;
- }
- return 0;
-}
-
-
-int usage(void)
-{
- //rt_kprintf("%s %s for %s by Chuck Forsberg\n",
- // Progname, VERSION, OS);
- //rt_kprintf("Usage: rz [-1buv] (ZMODEM Batch)\n");
- //rt_kprintf("or rb [-1buv] (YMODEM Batch)\n");
- //rt_kprintf("or rz [-1bcv] file (XMODEM)\n");
- //rt_kprintf(" -1 For cu(1): Use fd 1 for input\n");
- //rt_kprintf(" -b Binary transfer for all files\n");
- //rt_kprintf(" -u Allow all UPPER CASE names\n");
- //rt_kprintf(" -v Verbose more v's give more info\n");
- //rt_kprintf(" -c Use 16 bit CRC (XMODEM)\n");
- //exit(1);
- return 0;
-}
-/*
- * Debugging information output interface routine
- */
-/* VARARGS1 */
-void vfile(const char *fmt,...)
-{
- return;
-}
-
-/*
- * Let's receive something already.
- */
-int wcreceive(int argc, char **argp)
-{
- int c;
-
- if (Batch || argc==0) {
- Crcflg=(Wcsmask==0377);
- if ( !Quiet)
- rt_kprintf("\nrz: ready...\n");
- c = tryz();
- if (c) {
- if (c == ZCOMPL)
- return OK;
- if (c == ERROR)
- goto fubar;
- c = rzfiles();
- if (c)
- goto fubar;
- } else {
- for (;;) {
- if (wcrxpn(secbuf)== ERROR)
- goto fubar;
- if (secbuf[0]==0)
- return OK;
- if (procheader(secbuf) == ERROR)
- goto fubar;
- if (wcrx()==ERROR)
- goto fubar;
- }
- }
- } else {
- Bytesleft = DEFBYTL; Filemode = 0; Modtime = 0L;
-
- strcpy(Pathname, *argp);
- //checkpath(Pathname);
- //rt_kprintf(stderr, "\nrz: ready to receive %s ", Pathname);
- //if ((fout=fopen(Pathname, "w")) == NULL)
- // return ERROR;
- if (wcrx()==ERROR)
- goto fubar;
- }
- return OK;
-fubar:
- canit();
- if (Topipe && fout) {
- close(fout); return ERROR;
- }
- if (fout)
- close(fout);
- if (Restricted) {
- unlink(Pathname);
- rt_kprintf("\r\nrz: %s removed.\r\n", Pathname);
- }
- return ERROR;
-}
-
-
-/*
- * Fetch a pathname from the other end as a C ctyle ASCIZ string.
- * Length is indeterminate as long as less than Blklen
- * A null string represents no more files (YMODEM)
- */
-int wcrxpn(char *rpn)
-{
- int c;
-
-#ifdef NFGVMIN
- readline(1);
-#else
- purgeline();
-#endif
-
-et_tu:
- Firstsec=TRUE; Eofseen=FALSE;
- sendline(Crcflg?WANTCRC:NAK);
- Lleft=0; /* Do read next time ... */
- while ((c = wcgetsec(rpn, 100)) != 0) {
- log( "Pathname fetch returned %d\n", c);
- if (c == WCEOT) {
- sendline(ACK);
- Lleft=0; /* Do read next time ... */
- readline(1);
- goto et_tu;
- }
- return ERROR;
- }
- sendline(ACK);
- return OK;
-}
-
-/*
- * Adapted from CMODEM13.C, written by
- * Jack M. Wierda and Roderick W. Hart
- */
-
-int wcrx(void)
-{
- register int sectnum, sectcurr;
- register char sendchar;
- register char *p;
- int cblklen; /* bytes to dump this block */
-
- Firstsec=TRUE;sectnum=0; Eofseen=FALSE;
- sendchar=Crcflg?WANTCRC:NAK;
-
- for (;;) {
- sendline(sendchar); /* send it now, we're ready! */
- Lleft=0; /* Do read next time ... */
- sectcurr=wcgetsec(secbuf, (sectnum&0177)?50:130);
- report(sectcurr);
- if (sectcurr==(sectnum+1 &Wcsmask)) {
-
- if (sectnum==0 && !Thisbinary) {
- p=secbuf; sectcurr=Blklen;
- if (*p == 032) /* A hack for .arc files */
- goto binbin;
- for (; *p != 032 && --sectcurr>=0; ++p)
- if (*p < 07 || (*p & 0200)) {
-binbin:
- Thisbinary++;
- if (Verbose)
- rt_kprintf("Changed to BIN\n");
- break;
- }
- }
- sectnum++;
- cblklen = Bytesleft>Blklen ? Blklen:Bytesleft;
- if (putsec(secbuf, cblklen)==ERROR)
- return ERROR;
- if ((Bytesleft-=cblklen) < 0)
- Bytesleft = 0;
- sendchar=ACK;
- }
- else if (sectcurr==(sectnum&Wcsmask)) {
- log( "Received dup Sector\n");
- sendchar=ACK;
- }
- else if (sectcurr==WCEOT) {
- if (closeit())
- return ERROR;
- sendline(ACK);
- Lleft=0; /* Do read next time ... */
- return OK;
- }
- else if (sectcurr==ERROR)
- return ERROR;
- else {
- log( "Sync Error\n");
- return ERROR;
- }
- }
-}
-
-/*
- * Wcgetsec fetches a Ward Christensen type sector.
- * Returns sector number encountered or ERROR if valid sector not received,
- * or CAN CAN received
- * or WCEOT if eot sector
- * time is timeout for first char, set to 4 seconds thereafter
- ***************** NO ACK IS SENT IF SECTOR IS RECEIVED OK **************
- * (Caller must do that when he is good and ready to get next sector)
- */
-
-int wcgetsec(char *rxbuf, int maxtime)
-{
- int checksum, wcj, firstch;
- unsigned short oldcrc;
- char *p;
- int sectcurr;
-
- for (Lastrx=errors=0; errors<RETRYMAX; errors++) {
-
- if ((firstch=readline(maxtime))==STX) {
- Blklen=KSIZE; goto get2;
- }
- if (firstch==SOH) {
- Blklen=SECSIZ;
-get2:
- sectcurr=readline(1);
- if ((sectcurr+(oldcrc=readline(1)))==Wcsmask) {
- oldcrc=checksum=0;
- for (p=rxbuf,wcj=Blklen; --wcj>=0; ) {
- if ((firstch=readline(1)) < 0)
- goto bilge;
- oldcrc=updcrc(firstch, oldcrc);
- checksum += (*p++ = firstch);
- }
- if ((firstch=readline(1)) < 0)
- goto bilge;
- if (Crcflg) {
- oldcrc=updcrc(firstch, oldcrc);
- if ((firstch=readline(1)) < 0)
- goto bilge;
- oldcrc=updcrc(firstch, oldcrc);
- if (oldcrc & 0xFFFF)
- log("CRC=0%o\n", oldcrc);
- else {
- Firstsec=FALSE;
- return sectcurr;
- }
- }
- else if (((checksum-firstch)&Wcsmask)==0) {
- Firstsec=FALSE;
- return sectcurr;
- }
- else
- log( "Checksum Error\n");
- }
- else
- log("Sector number garbled 0%o 0%o\n",
- sectcurr, oldcrc);
- }
- /* make sure eot really is eot and not just mixmash */
-#ifdef NFGVMIN
- else if (firstch==EOT && readline(1)==TIMEOUT)
- return WCEOT;
-#else
- else if (firstch==EOT && Lleft==0)
- return WCEOT;
-#endif
- else if (firstch==CAN) {
- if (Lastrx==CAN) {
- log("Sender CANcelled\n");
- return ERROR;
- } else {
- Lastrx=CAN;
- continue;
- }
- }
- else if (firstch==TIMEOUT) {
- if (Firstsec)
- goto humbug;
-bilge:
- log( "Timeout\n");
- }
- else
- log( "Got 0%o sector header\n", firstch);
-
-humbug:
- Lastrx=0;
- while(readline(1)!=TIMEOUT)
- ;
- if (Firstsec) {
- sendline(Crcflg?WANTCRC:NAK);
- Lleft=0; /* Do read next time ... */
- } else {
- maxtime=40; sendline(NAK);
- Lleft=0; /* Do read next time ... */
- }
- }
- /* try to stop the bubble machine. */
- canit();
- return ERROR;
-}
-
-/*
- * This version of readline is reasoably well suited for
- * reading many characters.
- * (except, currently, for the Regulus version!)
- *
- * timeout is in tenths of seconds
- */
-int readline(int timeout)
-{
- static char *cdq; /* pointer for removing chars from linbuf */
- static char data_buffer[8];
- if (--Lleft >= 0)
- {
- return (*cdq++ & Wcsmask);
- }
- while (1)
- {
- Lleft = zread(shell->device, 0, data_buffer, 1);
- if (Lleft)
- {
- Lleft = Lleft;
- cdq = &data_buffer[0];
- break;
- }
- }
-
- if (Lleft < 1)
- return TIMEOUT;
- --Lleft;
- return (*cdq++ & Wcsmask);
-}
-
-
-
-/*
- * Purge the modem input queue of all characters
- */
-int purgeline(void)
-{
-
- Lleft = 0;
-#ifdef USG
- ioctl(iofd, TCFLSH, 0);
-#else
- lseek(iofd, 0L, 2);
-#endif
- return 0;
-}
-
-/*
- * Update CRC CRC-16 used by XMODEM/CRC, YMODEM, and ZMODEM.
- * Note: Final result must be masked with 0xFFFF before testing
- * More efficient table driven routines exist.
- */
-unsigned short int
-updcrc(int c, int crc)
-{
- int count;
-
- for (count=8; --count>=0;) {
- if (crc & 0x8000) {
- crc <<= 1;
- crc += (((c<<=1) & 0400) != 0);
- crc ^= 0x1021;
- }
- else {
- crc <<= 1;
- crc += (((c<<=1) & 0400) != 0);
- }
- }
- return crc;
-}
-
-/*
- * Process incoming file information header
- */
-int procheader(char *name)
-{
- char *openmode, *ptr;
- unsigned char i;
- char fname[100];
- /* set default parameters */
- openmode = "w"; Thisbinary=Rxbinary;
-
- /*
- * Process ZMODEM remote file management requests
- */
- if (zconv == ZCNL) /* Remote ASCII override */
- Thisbinary = 0;
- if (zconv == ZCBIN) /* Remote Binary override */
- ++Thisbinary;
- else if (zmanag == ZMAPND)
- openmode = "a";
- openmode = openmode;
- Bytesleft = DEFBYTL; Filemode = 0; Modtime = 0L;
- for(i=0;i<100;i++) fname[i] = 0;
- for (i=1,ptr=name;i<strlen(name)+1;i++) /* get file name */
- fname[i]= *ptr++;
- fname[0] = '/'; /* working_directory */
- if ((fout = open(fname,DFS_O_CREAT|DFS_O_WRONLY,0)) < 0) /* create file */
- {
- return ERROR;
- }
- return OK;
-}
-
-/* Make string s lower case */
-int uncaps(char *s)
-{
- return 0;
- /*
- for ( ; *s; ++s)
- if (isupper(*s))
- *s = tolower(*s);
- */
-}
-
-
-/*
- * IsAnyLower returns TRUE if string s has lower case letters.
- */
-int IsAnyLower(char *s)
-{
- return 0;
-/*
- for ( ; *s; ++s)
- if (islower(*s))
- return TRUE;
- return FALSE;
- */
-}
-/*
- * Putsec writes the n characters of buf to receive file fout.
- * If not in binary mode, carriage returns, and all characters
- * starting with CPMEOF are discarded.
- */
-int putsec(char *buf, int n)
-{
- register char *p;
-
- if (Thisbinary) {
- for (p=buf; --n>=0; )
- write(fout,p++,1);
- }
- else {
- if (Eofseen)
- return OK;
- for (p=buf; --n>=0; ++p ) {
- if ( *p == '\r')
- continue;
- if (*p == CPMEOF) {
- Eofseen=TRUE; return OK;
- }
- write(fout,p,1);
- }
- }
- return OK;
-}
-
-/*
- * Send a character to modem. Small is beautiful.
- */
-int sendline(int c)
-{
- zwrite(c);
- return 0;
-}
-
-int xsendline(int c)
-{
- sendline(c);
- return 0;
-}
-
-int flushmo(void)
-{
- return 0;
-}
-
-
-
-
-/*
- * substr(string, token) searches for token in string s
- * returns pointer to token within string if found, NULL otherwise
- */
-char *
-substr(char *s, char *t)
-{
- register char *ss,*tt;
- /* search for first char of token */
- for (ss=s; *s; s++)
- if (*s == *t)
- /* compare token with substring */
- for (ss=s,tt=t; ;) {
- if (*tt == 0)
- return s;
- if (*ss++ != *tt++)
- break;
- }
- return NULL;
-}
-
-/*
- * Log an error
- */
-/*VARARGS1*/
-int log(const char *s,...)
-{
- return 0;
-}
-
-/* send cancel string to get the other end to shut up */
-int canit(void)
-{ /*
- static char canistr[] = {
- ZPAD,ZPAD,24,24,24,24,24,24,24,24,8,8,8,8,8,8,8,8,8,8,0
- };
- */
- //printf(canistr);
- Lleft=0; /* Do read next time ... */
- //fflush(stdout);
- return 0;
-}
-
-
-/*
- * Return 1 iff stdout and stderr are different devices
- * indicating this program operating with a modem on a
- * different line
- */
-int fromcu(void)
-{
- struct stat a, b;
- fstat(1, &a);
- fstat(2, &b);
- //return (a.st_rdev != b.st_rdev);
- return 0;
-}
-
-int report(int sct)
-{
- //if (Verbose>1)
- // rt_kprintf(stderr,"%03d%c",sct,sct%10? ' ' : '\r');
- return 0;
-}
-
-/*
- * If called as [-][dir/../]vrzCOMMAND set Verbose to 1
- * If called as [-][dir/../]rzCOMMAND set the pipe flag
- * If called as rb use YMODEM protocol
- */
-int chkinvok(char *s)
-{
- register char *p;
-
- p = s;
- while (*p == '-')
- s = ++p;
- while (*p)
- if (*p++ == '/')
- s = p;
- if (*s == 'v') {
- Verbose=1; ++s;
- }
- Progname = s;
- if (s[0]=='r' && s[1]=='b')
- Nozmodem = TRUE;
- if (s[2] && s[0]=='r' && s[1]=='b')
- Topipe=TRUE;
- if (s[2] && s[0]=='r' && s[1]=='z')
- Topipe=TRUE;
- return 0;
-}
-
-/*
- * Totalitarian Communist pathname processing
- */
-int checkpath(char *name)
-{
-// if (Restricted) {
- // if (fopen(name, "r") != NULL) {
- // canit();
- //rt_kprintf(stderr, "\r\nrz: %s exists\n", name);
- // bibi();
- // }
- /* restrict pathnames to current tree or uucppublic */
- // if ( substr(name, "../")
- // || (name[0]== '/' && strncmp(name, PUBDIR, strlen(PUBDIR))) ) {
- // canit();
- //rt_kprintf(stderr,"\r\nrz:\tSecurity Violation\r\n");
- // bibi();
- // }
-// }
- return 0;
-}
-
-/*
- * Initialize for Zmodem receive attempt, try to activate Zmodem sender
- * Handles ZSINIT frame
- * Return ZFILE if Zmodem filename received, -1 on error,
- * ZCOMPL if transaction finished, else 0
- */
-int tryz(void)
-{
- int n;
- int cmdzack1flg;
-
- if (Nozmodem) /* Check for "rb" program name */
- return 0;
- Rxtimeout = 100;
-
-
- for (n=5; --n>=0; ) {
- /* Set buffer length (0) and capability flags */
- stohdr(0L);
- Txhdr[ZF0] = CANFDX|CANOVIO|CANBRK;
- zshhdr(Badclose?ZFERR:ZRINIT, Txhdr);
-again:
- switch (zgethdr(Rxhdr, 0)) {
- case ZRQINIT:
- continue;
- case ZEOF:
- continue;
- case TIMEOUT:
- continue;
- case ZFILE:
- zconv = Rxhdr[ZF0];
- zmanag = Rxhdr[ZF1];
- ztrans = Rxhdr[ZF2];
- Badclose = FALSE;
- if (zrbdata(secbuf, KSIZE) == GOTCRCW)
- return ZFILE;
- zshhdr(ZNAK, Txhdr);
- case ZSINIT:
- if (zrbdata(Attn, ZATTNLEN) == GOTCRCW) {
- zshhdr(ZACK, Txhdr);
- goto again;
- }
- zshhdr(ZNAK, Txhdr);
- continue;
- case ZFREECNT:
- stohdr(getfree());
- zshhdr(ZACK, Txhdr);
- goto again;
- case ZCOMMAND:
- cmdzack1flg = Rxhdr[ZF0];
- if (zrbdata(secbuf, KSIZE) == GOTCRCW) {
- if (cmdzack1flg & ZCACK1)
- stohdr(0L);
- else
- stohdr((long)sys2(secbuf));
- purgeline(); /* dump impatient questions */
- do {
- zshhdr(ZCOMPL, Txhdr);
- }
- while (++errors<10 && zgethdr(Rxhdr,1) != ZFIN);
- ackbibi();
- if (cmdzack1flg & ZCACK1)
- exec2(secbuf);
- return ZCOMPL;
- }
- zshhdr(ZNAK, Txhdr); goto again;
- case ZCOMPL:
- goto again;
- default:
- continue;
- case ZFIN:
- ackbibi(); return ZCOMPL;
- case ZCAN:
- return ERROR;
- }
- }
- return 0;
-}
-
-/*
- * Receive 1 or more files with ZMODEM protocol
- */
-int rzfiles(void)
-{
- int c;
-
- for (;;) {
- switch (c = rzfile()) {
- case ZEOF:
- case ZSKIP:
- switch (tryz()) {
- case ZCOMPL:
- return OK;
- default:
- return ERROR;
- case ZFILE:
- break;
- }
- continue;
- default:
- return c;
- case ERROR:
- return ERROR;
- }
- }
-}
-
-/*
- * Receive a file with ZMODEM protocol
- * Assumes file name frame is in secbuf
- */
-int rzfile(void)
-{
- int c, n;
- long int rxbytes;
-
- Eofseen=FALSE;
- if (procheader(secbuf) == ERROR) {
- zshhdr(ZSKIP, Txhdr);
- return ZSKIP;
- }
-
- n = 10; rxbytes = 0l;
-
- for (;;) {
- stohdr(rxbytes);
- zshhdr(ZRPOS, Txhdr);
-nxthdr:
- switch (c = zgethdr(Rxhdr, 0)) {
- default:
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- case ZNAK:
- case TIMEOUT:
- if ( --n < 0) {
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- }
- case ZFILE:
- continue;
- case ZEOF:
- if (rclhdr(Rxhdr) != rxbytes) {
- continue;
- }
- if (closeit()) {
- Badclose = TRUE;
- vfile("rzfile: closeit returned <> 0");
- return ERROR;
- }
- vfile("rzfile: normal EOF");
- return c;
- case ERROR: /* Too much garbage in header search error */
- if ( --n < 0) {
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- }
- zmputs(Attn);
- continue;
- case ZDATA:
- n = 10;
- if (rclhdr(Rxhdr) != rxbytes) {
- zmputs(Attn);
- continue;
- }
-moredata:
- switch (c = zrbdata(secbuf, KSIZE)) {
- case ZCAN:
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- case ERROR: /* CRC error */
- if ( --n < 0) {
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- }
- zmputs(Attn);
- continue;
- case TIMEOUT:
- if ( --n < 0) {
- vfile("rzfile: zgethdr returned %d", c);
- return ERROR;
- }
- continue;
- case GOTCRCW:
- putsec(secbuf, Rxcount);
- rxbytes += Rxcount;
- stohdr(rxbytes);
- zshhdr(ZACK, Txhdr);
- goto nxthdr;
- case GOTCRCQ:
- putsec(secbuf, Rxcount);
- rxbytes += Rxcount;
- stohdr(rxbytes);
- zshhdr(ZACK, Txhdr);
- goto moredata;
- case GOTCRCG:
- putsec(secbuf, Rxcount);
- rxbytes += Rxcount;
- goto moredata;
- case GOTCRCE:
- putsec(secbuf, Rxcount);
- rxbytes += Rxcount;
- goto nxthdr;
- }
- }
- }
-}
-
-/*
- * Send a string to the modem, processing for \336 (sleep 1 sec)
- * and \335 (break signal)
- */
-int zmputs(char *s)
-{
- int c;
-
- while (*s) {
- switch (c = *s++) {
- case '\336':
- //sleep(1);
- continue;
- case '\335':
- sendbrk(); continue;
- default:
- sendline(c);
- }
- }
- return 0;
-}
-
-/*
- * Close the receive dataset, return OK or ERROR
- */
-int closeit(void)
-{
- if (Topipe) {
- if (close(fout)) {
- return ERROR;
- }
- return OK;
- }
- if (close(fout)==ERROR) {
- //rt_kprintf(stderr, "file close ERROR\n");
- return ERROR;
- }
-// if (Modtime) {
-// timep[0] = time(NULL);
- // timep[1] = Modtime;
- // utime(Pathname, timep);
- //}
- //if (Filemode)
- //chmod(Pathname, (07777 & Filemode));
- return OK;
-}
-
-/*
- * Ack a ZFIN packet, let byegones be byegones
- */
-int ackbibi(void)
-{
- int n;
-
- vfile("ackbibi:");
- Readnum = 1;
- stohdr(0L);
- for (n=4; --n>=0; ) {
- zshhdr(ZFIN, Txhdr);
- for (;;) {
- switch (readline(100)) {
- case 'O':
- readline(1); /* Discard 2nd 'O' */
- /* ***** FALL THRU TO ***** */
- case TIMEOUT:
- vfile("ackbibi complete");
- return 0;
- default:
- break;
- }
- }
- }
- return 0;
-}
-
-/*
- * Local console output simulation
- */
-int bttyout(int c)
-{
- //if (Verbose || fromcu)
- //putc(c, stderr);
- return 0;
-}
-
-/*
- * Strip leading ! if present, do shell escape.
- */
-int sys2(char *s)
-{
- if (*s == '!')
- ++s;
- return 0;
-}
-/*
- * Strip leading ! if present, do exec.
- */
-int exec2(char *s)
-{
- if (*s == '!')
- ++s;
- mode(0);
- return 0;
-}
diff --git a/components/utilities/ZMODEM/RZ.H b/components/utilities/ZMODEM/RZ.H
deleted file mode 100644
index 8a4f237114..0000000000
--- a/components/utilities/ZMODEM/RZ.H
+++ /dev/null
@@ -1,77 +0,0 @@
-#ifndef __RZ_H__
-#define __RZ_H__
-
-#include "zmodem.h"
-
-
-unsigned short int updcrc(int c, unsigned int crc);
-void zmputs(char *s);
-int closeit(void);
-int sys2(char *s);
-int exec2(char *s);
-int rzfile(void);
-void ackbibi(void);
-unsigned int IsAnyLower(char *s);
-void usage(void);
-static int wcrx(void);
-char *substr(char *s, char *t);
-
-void alrm(void);
-void bibi(int n);
-int zreceive_main(void);
-void usage(void);
-static int wcreceive(unsigned int argc, char **argp);
-static int wcrxpn(char *rpn);
-static int wcgetsec(char *rxbuf, int maxtime);
-int readline(int timeout);
-unsigned short int updcrc(int c, unsigned int crc);
-int procheader(char *name);
-int purgeline(void);
-int putsec(char *buf, int n);
-int readline(int timeout);
-unsigned short int updcrc(int c, unsigned int crc);
-
-int bttyout(int c);
-int sys2(char *s);
-int exec2(char *s);
-void sendline(char c);
-void xsendline(char c);
-void canit(void);
-int tryz(void);
-int rzfiles(void);
-
-
-extern int Verbose;
-extern int iofd; /* File descriptor for ioctls & reads */
-extern int Zmodem; /* ZMODEM protocol requested */
-extern int Nozmodem; /* If invoked as "rb" */
-/* Ward Christensen / CP/M parameters - Don't change these! */
-#define ENQ 005
-#define CAN ('X'&037)
-//#define XOFF ('s'&037)
-//#define XON ('q'&037)
-#define SOH 1
-#define STX 2
-#define EOT 4
-#define ACK 6
-#define NAK 025
-#define CPMEOF 032
-#define WANTCRC 0103 /* send C not NAK to get crc not checksum */
-#define TIMEOUT (-2)
-#define ERRORMAX 5
-#define RETRYMAX 5
-#define WCEOT (-10)
-#define SECSIZ 128 /* cp/m's Magic Number record size */
-#define PATHLEN 257 /* ready for 4.2 bsd ? */
-#define KSIZE 1024 /* record size with k option */
-#define UNIXFILE 0x8000 /* happens to the the S_IFREG file mask bit for stat */
-/**************************zm.c **************************/
-
-
-
-
-
-
-
-
-#endif
diff --git a/components/utilities/ZMODEM/SZ.1 b/components/utilities/ZMODEM/SZ.1
deleted file mode 100644
index e5cd56029a..0000000000
--- a/components/utilities/ZMODEM/SZ.1
+++ /dev/null
@@ -1,336 +0,0 @@
-'\" Revision Level
-'\" Last Delta 5-19-86
-.TH SZ 1 OMEN
-.SH NAME
-sz \- XMODEM, YMODEM, ZMODEM Batch file Send
-.SH SYNOPSIS
-sz
-.RB [\- +1adfknqTuvy ]
-.I file ...
-.br
-sz -X
-.RB [\- 1kquv ]
-.I file
-.br
-sz
-.RB [\- 1qv ]
-.B "-c COMMAND"
-.br
-sz
-.RB [\- 1qv ]
-.B "-i COMMAND"
-.SH DESCRIPTION
-.B Sz
-uses the ZMODEM, YMODEM or XMODEM error correcting protocol to send
-one or more files over a serial port to a variety of programs running under
-PC-DOS, CP/M, Unix, VMS, and other operating systems.
-
-
-The first form of
-.B sz
-sends one or more files with ZMODEM or YMODEM batch protocol.
-Normally, only the file name part of the pathname is transmitted.
-On
-.SM Unix
-systems, additional information about the file is transmitted.
-If the receiving program uses this information,
-the transmitted file length controls the exact number of bytes written to
-the output dataset,
-and the modify time and file mode
-are set accordingly.
-
-Output from another program may be piped to
-.B sz
-for transmission by specifying the
-.B -1
-option and denoting standard input by "-":
-.ce
-ps -ef | sz -
-The program output is transmitted with the filename sPID.sz
-where PID is the process ID of the
-.B sz
-program.
-If the environment variable
-.B ONAME
-is set, that is used instead.
-In this case, the Unix command:
-.ce
-ONAME=con ps -ef|sz -ay -
-will send a "file" to the PC-DOS console display.
-The
-.B -y
-bypasses the receiver\'s checking of the output filename.
-The
-.B -a
-causes the receiver to convert Unix newlines to PC-DOS carriage returns
-and linefeeds.
-
-Unix
-.B sz
-supports
-.B YMODEM-g
-with "cbreak" tty mode, XON/XOFF flow control,
-and the interrupt character set to CAN.
-.B YMODEM-g
-(Professional-YAM
-.B g
-option)
-increases throughput over error free channels
-(direct connection, X.PC, etc.)
-by not acknowledging each transmitted sector.
-
-
-The second form of
-.B sz
-uses the
-.B -X
-flag to send a single
-.I file
-with
-.B XMODEM
-protocol.
-The user must supply the file name to both sending and receiving programs.
-
-Iff
-.B sz
-is invoked with $SHELL set and iff that variable contains the
-string
-.I "rsh"
-or
-.I "rksh"
-(restricted shell), sz operates in restricted mode.
-Restricted mode restricts pathnames to the current directory and
-PUBDIR (usually /usr/spool/uucppublic) and/or subdirectories
-thereof.
-
-
-The third form sends a single COMMAND to the receiver for execution.
-.B Sz
-exits with the COMMAND return value.
-If COMMAND includes spaces or characters special to the shell,
-it must be quoted.
-
-The fourth form sends a single COMMAND to the receiver for execution.
-.B Sz
-exits as soon as the receiver has received the command, before it is executed.
-
-
-If sz is invoked with stdout and stderr to different datasets,
-Verbose is set to 2, causing frame by frame progress reports
-to stderr.
-This may be disabled with the
-.B q
-option.
-.PP
-The meanings of the available options are:
-.PP
-.PD 0
-.TP
-.B +
-Force the receiver to append transmitted data to an existing file
-(ZMODEM only).
-.TP
-.B 1
-Use file descriptor 1 for ioctls and reads (Unix only).
-By default, file descriptor 0 is used.
-This option allows
-.B sz
-to be used with the
-.I cu
-~$
-command.
-.TP
-.B a
-Convert NL characters in the transmitted file to CR/LF.
-This is done by the sender for XMODEM and YMODEM, by the receiver
-for ZMODEM.
-.TP
-.B "c COMMAND"
-Send COMMAND to the receiver for execution, return with COMMAND\'s exit status.
-.TP
-.B "C N"
-Make N attempts at ten second intervals
-to read COMMAND\'s exit status before exiting.
-.TP
-.B d
-Change all instances of "." to "/" in the transmitted pathname.
-Thus, C.omenB0000 (which is unacceptable to MSDOS or CP/M)
-is transmitted as C/omenB0000.
-If the resultant filename has more than 8 characters in the stem,
-a "." in inserted to allow a total of eleven.
-.TP
-.B f
-Send Full pathname.
-Normally directory prefixes are stripped from the transmitted
-filename.
-.TP
-.B "i COMMAND"
-Send COMMAND to the receiver for execution, return Immediately.
-.TP
-.B k
-Send files using YMODEM 1024 byte blocks
-rather than the default 128 byte blocks.
-1024 byte packets speed file transfers at high bit rates.
-(ZMODEM streams the data for the best possible throughput.)
-.TP
-.B n
-Instruct ZMODEM receiver to skip files if the length and modification times
-of the source file and the file on the destination system are equal.
-.TP
-.B N
-Instruct ZMODEM receiver to skip files if the length and CRC\'s
-of the source file and the file on the destination system are equal.
-.TP
-.B q
-Quiet suppresses verbosity.
-.TP
-.B r
-Resume interrupted file transfer.
-If the source file is longer than the destination file,
-the transfer commences at the offset in the source file that equals
-the length of the destination file.
-.TP
-.B u
-Unlink the file after successful transmission.
-.TP
-.B v
-Verbose
-causes a list of file
-names to be appended to
-/tmp/szlog .
-More v's generate more output.
-.TP
-.B X
-Send a single file with
-.B XMODEM
-protocol.
-.TP
-.B y
-Force a ZMODEM receiving program to overwrite any existing file
-with the same name.
-.PD
-.SH EXAMPLES
-.ne 7
-.B "ZMODEM File Transfer"
-.br
-.B "$ sz -a *.c"
-.br
-This single command transfers all .c files in the current Unix directory
-with conversion
-.RB ( -a )
-to PC-DOS end of line conventions.
-With ZMODEM AutoDownload enabled, Professional-YAM automatically recieves
-the files after performing a security challenge.
-
-.B "ZMODEM Command Download"
-.br
- cpszall:all
- sz -c "c:;cd /yam/dist"
- sz -ya $(YD)/*.me
- sz -yqb y*.exe
- sz -c "cd /yam"
- sz -i "!insms"
-.br
-This Makefile fragment uses
-.B sz
-to issue commands to Professional-YAM to change current disk and directory.
-Next,
-.B sz
-transfers the
-.I .me
-files from the $YD directory, commanding the receiver to overwrite the old files
-and to convert from Unix end of line conventions to PC-DOS conventions.
-The third line transfers some
-.I .exe
-files.
-The fourth and fifth lines command Pro-YAM to
-change directory and execute a PC-DOS batch file
-.I insms .
-Since the batch file takes considerable time, the
-.B "-i"
-form is used to allow
-.B sz
-to exit immediately.
-
-.B "XMODEM File Transfer"
-.br
-$
-.B "sz -Xa foo.c"
-.br
-.B "ESC"
-.br
-.B "rx foo.c"
-.br
-The above three commands transfer a single file
-from Unix to a PC and Crosstalk XVI 3.6,
-translating Unix newlines to DOS CR/LF.
-
-.SH SEE ALSO
-rz(omen),
-ZMODEM.DOC,
-YMODEM.DOC,
-Professional-YAM manual,
-IMP(CP/M),
-cu(1),
-sq(omen),
-todos(omen),
-tocpm(omen),
-tomac(omen),
-yam(omen)
-
-Compile time options required for various operating systems are described in
-the source file.
-.SH "VMS VERSION"
-The VMS version does not transmit the file date.
-The VMS version calculates the file length by reading the file
-and counting the bytes.
-
-The VMS version does not support YMODEM-g or ZMODEM.
-
-When VMS is lightly loaded, the response time may be too quick for MODEM7
-unless the MODEM7
-.B "q"
-modifier is used.
-
-The VMS C standard i/o package and RMS sometimes interact to modify
-file contents unexpectedly.
-.SH FILES
-sz.c, rbsb.c, zm.c, zmodem.h source files
-
-/tmp/szlog stores debugging output (sz -vv)
-.SH "TESTING FEATURE"
-The command "sz -T file"
-exercises the
-.B Attn
-sequence error recovery by commanding
-errors with unterminated packets.
-The receiving program should complain five times about
-binary data packets being too long.
-Each time
-.B sz
-is interrupted,
-it should send a ZDATA header followed by another defective packet.
-If the receiver does not detect five long data packets,
-the
-.B Attn
-sequence is not interrupting the sender, and the
-.B Myattn
-string in
-.B sz.c
-must be modified.
-
-After 5 packets,
-.B sz
-stops the "transfer" and
-prints the total number of characters "sent" (Tcount).
-The difference between Tcount and 5120 represents the number of characters
-stored in various buffers when the Attn sequence is generated.
-.SH BUGS
-XMODEM transfers add up to 127 spurious bytes per file.
-
-Circular buffering and a ZMODEM sliding window should be used
-when input is from pipes instead of acknowledging frames each 1024 bytes.
-.B Sz
-should check for the presence of at least one accessible file before
-getting hot and bothered.
-The test mode leaves a zero length file on the receiving system.
diff --git a/components/utilities/ZMODEM/SZ.C b/components/utilities/ZMODEM/SZ.C
deleted file mode 100644
index f4aaaae345..0000000000
--- a/components/utilities/ZMODEM/SZ.C
+++ /dev/null
@@ -1,1168 +0,0 @@
-#define VERSION "sz 1.03 05-18-86"
-#define PUBDIR "/usr/spool/uucppublic"
-
-/*% cc -O -K sz.c -o sz; size sz
-
- * sz.c By Chuck Forsberg
- *
- * cc -O sz.c -o sz USG (SYS III/V) Unix
- * cc -O -DV7 sz.c -o sz Unix Version 7, 2.8 - 4.3 BSD
- *
- * ******* Some systems (Venix, Coherent, Regulus) do not *******
- * ******* support tty raw mode read(2) identically to *******
- * ******* Unix. ONEREAD must be defined to force one *******
- * ******* character reads for these systems. *******
- *
- * A program for Unix to send files and commands to computers running
- * Professional-YAM, PowerCom, YAM, IMP, or programs supporting XMODEM.
- *
- * Sz uses buffered I/O to greatly reduce CPU time compared to UMODEM.
- *
- * USG UNIX (3.0) ioctl conventions courtesy Jeff Martin
- */
-
-/*
- * Attention string to be executed by receiver to interrupt streaming data
- * when an error is detected. A pause (0336) may be needed before the
- * ^C (03) or after it.
- */
-char Myattn[] = { 03, 0336, 0 };
-
-unsigned updcrc();
-char *substr(), *getenv();
-
-#define LOGFILE "/tmp/szlog"
-#define zperr vfile
-
-/*
-#include <stdio.h>
-#include <signal.h>
-#include <setjmp.h>
-#include <ctype.h>
-*/
-#include "rtthread.h"
-#include "finsh.h"
-#include "shell.h"
-#include"rtdef.h"
-#include <dfs.h>
-#include <dfs_file.h>
-#include <dfs_posix.h>
-#include "zmodem.h"
-
-#define PATHLEN 256
-#define OK 0
-#define FALSE 0
-#define TRUE 1
-#define ERROR (-1)
-
-#define HOWMANY 2
-int Zmodem=0; /* ZMODEM protocol requested */
-unsigned Baudrate;
-#include "rbsb.c" /* most of the system dependent stuff here */
-
-int in;
-
-/* Ward Christensen / CP/M parameters - Don't change these! */
-#define ENQ 005
-#define CAN ('X'&037)
-#define XOFF ('s'&037)
-#define XON ('q'&037)
-#define SOH 1
-#define STX 2
-#define EOT 4
-#define ACK 6
-#define NAK 025
-#define CPMEOF 032
-#define WANTCRC 0103 /* send C not NAK to get crc not checksum */
-#define WANTG 0107 /* Send G not NAK to get nonstop batch xmsn */
-#define TIMEOUT (-2)
-#define RETRYMAX 10
-#define SECSIZ 128 /* cp/m's Magic Number record size */
-#define KSIZE 1024
-
-char Lastrx;
-char Crcflg;
-int Wcsmask=0377;
-int Verbose=0;
-int Modem=0; /* MODEM - don't send pathnames */
-int Restricted=0; /* restricted; no /.. or ../ in filenames */
-int Quiet=0; /* overrides logic that would otherwise set verbose */
-int Ascii=0; /* Add CR's for brain damaged programs */
-int Fullname=0; /* transmit full pathname */
-int Unlinkafter=0; /* Unlink file after it is sent */
-int Dottoslash=0; /* Change foo.bar.baz to foo/bar/baz */
-int firstsec;
-int errcnt=0; /* number of files unreadable */
-int blklen=SECSIZ; /* length of transmitted records */
-int Optiong; /* Let it rip no wait for sector ACK's */
-int Noeofseen;
-int Totsecs; /* total number of sectors this file */
-char txbuf[KSIZE];
-int Filcnt=0; /* count of number of files opened */
-int Lfseen=0;
-unsigned Rxbuflen = 16384; /* Receiver's max buffer length */
-int Rxflags = 0;
-char Lzconv; /* Local ZMODEM file conversion request */
-char Lzmanag; /* Local ZMODEM file management request */
-char Lztrans;
-char zconv; /* ZMODEM file conversion request */
-char zmanag; /* ZMODEM file management request */
-char ztrans; /* ZMODEM file transport request */
-int Command; /* Send a command, then exit. */
-char *Cmdstr; /* Pointer to the command string */
-int Cmdtries = 11;
-int Cmdack1; /* Rx ACKs command, then do it */
-int Exitcode;
-int Testattn; /* Force receiver to send Attn, etc with qbf. */
-char *qbf="The quick brown fox jumped over the lazy dog's back 1234567890\r\n";
-
-
-//jmp_buf tohere; /* For the interrupt on RX timeout */
-//jmp_buf intrjmp; /* For the interrupt on RX CAN */
-
-/* called by signal interrupt or terminate to clean things up */
-bibi(n)
-{
- canit();
- //fflush(stdout);
- mode(0);
- //rt_kprintf(stderr, "sz: caught signal %d; exiting\n", n);
- //if (n == SIGQUIT)
- // abort();
- //exit(128+n);
-}
-/* Called when Zmodem gets an interrupt (^X) */
-onintr()
-{
- //signal(SIGINT, SIG_IGN);
- //longjmp(intrjmp, -1);
-}
-
-
-//#define sendline(c) putchar(c & Wcsmask)
-
-//#define xsendline(c) putchar(c)
-int sendline (int c)
-{
- c = c&Wcsmask;
- zwrite(c);
-
-}
-int xsendline(int c)
-{
- zwrite(c);
-}
-
-
-flushmo()
-{
- //fflush(stdout);
-}
-
-#include "zm.c"
-
-zsmain(argc, argv)
-char *argv[];
-{
- register char *cp;
- register npats;
- int agcnt; char **agcv;
- char **patts;
- static char xXbuf[BUFSIZ];
-
- //if ((cp=getenv("SHELL")) && (substr(cp, "rsh") || substr(cp, "rsh")))
- // Restricted=TRUE;
-
- Rxtimeout = 600;
- npats=0;
- /*
- if (argc<2)
- usage();
- //setbuf(stdout, xXbuf);
- while (--argc) {
- cp = *++argv;
- if (*cp++ == '-' && *cp) {
- while ( *cp) {
- switch(*cp++) {
- case '+':
- Lzmanag = ZMAPND; break;
- case '1':
- iofd = 1; break;
- case '7':
- Wcsmask=0177; break;
- case 'a':
- Lzconv = ZCNL;
- Ascii = TRUE; break;
- case 'b':
- Lzconv = ZCBIN; break;
- case 'C':
- if (--argc < 1) {
- usage();
- }
- Cmdtries = atoi(*++argv);
- break;
- case 'i':
- Cmdack1 = ZCACK1;
- //* **** FALL THROUGH TO ****
- case 'c':
- if (--argc != 1) {
- usage();
- }
- Command = TRUE;
- Cmdstr = *++argv;
- break;
- case 'd':
- ++Dottoslash;
- //* **** FALL THROUGH TO **** *
- case 'f':
- Fullname=TRUE; break;
- case 'k':
- blklen=KSIZE; break;
- case 'N':
- Lzmanag = ZMCRC; break;
- case 'n':
- Lzmanag = ZMNEW; break;
- case 'r':
- Lzconv = ZCRESUM;
- case 'q':
- Quiet=TRUE; Verbose=0; break;
- case 'T':
- Testattn = TRUE; break;
- case 'u':
- ++Unlinkafter; break;
- case 'v':
- ++Verbose; break;
- case 'X':
- ++Modem; break;
- case 'y':
- Lzmanag = ZMCLOB; break;
- default:
- usage();
- }
- }
- }
- else if ( !npats && argc>0) {
- if (argv[0][0]) {
- npats=argc;
- patts=argv;
- if ( !strcmp(*patts, "-"))
- iofd = 1;
- }
- }
- }
- if (npats < 1 && !Command)
- usage();
- if (Verbose) {
- if (freopen(LOGFILE, "a", stderr)==NULL) {
- printf("Can't open log file %s\n",LOGFILE);
- exit(0200);
- }
- setbuf(stderr, NULL);
- }
- if (fromcu() && !Quiet) {
- if (Verbose == 0)
- Verbose = 2;
- }
-
- mode(1);
-
-// if (signal(SIGINT, bibi) == SIG_IGN) {
-// signal(SIGINT, SIG_IGN); signal(SIGKILL, SIG_IGN);
-// }
-// else {
- // signal(SIGINT, bibi); signal(SIGKILL, bibi);
-// signal(SIGQUIT, bibi);
-// }
-
- if ( !Modem) {
- if (!Command) {
- printf("rz\r"); fflush(stdout);
- }
- if (!Command && !Quiet && Verbose != 1) {
- rt_kprintf(stderr, "sz: %d file%s requested:\r\n",
- npats, npats>1?"s":"");
- for ( agcnt=npats, agcv=patts; --agcnt>=0; ) {
- rt_kprintf(stderr, "%s ", *agcv++);
- }
- rt_kprintf(stderr, "\r\n");
- printf("\r\n\bSending in Batch Mode\r\n");
- }
- stohdr(0L);
- if (Command)
- Txhdr[ZF0] = ZCOMMAND;
- zshhdr(ZRQINIT, Txhdr);
- }
- fflush(stdout);
- */
- if (Command) {
- if (getzrxinit()) {
- Exitcode=0200; canit();
- }
- else if (zsendcmd(Cmdstr, 1+strlen(Cmdstr))) {
- Exitcode=0200; canit();
- }
- } else if (wcsend(npats, patts)==ERROR) {
- Exitcode=0200;
- canit();
- }
- //fflush(stdout);
- //mode(0);
- //exit((errcnt != 0) | Exitcode);
- /*NOTREACHED*/
-}
-
-wcsend(argc, argp)
-char *argp[];
-{
- register n;
-
- Crcflg=FALSE;
- firstsec=TRUE;
- //for (n=0; n<argc; ++n) {
- Totsecs = 0;
- if (wcs(argp[n])==ERROR)
- return ERROR;
- //}
- Totsecs = 0;
- if (Filcnt==0) { /* bitch if we couldn't open ANY files */
- //rt_kprintf(stderr,"\r\nCan't open any requested files.\r\n");
- return ERROR;
- }
- if (Zmodem)
- saybibi();
- else
- wctxpn("");
- return OK;
-}
-
-wcs(oname)
-char *oname;
-{
- register c;
- register char *p;
- struct stat f;
- char name[PATHLEN];
- char *filename ="/tt2.txt";
- oname = filename;
- strcpy(name, oname);
-
- if (Restricted) {
- /* restrict pathnames to current tree or uucppublic */
- if ( substr(name, "../")
- || (name[0]== '/' && strncmp(name, PUBDIR, strlen(PUBDIR))) ) {
- canit();
- //rt_kprintf(stderr,"\r\nsz:\tSecurity Violation\r\n");
- return ERROR;
- }
- }
-
- //if ( !strcmp(oname, "-")) {
- // if ((p = getenv("ONAME")) && *p)
- // strcpy(name, p);
- //else
- //sprintf(name, "s%d.sz", getpid());
-/////////////////////////////////////////////////////////////////////////////////////////////////
- //in = stdin;
-// }
- //else if ((in=fopen(oname, "r"))==NULL) {
- // ++errcnt;
- //return OK; /* pass over it, there may be others */
- //}
- if ((in=open(oname, DFS_O_RDONLY,0)) <0)
- {
- ++errcnt;
- return OK;
- }
- ++Noeofseen;
- /* Check for directory or block special files */
- fstat(in, &f);
- c = f.st_mode & S_IFMT;
- if (c == S_IFDIR || c == S_IFBLK) {
- close(in);
- return OK;
- }
-
- ++Filcnt;
- switch (wctxpn(name)) {
- case ERROR:
- return ERROR;
- case ZSKIP:
- return OK;
- }
- if (!Zmodem && wctx()==ERROR)
- return ERROR;
- if (Unlinkafter)
- unlink(oname);
- return 0;
-}
-
-/*
- * generate and transmit pathname block consisting of
- * pathname (null terminated),
- * file length, mode time and file mode in octal
- * as provided by the Unix fstat call.
- * N.B.: modifies the passed name, may extend it!
- */
-wctxpn(name)
-char *name;
-{
- register char *p, *q;
- char name2[PATHLEN];
- struct stat f;
-
- if (Modem) {
- //if ((in!=stdin) && *name && fstat(fileno(in), &f)!= -1) {
- // rt_kprintf(stderr, "Sending %s, %ld blocks: ",
- // name, f.st_size>>7);
- //}
- //rt_kprintf(stderr, "Give your local XMODEM receive command now.\r\n");
- return OK;
- }
- logent("\r\nAwaiting pathname nak for %s\r\n", *name?name:"<END>");
- if ( !Zmodem)
- if (getnak())
- return ERROR;
-
- q = (char *) 0;
- if (Dottoslash) { /* change . to . */
- for (p=name; *p; ++p) {
- if (*p == '/')
- q = p;
- else if (*p == '.')
- *(q=p) = '/';
- }
- if (q && strlen(++q) > 8) { /* If name>8 chars */
- q += 8; /* make it .ext */
- strcpy(name2, q); /* save excess of name */
- *q = '.';
- strcpy(++q, name2); /* add it back */
- }
- }
-
- for (p=name, q=txbuf ; *p; )
- if ((*q++ = *p++) == '/' && !Fullname)
- q = txbuf;
- *q++ = 0;
- p=q;
- while (q < (txbuf + KSIZE))
- *q++ = 0;
- //if (!Ascii && (in!=stdin) && *name && fstat(fileno(in), &f)!= -1)
- //sprintf(p, "%lu %lo %o", f.st_size, f.st_mtime, f.st_mode);
- fstat(in,&f);
- /* force 1k blocks if name won't fit in 128 byte block */
- if (txbuf[125])
- blklen=KSIZE;
- else { /* A little goodie for IMP/KMD */
- if (Zmodem)
- blklen = SECSIZ;
- txbuf[127] = f.st_size >>7;
- txbuf[126] = f.st_size >>15;
- }
- if (Zmodem)
- return zsendfile(txbuf, 1+strlen(p)+(p-txbuf));
- if (wcputsec(txbuf, 0, SECSIZ)==ERROR)
- return ERROR;
- return OK;
-}
-
-getnak()
-{
- register firstch;
-
- Lastrx = 0;
- for (;;) {
- switch (firstch = readock(800,1)) {
- case ZPAD:
- if (getzrxinit())
- return ERROR;
- Ascii = 0;
- return FALSE;
- case TIMEOUT:
- logent("Timeout on pathname\n");
- return TRUE;
- case WANTG:
- mode(2); /* Set cbreak, XON/XOFF, etc. */
- Optiong = TRUE;
- blklen=KSIZE;
- case WANTCRC:
- Crcflg = TRUE;
- case NAK:
- return FALSE;
- case CAN:
- if (Lastrx == CAN)
- return TRUE;
- default:
- break;
- }
- Lastrx = firstch;
- }
-}
-
-
-wctx()
-{
- register int sectnum, attempts, firstch;
-
- firstsec=TRUE;
-
- while ((firstch=readock(400, 2))!=NAK && firstch != WANTCRC
- && firstch != WANTG && firstch!=TIMEOUT && firstch!=CAN)
- ;
- if (firstch==CAN) {
- logent("Receiver CANcelled\n");
- return ERROR;
- }
- if (firstch==WANTCRC)
- Crcflg=TRUE;
- if (firstch==WANTG)
- Crcflg=TRUE;
- sectnum=1;
- while (filbuf(txbuf, blklen)) {
- if (wcputsec(txbuf, sectnum, blklen)==ERROR) {
- return ERROR;
- } else
- sectnum++;
- }
- //if (Verbose>1)
- // rt_kprintf(stderr, " Closing ");
- close(in);
- attempts=0;
- do {
- logent(" EOT ");
- purgeline();
- sendline(EOT);
- //fflush(stdout);
- ++attempts;
- }
- while ((firstch=(readock(100, 1)) != ACK) && attempts < RETRYMAX);
- if (attempts == RETRYMAX) {
- logent("No ACK on EOT\n");
- return ERROR;
- }
- else
- return OK;
-}
-
-wcputsec(buf, sectnum, cseclen)
-char *buf;
-int sectnum;
-int cseclen; /* data length of this sector to send */
-{
- register checksum, wcj;
- register char *cp;
- unsigned oldcrc;
- int firstch;
- int attempts;
-
- firstch=0; /* part of logic to detect CAN CAN */
-
- //if (Verbose>1)
- // rt_kprintf(stderr, "\rSector %3d %2dk ", Totsecs, Totsecs/8 );
- for (attempts=0; attempts <= RETRYMAX; attempts++) {
- Lastrx= firstch;
- sendline(cseclen==KSIZE?STX:SOH);
- sendline(sectnum);
- sendline(-sectnum -1);
- oldcrc=checksum=0;
- for (wcj=cseclen,cp=buf; --wcj>=0; ) {
- sendline(*cp);
- oldcrc=updcrc(*cp, oldcrc);
- checksum += *cp++;
- }
- if (Crcflg) {
- oldcrc=updcrc(0,updcrc(0,oldcrc));
- sendline((int)oldcrc>>8);
- sendline((int)oldcrc);
- }
- else
- sendline(checksum);
-
- if (Optiong) {
- firstsec = FALSE; return OK;
- }
- firstch = readock(400, (Noeofseen&&sectnum) ? 2:1);
-gotnak:
- switch (firstch) {
- case CAN:
- if(Lastrx == CAN) {
-cancan:
- logent("Cancelled\n"); return ERROR;
- }
- break;
- case TIMEOUT:
- logent("Timeout on sector ACK\n"); continue;
- case WANTCRC:
- if (firstsec)
- Crcflg = TRUE;
- case NAK:
- logent("NAK on sector\n"); continue;
- case ACK:
- firstsec=FALSE;
- Totsecs += (cseclen>>7);
- return OK;
- case ERROR:
- logent("Got burst for sector ACK\n"); break;
- default:
- logent("Got %02x for sector ACK\n", firstch); break;
- }
- for (;;) {
- Lastrx = firstch;
- if ((firstch = readock(400, 2)) == TIMEOUT)
- break;
- if (firstch == NAK || firstch == WANTCRC)
- goto gotnak;
- if (firstch == CAN && Lastrx == CAN)
- goto cancan;
- }
- }
- logent("Retry Count Exceeded\n");
- return ERROR;
-}
-
-/* fill buf with count chars padding with ^Z for CPM */
-filbuf(buf, count)
-register char *buf;
-{
- register c, m;
-
- if ( !Ascii) {
- m = read(in, buf, count);
- if (m <= 0)
- return 0;
- while (m < count)
- buf[m++] = 032;
- return count;
- }
- m=count;
- if (Lfseen) {
- *buf++ = 012; --m; Lfseen = 0;
- }
- /////////////////////////////////////////////////////////////////////////////////////
- /*
- while ((c=getc(in))!=EOF) {
- if (c == 012) {
- *buf++ = 015;
- if (--m == 0) {
- Lfseen = TRUE; break;
- }
- }
- *buf++ =c;
- if (--m == 0)
- break;
- }
- */
- if (m==count)
- return 0;
- else
- while (--m>=0)
- *buf++ = CPMEOF;
- return count;
-}
-/* fill buf with count chars */
-zfilbuf(buf, count)
-register char *buf;
-{ //int read(int fd, void *buf, size_t len)
- int c, m;
- int res;
-
- m=count;
- res = 0;
- while (1) {
- res = read(in,&c,1);
- if (res == 0) break;
- *buf++ =c;
- res = 0;
- if (--m == 0)
- break;
- }
- return (count - m);
-}
-
-/* VARARGS1 */
-vfile(f, a, b, c)
-register char *f;
-{
-// if (Verbose > 1) {
- // rt_kprintf(stderr, f, a, b, c);
- // rt_kprintf(stderr, "\n");
-// }
-}
-
-
-alarm()
-{
- //longjmp(tohere, -1);
-}
-
-
-/*
- * readock(timeout, count) reads character(s) from file descriptor 0
- * (1 <= count <= 3)
- * it attempts to read count characters. If it gets more than one,
- * it is an error unless all are CAN
- * (otherwise, only normal response is ACK, CAN, or C)
- * Only looks for one if Optiong, which signifies cbreak, not raw input
- *
- * timeout is in tenths of seconds
- */
-readock(timeout, count)
-{
- register int c;
- static char byt[5];
- int ch;
- if (Optiong)
- count = 1; /* Special hack for cbreak */
-
- //fflush(stdout);
- //if (setjmp(tohere)) {
- // logent("TIMEOUT\n");
- // return TIMEOUT;
- //}
- c = 0;
- while (1)
- {
- c = zread(shell->device, 0, byt, 1);
- if (c > 0) break;
- }
- //if (Verbose>5)
- // rt_kprintf(stderr, "ret cnt=%d %x %x\n", c, byt[0], byt[1]);
- if (c<1)
- return TIMEOUT;
- if (c==1)
- return (byt[0]&0377);
- else
- while (c)
- if (byt[--c] != CAN)
- return ERROR;
- return CAN;
-}
-readline(n)
-{
- return (readock(n, 1));
-}
-
-
-purgeline()
-{
-#ifdef USG
- ioctl(iofd, TCFLSH, 0);
-#else
- lseek(iofd, 0L, 2);
-#endif
-}
-
-/* update CRC */
-unsigned
-updcrc(c, crc)
-register c;
-register unsigned crc;
-{
- register count;
-
- for (count=8; --count>=0;) {
- if (crc & 0x8000) {
- crc <<= 1;
- crc += (((c<<=1) & 0400) != 0);
- crc ^= 0x1021;
- }
- else {
- crc <<= 1;
- crc += (((c<<=1) & 0400) != 0);
- }
- }
- return crc;
-}
-
-/* send cancel string to get the other end to shut up */
-canit()
-{
- static char canistr[] = {
- ZPAD,ZPAD,24,24,24,24,24,24,24,24,8,8,8,8,8,8,8,8,8,8,0
- };
-
- //printf(canistr);
- //fflush(stdout);
-}
-
-/*VARARGS1*/
-logent(a, b, c)
-char *a, *b, *c;
-{
-// if(Verbose)
- // rt_kprintf(stderr, a, b, c);
-}
-
-/*
- * return 1 iff stdout and stderr are different devices
- * indicating this program operating with a modem on a
- * different line
- */
-fromcu()
-{
- struct stat a, b;
- fstat(1, &a); fstat(2, &b);
-// return (a.st_rdev != b.st_rdev);
-}
-
-/*
- * substr(string, token) searches for token in string s
- * returns pointer to token within string if found, NULL otherwise
- */
-char *
-substr(s, t)
-register char *s,*t;
-{
- register char *ss,*tt;
- /* search for first char of token */
- for (ss=s; *s; s++)
- if (*s == *t)
- /* compare token with substring */
- for (ss=s,tt=t; ;) {
- if (*tt == 0)
- return s;
- if (*ss++ != *tt++)
- break;
- }
- return NULL;
-}
-
-usage()
-{
-
-}
-
-/*
- * Get the receiver's init parameters
- */
-getzrxinit()
-{
- register n;
- struct stat f;
-
- for (n=10; --n>=0; ) {
-
- switch (zgethdr(Rxhdr, 1)) {
- case ZCHALLENGE: /* Echo receiver's challenge numbr */
- stohdr(Rxpos);
- zshhdr(ZACK, Txhdr);
- continue;
- case ZCOMMAND: /* They didn't see out ZRQINIT */
- stohdr(0L);
- zshhdr(ZRQINIT, Txhdr);
- continue;
- case ZRINIT:
- Rxflags = Rxhdr[ZF0];
- Rxbuflen = Rxhdr[ZP0] + (Rxhdr[ZP1]<<8);
- //signal(SIGINT, SIG_IGN);
- mode(2); /* Set cbreak, XON/XOFF, etc. */
-
- /* If using a pipe for testing set lower buf len */
- fstat(iofd, &f);
- if ((f.st_mode & S_IFMT) != S_IFCHR
- && (Rxbuflen == 0 || Rxbuflen > 4096))
- Rxbuflen = 4096;
- /*
- * If input is not a regular file, force ACK's each 1024
- * (A smarter strategey could be used here ...)
- */
- fstat(in, &f);
- if (((f.st_mode & S_IFMT) != S_IFREG)
- && (Rxbuflen == 0 || Rxbuflen > 1024))
- Rxbuflen = 1024;
-
- return (sendzsinit());
- case ZCAN:
- case TIMEOUT:
- return ERROR;
- case ZRQINIT:
- if (Rxhdr[ZF0] == ZCOMMAND)
- continue;
- default:
- zshhdr(ZNAK, Txhdr);
- continue;
- }
- }
- return ERROR;
-}
-
-/* Send send-init information */
-sendzsinit()
-{
- register c;
- register errors;
-
- errors = 0;
- for (;;) {
- stohdr(0L);
- zsbhdr(ZSINIT, Txhdr);
- zsbdata(Myattn, 1+strlen(Myattn), ZCRCW);
- c = zgethdr(Rxhdr, 1);
- switch (c) {
- case ZCAN:
- return ERROR;
- case ZACK:
- return OK;
- default:
- if (++errors > 9)
- return ERROR;
- continue;
- }
- }
-}
-
-/* Send file name and related info */
-zsendfile(buf, blen)
-char *buf;
-{
- register c;
-
- for (;;) {
- Txhdr[ZF0] = Lzconv; /* file conversion request */
- Txhdr[ZF1] = Lzmanag; /* file management request */
- Txhdr[ZF2] = Lztrans; /* file transport request */
- Txhdr[ZF3] = 0;
- zsbhdr(ZFILE, Txhdr);
- zsbdata(buf, blen, ZCRCW);
-again:
- c = zgethdr(Rxhdr, 1);
- switch (c) {
- case ZRINIT:
- goto again;
- case ZCAN:
- case TIMEOUT:
- case ZABORT:
- case ZFIN:
- return ERROR;
- case ZSKIP:
- close(in); return c;
- case ZRPOS:
- lseek(in, Rxpos, 0);
- Txpos = Rxpos;
- return zsendfdata();
- case ERROR:
- default:
- continue;
- }
- }
-}
-
-/* Send the data in the file */
-zsendfdata()
-{
- register c, e;
- register newcnt;
- register long tcount = 0;
- static int tleft = 6; /* Counter for test mode */
-
- if (Baudrate > 300)
- blklen = 256;
- if (Baudrate > 2400)
- blklen = KSIZE;
- if (Rxbuflen && blklen>Rxbuflen)
- blklen = Rxbuflen;
-somemore:
- //if (setjmp(intrjmp)) {
-waitack:
- // switch (c = getinsync()) {
- // default:
- // case ZCAN:
- // close(in);
- // return ERROR;
- // case ZSKIP:
- // close(in);
- // return c;
- // case ZACK:
- // case ZRPOS:
- // break;
- // }
-// }
-
- //signal(SIGINT, onintr);
- newcnt = Rxbuflen;
- stohdr(Txpos);
- zsbhdr(ZDATA, Txhdr);
-
- /*
- * Special testing mode. This should force receiver to Attn,ZRPOS
- * many times. Each time the signal should be caught, causing the
- * file to be started over from the beginning.
- */
- if (Testattn) {
- if ( --tleft)
- while (tcount < 20000) {
- //printf(qbf);
- //fflush(stdout);
- tcount += strlen(qbf);
- }
- //signal(SIGINT, SIG_IGN);
- canit();
- //sleep(3);
- purgeline(); mode(0);
- //printf("\nsz: Tcount = %ld\n", tcount);
- if (tleft) {
- //printf("ERROR: Interrupts Not Caught\n");
- //exit(1);
- }
- //exit(0);
- }
-
- do {
- c = zfilbuf(txbuf, blklen);
- if (c < blklen)
- e = ZCRCE;
- else if (Rxbuflen && (newcnt -= c) <= 0)
- e = ZCRCW;
- else
- e = ZCRCG;
- zsbdata(txbuf, c, e);
- Txpos += c;
- if (e == ZCRCW)
- goto waitack;
-#ifdef NOTDEF_DOS
- if ( !carrier()) {
- return ERROR;
- }
- /*
- * If the reverse channel can be tested for data,
- * this logic may be used to detect error packets
- * sent by the receiver, in place of setjmp/longjmp
- * miready() returns non 0 if a character is available
- */
- while (miready()) {
- if (readline(1) == ZPAD) {
- zsbdata(U.ubuf, 0, ZCRCW);
- goto somemore;
- }
- }
-#endif
- } while (c == blklen);
- //signal(SIGINT, SIG_IGN);
-
- for (;;) {
- stohdr(Txpos);
- zsbhdr(ZEOF, Txhdr);
- switch (getinsync()) {
- case ZRPOS:
- goto somemore;
- case ZRINIT:
- close(in);
- return OK;
- case ZSKIP:
- close(in);
- return c;
- default:
- close(in);
- return ERROR;
- }
- }
-}
-
-/*
- * Respond to receiver's complaint, get back in sync with receiver
- */
-getinsync()
-{
- register c;
-
- for (;;) {
- if (Testattn) {
- //printf("\r\n\n\n***** Signal Caught *****\r\n");
- Rxpos = 0; c = ZRPOS;
- } else
- c = zgethdr(Rxhdr, 0);
- switch (c) {
- case ZCAN:
- case ZABORT:
- case ZFIN:
- case TIMEOUT:
- return ERROR;
- case ZRPOS:
- //clearerr(in); /* In case file EOF seen */
- lseek(in, Rxpos, 0);
- Txpos = Rxpos;
- return c;
- case ZACK:
- return c;
- case ZRINIT:
- case ZSKIP:
- close(in);
- return c;
- case ERROR:
- default:
- zsbhdr(ZNAK, Txhdr);
- continue;
- }
- }
-}
-/* Say "bibi" to the receiver, try to do it cleanly */
-saybibi()
-{
- for (;;) {
- stohdr(0L);
- zsbhdr(ZFIN, Txhdr);
- switch (zgethdr(Rxhdr, 0)) {
- case ZFIN:
- sendline('O'); sendline('O'); flushmo();
- case ZCAN:
- case TIMEOUT:
- return;
- }
- }
-}
-
-/* Local screen character display function */
-bttyout(c)
-{
- //if (Verbose)
- // putc(c, stderr);
-}
-
-/* Send command and related info */
-zsendcmd(buf, blen)
-char *buf;
-{
- register c, errors;
- long cmdnum;
-
-// cmdnum = getpid();
- errors = 0;
- for (;;) {
- stohdr(cmdnum);
- Txhdr[ZF0] = Cmdack1;
- zsbhdr(ZCOMMAND, Txhdr);
- zsbdata(buf, blen, ZCRCW);
-listen:
- Rxtimeout = 100; /* Ten second wait for resp. */
- c = zgethdr(Rxhdr, 1);
-
- switch (c) {
- case ZRINIT:
- continue;
- case ERROR:
- case TIMEOUT:
- if (++errors > Cmdtries)
- return ERROR;
- continue;
- case ZCAN:
- case ZABORT:
- case ZFIN:
- case ZSKIP:
- case ZRPOS:
- return ERROR;
- default:
- if (++errors > 10)
- return ERROR;
- continue;
- case ZCOMPL:
- Exitcode = Rxpos;
- saybibi();
- return OK;
- case ZRQINIT:
- vfile("******** RZ *******");
- system("rz");
- vfile("******** SZ *******");
- goto listen;
- }
- }
-}
-
diff --git a/components/utilities/ZMODEM/ZM.C b/components/utilities/ZMODEM/ZM.C
deleted file mode 100644
index 6dceb7ae09..0000000000
--- a/components/utilities/ZMODEM/ZM.C
+++ /dev/null
@@ -1,480 +0,0 @@
-/*
- * Z M . C
- * ZMODEM protocol primitives
- * 5-18-86 Chuck Forsberg Omen Technology Inc
- *
- * Entry point Functions:
- * zsbhdr(type, hdr) send binary header
- * zshhdr(type, hdr) send hex header
- * zgethdr(hdr, eflag) receive header - binary or hex
- * zsbdata(buf, len, frameend) send binary data
- * zrbdata(buf, len) receive binary data
- * stohdr(pos) store position data in Txhdr
- * long rclhdr(hdr) recover position offset from header
- */
-
-//#ifndef CANFDX
-#include "zmodem.h"
-int Rxtimeout = 100; /* Tenths of seconds to wait for something */
-//#endif
-#define ERROR (-1)
-static char *frametypes[] = {
- "TIMEOUT",
- "ERROR",
- "ZRQINIT",
- "ZRINIT",
- "ZSINIT",
- "ZACK",
- "ZFILE",
- "ZSKIP",
- "ZNAK",
- "ZABORT",
- "ZFIN",
- "ZRPOS",
- "ZDATA",
- "ZEOF",
- "ZFERR",
- "ZCRC",
- "ZCHALLENGE",
- "ZCOMPL",
- "ZCAN",
- "ZFREECNT",
- "ZCOMMAND",
- "ZCACK"
-#define FRTYPES 21 /* Total number of frame types in this array */
-};
-
-long int rclhdr(char *hdr);
-int zputhex(int c);
-int zsendline(int c);
-int zgethex(void);
-int zgeth1(void);
-int zrbhdr(char *hdr);
-int zrhhdr(char *hdr);
-int zdlread(void);
-int noxread7(void);
-
-
-/* Send ZMODEM binary header hdr of type type */
-int zsbhdr(int type, char *hdr)
-{
- int n;
- unsigned short oldcrc;
-
- vfile("zsbhdr: %s %lx", frametypes[type+2], rclhdr(hdr));
- xsendline(ZPAD); xsendline(ZDLE); xsendline(ZBIN);
-
- zsendline(type); oldcrc = updcrc(type, 0);
-
- for (n=4; --n >= 0;) {
- zsendline(*hdr);
- oldcrc = updcrc(*hdr++, oldcrc);
- }
- oldcrc = updcrc(0,updcrc(0,oldcrc));
- zsendline(oldcrc>>8);
- zsendline(oldcrc);
- if (type != ZDATA)
- flushmo();
- return 0;
-}
-
-/* Send ZMODEM HEX header hdr of type type */
-int zshhdr(int type, char *hdr)
-{
- int n;
- unsigned short oldcrc;
-
- vfile("zshhdr: %s %lx", frametypes[type+2], rclhdr(hdr));
-
- sendline(ZPAD); sendline(ZPAD); sendline(ZDLE); sendline(ZHEX);
- zputhex(type);
-
- oldcrc = updcrc(type, 0);
- for (n=4; --n >= 0;) {
- zputhex(*hdr); oldcrc = updcrc(*hdr++, oldcrc);
- }
- oldcrc = updcrc(0,updcrc(0,oldcrc));
- zputhex(oldcrc>>8); zputhex(oldcrc);
-
- /* Make it printable on remote machine */
- sendline(015); sendline(0212); /*012*/
- /*
- * Uncork the remote in case a fake XOFF has stopped data flow
- */
- if (type != ZFIN)
- sendline(021);
- flushmo();
- return 0;
-}
-
-/*
- * Send binary array buf of length length, with ending ZDLE sequence frameend
- */
-int zsbdata(char *buf, int length, int frameend)
-{
- register unsigned short oldcrc;
-
- vfile("zsbdata: length=%d end=%x", length, frameend);
- oldcrc = 0;
- for (;--length >= 0;) {
- zsendline(*buf);
- oldcrc = updcrc(*buf++, oldcrc);
- }
- xsendline(ZDLE); xsendline(frameend);
- oldcrc = updcrc(frameend, oldcrc);
-
- oldcrc = updcrc(0,updcrc(0,oldcrc));
- zsendline(oldcrc>>8);
- zsendline(oldcrc);
- if (frameend == ZCRCW)
- flushmo();
- return 0;
-}
-
-/*
- * Receive binary array buf of max length with ending ZDLE sequence
- * and CRC. Returns the ending character or error code.
- */
-int zrbdata(char *buf, int length)
-{
- int c;
- unsigned short oldcrc;
- int d;
-
- oldcrc = Rxcount = 0;
- for (;;) {
- if ((c = zdlread()) & ~0377) {
- switch (c) {
- case GOTCRCE:
- case GOTCRCG:
- case GOTCRCQ:
- case GOTCRCW:
- oldcrc = updcrc((d=c)&0377, oldcrc);
- if ((c = zdlread()) & ~0377)
- goto badcrc;
- oldcrc = updcrc(c, oldcrc);
- if ((c = zdlread()) & ~0377)
- goto badcrc;
- oldcrc = updcrc(c, oldcrc);
- if (oldcrc & 0xFFFF) {
-badcrc:
- zperr("Bad data packet CRC");
- return ERROR;
- }
- vfile("zrbdata: Rxcount = %d ret = %x",
- Rxcount, d);
- return d;
- case GOTCAN:
- zperr("ZMODEM: Sender Canceled");
- return ZCAN;
- case TIMEOUT:
- zperr("ZMODEM data packet TIMEOUT");
- return c;
- default:
- zperr("ZMODEM bad data packet ret=%x", c);
- return c;
- }
- }
- if (--length < 0) {
- zperr("ZMODEM binary data packet too long");
- return ERROR;
- }
- ++Rxcount;
- *buf++ = c;
- oldcrc = updcrc(c, oldcrc);
- continue;
- }
-}
-
-/*
- * Read a ZMODEM header to hdr, either binary or hex.
- * eflag controls local display of non zmodem characters:
- * 0: no display
- * 1: display printing characters only
- * 2: display all non ZMODEM characters
- * On success, set Zmodem to 1 and return type of header.
- * Otherwise return negative on error
- */
-int zgethdr(char *hdr, int eflag)
-{
- int c, n;
-
- n = Baudrate; /* Max characters before start of frame */
-again:
- Rxframeind = Rxtype = 0;
- switch (c = noxread7()) {
- case TIMEOUT:
- goto fifi;
- case ZDLE:
- if (noxread7() == ZDLE) {
- c = ZCAN; goto fifi;
- }
- /* **** FALL THRU TO **** */
- default:
- if ( --n == 0) {
- zperr("ZMODEM Garbage count exceeded");
- return(ERROR);
- }
- if (eflag && ((c &= 0177) & 0140))
- bttyout(c);
- else if (eflag > 1)
- bttyout(c);
- goto again;
- case ZPAD:
- break;
- }
-splat:
- switch (c = noxread7()) {
- case ZPAD:
- goto splat;
- case TIMEOUT:
- goto fifi;
- default:
- goto again;
- case ZDLE:
- break;
- }
-
- switch (c = noxread7()) {
- case TIMEOUT:
- goto fifi;
- case ZBIN:
- Rxframeind = ZBIN;
- c = zrbhdr(hdr);
- break;
- case ZHEX:
- Rxframeind = ZHEX;
- c = zrhhdr(hdr);
- break;
- case ZDLE:
- if (noxread7() == ZDLE) {
- c = ZCAN; goto fifi;
- }
- /* **** FALL THRU TO **** */
- default:
- goto again;
- }
- Rxpos = hdr[ZP3] & 0377;
- Rxpos = (Rxpos<<8) + (hdr[ZP2] & 0377);
- Rxpos = (Rxpos<<8) + (hdr[ZP1] & 0377);
- Rxpos = (Rxpos<<8) + (hdr[ZP0] & 0377);
-fifi:
- switch (c) {
- case GOTCAN:
- c = ZCAN;
- /* **** FALL THRU TO **** */
- case ZNAK:
- case ZCAN:
- case ERROR:
- case TIMEOUT:
- zperr("ZMODEM: Got %s header", frametypes[c+2]);
- default:
- if (c >= -2 && c <= FRTYPES)
- vfile("zgethdr: %s %lx", frametypes[c+2], Rxpos);
- else
- vfile("zgethdr: %d %lx", c, Rxpos);
- }
- return c;
-}
-
-/* Receive a binary style header (type and position) */
-int zrbhdr(char *hdr)
-{
- int c, n;
- unsigned short oldcrc;
-
- if ((c = zdlread()) & ~0377)
- return c;
- Rxtype = c;
- oldcrc = updcrc(c, 0);
-
- for (n=4; --n >= 0;) {
- if ((c = zdlread()) & ~0377)
- return c;
- oldcrc = updcrc(c, oldcrc);
- *hdr++ = c;
- }
- if ((c = zdlread()) & ~0377)
- return c;
- oldcrc = updcrc(c, oldcrc);
- if ((c = zdlread()) & ~0377)
- return c;
- oldcrc = updcrc(c, oldcrc);
- if (oldcrc & 0xFFFF) {
- zperr("Bad Header CRC"); return ERROR;
- }
- Zmodem = 1;
- return Rxtype;
-}
-
-/* Receive a hex style header (type and position) */
-int zrhhdr(char *hdr)
-{
- int c;
- unsigned short oldcrc;
- int n;
-
- if ((c = zgethex()) < 0)
- return c;
- Rxtype = c;
- oldcrc = updcrc(c, 0);
-
- for (n=4; --n >= 0;) {
- if ((c = zgethex()) < 0)
- return c;
- oldcrc = updcrc(c, oldcrc);
- *hdr++ = c;
- }
- if ((c = zgethex()) < 0)
- return c;
- oldcrc = updcrc(c, oldcrc);
- if ((c = zgethex()) < 0)
- return c;
- oldcrc = updcrc(c, oldcrc);
- if (oldcrc & 0xFFFF) {
- zperr("Bad Header CRC"); return ERROR;
- }
- if (readline(1) == '\r') /* Throw away possible cr/lf */
- readline(1);
- Zmodem = 1; return Rxtype;
-}
-
-/* Send a byte as two hex digits */
-int zputhex(int c)
-{
- static char digits[] = "0123456789abcdef";
-
- if (Verbose>4)
- vfile("zputhex: %x", c);
- sendline(digits[(c&0xF0)>>4]);
- sendline(digits[(c)&0xF]);
- return 0;
-}
-
-/* Send character c with ZMODEM escape sequence encoding */
-int zsendline(int c)
-{
- switch (c & 0377) {
- case ZDLE:
- case 021:
- case 023:
- case 0221:
- case 0223:
- xsendline(ZDLE);
- c ^= 0100;
- /* **** FALL THRU TO **** */
- default:
- xsendline(c);
- }
- return 0;
-}
-
-/* Decode two lower case hex digits into an 8 bit byte value */
-int zgethex(void)
-{
- int c;
-
- c = zgeth1();
- if (Verbose>4)
- vfile("zgethex: %x", c);
- return c;
-}
-int zgeth1(void)
-{
- int c, n;
-
- if ((c = noxread7()) < 0)
- return c;
- n = c - '0';
- if (n > 9)
- n -= ('a' - ':');
- if (n & ~0xF)
- return ERROR;
- if ((c = noxread7()) < 0)
- return c;
- c -= '0';
- if (c > 9)
- c -= ('a' - ':');
- if (c & ~0xF)
- return ERROR;
- c += (n<<4);
- return c;
-}
-
-/*
- * Read a byte, checking for ZMODEM escape encoding
- * including CAN-CAN which represents a quick abort
- */
-int zdlread(void)
-{
- int c;
-
- if ((c = readline(Rxtimeout)) != ZDLE)
- return c;
- if ((c = readline(Rxtimeout)) < 0)
- return c;
- switch (c) {
- case ZDLE:
- return GOTCAN;
- case ZCRCE:
- case ZCRCG:
- case ZCRCQ:
- case ZCRCW:
- return (c | GOTOR);
- case ZRUB0:
- return 0177;
- case ZRUB1:
- return 0377;
- default:
- if ((c & 0140) == 0100)
- return (c ^ 0100);
- break;
- }
- zperr("Got bad ZMODEM escape sequence %x", c);
- return ERROR;
-}
-
-/*
- * Read a character from the modem line with timeout.
- * Eat parity, XON and XOFF characters.
- */
-int noxread7(void)
-{
- int c;
-
- for (;;) {
- if ((c = readline(Rxtimeout)) < 0)
- return c;
- switch (c &= 0177) {
- case XON:
- case XOFF:
- continue;
- default:
- return c;
- }
- }
-}
-
-/* Store long integer pos in Txhdr */
-int stohdr(long int pos)
-{
- Txhdr[ZP0] = pos;
- Txhdr[ZP1] = pos>>8;
- Txhdr[ZP2] = pos>>16;
- Txhdr[ZP3] = pos>>24;
- return 0;
-}
-
-/* Recover a long integer from a header */
-long
-int rclhdr(char *hdr)
-{
- long int l;
-
- l = (hdr[ZP3] & 0377);
- l = (l << 8) | (hdr[ZP2] & 0377);
- l = (l << 8) | (hdr[ZP1] & 0377);
- l = (l << 8) | (hdr[ZP0] & 0377);
- return l;
-}
-
diff --git a/components/utilities/ZMODEM/ZMODEM.DOC b/components/utilities/ZMODEM/ZMODEM.DOC
deleted file mode 100644
index 3b2149c884..0000000000
--- a/components/utilities/ZMODEM/ZMODEM.DOC
+++ /dev/null
@@ -1,2056 +0,0 @@
-
-
-
- The ZMODEM Asynchronous Inter Application File Transfer Protocol
-
- Chuck Forsberg
-
- Omen Technology Inc
-
-
- Chuck Forsberg
- Omen Technology Inc
- 17505-V Northwest Sauvie Island Road
- Portland Oregon 97231
- Voice: 503-621-3406
- Modem (Telegodzilla): 503-621-3746 Speed 1200,300
- Compuserve: 70715,131
- UUCP: ...!tektronix!reed!omen!caf
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Chapter 0 rev051486 Printed 5-16-86 1
-
-
-
-
-
-
-
-Chapter 0 rev051486 Printed 5-16-86 2
-
-
-
-1. INTENDED AUDIENCE
-
-This document is intended for systems programmers and other technically
-qualified people who choose and implement asynchronous file transfer
-protocols over dial-up networks and related environments.
-
-
-2. ACKNOWLEDGMENTS
-
-Encouragement and suggestions by Stuart Mathison, Thomas Buck, John Wales,
-Ward Christensen, and Irv Hoff are gratefully acknowledged.
-
-
-3. RELATED DOCUMENTS
-
-The following files should be available for reference while studying this
-document:
-
-YMODEM.DOC Describes the XMODEM and YMODEM file transfer protocols
-
-ZMODEM.H Provides definitions for the manifest constants referenced
- herein.
-
-rz.c, sz.c, rbsb.c Unix source code for operating ZMODEM programs.
-
-rz.1, sz.1 Manual pages for rz and sz.
-
-zm.c, zmodem.h Operating system independent ZMODEM subroutines, header
- file.
-
-
-4. ROSETTA STONE
-
-Here are some definitions which reflect the current vernacular in the
-computer media. The attempt here is identify the file transfer protocol
-rather than specific programs.
-
-Frame A ZMODEM frame consists of a header packet and 0 or more data
- packets.
-
-XMODEM refers to the original 1979 file transfer etiquette introduced by
- Ward Christensen's 1979 MODEM2 program. It's also called the
- MODEM or MODEM2 protocol. Some who are unaware of MODEM7's
- unusual batch file mode call it MODEM7. Other aliases include
- "CP/M Users's Group" and "TERM II FTP 3". This protocol is
- supported by every serious communications program because of its
- universality, simplicity, and reasonable performance.
-
-XMODEM/CRC replaces XMODEM's 1 byte checksum with a two byte Cyclical
- Redundancy Check (CRC-16), giving modern error detection
- protection.
-
-
-
-Chapter 4 rev051486 Printed 5-16-86 2
-
-
-
-
-
-
-
-Chapter 4 rev051486 Printed 5-16-86 3
-
-
-
-YMODEM refers to the XMODEM/CRC protocol with the throughput and/or batch
- transmission enhancements described in YMODEM.DOC.
-
-ZMODEM Zmodem is a second generation streaming protocol for text and
- binary file transmission between applications running on
- microcomputers and mainframes.
-
-
-5. WHY DEVELOP ZMODEM?
-
-Since its development half a decade ago, the Ward Christensen MODEM
-protocol has enabled a wide variety of computer systems to interchange
-data. There is hardly a communications program that doesn't at least
-claim to support this protocol, now called XMODEM.
-
-Advances in computing, modems and networking have spread the XMODEM
-protocol far beyond the micro to micro environment for which it was
-designed. These application have exposed some weaknesses:
-
- + The user interface is suitable for computer hobbyists. Three or four
- commands must be keyboarded to transfer each file.
-
- + The short block length causes throughput to suffer when used with
- timesharing systems, packet switched networks, satellite circuits,
- and buffered (error correcting) modems.
-
- + The 8 bit checksum and unprotected transactions allow undetected
- errors and disrupted file transfers.
-
- + Only one file can be sent per command. The file name has to be given
- twice, first to the sending program and then again to the receiving
- program.
-
- + The transmitted file accumulates as many as 127 extraneous bytes.
-
- + The modification date and other file attributes are lost.
-
- + XMODEM requires complete 8 bit transparency, all 256 codes. XMODEM
- will not operate over some networks that need flow control.
-
-A number of other protocols have been developed over the years, but none
-have displaced XMODEM to date.
-
- + Lack of public domain documentation and example programs have kept
- proprietary protocols such as MNP, Blast, and others tightly bound to
- the fortunes of their suppliers.
-
- + Hardware and/or software complexity discourages the widespread
- application of BISYNC, SDLC, HDLC, X.25, and X.PC protocols.
-
-
-
-
-
-Chapter 5 rev051486 Printed 5-16-86 3
-
-
-
-
-
-
-
-Chapter 5 rev051486 Printed 5-16-86 4
-
-
-
- + Link level protocols such as X.25, X.PC, and MNP do not manage
- application to application file transfers.
-
- + The Kermit protocol was developed to allow file transfers in
- environments hostile to XMODEM. The performance compromises
- necessary to accomodate non transparent environments limit Kermit's
- efficiency. Even with completely transparent channels, Kermit
- control character quoting limits the efficiency of binary file
- transfers to about 75 per cent.[1]
-
- Kermit Sliding Windows ("SuperKermit") improves throughput over
- networks at the cost of increased complexity. SuperKermit state
- transitions are encoded in a special language "wart" which requires a
- C compiler. The SuperKermit C code requires full duplex
- communications and the ability to check for the presence of
- characters in the input queue, precluding its implementation on some
- operating systems.
-
- A number of submodes are used in various Kermit programs, including
- different methods of transferring binary files. Two Kermit programs
- will mysteriously fail to operate with each other if these submodes
- are not matched.
-
-A number of extensions to the XMODEM protocol have been made under the
-collective name YMODEM.
-
- + YMODEM-k uses 1024 byte blocks to reduce the overhead from transmission
- delays by 87 per cent compared to XMODEM, but network delays can still
- degrade performance. Some networks may not be transmit the 1024 byte
- packets unmodified.
-
- + The handling of files that are not a multiple of 1024 or 128 bytes is
- awkward, especially if the file length is not known, or changes during
- transmission.
-
- + YMODEM-g provides efficient batch file transfers, preserving the exact
- file length and file modification date. YMODEM-g is essentially
- insensitive to network delays. Because it does not support error
- recovery, YMODEM-g is usually used hardwired or with a reliable link
- level protocol. IF YMODEM-g detects a CRC error, data transfers are
- aborted. YMODEM-g is easy to implement because it closely resembles
- XMODEM-CRC.
-
-Another XMODEM "extension" is protocol cheating, referred to as "Turbo
-Download" and OverThruster. [2] These sometimes improve XMODEM throughput
-
-
-__________
-
- 1. Some Kermit programs support run length encoding.
-
-
-
-
-Chapter 5 rev051486 Printed 5-16-86 4
-
-
-
-
-
-
-
-Chapter 5 rev051486 Printed 5-16-86 5
-
-
-
-at the expense of error recovery.
-
-The ZMODEM Protocol is proposed as a means of addressing the weaknesses
-described above while maintaining as much of XMODEM's simplicity and prior
-art as possible.
-
-
-
-6. ZMODEM Protocol Design Criteria
-
-The design of a file transfer protocol is an engineering compromise
-between conflicting requirements:
-
-6.1 Ease of Use
-
- + ZMODEM allows either program to initiate file transfers, passing
- commands and/or modifiers to the other program.
-
- + File names need be entered only once, menu selections are possible.
-
- + Wild Card names may be used with batch transfers.
-
- + Minimum keystrokes required to initiate transfers.
-
- + ZRQINIT packet sent by sending program can trigger automatic downloads.
-
- + ZMODEM can step down to YMODEM if the other end does not support
- ZMODEM.[1]
-
-6.2 Throughput
-
-ZMODEM is designed for optimum performance with minimum degradation caused
-by delays introduced by packet switched networks and timesharing systems.
-
-ZMODEM is optimized for best throughput when line hits occur infrequently.
-This assumption markedly reduces code complexity and memory requirements.
-ZMODEM protocol features enhance rapid error recovery compared to network
-compatible XMODEM implementations.
-
-It is assumed that many transfers will originate from a timesharing system
-connected to a packet switched network. ZMODEM provides features to allow
-for simple, efficient implementation on timesharing hosts.
-
-
-
-__________________________________________________________________________
-
- 2. Omen Technology Trademark
-
- 1. Provided the transmission medium accomodates YMODEM.
-
-
-
-
-Chapter 6 rev051486 Printed 5-16-86 5
-
-
-
-
-
-
-
-Chapter 6 rev051486 Printed 5-16-86 6
-
-
-
-File transfers begin immediately regardless of which program is started
-first, without the 10 second delay associated with XMODEM.
-
-
-6.3 Integrity and Robustness
-
-All packets are protected with 16 bit CRC. Proprietary alogrithyms[2] are
-not needed for reliable transfers.
-
-A security challenge guards againgst Trojan Horse messages.
-
-6.4 Ease of Implementation
-
-ZMODEM accomodates a wide variety of systems:
-
- + Microcomputers that cannot overlap disk and serial i/o
-
- + Microcomputers that cannot overlap serial send and receive
-
- + Computers and/or networks requiring XON/XOFF flow control
-
- + Computers that cannot check the serial input queue for the presence of
- data without having to wait for the data to arrive.
-
-Although ZMODEM provides "hooks" for multiple "threads", ZMODEM is not
-intended to replace link level protocols such as X.25.
-
-ZMODEM accomodates network and timesharing system delays by continuously
-transmitting data unless the receiver interrupts the sender to request
-retransmission of garbled data. ZMODEM in effect uses the entire file as
-a window.[3]
-
-ZMODEM provides a general purpose application to application file transfer
-protocol which may be used directly or with with reliable link level
-protocols such as X.25, MNP, Fastlink, etc.
-
-
-7. ZMODEM BASICS
-
-
-
-
-
-
-
-__________
-
- 2. Unique to Professional-YAM, PowerCom, etc.
-
- 3. Streaming strategey is discussed in a coming chapter.
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 6
-
-
-
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 7
-
-
-
-7.1 Packetization
-
-ZMODEM frames somewhat different from X/YMODEM blocks. X/YMODEM blocks
-are not used for the following reasons:
-
- + Block numbers are limited to 256
-
- + No provision for variable length blocks
-
- + Line hits corrupt protocol signals, causing failed file transfers. In
- particular, modem errors sometimes generate false block numbers, false
- EOTs and false ACKs. False ACKs are the most troublesome as they cause
- the sender to lose synchronization with the receiver.
-
- State of the art X/YMODEM programs such as Professional-YAM and
- PowerCom overcome some of these weaknesses with clever proprietary
- code, but a stronger protocol is desired.
-
- + It is difficult to determine the beginning and ends of X/YMODEM blocks
- when line hits cause a loss of synchronization. This precludes rapid
- error recovery.
-
-7.2 Link Escape Encoding
-
-ZMODEM acheives data transparency by extending the 8 bit character set
-(256 codes) with escape sequences based on the ZMODEM data link escape
-character ZDLE.[1]
-
-Link Escape coding permits variable length data packets without the
-overhead of a separate byte count. It allows the beginning of frames to
-be detected without special timing techniques, facilitating rapid error
-recovery.
-
-Link Escape coding does add some overhead. The worst case, a file
-consisting entirely of ZDLE characters, would incur a 50% overhead.
-
-The ZDLE character is special. ZDLE represents a control sequence of some
-sort. If a ZDLE character appears in the data sent within a binary
-packet, it is prefixed with ZDLE, then sent as ZDLEE.
-
-The value for ZDLE is octal 030 (ASCII CAN). This particular value was
-chosen to allow a string of CAN characters to abort a ZMODEM session,
-compatible with X/YMODEM session abort.
-
-
-
-__________
-
- 1. This and other constants are defined in the zmodem.h include file.
- Please note that constants with a leading 0 are octal constants in C.
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 7
-
-
-
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 8
-
-
-
-Since CAN is not used for normal terminal operations, communications
-programs can monitor the data flow for ZDLE. The following characters can
-be scanned to detect the ZRQINIT packet, the invitation to automatically
-download commands or files.
-
-Two successive CAN characters will abort a ZMODEM session. Experience
-with YMODEM file transfers suggests that this does not impair the
-robustness of the protocol. A minimum of 8 CAN are sent, so the ZMODEM
-subroutines can be modified to require more successive CAN characters to
-signal an abort.
-
-The receiving program will decode any sequence of ZDLE followed by a byte
-with bit 6 set and bit 5 reset (upper case letter, either parity) to the
-equivalent control character by inverting bit 6. This allows the
-transmitter to escape any control character that cannot be sent by the
-communications medium. The ZMODEM software currently escapes ZDLE, 021,
-0221, 023, and 0223. In addition, the receiver recognizes escapes for
-0177 and 0377 should these characters need to be escaped.
-
-7.3 Header Packet Information
-
-All ZMODEM frames begin with a header packet which may be sent in binary
-or HEX form. ZMODEM uses a single routine to recognize binary and hex
-header packets. Either form of the header packet contains the same raw
-information:
-
- + A type byte[2] Future extensions to ZMODEM may use the high order bits
- of the type byte to indicate thread selection.
-
- + Four bytes of data indicating flags and/or numeric quantities depending
- on the packet type
-
- Figure 1. Order of Bytes in Header Packet
-
-
- TYPE: packet Type
- F0: Flags least significant byte
- P0: file Position least significant
- P3: file Position most significant
-
- TYPE F3 F2 F1 F0
- --------------
- TYPE P0 P1 P2 P3
-
-
-
-__________
-
- 2. The packet types are cardinal numbers beginning with 0 to minimize
- state transition table memory requirements.
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 8
-
-
-
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 9
-
-
-
-7.4 Binary Header Packet
-
-A binary header packet is only sent by the sending program to the
-receiving program.
-
-A binary header packet begins with the sequence ZPAD, ZDLE, ZBIN.
-
-The frame type byte is ZDLE encoded.
-
-The four position/flags bytes are ZDLE encoded.
-
-A two byte CRC of the frame type and position/flag bytes is ZDLE encoded.
-
-0 or more binary data packets will follow depending on the frame type.
-
-The function zsbhdr transmits a binary header packet. The function
-zgethdr receives a binary or hex header packet.
-
- Figure 2. Binary Header Packet
- * * ZDLE TYPE F3/P0 F2/P1 F1/P2 F0/P3 CRC-1 CRC-2
-
-
-7.5 HEX Header Packet
-
-The receiver sends responses in hex header packets. The sender also uses
-hex header packets when they are not followed by binary data packets.
-
-Hex encoding is required to support XON/XOFF flow control. The hex header
-receiving routine ignores flow control characters.
-
-Use of Kermit style encoding for control and paritied characters was
-considered and rejected because of increased possibility of interacting
-with some timesharing systems's line edit functions. Use of HEX packets
-from the receiving program allows control characters to be used to
-interrupt the sender when errors are detected. Except for header packet
-types that imply data packets to follow, a HEX header packet may be used
-in place of a binary header packet.
-
-A hex header packet begins with the sequence ZPAD, ZPAD, ZDLE, ZHEX. The
-zgethdr routine synchronizes in the ZPAD-ZDELE sequence. The extra ZPAD
-allows other parts of the program to detect a ZMODEM packet and then call
-zgethdr to receive the packet.
-
-The type byte, the four position/flag bytes, and the CRC thereof are sent
-in hex using the character set 01234567890abcdef. Upper case hex digits
-are not allowed; they false trigger X/YMODEM programs.
-
-A carriage return, line feed, and XON are appended to the HEX header
-packet but are not considered to be part of it. The CR/LF aids debugging
-from printouts. The XON releases the sender from spurious XOFF flow
-control characters generated by line noise, a common occurrence.
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 9
-
-
-
-
-
-
-
-Chapter 7 rev051486 Printed 5-16-86 10
-
-
-
-0 or more ASCII Encoded data packets will follow depending on the frame
-type.
-
-The function zshhdr sends a hex header packet.
-
- Figure 3. HEX Header Packet
- * * ZDLE TYPE F3/P0 F2/P1 F1/P2 F0/P3 CRC-1 CRC-2 CR LF XON
-
-(TYPE, F3...F0, CRC-1, and CRC-2 are each sent as two hex digits.)
-
-
-7.6 Binary Data Packets
-
-Binary data packets immediately follow the associated binary header
-packet. A binary data packet contains 0 to 1024 bytes of data.
-Recommended length values are 256 bytes below 4800 bps, 1024 above 4800
-bps or when the data link is known to be relatively error free.
-
-No padding is used with binary data packets. The data bytes are ZDLE
-encoded and transmitted. A ZDLE and frameend are then sent, followed by
-two ZDLE encoded CRC bytes. The CRC accumulates the data bytes and
-frameend.
-
-The function zsbdata sends a binary data packet. The function zrbdata
-receives a binary data packet.
-
-7.7 ASCII Encoded Data Packet
-
-The format of ASCII Encoded data packets is not currently specified.
-These would be used for server commands, etc.
-
-
-8. PROTOCOL TRANSACTION OVERVIEW
-
-As with the XMODEM recommendation, ZMODEM timing is receiver driven. The
-transmitter should not time out at all, except to abort the program if no
-packets are received for an extended period of time, say one minute.[1]
-
-To start a ZMODEM file transfer session, the sending program is called
-with the names of the desired file(s) and option(s).
-
-The sending program sends the string "rz\r" to invoke the receiving
-program from a possible command mode. The "rz" followed by carriage
-return activates a ZMODEM receive program or command if it were not
-already active.
-
-
-__________
-
- 1. Special considerations apply when sending commands.
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 10
-
-
-
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 11
-
-
-
-The sender may then display a message intended for human consumption, such
-as a list of the files requested, etc.
-
-Then the sender sends a ZRQINIT packet. The ZRQINIT packet causes a
-previously started receive program to send its ZRINIT packet without
-delay.
-
-In an interactive or conversational mode, the receiving application may
-monitor the data stream for ZDLE. The following characters may be scanned
-for B000000 indicating a ZRQINIT packet, a command to download a command
-or data.
-
-The sending program awaits a command from the receiving program to start
-file transfers. If a "C", "G", or NAK is received, an XMODEM or YMODEM
-file transfer is indicated, and file transfer(s) use the X/YMODEM
-protocol. Note: With ZMODEM and YMODEM Batch, the sending program
-provides the file name, but not with XMODEM.
-
-When the ZMODEM receive program starts, it immediately sends a ZRINIT
-packet to initiate ZMODEM file transfers, or a ZCHALLENGE packet to verify
-the sending program. The receive program resends its packet at repsonse
-time intervals for a suitable period of time (40 seconds typical) before
-falling back to X/YMODEM protocol. If the receiving program receives a
-ZRQINIT packet, it resends the ZRINIT packet. If the sending program
-receives the ZCHALLENGE packet, it places the data in ZP0...ZP3 in an
-answering ZACK packet.
-
-If the receiving program receives a ZRINIT packet, it is an echo
-indicating that the sending program is not operational.
-
-Eventually the sending program correctly receives the ZRINIT packet.
-
-The sender may then respond with an optional ZSINIT frame to set the
-receiving program's Attention string. The receiver sends a ZACK packet in
-response, containing the serial number of the receiving program, or 0.
-
-The sender then sends a ZFILE header with ZMODEM Conversion, Management,
-and Transport options[2] followed by a ZCRCW data packet containing the
-file name, file length, modification date, and other information identical
-to that used by YMODEM Batch.
-
-The receiving program should insure the pathname and options are
-compatible with its operating environment and local security requirements.
-
-
-
-
-__________
-
- 2. See below, under ZFILE packet type.
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 11
-
-
-
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 12
-
-
-
- If the receiver has a file with the same name and length,
- it may respond with a ZCRC packet, which requires the
- sender to permorm a 16 bit CRC on the file and transmit the
- CRC in ZP0...ZP1 of a ZCRC packet. The receiver uses this
- information to determine whether to accept the file or skip
- it. This sequence is triggered by the ZMCRC Management
- Option.
-
-The receiver may then respond with a ZSKIP packet, which causes the
-sender to process the next file (if any) in the batch.
-
-A ZRPOS packet from the receiver initiates transmission of the file data
-starting at the offset in the file specified in the ZRPOS packet.
-Normally the receiver specifies the data transfer begin begin at offset 0
-in the file.
- The receiver may start the transfer further down in the
- file. This allows a file transfer interrupted by a loss
- or carrier or system crash to be completed on the next
- connection without requiring the entire file to be
- retransmitted.[3] If downloading a file from a timesharing
- system that becomes sluggish, the transfer can be
- interrupted and resumed later with no loss of data.
-
-The sender sends a ZDATA binary header packet (with file position)
-followed by one or more data packets.
-
-The receiver compares the file position in the ZDATA header with the
-number of characters successfully received to the file. If they do not
-agree, a ZRPOS error response is generated to force the sender to the
-right position within the file.[4]
-
-A data packet terminated by ZCRCGO and CRC does not elicit a response
-unless an error is detected; more data packet(s) follow immediately.
-
- ZCRCQ data packets expect a ZACK response (with the file
- offset) if no error, otherwise a ZRPOS response (with the
- last good file offset). Another data packet continues
- immediately. ZCRCQ packets are not used if the receiver
- does not indicate FDX ability with the CANFDX bit.
-
-ZCRCW data packets expect a response before the next frame is sent. If
-the receiver does not indicate overlapped I/O capability with the
-
-
-__________
-
- 3. This does not apply to files that have been translated.
-
- 4. If the ZMSPARS option is used, the receiver instead seeks to position
- in the ZDATA packet.
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 12
-
-
-
-
-
-
-
-Chapter 8 rev051486 Printed 5-16-86 13
-
-
-
-CANOVIO bit, or by setting a buffer size, the sender uses the ZCRCW to
-allow the receiver to write its buffer before sending more data.
-
- A zero length data frame may be used as a sending idle
- packet to prevent the receiver from timing out in case
- data is not immediately available to the sender.
-
-In the absence of fatal error, the sender eventually encounters end of
-file. If the end of file is encountered within a frame, the frame is
-closed with a ZCRCE data packet which does not elicit a response
-except in case of error.
-
-The sender sends a ZEOF packet with the file ending offset equal to
-the number of characters in the file. The receiver compares this
-number with the number of characters received. If the receiver has
-received all of the file, it closes the file. If the file close was
-satisfactory, the receiver responds with ZRINIT. If the receiver has
-not received all the bytes of the file, the receiver sends ZRPOS with
-the current file offset, forcing the sender to resend the missing
-data. (If the receiver cannot properly close the file, a ZFERR packet
-is sent.)
-
- After all files are processed, any further protocol
- errors should not prevent the sending program from
- returning with a success status.
-
-The sender closes the session with a ZEXIT header packet. The
-receiver acknowledges this with its own ZEXIT packet.
-
-When the sender receives the acknowledging packet, it sends two
-characters, "OO" (Over and Out) and exits to the operating system or
-application that invoked it. The receiver waits briefly for the "O"
-characters, then exits whether they were received or not.
-
-8.1 Session Cancel Packet
-
-The Cancel packet consists of two ZPAD characters, eight CAN
-characters, and an optional ten backspace characters. First, the
-Attn sequence is executed if the receiving program has been receiving
-data in streaming mode. The ZPAD characters allow sending programs
-that sample the reverse data stream to check for a single character
-code indicating a packet from the receiver. The trailing backspace
-characters attempt to erase the effects of the other characters if
-they are received by a command interpreter.
-
- static char canistr[] = {
-ZPAD,ZPAD,24,24,24,24,24,24,24,24,8,8,8,8,8,8,8,8,8,8,0 };
-
-
-
-
-
-
-
-Chapter 9 rev051486 Printed 5-16-86 13
-
-
-
-
-
-
-
-Chapter 9 rev051486 Printed 5-16-86 14
-
-
-
-9. ZMODEM STREAMING TECHNIQUES
-
-ZMODEM allows choices of several data streaming methods selected
-according to the limitations of the sending environment, receiving
-environment, and transmission channel(s).
-
-
-9.1 Full Streaming with Sampling
-
-If the computers can overlap serial I/O with disk I/O, and if the
-sender can sample the reverse channel for the presence of data
-without having to wait, full streaming can be used with no Attn
-sequence required. The sender begins data transmission with a ZDATA
-header and continuous ZCRCG data packets. When the receiver detects
-an error, it executes the Attn sequence and then sends a ZRPOS packet
-to force the sender back to the correct position within the file. At
-the end of each transmitted packet, the sender checks for the
-presence of an error packet from the receiver. To do this, the
-sender may sample the reverse data stream for the presence of a ZPAD
-character.
-
-Such a program would sample the reverse channel for ZPAD. If seen,
-an empty ZCRCW data packet is sent (in case the receiver was still
-reading packets) and then the receiver's response packet is read and
-acted upon. The code fragment in sz.c beginning at NOTDEF_DOS would
-perform this function.
-
-
-9.2 Full Streaming with Interrupt
-
-The method above cannot be used if if the reverse data stream cannot
-be sampled without entering an I/O wait. An alternate method is to
-instruct the receiver to interrupt the sending program when an error
-is detected.
-
-The receiver can interrupt the sender with a control character, break
-signal, or combination thereof, as specified in the ZSINIT frame sent
-by the sending program.
-
-When the sending program "catches" this interrupt, it reads a HEX
-packet (normally ZRPOS) from the receiver and takes appropriate
-action. The Unix sb.c program uses a setjmp/longjmp call and the
-getinsync() function to read the receiver's error packet and take
-appropriate action.
-
-
-
-
-
-
-
-
-
-
-Chapter 9 rev051486 Printed 5-16-86 14
-
-
-
-
-
-
-
-Chapter 9 rev051486 Printed 5-16-86 15
-
-
-
-9.3 Full Streaming with a Sliding Window
-
-If none of the above methods is applicable, hope is not yet lost. If
-the sender can buffer responses from the receiver, the sender can use
-ZCRCQ packets to get ACKs from the receiver without interrupting the
-transmission of data. After a sufficient number of ZCRCQ packets
-have been sent, the sender can read one of the one or more packets
-that should have arrived in it's receive interrupt buffer.
-
-A problem with this method is the probability of wasting an excessive
-amount of time responding to the receiver's error packet.
-
-9.4 No Streaming
-
-If the receiver cannot overlap serial and disk I/O, it uses the
-ZRINIT frame to specify a buffer length which the sender will not
-overflow. The sending program sends a ZCRCW packet and waits for an
-ZACK packet before sending the next segment of the file.
-
-If the sending program supports reverse data stream sampling or
-interrupt, error recovery will be faster (on average) than a protocol
-(such as YMODEM) that sends "monolithic" blocks.
-
-
-10. ATTENTION SEQUENCE
-
-The receiving program sends the Attn sequence whenever it detects an
-error and needs to interrupt the sending program.
-
-The default Attn string value is empty (no Attn sequence). The
-receiving program resets Attn to the empty default before each
-transfer session.
-
-The sender speficies the Attn sequence in its optional ZSINIT frame.
-The Attn string is terminated with a null.
-
-Two meta-characters perform special functions:
-
- + \335 (octal) Sends a break signal
-
- + \336 (octal) Pauses one second
-
-
-11. PACKET/FRAME TYPES
-
-The numeric values for the values shown in boldface are given in
-zmodem.h.
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 15
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 16
-
-
-
-11.1 ZRQINIT
-
-Sent once by the sending program, to trigger the receiving program to
-send its ZRINIT packet. This aviods the aggravatimg startup delay
-associated with XMODEM and Kermit transfers.
-
-ZF0 contains ZCOMMAND if the program is attempting to send a command,
-0 otherwise.
-
-11.2 ZRINIT
-
-Sent by the receiving program. ZF0 and ZF1 contain the bitwise or
-of the receiver capability flags:
-#define CANFDX 1 /* Rx can send and receive FDX */
-#define CANOVIO 2 /* Rx can receive during disk I/O */
-#define CANBRK 4 /* Rx can send a break signal */
-#define CANCRY 8 /* Receiver can decrypt */
-
-ZP0 and ZP1 contain the size of the receiver's buffer in bytes, or 0
-if nonstop I/O is allowed.
-
-11.3 ZSINIT
-
-Sender sends capability flags (currently all 0) (none currently
-defined) followed by a binary data packet terminated with ZCRCW. The
-data packet contains the null terminated Attn sequence, maximum
-length 32 bytes including the terminating null.
-
-11.4 ZACK
-
-Acknowedgement to ZSINIT header packet, ZCHALLENGE header packet, or
-ZCRCW data packet. ZP0 to ZP3 contain file offset. Response to
-ZCHALLENGE contains the same 32 bits as received.
-
-11.5 ZFILE
-
-This packet denotes the beginning of a file transmission attempt.
-ZF0, ZF1, and ZF2 may contain options. A value of 0 in each of these
-bytes implies no special treatment. If options are specified to the
-reciever, they override options specified to the sender with the
-exception of the ZCBIN option, which overrides any other Conversion
-Option.
-
-
-11.5.1 ZF0: Conversion Option
-If the receiver does not recognize the Conversion Option, an
-application dependent default conversion may apply.
-
-ZCBIN "Binary" transfer - inhibit conversion unconditionally
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 16
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 17
-
-
-
-ZCNL Convert received end of line to local end of line convention.
- The suported end line conventions are CR/LF (most ASCII based
- operating systems except Unix and Macintosh), and NL (Unix).
- Neither of these two end of line conventions violate the
- permissible ASCII definitions for Carriage Return and Line
- Feed/New Line.
-
-ZCRECOV Recover interrupted file transfer; start transfer at location
- corresponding to the receiver's end of file. This option does
- not apply if the source file is shorter. Files that have been
- converted (e.g., ZCNL) or subject to a single ended Transport
- Option cannot have their transfers recovered.
-
-11.5.2 ZF1: Management Option
-If the receiver does not recognize the Management Option, the file
-should be transferred normally.
-
-ZMNEW Compare the source and destination files. Transfer file if
- source newer or different length
-
-ZMCRC Compare the source and destination files. Transfer if
- different file length or CRC
-
-ZMAPND Append source file contents to existing destination file (if
- any)
-
-ZMCLOB Replace existing destination file (if any)
-
-ZTSPARS Special processing for sparse file; each file segment is
- transmitted as a separate frame, where the frames are not
- necessarily contiguous.
-
-11.5.3 ZF2: Transport Option
-If the receiver does not implement the particular transport option,
-the file is copied without conversion for later processing.
-
-ZTLZW Lempel-Ziv compression. Transmitted data will be identical to
- that produced by compress 4.0 operating on a computer with VAX
- byte ordering, using 12 bit encoding.
-
-ZTCRYPT Encryption. An initial null terminated string identifies the
- key. Details to be determined.
-
-ZTRLE Run Length encoding Details to be determined.
-
-A ZCRCW data packet follows with file name, file length, modification
-date, and other information described in a later chapter.
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 17
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 18
-
-
-
-11.6 ZSKIP
-
-Sent by the receiver in response to ZFILE, makes the sender skip to
-the next file.
-
-11.7 ZNAK
-
-Indicates last packet header was garbled. (See also ZRPOS).
-
-11.8 ZABORT
-
-Sent by receiver to terminate batch file transfers when requested by
-the user. Sender initiates a ZFIN sequence.[1]
-
-11.9 ZFIN
-
-Sent by sending program to terminate a ZMODEM session. Receiver
-responds with ZFIN.
-
-11.10 ZRPOS
-
-Sent by receiver to force file transfer to resume at file offset
-given in ZP0...ZP3.
-
-11.11 ZDATA
-
-ZP0...ZP3 contain file offset. One or more data packets follow.
-
-11.12 ZEOF
-
-Sender reports End of File. ZP0...ZP3 contain the ending file
-offset.
-
-11.13 ZFERR
-
-Error in reading or writing file, protocol equivalent to ZABORT.
-
-11.14 ZCRC
-
-Request (receiver) and response (sender) for file CRC. ZP0 and ZP1
-contain 16 bit file CRC.
-
-
-
-
-
-
-__________
-
- 1. Or ZCOMPL in case of server mode.
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 18
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 19
-
-
-
-11.15 ZCHALLENGE
-
-Request to echo a random number in ZP0...ZP3 in a ZACK frame. Sent
-by the receiving program to the sending program to verify that it is
-connected to an operating program, and was not activated by spurious
-data or a Trojan Horse message.
-
-11.16 ZCOMPL
-
-Request now completed.
-
-11.17 ZCAN
-
-This is a pseudo frame type returned by gethdr() in response to a
-Cancel sequence.
-
-11.18 ZFREECNT
-
-Sending program requests a ZACK frame with ZP0...ZP3 containing the
-number of free bytes on the current file system. A value of 0
-represents an indefinite amount of free space.
-
-11.19 ZCOMMAND
-
-ZCOMMAND is only sent as a binary header packet. ZP0...ZP2 contain a
-unique cardinal number to differentiate this command from other
-commands[2]. ZF0 contains 0 or ZCACK1.
-
-
-A ZCRCW data packet follows, with the ASCII text command string
-terminated with a NULL character. If the command is intended to be
-executed by the operating system hosting the receiving program (e.g.,
-"shell escape"), it must have "!" as the first character. Otherwise
-the command is meant to be executed by the application program which
-received the command.
-
-If ZF0 contained ZCACK1, the receiver immediately responds with a
-ZCOMPL header. Otherwise, the receiver responds with a ZCOMPL header
-when the operation is completed.
-
-The exit status of the completed command is stored in ZP0...ZP3 (0 if
-ZCACK1). A 0 exit status implies nominal completion of the command.
-
-If the command caused a file to be transmitted, the command sender
-will see a ZRQINIT frame from the other computer attempting to send
-
-
-__________
-
- 2. Currently unused.
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 19
-
-
-
-
-
-
-
-Chapter 11 rev051486 Printed 5-16-86 20
-
-
-
-data.
-
-The sender examines ZF0 of the received ZRQINIT packet to determine
-it is not an echo of its own ZRQINIT packet. It is illegal for the
-sending program to command the receiving program to send a command.
-
-
-
-12. TRANSACTION EXAMPLE
-
-12.1 A simple file transfer
-
-A simple transaction, one file, no errors, no CHALLENGE, overlapped
-I/O:
-
-Sender Receiver
-
-"rz\r"
-ZRQINIT(0)
- ZRINIT
-ZFILE
- ZRPOS
-ZDATA data ...
-ZEOF
- ZRINIT
-ZFIN
- ZFIN
-OO
-
-
-12.2 Challenge and Command Download
-
-
-Sender Receiver
-
-"rz\r"
-ZRQINIT(ZCOMMAND)
- ZCHALLENGE(rnd)
-ZACK(same-rnd)
- ZRINIT
-ZCOMMAND
- (Perform Command)
- ZCOMPL
-ZFIN
- ZFIN
-OO
-
-
-
-
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 20
-
-
-
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 21
-
-
-
-13. ZFILE FRAME FILE INFORMATION
-
-ZMODEM sends the same file information with the ZFILE frame data that
-YMODEM Batch sends in its block 0.
-
-N.B.: Only the pathname (file name) part is s required for batch
-transfers.
-
-Pathname The pathname (conventionally, the file name) is sent as a
- null terminated ASCII string. This is the filename format used
- by the handle oriented MSDOS(TM) functions and C library fopen
- functions. An assembly language example follows:
- DB 'foo.bar',0
- No spaces are included in the pathname. Normally only the file
- name stem (no directory prefix) is transmitted unless the sender
- has selected YAM's f option to send the full relative pathname.
- The source drive designator (A:, B:, etc.) is not sent.
-
- Filename Considerations:
-
- + File names should be translated to lower case unless the
- sending system supports upper/lower case file names. This
- is a convenience for users of systems (such as Unix) which
- store filenames in upper and lower case.
-
- + The receiver should accommodate file names in lower and
- upper case.
-
- + The rb(1) program on Unix systems normally translates the
- filename to lower case unless one or more letters in the
- filename are already in lower case.
-
- + When transmitting files between different operating
- systems, file names must be acceptable to both the sender
- and receiving operating systems.
-
- If directories are included, they are delimited by /; i.e.,
- "subdir/foo" is acceptable, "subdir\foo" is not.
-
-Length The file length and each of the succeeding fields are
- optional.[1] The length field is stored as a decimal string
- counting the number of data bytes in the file.
-
- With ZMODEM, the receiver uses the file length only for display
- (progress reporting) purposes; the actual length is determined
-
-
-__________
-
- 1. Fields may not be skipped.
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 21
-
-
-
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 22
-
-
-
- by the data transfer.
-
-Modification Date A single space separates the modification date from
- the file length.
-
- The mod date is optional, and the filename and length may be
- sent without requiring the mod date to be sent.
-
- The mod date is sent as an octal number giving the time the
- contents of the file were last changed measured in seconds from
- Jan 1 1970 Universal Coordinated Time (GMT). A date of 0
- implies the modification date is unknown and should be left as
- the date the file is received.
-
- This standard format was chosen to eliminate ambiguities arising
- from transfers between different time zones.
-
- Two Microsoft blunders complicate the use of modification dates
- in file transfers with MSDOS(TM) systems. The first is the lack
- of timezone standardization in MS-DOS. A file's creation time
- can not be known unless the timezone of the system that wrote
- the file[2] is known. Unix solved this problem (for planet
- Earth, anyway) by stamping files with Universal Time (GMT).
- Microsoft would have to include the timezone of origin in the
- directory entries, but does not. Professional-YAM gets around
- this problem by using the z parameter which is set to the number
- of minutes local time lags GMT. For files known to originate
- from a different timezone, the -zT option may be used to specify
- T as the timezone for an individual file transfer.
-
- The second problem is the lack of a separate file creation date
- in DOS. Since some backup schemes used with DOS rely on the
- file creation date to select files to be copied to the archive,
- back-dating the file modification date could interfere with the
- safety of the transferred files. For this reason,
- Professional-YAM does not modify the date of received files with
- the header information unless the d parameter is non zero.
-
-
-Mode A single space separates the file mode from the modification
- date. The file mode is stored as an octal string. Unless the
- file originated from a Unix system, the file mode is set to 0.
- rb(1) checks the file mode for the 0x8000 bit which indicates a
- Unix type regular file. Files with the 0x8000 bit set are
- assumed to have been sent from another Unix (or similar) system
-
-
-__________
-
- 2. Not necessarily that of the transmitting system!
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 22
-
-
-
-
-
-
-
-Chapter 13 rev051486 Printed 5-16-86 23
-
-
-
- which uses the same file conventions. Such files are not
- translated in any way.
-
-
-Serial Number A single space separates the serial number from the
- file mode. The serial number of the transmitting program is
- stored as an octal string. Programs which do not have a serial
- number should omit this field, or set it to 0. The receiver's
- use of this field is optional.
-
-The file information is terminated by a null. If only the pathname
-is sent, the pathname will be terminated by two nulls. The length of
-the file information packet, including the trailing null, must not
-exceed 1024 bytes; a typical length is less than 64 bytes.
-
-
-14. PERFORMANCE RESULTS
-
-14.1 Throughput
-
-Between two single task PC-XT computrers, on a Telenet link through
-the local Telenet, SuperKermit gave 72 ch/sec throughput at 1200
-baud. YMODEM-k yielded 85 chars/sec, and ZMODEM provided 113 chat
-sec. ZMODEM was not measured, but would have given much less.
-
-14.2 Error Recovery
-
-Some tests of ZMODEM protocol performance have been made. A PC-AT
-with SCO SYS V Xenix or DOS 3.1 was connected to a PC with DOS 2.1
-either directly at 9600 bps or with unbuffered dial-up 1200 bps
-modems. The ZMODEM software was configured to use 1024 byte packet
-lengths above 2400 bps, 256 otherwise.
-
-Because no time delays are necessary in normal file transfers, per
-file negotiations are much faster than with YMODEM, the only observed
-impidiment being the time required by the program(s) to update
-logging files.
-
-During a file transfer, a short line hit seen by the receiver usually
-induces a CRC error. The interrupt packet is usually seen by the
-sender before the next packet is sent, and the resultant loss of data
-throughput averages about half a packet. At 1200 bps this is would
-be about .75 second lost per hit. At 10-5 error rate, this would
-degrade throughput by about 9 per cent. The throughput degradation
-increases with the channel delay, as the packets in transit through
-the channel are discarded on error.
-
-A longer noise burst that affects both the receiver and the sender's
-reception of the interrupt packet usually causes the sender to remain
-silent until the receiver times out in 10 seconds. If the round trip
-channel delay exceeds the receiver's 10 second timeout, recovery from
-
-
-
-Chapter 14 rev051486 Printed 5-16-86 23
-
-
-
-
-
-
-
-Chapter 14 rev051486 Printed 5-16-86 24
-
-
-
-this type of error may become difficult.
-
-Noise affecting only the sender is usually ignored, with one common
-exception. Spurious XOFF characters generated by noise stop the
-sender until the receiver times out and sends an interrupt packet
-which concludes with an XON.
-
-In summation, ZMODEM performance in the presence of errors resembles
-that of X.PC and SuperKermit. Short bursts cause minimuml data loss.
-Long bursts (such as pulse dialing noises) often require a timeout
-error to restore the flow of data.
-
-
-15. PACKET SWITCHED NETWORK CONSIDERATIONS
-
-Flow control is necessary for printing messages and directories, and
-for streaming file transfer protocols including Kermit Sliding
-Windows and ZMODEM. A non transparent flow control is incompatible
-with XMODEM and YMODEM transfers. XMODEM and YMODEM protocols
-require complete transparency of all 256 8 bit codes to operate
-properly.
-
-The most desireable flow control (when X.25 or hardware CTS is
-unavailable) does not "eat" any characters at all. When the PAD's
-buffer almost fills up, an XOFF should be emitted. When the buffer
-is no longer nearly full, send an XON. Otherwise, the network should
-neither generate nor eat XON or XOFF control characters.
-
-On Telenet, this can be met by setting CCIT X3 5:1 and 12:0 at both
-ends of the network. For best throughput, parameter 64 (advance ACK)
-should be set to something like 4. Packets should be sent when the
-packet is a full 128 bytes, or after a moderate delay (3:0,4:10,6:0).
-
-For YMODEM, PAD buffering should guarantee that a minimum of 1040
-characters can be sent in a burst without loss of data or generation
-of flow control characters. Failure to provide this buffering will
-generate excessive retries with YMODEM.
-
- Figure 4. Flow Control Compatibility
-
- Connectivity Interactive XMODEM KERMIT ZMODEM
-
-Direct Connection YES YES YES YES
-Network, no flow control NO YES (1) (1)
-Network, transparent f.c. YES YES YES YES
-Network, semi-transparent f.c. YES NO YES YES
-Network, 7 bit YES NO YES(2) NO(3)
-
-(1) Cannot operate in streaming mode. Kermit is very slow because of
-96 byte max packet size. ZMODEM can adjust burst length to maximum
-for faster transfers.
-
-
-
-Chapter 15 rev051486 Printed 5-16-86 24
-
-
-
-
-
-
-
-Chapter 15 rev051486 Printed 5-16-86 25
-
-
-
-(2) Parity bits must be encoded, slowing binary transfers.
-
-(3) Extension possible for encoding data to 7 bits.
-
-
-
-16. PERFORMANCE COMPARISION TABLES
-
-
-"Round Trip Delay Time" includes the time for the last byte in a
-packet to propagate through the operating systems and network to the
-receiver, plus the time for the receiver's response to that packet to
-propogate back to the sender.
-
-The figures shown below are calculated for round trip delay times of
-40 milliseconds and 5 seconds. Shift registers in the two computers
-and a pair of 212 modems generate a round trip delay time on the
-order of 40 milliseconds. Operation with busy timesharing computers
-and networks can easily generate round trip delays of five seconds.
-Because the round trip delays cause visible interruptions of data
-transfer when using XMODEM protocol, the subjective effect of these
-delays is greatly exaggerated, especially when the user is paying for
-connect time.
-
-A 102400 byte binary file with randomly distributed codes is sent at
-1200 bps 8 data bits, 1 stop bit. The calculations assume no
-transmission errors. For each of the protocols, only the per file
-functions are considered. Processor and I/O overhead are not
-included. YM-k refers to YMODEM with 1024 byte packets. YM-g refers
-to the YMODEM "g" option. ZMODEM uses 256 byte packets for this
-example. SuperKermit uses maximum packet size, 8 bit transparent
-transmission, no run length compression.
-
-For comparison, a straight "dump" of the file contents with no file
-management or error checking takes 853 seconds.
-
- Figure 5. Protocol Overhead Information
-
- Protocol XMODEM YM-k YM-g ZMODEM S-Kermit
-
-Protocol Round Trips 803 103 5 5 5
-Trip Time at 40ms 32s 4s 0 0 0
-Trip Time at 5s 4015s 515s 25s 25s 25
-
-Overhead Characters 4803 603 503 3600 38280
-
-Transfer Time at 0s 893s 858s 857s 883s 1172s
-Transfer Time at 40ms 925s 862s 857s 883s 1172s
-Transfer Time at 5s 5761s 1373s 882s 918s 1197s
-
-
-
-
-
-Chapter 16 rev051486 Printed 5-16-86 25
-
-
-
-
-
-
-
-Chapter 16 rev051486 Printed 5-16-86 26
-
-
-
- Figure 6. Transmission Time Comparision
- (5 Second Round Trip)
-
-************************************************** XMODEM
-************ YMODEM-K
-********** SuperKermit (Sliding Windows)
-******* YMODEM-G
-******* ZMODEM
-
- Figure 7. Y/ZMODEM Header Information usage
-
-
- Program Batch Length Date Mode S/N YMODEM-g ZMODEM
- Unix rb/sb yes yes yes yes no sb only no
- Unix rz/sz yes yes yes yes no sz only yes
- VMS rb/sb yes yes no no no no no
- Pro-YAM yes yes yes no yes yes yes
- CP/M YAM yes no no no no no no
- KMD/IMP yes yes- no no no no no
- MEX no no no no no no no
-
-
-17. MORE INFORMATION
-
-More information may be obtained by calling Telegodzilla at
-503-621-3746.
-
-UUCP sites can obtain the nroff/troff source to this file with
- uucp omen!/usr/caf/public/zmodem.mm /tmp
-A continually updated list of available files is stored in
-/usr/spool/uucppublic/FILES.
-
-The following L.sys line calls site "omen" yia UUCP. Telegodzilla
-uses Pro-YAM in host operation.
-
-In response to "Name Please:" uucico gives the Pro-YAM "link" command
-as a user name. The password (Giznoid) controls access to the Xenix
-system connected to the IBM PC's other serial port. Communications
-between Pro-YAM and Xenix use 9600 bps; YAM converts this to the
-caller's speed.
-
-Finally, the calling uucico logs in as uucp.
-
- omen Any ACU 1200 1-503-621-3746 e:--e: link d: Giznoid n:--n: uucp
-
-
-
-
-
-
-
-
-
-
-Chapter 18 rev051486 Printed 5-16-86 26
-
-
-
-
-
-
-
-Chapter 18 rev051486 Printed 5-16-86 27
-
-
-
-18. ZMODEM PROGRAMS
-
-A demonstration version of Professional-YAM is available as
-YAMDEMO.ARC on TeleGodzilla.. This file must be unpacked with the
-"ARC" program, version 5 or later. A copy of ARC is available as
-"ARC.EXE" or "ARC510.COM" on TeleGodzilla.
-
-
-This may be used to test ZMODEM and YMODEM implementations. A
-flash-up tree structured help file and processor are provided in
-YAMHELP.LQR.
-
-
-
-19. YMODEM PROGRAMS
-
-Unix programs supporting the YMODEM protocol are available on
-Telegodzilla in the "upgrade" subdirectory as RBSB.SHQ (a SQueezed
-shell archive). Most Unix like systems are supported, including V7,
-Sys III, 4.2 BSD, SYS V, Idris, Coherent, and Regulus.
-
-A version for VAX-VMS is available in VRBSB.SHQ, in the same
-directory.
-
-Irv Hoff has added YMODEM 1k packets and YMODEM batch transfers to
-the KMD and IMP series programs, which replace the XMODEM and
-MODEM7/MDM7xx series respectively. Overlays are available for a wide
-variety of CP/M systems.
-
-Many other programs, including MEX and MEX-PC also support some of
-the YMODEM extensions.
-
-Questions about YMODEM, the Professional-YAM communications program,
-and requests for evaluation copies may be directed to:
-
- Chuck Forsberg
- Omen Technology Inc
- 17505-V Sauvie Island Road
- Portland Oregon 97231
- Voice: 503-621-3406
- Modem (Telegodzilla): 503-621-3746
- Usenet: ...!tektronix!reed!omen!caf
- Compuserve: 70715,131
- Source: TCE022
-
- Yours very truly,
-
-
-
-
-
-
-
-
-Chapter 19 rev051486 Printed 5-16-86 27
-
-
-
-
-
-
-
-
-
-
-
- CONTENTS
-
-
- 1. INTENDED AUDIENCE................................................ 2
-
- 2. ACKNOWLEDGMENTS.................................................. 2
-
- 3. RELATED DOCUMENTS................................................ 2
-
- 4. ROSETTA STONE.................................................... 2
-
- 5. WHY DEVELOP ZMODEM?.............................................. 3
-
- 6. ZMODEM Protocol Design Criteria.................................. 5
- 6.1 Ease of Use............................................... 5
- 6.2 Throughput................................................ 5
- 6.3 Integrity and Robustness.................................. 6
- 6.4 Ease of Implementation.................................... 6
-
- 7. ZMODEM BASICS.................................................... 6
- 7.1 Packetization............................................. 7
- 7.2 Link Escape Encoding...................................... 7
- 7.3 Header Packet Information................................. 8
- 7.4 Binary Header Packet...................................... 9
- 7.5 HEX Header Packet......................................... 9
- 7.6 Binary Data Packets....................................... 10
- 7.7 ASCII Encoded Data Packet................................. 10
-
- 8. PROTOCOL TRANSACTION OVERVIEW.................................... 10
- 8.1 Session Cancel Packet..................................... 13
-
- 9. ZMODEM STREAMING TECHNIQUES...................................... 14
- 9.1 Full Streaming with Sampling.............................. 14
- 9.2 Full Streaming with Interrupt............................. 14
- 9.3 Full Streaming with a Sliding Window...................... 15
- 9.4 No Streaming.............................................. 15
-
-10. ATTENTION SEQUENCE............................................... 15
-
-11. PACKET/FRAME TYPES............................................... 15
- 11.1 ZRQINIT................................................... 16
- 11.2 ZRINIT.................................................... 16
- 11.3 ZSINIT.................................................... 16
- 11.4 ZACK...................................................... 16
- 11.5 ZFILE..................................................... 16
- 11.6 ZSKIP..................................................... 18
- 11.7 ZNAK...................................................... 18
- 11.8 ZABORT.................................................... 18
- 11.9 ZFIN...................................................... 18
- 11.10 ZRPOS..................................................... 18
- 11.11 ZDATA..................................................... 18
-
-
-
- - i -
-
-
-
-
-
-
-
-
-
-
-
- 11.12 ZEOF...................................................... 18
- 11.13 ZFERR..................................................... 18
- 11.14 ZCRC...................................................... 18
- 11.15 ZCHALLENGE................................................ 19
- 11.16 ZCOMPL.................................................... 19
- 11.17 ZCAN...................................................... 19
- 11.18 ZFREECNT.................................................. 19
- 11.19 ZCOMMAND.................................................. 19
-
-12. TRANSACTION EXAMPLE.............................................. 20
- 12.1 A simple file transfer.................................... 20
- 12.2 Challenge and Command Download............................ 20
-
-13. ZFILE FRAME FILE INFORMATION..................................... 21
-
-14. PERFORMANCE RESULTS.............................................. 23
- 14.1 Throughput................................................ 23
- 14.2 Error Recovery............................................ 23
-
-15. PACKET SWITCHED NETWORK CONSIDERATIONS........................... 24
-
-16. PERFORMANCE COMPARISION TABLES................................... 25
-
-17. MORE INFORMATION................................................. 26
-
-18. ZMODEM PROGRAMS.................................................. 27
-
-19. YMODEM PROGRAMS.................................................. 27
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - ii -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- LIST OF FIGURES
-
-
-Figure 1. Order of Bytes in Header Packet............................ 8
-
-Figure 2. Binary Header Packet....................................... 9
-
-Figure 3. HEX Header Packet.......................................... 10
-
-Figure 4. Flow Control Compatibility................................. 24
-
-Figure 5. Protocol Overhead Information.............................. 25
-
-Figure 6. Transmission Time Comparision.............................. 26
-
-Figure 7. Y/ZMODEM Header Information usage.......................... 26
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - iii -
-
-
-
-
-
-
-
-
-
- The ZMODEM Asynchronous Inter Application File Transfer Protocol
-
- Chuck Forsberg
-
- Omen Technology Inc
-
-
- ABSTRACT
-
-
-
-The ZMODEM file transfer protocol greatly simplifies file transfers
-compared to XMODEM. In addition to supporting a transparent user
-interface, ZMODEM provides Personal Computer and other users an efficient,
-accurate, robust file transfer method.
-
-ZMODEM provides especially efficient file transfers with timesharing
-systems, satellite relays, and wide area packet switched networks. A
-choice of buffering and windowing modes allow ZMODEM to operate
-efficiently on systems that cannot support some other streaming protocols.
-
-ZMODEM provides advanced file management features including AutoDownload,
-remote file compare, aborted transfer recovery, selective file transfers,
-and security verified command downloading.
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-Xv{u� P
-�
-�����
-
- f�^ �s
-�F
- �`����pgt
-��X}��Y~�
-X�X� �4K��
-��
diff --git a/components/utilities/ZMODEM/ZMODEM.H b/components/utilities/ZMODEM/ZMODEM.H
deleted file mode 100644
index efb10b7550..0000000000
--- a/components/utilities/ZMODEM/ZMODEM.H
+++ /dev/null
@@ -1,107 +0,0 @@
-/*
- * Z M O D E M . H Manifest constants for ZMODEM
- * application to application file transfer protocol
- * 5-16-86 Chuck Forsberg Omen Technology Inc
- */
-#define ZPAD '*' /* 052 Padding character begins frames */
-#define ZDLE 030 /* Ctrl-X Zmodem escape - `ala BISYNC DLE */
-#define ZDLEE (ZDLE^0100) /* Escaped ZDLE as transmitted */
-#define ZBIN 'A' /* Binary frame indicator */
-#define ZHEX 'B' /* HEX frame indicator */
-
-/* Frame types (see array "frametypes" in zm.c) */
-#define ZRQINIT 0 /* Request receive init */
-#define ZRINIT 1 /* Receive init */
-#define ZSINIT 2 /* Send init sequence (optional) */
-#define ZACK 3 /* ACK to above */
-#define ZFILE 4 /* File name from sender */
-#define ZSKIP 5 /* To sender: skip this file */
-#define ZNAK 6 /* Last packet was garbled */
-#define ZABORT 7 /* Abort batch transfers */
-#define ZFIN 8 /* Finish session */
-#define ZRPOS 9 /* Resume data trans at this position */
-#define ZDATA 10 /* Data packet(s) follow */
-#define ZEOF 11 /* End of file */
-#define ZFERR 12 /* Fatal Read or Write error Detected */
-#define ZCRC 13 /* Request for file CRC and response */
-#define ZCHALLENGE 14 /* Receiver's Challenge */
-#define ZCOMPL 15 /* Request is complete */
-#define ZCAN 16 /* Other end canned session with CAN-CAN */
-#define ZFREECNT 17 /* Request for free bytes on filesystem */
-#define ZCOMMAND 18 /* Command from sending program */
-
-/* ZDLE sequences */
-#define ZCRCE 'h' /* CRC next, frame ends, header packet follows */
-#define ZCRCG 'i' /* CRC next, frame continues nonstop */
-#define ZCRCQ 'j' /* CRC next, frame continues, ZACK expected */
-#define ZCRCW 'k' /* CRC next, ZACK expected, end of frame */
-#define ZRUB0 'l' /* Translate to rubout 0177 */
-#define ZRUB1 'm' /* Translate to rubout 0377 */
-
-/* zdlread return values (internal) */
-/* -1 is general error, -2 is timeout */
-#define GOTOR 0400
-#define GOTCRCE (ZCRCE|GOTOR) /* ZDLE-ZCRCE received */
-#define GOTCRCG (ZCRCG|GOTOR) /* ZDLE-ZCRCG received */
-#define GOTCRCQ (ZCRCQ|GOTOR) /* ZDLE-ZCRCQ received */
-#define GOTCRCW (ZCRCW|GOTOR) /* ZDLE-ZCRCW received */
-#define GOTCAN (GOTOR|030) /* CAN-CAN seen */
-
-/* Byte positions within header array */
-#define ZF0 3 /* First flags byte */
-#define ZF1 2
-#define ZF2 1
-#define ZF3 0
-#define ZP0 0 /* Low order 8 bits of position */
-#define ZP1 1
-#define ZP2 2
-#define ZP3 3 /* High order 8 bits of file position */
-
-/* Bit Masks for ZRINIT flags byte ZF0 */
-#define CANFDX 01 /* Rx can send and receive true FDX */
-#define CANOVIO 02 /* Rx can receive data during disk I/O */
-#define CANBRK 04 /* Rx can send a break signal */
-#define CANCRY 010 /* Receiver can decrypt */
-#define CANLZW 020 /* Receiver can uncompress */
-
-/* Parameters for ZSINIT frame */
-#define ZATTNLEN 32 /* Max length of attention string */
-
-/* Parameters for ZFILE frame */
-/* Conversion options one of these in ZF0 */
-#define ZCBIN 1 /* Binary transfer - inhibit conversion */
-#define ZCNL 2 /* Convert NL to local end of line convention */
-#define ZCRESUM 3 /* Resume interrupted file transfer */
-/* Management options, one of these in ZF1 */
-#define ZMNEW 1 /* Transfer if source newer or different length */
-#define ZMCRC 2 /* Transfer if different file CRC or length */
-#define ZMAPND 3 /* Append contents to existing file (if any) */
-#define ZMCLOB 4 /* Replace existing file */
-#define ZMSPARS 5 /* Encoding for sparse file */
-/* Transport options, one of these in ZF2 */
-#define ZTLZW 1 /* Lempel-Ziv compression */
-#define ZTCRYPT 2 /* Encryption */
-#define ZTRLE 3 /* Run Length encoding */
-
-/* Parameters for ZCOMMAND frame ZF0 (otherwise 0) */
-#define ZCACK1 1 /* Acknowledge, then do command */
-
-long int rclhdr(char *hdr);
-
-/* Globals used by ZMODEM functions */
-int Rxframeind; /* ZBIN or ZHEX indicates type of frame received */
-int Rxtype; /* Type of header received */
-int Rxcount; /* Count of data bytes received */
-extern int Rxtimeout; /* Tenths of seconds to wait for something */
-char Rxhdr[4]; /* Received header */
-char Txhdr[4]; /* Transmitted header */
-long Rxpos; /* Received file position */
-long Txpos; /* Transmitted file position */
-char Attn[ZATTNLEN+1]; /* Attention string rx sends to tx on err */
-
-extern rt_device_t _console_device;
-extern struct finsh_shell* shell;
-#define zwrite(x1) rt_device_write(_console_device, 0, &x1, 1)
-#define zread(x1,x2,x3,x4) rt_device_read (x1,x2,x3,x4)
-
-extern void vfile(const char *fmt,...);
generated by cgit v1.3.1 (git 2.54.0) at 2026-10-30 08:43:54 +0000