Home
Main website
Display Sidebar
Hide Ads
Recent Changes
View Source:
rz(1)
Edit
PageHistory
Diff
Info
LikePages
RZ !!!RZ NAME SYNOPSIS DESCRIPTION OPTIONS SECURITY ENVIRONMENT EXAMPLES SEE ALSO NOTES BUGS VMS VERSION ZMODEM CAPABILITIES FILES ---- !!NAME rx, rb, rz - XMODEM, YMODEM, ZMODEM (Batch) file receive !!SYNOPSIS __rz__ [[- __+8abeOpqRtTuUvy__]__ rb__ [[- __+abqRtuUvy__]__ rx__ [[- __abceqRtuUv__] ''file'' [[__-__][[__v__]__rzCOMMAND__ !!DESCRIPTION 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 While ''rz'' is smart enough to be called from ''cu(1),'' very few versions of ''cu(1)'' are smart enough to allow ''rz'' to work properly. Unix flavors of Professional-YAM are available for such dial-out application. __Rz__ (Receive ZMODEM) receives files with the ZMODEM batch protocol. Pathnames are supplied by the sending program, and directories are made if necessary (and possible). Normally, the __rz'' the old fashioned way. __Rb__ receives file(s) with YMODEM, accepting either standard 128 byte sectors or 1024 byte sectors (YAM sb __-k__ option). The user should determine when the 1024 byte block length actually improves throughput without causing lost data or even system crashes. 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 and file mode (iff non zero) are set accordingly. If no True YMODEM 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. With YMODEM, each file name is converted to lower case unless it contains one or more lower case letters. __Rx__ receives a single ''file'' 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. __Rz__ may be invoked as __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 ''rzrmail'' which calls rmail(1) to post mail to the user specified by the transmitted file name. For example, sending the file ''rzrmail'' on a Unix system would result in the contents of the DOS file On some 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'', ''rz'' will be verbose (see __v__ option). The following entry works for Unix SYS III/V: rzrmail::5:1::/bin:/usr/local/rzrmail If the SHELL environment variable includes ''rsh'' , ''rbash'' or ''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 __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 __q__ option. !!OPTIONS The meanings of the available options are: __-+, --append__ append received data to an existing file (ZMODEM, ASCII only). __-a, --ascii__ Convert files to Unix conventions by stripping carriage returns and all characters beginning with the first Control Z (CP/M end of file). __-b, --binary__ Binary (tell it like it is) file transfer override. __-B NUMBER, --bufsize NUMBER__ Buffer __NUMBER__ bytes before writing to disk. Default ist 32768, which should be enough for most situations. If you have a slow machine or a bad disk interface or suffer from other hardware problems you might want to increase the buffersize. __-1__ or __auto__ use a buffer large enough to buffer the whole file. Be careful with this options - things normally get worse, not better, if the machine starts to swap. __-c, --with-crc__ XMODEM only. Use 16 bit CRC (normally a one byte checksum is used). __-C, --allow-remote-commands__ allow remote command execution ( __insecure__ ). This allows the sender to execute an arbitrary command through __system__ () or __execl__ (). Default is to disable this feature (?). This option is ignored if running in restricted mode. __-D, --null__ Output file data to /dev/null; for testing. (Unix only) __--delay-startup N__ Wait __N__ seconds before doing anything. __-e, --escape__ Force sender to escape all control characters; normally XON, XOFF, DLE, CR-@-CR, and Ctrl-X are escaped. __-E, --rename__ Rename incoming file if target filename already exists. The new file name will have a dot and a number (0..999) appended. __-h, --help__ give help screen. __-m N, --min-bps N__ Stop transmission if BPS-Rate (Bytes Per Second) falls below N for a certain time (see --min-bps-time option). __-M N, --min-bps-time__ Used together with --min-bps. Default is 120 (seconds). __-O, --disable-timeouts__ Disable read timeout handling code. This makes lrz hang if the sender does not send any more, but increases performance (a bit) and decreases system load (through reducing the number of system calls by about 50 percent). Use this option with care. __--o-sync__ Open output files in synchronous write mode. This may be useful if you experience errors due to lost interrupts if update (or bdflush or whoever this daemon is called on your system) writes the buffers to the disk. This option is ignored and a warning is printed if your systems doesn't support O_SYNC. __-p, --protect__ (ZMODEM) Protect: skip file if destination file exists. __-q, --quiet__ Quiet suppresses verbosity. __-r, --resume__ Crash recovery mode. lrz tries to resume interrupted file transfers. __-R, --restricted__ Enter more restricted mode. lrz will not create directories or files with a leading dot if this option is given twice. See __SECURITY__ for mode information about restricted mode. __-s HH:MM, --stop-at HH:MM__ Stop transmission at __HH__ hours, __MM__ minutes. Another variant, using __+N__ instead of __HH:MM,__ stops transmission in __N__ seconds. __-S, --timesync__ Request timesync packet from the sender. The sender sends its system time, causing lrz to complain about more then 60 seconds difference. Lrz tries to set the local system time to the remote time if this option is given twice (this fails if lrz is not run by root). This option makes lrz incompatible with certain other ZModems. Don't use it unless you know what you are doing. __--syslog[[=off]__ turn syslogging on or off. the default is set at configure time. This option is ignored if no syslog support is compiled in. __-t TIM, --timeout TIM__ Change timeout to ''TIM'' tenths of seconds. This is ignored if timeout handling is turned of through the __O__ option. __--tcp-client ADDRESS:PORT__ Act as a tcp/ip client: Connect to the given port. See __--tcp-server__ for more information. __--tcp-server__ Act as a server: Open a socket, print out what to do, wait for connection. You will normally not want to use this option as lrzsz is the only zmodem which understands what to do (private extension). You might want to use this if you have to use zmodem (for which reason whatever), and cannot use the __--tcp__ option of ''lsz'' (perhaps because your telnet doesn't allow to spawn a local program with stdin/stdout connected to the remote side). If you use this option you have to start ''lsz'' with the __--tcp-client ADDRESS:PORT__ option. ''lrz will print the address and port on startup.'' Use of this option imposes a security risk, somebody else could connect to the port in between. See __SECURITY__ for details. __-U, --unrestrict__ turn off restricted mode (this is not possible if running under a restricted shell). __--version__ prints out version number. __-v, --verbose__ Verbose causes a list of file names to be appended to stderr. More v's generate more output. __-wN, --windowsize N__ Set window size to N. __-X, --xmodem__ use XMODEM protocol. __-y, --overwrite__ Yes, clobber any existing files with the same name. __--ymodem__ use YMODEM protocol. __-Z, --zmodem__ use ZMODEM protocol. !!SECURITY Contrary to the original ZMODEM lrz defaults to restricted mode. In restricted mode lrz will not accept absolute pathnames or references to a parent directory, will not modify an existing file, and removes any files received in error. Remote command execution is disabled. To use a more restricted mode set the environment variable __ZMODEM_RESTRICTED__ or give the __R__ option. This disables creation of subdirectories and invisible files. Restricted mode may be turned off with the __U__ option, unless lrz runs under a restricted shell. Use of the __--tcp-client__ or __--tcp-server__ options imposes a security risk, as somebody else could connect to the port before you do it, and grab your data. If there's strong demand for a more secure mode i might introduce some sort of password challenge. !!ENVIRONMENT lrz uses the following environment variables: __SHELL__ lrz recognizes a restricted shell if this variable includes ''rsh'' or ''rksh'' __ZMODEM_RESTRICTED__ lrz enters the more restricted mode if the variable is set. !!EXAMPLES (Pro-YAM command)'' Pro-YAM Command: ''sz *.h *.c'' (This automatically invokes ''rz'' on the connected system.) !!SEE ALSO ZMODEM.DOC, YMODEM.DOC, Professional-YAM, crc(omen), sz(omen), usq(omen), undos(omen) Compile time options required for various operating systems are described in the source file. !!NOTES Sending serial data to timesharing minicomputers at sustained high speeds has been known to cause lockups, system halts, kernel panics, and occasional antisocial behaviour. When experimenting with high speed input to a system, consider rebooting the system if the file transfers are not successful, especially if the personality of the system appears altered. The Unix The TTY input buffering on some systems may not allow long blocks or streaming input at high speed. You should suspect this problem when you can't send data to the Unix system at high speeds using ZMODEM, YMODEM-1k or XMODEM-1k, when YMODEM with 128 byte blocks works properly. If the system's tty line handling is really broken, the serial port or the entire system may not survive the onslaught of long bursts of high speed data. The DSZ or Pro-YAM __zmodem l__ numeric parameter may be set to a value between 64 and 1024 to limit the burst length (__ 32 bit CRC code courtesy Gary S. Brown. Directory creation code from John Gilmore's PD TAR program. !!BUGS Calling ''rz'' from most versions of cu(1) doesn't work because cu's receive process fights ''rz'' for characters from the modem. Programs that do not properly implement the specified file transfer protocol may cause ''sz'' to '' Many programs claiming to support YMODEM only support XMODEM with 1k blocks, and they often don't get that quite right. 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 ASCII options CR/LF to NL translation merely deletes CRs; undos(omen) performs a more intelligent translation. !!VMS VERSION The VMS version does not set the file time. VMS C Standard I/O and RMS may interact to modify file contents unexpectedly. The VMS version does not support invocation as __rzCOMMAND .__ The current VMS version does not support XMODEM, XMODEM-1k, or YMODEM. According to the VMS documentation, the buffered input routine used on the VMS version of ''rz'' introduces a delay of up to one second for each protocol transaction. This delay may be significant for very short files. Removing the '' The VMS version causes DCL to generate a random off the wall error message under some error conditions; this is a result of the incompatibility of the VMS !!ZMODEM CAPABILITIES ''Rz'' supports incoming ZMODEM binary (-b), ASCII (-a), protect (-p), clobber (-y), and append (-+) requests. The default is protect (-p) and binary (-b). The Unix versions support ZMODEM command execution. !!FILES rz.c, crctab.c, rbsb.c, zm.c, zmodem.h Unix source files. rz.c, crctab.c, vrzsz.c, zm.c, zmodem.h, vmodem.h, vvmodem.c, VMS source files. ----
One page links to
rz(1)
:
Man1r
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.
