sz.doc

通讯程序源码

     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 [-++++aaaabbbbddddeeeeffffkkkkLLLLllllNNNNnnnnooooppppTTTTttttuuuuvvvvyyyyYYYYZZZZ] _f_i_l_e ...
	  sb [-ddddffffkkkkttttuuuuvvvv] _f_i_l_e ...
	  sx [-kkkkttttuuuuvvvv] _f_i_l_e
	  zcommand [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
	  zcommandi [-oooottttvvvv] CCCCOOOOMMMMMMMMAAAANNNNDDDD
	  sz -TT

     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.

	  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 use of this
	  program to send files	to commercial and/or shareware
	  programs not published by Omen Technology INC.


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




     Page 1					    (printed 12/15/91)






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



	  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.


	  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 -TT) attempts to output all 256 code
	  combinations to the terminal.	 In you	are having difficulty
	  sending files, this command lets you see which character
	  codes	are being eaten	by the operating system.



	  The meanings of the available	options	are:




     Page 2					    (printed 12/15/91)






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



	  ++++    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.
	  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.)
	  LLLL NNNN  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.
	  llll NNNN  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 reciever) before resuming the	transfer.
	  tttt ttttiiiimmmm
	       Change timeout to _t_i_m tenths of seconds.
	  uuuu    Unlink the file after successful	transmission.
	  wwww NNNN  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.



     Page 3					    (printed 12/15/91)