rz.doc

开源串口利用Xmodem,Ymodem,ZModem 下载,上传的程序.在Linux,Arm-Linux 都可使用

     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



     NNNNAAAAMMMMEEEE
	  rx, rc, rb, rz - Receive Files and Commands with X/Y/ZMODEM

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  rrrrzzzz [-vvvv] [-wwwwWWWWIIIINNNNDDDDOOOOWWWW] [-ttttTTTTIIIIMMMMEEEEOOOOUUUUTTTT]
	  rrrrbbbb [-vvvvyyyy] [-ttttTTTTIIIIMMMMEEEEOOOOUUUUTTTT]
	  rrrrcccc [-vvvvyyyy] [-ttttTTTTIIIIMMMMEEEEOOOOUUUUTTTT] _f_i_l_e
	  rrrrxxxx [-vvvvyyyy] [-ttttTTTTIIIIMMMMEEEEOOOOUUUUTTTT] _f_i_l_e
	  ggggzzzz _f_i_l_e ...

     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 receive files	from a commercial or shareware
	  program not published	by Omen	Technology INC.

	  Registration information is provided in the file mailer.rz.

	  Use of this program constitutes agreement to the License
	  Agreement.

	  Please check http://www.omen.com for more information.

     SSSSUUUUPPPPPPPPOOOORRRRTTTT
	  Users	who have not purchased support as part of their
	  registration may call	503-614-0430 to	arrange	for technical
	  support on a consulting basis.

	  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.	 Solutions to nearly
	  all file transfer problems are described in the
	  Professional-YAM/ZCOMM documentation.

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  This program uses error correcting protocols to receive
	  files	over a dial-in serial port from	a variety of programs
	  running under	PC-DOS,	CP/M, Unix, and	other operating
	  systems.  It is invoked from a shell prompt manually,	or
	  automatically	as a result of an "sz file ..."	command	given
	  to the calling program.

	  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 act as a server for 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-



     Page 1					     (printed 1/27/98)






     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



	  YAM communications software are suitable 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.


	  RRRRzzzz (Receive ZMODEM) receives one or more files with the
	  ZMODEM protocol.  Pathnames are supplied by the sending
	  program, and directories are created if necessary.  (See the
	  example below.) if standard output is	not redirected to a
	  file or pipe,	output is appended to a	file named "stdout".

	  Normally, the	"rz" command is	automatically issued by	the
	  calling ZMODEM program, but defective	ZMODEM implementations
	  may require starting _r_z manually.

	  RRRRbbbb receives file(s) with YMODEM, accepting either standard
	  128 byte sectors or 1024 byte	sectors	(Pro-YAM/ZCOMM sb ----kkkk
	  option).  The	user should determine when the 1024 byte block
	  length actually improves throughput.

	  If True YMODEM (Omen Technology trademark) file information
	  (file	length,	etc.) is received, the file length controls
	  the number of	bytes written to the output dataset and	the
	  modify time (iff non zero) are set accordingly.

	  If True YMODEM file information is not 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 and other	historical
	  systems.

	  RRRRcccc receives a	single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
	  protocol.  The user should determine when the	1024 byte
	  block	length actually	improves throughput without causing
	  problems.  The user must supply the file name	to both
	  sending and receiving	programs.  Up to 1023 garbage
	  characters may be added to the received file.

	  RRRRxxxx receives a	single _f_i_l_e with XMODEM	or XMODEM-1k protocol.
	  The user should determine when the 1024 byte block length
	  actually improves throughput without causing problems.  The
	  user must supply the file name to both sending and receiving
	  programs.  Up	to 1023	garbage	characters may be added	to the
	  received file.

	  GGGGzzzz is	a shell	script which calls _s_z to command Pro-YAM or
	  ZCOMM	to transmit the	specified files.  Pathnames used with
	  _g_z must be escaped if	they have special significance to the
	  Unix shell.
	  EXAMPLE: gz "-a C:*.c	D:*.h"



     Page 2					     (printed 1/27/98)






     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



	  If invoked with a leading ``v'', _r_z will report progress to
	  /tmp/rzlog.
	  EXAMPLE: ln rz vrz; rz=vrz; export rz

	  If the RESTRICTED shell environment variable is set to 1, or
	  if the SHELL environment variable includes _r_s_h or _r_k_s_h
	  (restricted shell), registered copies	of _r_z will not accept
	  command uploads, absolute pathnames, references to a parent
	  directory, will not modify an	existing file, and removes any
	  files	received in error.
	  EXAMPLE: RESTRICTED=1	rz


	  The meanings of the available	options	are:

	  ttttTTTTIIIIMMMMEEEEOOOOUUUUTTTT
	       Change TIMEOUT to _T_I_M_E_O_U_T tenths	of seconds.
	  vvvv    Verbose causes a	list of	file names to be appended to
	       /tmp/rzlog .  More v's generate more detailed debugging
	       output.
	  wwwwWWWWIIIINNNNDDDDOOOOWWWW
	       Use a receive window of WINDOW bytes.  Details in the
	       Professional-YAM	user manual.
	  (Pro-YAM command)
	  <_A_L_T-_2>
	  Pro-YAM Command: _s_z *._h *._c
	  This automatically invokes _r_z	on the connected system, and
	  sends	all .h and .c files in the current directory.

	  _s_z -_n	-_R_f .
	  This Professional-YAM	command	recursively follows the
	  current directory tree (.) (Pro-YAM -R option), sends	the
	  full relative	pathname (-f), for files that are newer	(-n)
	  than their copies on the destination system.

	  _r_z | _s_o_r_t >/_t_m_p/_s_o_r_t_e_d
	  _s_z _O_N_A_M_E=- *._l_s_t
	  The first command manually starts rrrrzzzz with output piped to
	  the sort command.  The second	command	instructs
	  Professional-YAM, ZCOMM, GSZ or DSZ to sene the files	using
	  "-" as pathname, which instructs rrrrzzzz to output	the received
	  data to its standard output.	The end	result is a single
	  file containing all the lines	of the .lst files sorted
	  alphabetically.



     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.



     Page 3					     (printed 1/27/98)






     RRRRZZZZ((((1111))))		OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy	IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))		 RRRRZZZZ((((1111))))



     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  Professional-YAM, ZCOMM, DSZ,	crc(omen), sz(omen),
	  usq(omen), undos(omen)

	  Compile time options required	for various operating systems
	  are described	in the source file.

     SSSSEEEERRRRVVVVEEEERRRR////NNNNEEEETTTTWWWWOOOORRRRKKKK NNNNOOOOTTTTEEEESSSS
	  Terminals on some timesharing	systems	are connected
	  indirectly to	the host with TTTTEEEERRRRMMMMIIIINNNNAAAALLLL SSSSEEEERRRRVVVVEEEERRRRSSSS operating over
	  networks.  Terminal servers often interfere with file
	  transfers by "eating"	control	characters and/or losing data.

	  Accessing a distant system using tttteeeellllnnnneeeetttt on a local Unix
	  system entails the same problems.  If	tttteeeellllnnnneeeetttt does not	work
	  well,	try rrrrllllooooggggiiiinnnn with	the ----8888 option.	Set the	escape
	  character to ^P (control P) which is protected by ZMODEM.

	  When terminal	servers	interfere with file transfers, server
	  commands are often available to help the problem.  When
	  possible, enable the server and modems for hardware flow
	  control in and out.  Set the terminal	server to telnet
	  transparent mode.  Some typical commands are "SET TERMINAL
	  DOWNLOAD", "set session passall", and	"SET TERMINAL NO ESC",
	  but there is no standard set of commands suitable for	all
	  terminal servers.  Normally these commands are given before
	  attempting file transfers, but one user has reported that