Provided by: lrzsz_0.12.21-11build1_amd64 
NAME
sx, sb, sz - XMODEM, YMODEM, ZMODEM file send
SYNOPSIS
sz [-+8abdefkLlNnopqTtuvyY] file ...
sb [-adfkqtuv] file ...
sx [-akqtuv] file
sz [-oqtv] -c COMMAND
sz [-oqtv] -i COMMAND
sz -TT
DESCRIPTION
Sz 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.
While rz is smart enough to be called from cu(1), very few versions of cu(1) are smart
enough to allow sz to work properly. Unix flavors of Professional-YAM are available for
such dial-out application.
Sz 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 END-TO-END 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.
Output from another program may be piped to sz for transmission by denoting standard input
with "-":
ls -l | sz -
The program output is transmitted with the filename sPID.sz where PID is the process ID of
the sz program. If the environment variable ONAME is set, that is used instead. In this
case, the Unix command:
ls -l | ONAME=con sz -ay -
will send a "file" to the PC-DOS console display. The -y option instructs the receiver to
open the file for writing unconditionally. The -a option causes the receiver to convert
Unix newlines to PC-DOS carriage returns and linefeeds.
Sb batch sends one or more files with YMODEM or ZMODEM protocol. The initial ZMODEM
initialization is not sent. When requested by the receiver, sb supports YMODEM-g with
"cbreak" tty mode, XON/XOFF flow control, and interrupt character set to CAN (^X).
YMODEM-g (Professional-YAM g option) increases throughput over error free channels (direct
connection, X.PC, etc.) by not acknowledging each transmitted sector.
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.
Sx sends a single file with XMODEM or XMODEM-1k protocol (sometimes incorrectly called
"ymodem"). The user must supply the file name to both sending and receiving programs.
If sz is invoked with $SHELL set and iff that variable contains the string rsh , rbash or
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 fourth form sends a single COMMAND to a ZMODEM receiver for execution. Sz 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. Sz 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.
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 q
option.
The meanings of the available options are:
-+, --append
Instruct the receiver to append transmitted data to an existing file (ZMODEM only).
-2, --twostop
use two stop bits (if possible). Do not use this unless you know what you are
doing.
-8, --try-8k
Try to go up to 8KB blocksize. This is incompatible with standard zmodem, but a
common extension in the bbs world. (ZMODEM only).
--start-8k
Start with 8KB blocksize. Like --try-8k.
-a, --ascii
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.
-b, --binary
(ZMODEM) Binary override: transfer file without any translation.
-B NUMBER, --bufsize NUMBER
Use a readbuffer of NUMBER bytes. Default ist 16384, 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 option -
things normally get worse, not better, if the machine starts to swap.
Using this option turns of memory mapping of the input file. This increases memory
and cpu usage.
-c COMMAND, --command COMMAND
Send COMMAND to the receiver for execution, return with COMMAND´s exit status.
-C N, --command-tries N
Retry to send command N times (default: 11).
-d, --dot-to-slash
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.
This option enables the --full-path option.
--delay-startup N
Wait N seconds before doing anything.
-e, --escape
Escape all control characters; normally XON, XOFF, DLE, CR-@-CR, and Ctrl-X are
escaped.
-E, --rename
Force the sender to rename the new file if a file with the same name already
exists.
-f, --full-path
Send Full pathname. Normally directory prefixes are stripped from the transmitted
filename.
This is also turned on with to --dot-to-slash option.
-h, --help
give help.
-i COMMAND, --immediate-command COMMAND
Send COMMAND to the receiver for execution, return immediately upon the receiving
program's successful reception of the command.
-k, --1k
(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.)
-L N, --packetlen N
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.
-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).
-l N, --framelen N
Wait for the receiver to acknowledge correct data every N (32 <= N <= 1024)
characters. This may be used to avoid network overrun when XOFF flow control is
lacking.
-n, --newer
(ZMODEM) Send each file if destination file does not exist. Overwrite destination
file if source file is newer than the destination file.
-N, --newer-or-longer
(ZMODEM) Send each file if destination file does not exist. Overwrite destination
file if source file is newer or longer than the destination file.
-o, --16-bit-crc
(ZMODEM) Disable automatic selection of 32 bit CRC.
-O, --disable-timeouts
Disable read timeout handling. This makes lsz hang if the other side doesn't send
anything, but increases performance (not much) and decreases system load (reduces
number of system calls by about 50 percent).
Use this option with care.
-p, --protect
(ZMODEM) Protect existing destination files by skipping transfer if the destination
file exists.
-q, --quiet
Quiet suppresses verbosity.
-R, --restricted
Restricted mode: restricts pathnames to the current directory and PUBDIR (usually
/usr/spool/uucppublic) and/or subdirectories thereof.
-r, --resume
(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.
-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
enable timesync protocol support. See timesync.doc for further information.
This option is incompatible with standard zmodem. Use it with care.
--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.
-T, --turbo
Do not escape certain characters (^P, ^P|0x80, telenet escape sequence [CR + @]).
This improves performance by about 1 percent and shouldn't hurt in the normal case
(but be careful - ^P might be useful if connected through a terminal server).
--tcp Try to initiate a TCP/IP connection. lsz will ask the receiving zmodem to open a
TCP/IP connection. All handshaking (which address / port to use) will be done by
the zmodem programs.
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 option if
the two programs are connected (stdin/out) over a slow or bad (not 8bit clean)
network connection.
Use of this option imposes a security risk, somebody else could connect to the port
in between. See SECURITY for details.
--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 Unlink the file after successful transmission.
-U, --unrestrict
Turn off restricted mode (this is not possible if running under a restricted
shell).
-w N, --windowsize N
Limit the transmit window size to N bytes (ZMODEM).
-v, --verbose
Verbose output to stderr. More v's generate more output.
-X, --xmodem
use XMODEM protocol.
-y, --overwrite
Instruct a ZMODEM receiving program to overwrite any existing file with the same
name.
-Y, --overwrite-or-skip
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.
--ymodem
use ZMODEM protocol.
-Z, --zmodem
use ZMODEM protocol.
SECURITY
Restricted mode restricts pathnames to the current directory and PUBDIR (usually
/var/spool/uucppublic) and/or subdirectories thereof, and disables remote command
execution.
Restricted mode is entered if the R option is given or if lsz detects that it runs under a
restricted shell or if the environment variable ZMODEM_RESTRICTED is found.
Restricted mode can be turned of with the U option if not running 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
ZNULLS may be used to specify the number of nulls to send before a ZDATA frame.
SHELL lsz recognizes a restricted shell if this variable includes rsh or rksh
ZMODEM_RESTRICTED
lrz enters restricted mode if the variable is set.
TMPDIR If this environment variable is set its content is used as the directory to place
in the answer file to a timesync request. TMP Used instead of TMPDIR if TMPDIR is
not set. If neither TMPDIR nor TMP is set /tmp will be used.
EXAMPLES
ZMODEM File Transfer (Unix to DSZ/ZCOMM/Professional-YAM)
% sz -a *.c
This single command transfers all .c files in the current Unix directory with conversion
(-a) 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 security check.
% sz -Yan *.c *.h
Send only the .c and .h files that exist on both systems, and are newer on the sending
system than the corresponding version on the receiving system, converting Unix to DOS text
format.
$ sz -\Yan file1.c file2.c file3.c foo.h baz.h ®(for VMS)
ZMODEM Command Download (Unix to Professional-YAM)
cpszall:all
sz -c "c:;cd /yam/dist"
sz -ya $(YD)/*.me
sz -yqb y*.exe
sz -c "cd /yam"
sz -i "!insms"
This Makefile fragment uses sz to issue commands to Professional-YAM to change current
disk and directory. Next, sz transfers the .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 .exe files. The fourth and fifth
lines command Pro-YAM to change directory and execute a PC-DOS batch file insms . Since
the batch file takes considerable time, the -i form is used to allow sz to exit
immediately.
XMODEM File Transfer (Unix to Crosstalk)
% sx -a foo.c
ESC
rx foo.c
The above three commands transfer a single file from Unix to a PC and Crosstalk with sz
translating Unix newlines to DOS CR/LF. This combination is much slower and far less
reliable than ZMODEM.
ERROR MESSAGES
"Caught signal 99" indicates the program was not properly compiled, refer to "bibi(99)" in
rbsb.c for details.
SEE ALSO
rz(omen), ZMODEM.DOC, YMODEM.DOC, Professional-YAM, crc(omen), sq(omen), todos(omen),
tocpm(omen), tomac(omen), yam(omen)
Compile time options required for various operating systems are described in the source
file.
VMS VERSION
The VMS version does not support wild cards. Because of VMS DCL, upper case option
letters must be represented by \ preceding the letter.
The current VMS version does not support XMODEM, XMODEM-1k, or YMODEM.
VMS C Standard I/O and RMS may interact to modify the file contents.
FILES
32 bit CRC code courtesy Gary S. Brown.
sz.c, crctab.c, rbsb.c, zm.c, zmodem.h Unix source files
sz.c, crctab.c, vrzsz.c, zm.c, zmodem.h, vmodem.h, vvmodem.c, VMS source files.
/tmp/szlog stores debugging output (sz -vv) (szlog on VMS).
TESTING FEATURE
The command "sz -T file" exercises the 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 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 Attn sequence is not interrupting the sender, and the Myattn string in sz.c
must be modified.
After 5 packets, 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.
BUGS
Calling sz from most versions of cu(1) doesn't work because cu's receive process fights sz
for characters from the modem.
On at least one BSD system, sz would hang or exit when it got within a few kilobytes of
the end of file. Using the "-w 8192" flag fixed the problem. The real cause is unknown,
perhaps a bug in the kernel TTY output routines.
Programs that do not properly implement the specified file transfer protocol may cause sz
to "hang" the port for a minute or two. This problem is corrected by using ZCOMM, Pro-
YAM, or other program with a correct implementation of the specified protocol.
Many programs claiming to support YMODEM only support XMODEM with 1k blocks, and they
often don't get that quite right.
XMODEM transfers add up to 127 garbage bytes per file. XMODEM-1k and YMODEM-1k transfers
use 128 byte blocks to avoid extra padding.
YMODEM programs use the file length transmitted at the beginning of the transfer to prune
the file to the correct length; this may cause problems with source files that grow during
the course of the transfer. This problem does not pertain to ZMODEM transfers, which
preserve the exact file length unconditionally.
Most ZMODEM options are merely passed to the receiving program; some do not implement all
these options.
Circular buffering and a ZMODEM sliding window should be used when input is from pipes
instead of acknowledging frames each 1024 bytes. If no files can be opened, sz sends a
ZMODEM command to echo a suitable complaint; perhaps it 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.
A few high speed modems have a firmware bug that drops characters when the direction of
high speed transmission is reversed. The environment variable ZNULLS may be used to
specify the number of nulls to send before a ZDATA frame. Values of 101 for a 4.77 mHz PC
and 124 for an AT are typical.