sz.doc

支持ZModem协议的串口通讯程序

     SSSSZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 SSSSZZZZ((((1111))))



     NNNNAAAAMMMMEEEE
	  sx, sb, sz - Send Files with ZMODEM, YMODEM, or XMODEM
	  zcommand, zcommandi -	Send Commands with ZMODEM

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  sz [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppttttuuuuvvvvyyyyYYYYZZZZ] _f_i_l_e ...
	  sb [-ddddffffkkkkttttuuuuvvvv] _f_i_l_e ...
	  sx [-kkkkttttuuuuvvvv] _f_i_l_e
	  zcommand [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
	  zcommandi [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
	  sz -T


     LLLLIIIICCCCEEEENNNNSSSSEEEE AAAAGGGGRRRREEEEEEEEMMMMEEEENNNNTTTT
	  This is a copyrighted	shareware program.  Commercial use of
	  this program is subject to licensing conditions detailed in
	  the rz.c source code.	 "Commercial Use" includes any use of
	  this program to send files to	a commercial or	shareware
	  program not published	or licensed by Omen Technology INC.

	  Registration information is provided in the file mailer.rz.

	  Use of this program constitutes agreement to the License
	  Agreement.

     SSSSUUUUPPPPPPPPOOOORRRRTTTT
	  Unregistered users may dial 900-737-7836 (900-737-RTFM) for
	  technical assistance.	 There is a charge of $3.69 per	minute
	  to use this support line.  Callers must be 18	years or
	  older.

	  Registered users encountering	problems using this program on
	  standard serial ports	to transfer files with Professional-
	  YAM or ZCOMM may call	the support number listed in the
	  Professional-YAM/ZCOMM documentation.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  SSSSzzzz (send ZMODEM) uses	the ZMODEM, YMODEM or XMODEM error
	  correcting protocol to send one or more files	over a dial-in
	  serial port to a variety of programs running under PC-DOS,
	  CP/M,	Unix, VMS, and other operating systems.

	  To obtain the	maximum	performance and	full functionality of
	  this program we recommend its	use with GSZ, Professional-YAM
	  or ZCOMM.

	  This program is intended to interface	with terminal
	  programs, not	to act as one.	This program is	not designed
	  to be	called from _c_u(_1) _t_i_p(_1), or other communications
	  programs.  Unix flavors of Omen Technology's Professional-
	  YAM communications software are available for	dial-out
	  applications.	 Unix Professional-YAM supports	dial-out



     Page 1					     (printed 2/18/94)






     SSSSZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 SSSSZZZZ((((1111))))



	  applications with telephone directory, a powerful script
	  language with	learn function,	high quality multiple protocol
	  support, and UUCP port arbitration.

	  SSSSzzzz sends one or more files with ZMODEM protocol.

	  ZMODEM greatly simplifies file transfers compared to XMODEM.
	  In addition to a friendly user interface, ZMODEM provides
	  Personal Computer and	other users an efficient, accurate,
	  and robust file transfer method.

	  ZMODEM provides complete EEEENNNNDDDD----TTTTOOOO----EEEENNNNDDDD data integrity between
	  application programs.	 ZMODEM's 32 bit CRC catches errors
	  that sneak into even the most	advanced networks.

	  Advanced file	management features include AutoDownload
	  (Automatic file Download initiated without user
	  intervention), Display of individual and total file lengths
	  and transmission time	estimates, Crash Recovery, selective
	  file transfers, and preservation of exact file date and
	  length.

	  The ----yyyy option	instructs the receiver to open the file	for
	  writing unconditionally.  The	----aaaa option causes the receiver
	  to convert Unix newlines to PC-DOS carriage returns and
	  linefeeds.


	  SSSSbbbb sends one or more files with YMODEM or ZMODEM protocol.
	  The initial ZMODEM initialization is not sent.  When
	  requested by the receiver, ssssbbbb	supports YYYYMMMMOOOODDDDEEEEMMMM----gggg with
	  "cbreak" tty mode, XON/XOFF flow control, and	interrupt
	  character set	to CAN (^X).  YYYYMMMMOOOODDDDEEEEMMMM----gggg (Professional-YAM gggg
	  option) increases YMODEM throughput over error free channels
	  (direct connection, X.PC, etc.) by disabling error recovery.

	  On 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.


	  SSSSxxxx sends a single _f_i_l_e with XXXXMMMMOOOODDDDEEEEMMMM or	XXXXMMMMOOOODDDDEEEEMMMM----1111kkkk protocol
	  (sometimes incorrectly called	"ymodem").  The	user must
	  supply the file name to both sending and receiving programs.

	  Iff sssszzzz is invoked with $SHELL	set and	iff that variable
	  contains the string _r_s_h or _r_k_s_h (restricted shell), sssszzzz
	  operates in restricted mode.	Restricted mode	restricts
	  pathnames to the current directory and PUBDIR	(usually
	  /usr/spool/uucppublic) and/or	subdirectories thereof.



     Page 2					     (printed 2/18/94)






     SSSSZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 SSSSZZZZ((((1111))))



	  The fourth form sends	a single COMMAND to a ZMODEM receiver
	  for execution.  ZZZZccccoooommmmmmmmaaaannnndddd exits with the COMMAND return
	  value.  If COMMAND includes spaces or	characters special to
	  the shell, it	must be	quoted.


	  The fifth form sends a single	COMMAND	to a ZMODEM receiver
	  for execution.  ZZZZccccoooommmmmmmmaaaannnnddddiiii exits as soon as the receiver has
	  correctly received the command, before it is executed.


	  The sixth form (sz -T) outputs all 256 code combinations to
	  the terminal.	 The hex value of the character, a space, and
	  the raw character are	sent, 8	per line.  In you are having
	  difficulty sending files, this command lets you see which
	  character codes are being eaten by the operating system or
	  network.  The	terminal program must be set to	display	all
	  256 codes in a distinct form.	 Check that each code is sent,
	  and that the 8th bit on codes	0x80 to	0xFF is	set.

	  Sz -T	then allows the	caller to input	characters which are
	  echoed in hex.  You should check that	all control characters
	  can be input this way.



	  The meanings of the available	options	are:

	  ++++    Instruct	the receiver to	append transmitted data	to an
	       existing	file (ZMODEM only).
	  aaaa    Instruct	the ZMODEM receiver to convert text file
	       format as appropriate for the receiving system.	Valid
	       only for	ZMODEM.
	  bbbb    (ZMODEM)	Binary override: transfer file without any
	       translation.
	  cccc    Instruct	the receiver to	change the pathname if the
	       destination file	exists.
	  dddd    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 "." is inserted to allow	a total	of eleven.
	  eeee    Escape all control characters; normally only XON, XOFF,
	       DLE, CR-@-CR, and Ctrl-X	are escaped.
	  ffff    Send Full pathname.  Normally directory prefixes	are
	       stripped	from the transmitted filename.
	  gggg    Send ESC-[-?-3-4-l to start DSZ from Kermit.
	  kkkk    (XMODEM/YMODEM) Send files using	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.)



     Page 3					     (printed 2/18/94)






     SSSSZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 SSSSZZZZ((((1111))))



	  LLLLNNNN   Use ZMODEM sub-packets of length	N.  A larger N (32 <=
	       N <= 1024) gives	slightly higher	throughput, a smaller
	       N speeds	error recovery.	 The default is	128 below 300
	       baud, 256 above 300 baud, or 1024 above 2400 baud.
	  llllNNNN   Wait for	the receiver to	acknowledge correct data every
	       NNNN (32 <=	N <= 1024) characters.	This may be used to
	       avoid network overrun when XOFF flow control is
	       lacking.
	  nnnn    (ZMODEM)	Send each file if destination file does	not
	       exist.  Overwrite destination file if source file is
	       newer than the destination file.
	  NNNN    (ZMODEM)	Send each file if destination file does	not
	       exist.  Overwrite destination file if source file is
	       newer or	longer than the	destination file.
	  oooo    (ZMODEM)	Disable	automatic selection of 32 bit CRC.
	  pppp    (ZMODEM)	Protect	existing destination files by skipping
	       transfer	if the destination file	exists.
	  rrrr    (ZMODEM)	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.
	  rrrrrrrr   As above, but compares the files	(the portion common to
	       sender and receiver) before resuming the	transfer.
	  ttttttttiiiimmmm Change timeout to _t_i_m tenths of seconds.
	  uuuu    Unlink the file after successful	transmission.  Users
	       should not manually abort or skip file transfers	when
	       this option is used.
	  wwwwNNNN   Limit the transmit window size to N bytes (ZMODEM).
	  vvvv    Verbose causes a	list of	file names to be appended to
	       /tmp/szlog .  More v's generate more output.
	  yyyy    Instruct	a ZMODEM receiving program to overwrite	any
	       existing	file with the same name.
	  YYYY    Instruct	a ZMODEM receiving program to overwrite	any
	       existing	file with the same name, and to	skip any
	       source files that do have a file	with the same pathname
	       on the destination system.
	  ZZZZ    Use ZMODEM file compression to speed file transfer.

     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
	  Exit status is as follows: 0 for successful transfers.  1 if
	  unrecoverable	errors are detected.  2	if syntax errors or
	  file access problems are detected.  3	if the program was
	  terminated by	a caught interrupt.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
	  ZZZZMMMMOOOODDDDEEEEMMMM FFFFiiiilllleeee TTTTrrrraaaannnnssssffffeeeerrrr (Unix to	DSZ/ZCOMM/Professional-YAM)
	  %%%% sssszzzz ----aaaa ****....cccc
	  This single command transfers	all .c files in	the current
	  Unix directory with conversion (----aaaa) to end of	line
	  conventions appropriate to the receiving environment.	 With
	  ZMODEM AutoDownload enabled, Professional-YAM	 and ZCOMM
	  will automatically receive the files after performing	a



     Page 4					     (printed 2/18/94)