НАЗВАНИЕ

СИНТАКСИС

ОПИСАНИЕ

Sz может быть запущена из cu(1), но немногие версии cu(1) могут правильно работать с sz. Для таких случаев подойдут Unix-версии Professional-YAM.

Sz передаёт один или более файлов по протоколу ZMODEM.

ZMODEM значительно упрощает передачу файлов, по сравнению с протоколом XMODEM. В дополнение к дружественному интерфейсу пользователя, ZMODEM предоставляет персональному компьютеру и другим пользователям эффективный, точный и надежный способ передачи файлов.

ZMODEM гарантирует полную один-в-один сохранность данных при передаче. 32-битные CRC протокола ZMODEM позволяют отловить ошибки, не замечаемые даже более совершенными сетями.

Средства улучшенного управления файлами включают в себя: автопередачу (autodownload - автоматическую передачу файлов, начинаемую без вмешательства пользователя); вывод размера отдельных файлов и суммарной длины загружаемых файлов, а также предполагаемого времени окончания передачи (ETA); выборочную передачу файлов; сохранение точной даты и длины файла.

Стандартный вывод другой программы может быть перенаправлен через канал программе sz для передачи путём указания в качестве имени файла символа "-": ls -l | sz -

При этом стандартный вывод будет передан как файл sPID.sz, где PID - это идентификатор процесса sz. Если установлена переменная окружения ONAME, то в качестве имени будет использовано её значение. Например, команда Unix: ls -l | ONAME=con sz -ay -

передаст "file" на дисплей консоли PC-DOS. Опция -y указывает приёмнику перезаписывать файл назначения. Опция -a указывает приёмнику преобразовывать символы новой строки Unix в принятые в PC-DOS символы возврата каретки и перевода строки.

Sb группирует один или более файлов для передачи по протоколу YMODEM или ZMODEM. Начальная инициализация протокола ZMODEM не производится. Sb поддерживает включаемый по запросу приемника YMODEM-g с режимом tty "cbreak", XON/XOFF контролем потока и символом прерывания, установленным в CAN (^X). YMODEM-g (Опция g Professional-YAM) увеличивает пропускную способность свободных от появления ошибок (прямое соединение, X.PC и т.п.) каналов, путем отказа от подтверждения каждого переданного сектора.

На системах Unix передается дополнительная информациия о файлах. Если принимающая программа использует эту информацию, то длина переданного файла соответствует длине записанного файла. Кроме того, правильно выставляются дата последнего изменения и атрибуты файла.

Sx передаёт один файл file по протоколу XMODEM или XMODEM-1k (иногда неправильно называемому "ymodem"). Пользователь должен указать имя файла как передающей, так и принимающей программе.

Если sz запущен с установленной переменной $SHELL, и эта переменная содержит строку rsh, rbash или rksh (restricted shell),то sz будет работать в ограниченном режиме. При этом пути к файлам ограничиваются текущим каталогом и значением PUBDIR и/или их подкаталогами.

Четвертый способ применения дает приемнику COMMAND для исполнения. Sz выходит со значением, которое вернула команда COMMAND. Если в команде COMMAND встречаются пробелы или управляющие символы, имеющие специальное значение для shell, то они должны быть экранированы.

Пятый способ дает ZMODEM-приемнику одну команду для исполнения. Sz выходит, как только приемник успешно получил команду, до ее исполнения.

Шестой способ (sz -TT) дает sz команду вывести на терминал все 256 символов. Она позволяет вам определить коды символов, "съедаемых" операционной системой. Используйте ее, если у вас возникли трудности с передачей файлов.

Если sz запущена со стандартными потоками вывода и ошибок, перенаправленными в разные места, то Verbose будет установлен в 2, что приведет к покадровому выводу прогресса передачи в стандартный поток ошибок. Такое поведение может быть выключено опцией q.

ОПЦИИ

-+, --append

Указать приемнику добавлять полученные данные к существующему файлу (только ZMODEM).

-2, --twostop

Использовать два стоповых бита (если это возможно). Не использовать эту опцию, если нет уверенности в том, что вы делаете.

-8, --try-8k

Попробовать увеличить размер блока до 8Кб. Практикуется среди пользователей bbs, хотя и не соответствует стандарту (только ZMODEM).

--start-8k

Начать работу с 8Кб блоков. То же, что и --try-8k.

-a, --ascii

Преобразовывать символы NL в передаваемом файле в CR/LF. Это преобразование производится передатчиком в протоколах XMODEM и YMODEM, и приемником в протоколе ZMODEM.

-b, --binary

(ZMODEM) Двоичная передача: передавать файлы без какого-либо преобразования.

-B NUMBER, --bufsize NUMBER

Использовать буфер чтения размером в число NUMBER байт. По умолчанию значение числа NUMBER равно 16384, что вполне достаточно для подавляющего числа случаев. Если машина слишком медленна или плохой интерфейс дискового накопителя, или есть другие подобные проблемы с аппаратным обеспечением, то можно увеличить размер буфера. -1 или auto создает буфер, достаточный для всего файла. Нужно быть осторожным с этой опцией - если буфер слишком большой, машина может заняться подкачкой недостающей памяти, что, как правило, еще хуже. Использование этой опции выключает отображение памяти на входящий файл, что обычно увеличивает загрузку процессора и памяти.

-c COMMAND, --command COMMAND

Дать приемнику команду COMMAND для исполнения, выйти со значением, которое вернула команда COMMAND.

-C N, --command-tries N

Пробовать дать команду N раз (по умолчанию 11).

-d, --dot-to-slash

Заменить все встречающиеся в передаваемом имени "." на "/". Таким образом, C.omenB0000 (имя, неприемлимое для MSDOS или CP/M) будет передано как C/omenB0000. Если результат содержит более 8 символов, то будет добавлена ".",что позволит увеличить число символов до одиннадцати. Эта опция автоматически включает опцию --full-path.

--delay-startup N

Ждать N секунд перед тем, как начать что-либо делать.

-e, --escape

Экранировать все управляющие символы; в обычном режиме экранируются XON, XOFF, DLE, CR-@-CR и Ctrl- X.

-E, --rename

Переименовать принимаемые файлы, если файлы с таким именем уже существуют.

-f, --full-path

Передавать полное имя файла. В обычном режиме имена каталогов обрезаются. Эта опция автоматически включается, если указана опция --dot-to-slash.

-h, --help

Показать помощь.

-i COMMAND, --immediate-command COMMAND

Дать приемнику команду COMMAND для исполнения, выйти сразу после успешного получения команды приемником.

-k, --1k

(XMODEM/YMODEM) Передавать файлы 1024-байтными блоками (по умолчанию используются 128-байтные блоки). 1024-байтные пакеты повышают скорость передачи файлов при наличии высоких битовых скоростей. (ZMODEM для получения максимальной пропускной способности подстраивает поток данных.)

-L N, --packetlen N

Использовать под-пакеты протокола ZMODEM длиной N. Более высокие значения N (32 <= N <= 1024) заметно увеличивают пропускную способность, более низкие - улучшают скорость коррекции ошибок. По умолчанию используется 128 при скоростях ниже 300 бод, 256 при скоростях выше 300 бод, 1024 при скоростях выше 2400 бод.

-m N, --min-bps N

Остановить передачу, если BPS (Bytes Per Second - байт в секунду) упадет ниже N на определенное время (см. опцию --min-bps-time).

-M N, --min-bps-time

Использовать совместно с --min-bps. Значение по умолчанию равно 120 (секундам).

-l N, --framelen N

Ждать от приемника подтверждения правильности данных каждые N (32 <= N <= 1024) символов. Эта опция может быть использована для предотвращения перегрузки сети при отстуствии XOFF контроля потока.

-n, --newer

(ZMODEM) Передать файл, если файл назначения не существует. Перезаписывать файл назначения, если передаваемый файл новее существующего.

-N, --newer-or-longer

(ZMODEM) Передать файл, если файл назначения не существует. Перезаписывать файл назначения, если передаваемый файл новее или длиннее существующего.

-o, --16-bit-crc

(ZMODEM) Выключить автоматический выбор 32-битных CRC.

-O, --disable-timeouts

Выключить отслеживание времени ожидания. При этом, если противоположная сторона ничего не посылает, то lsz будет ждать бесконечно. Эта опция незначительно повышает производительность и снижает загрузку системы (за счет уменьшения примерно на 50 процентов количества системных вызовов). Нужно быть осторожным при использовании этой опции.

-p, --protect

(ZMODEM) Защитить существующие файлы назначения, не передавая файлы при наличии соответствующих файлов назначения.

-q, --quiet

Предотвратить вывод подробной информации

-R, --restricted

Ограниченный режим: пути к файлам ограничиваются текущим каталогом и значением PUBDIR и/или их подкаталогами.

-r, --resume

(ZMODEM) Возобновить прерванную передачу файла. Если передаваемый файл длиннее файла назначения, то передача будет продолжена со смещения, равного текущей длине файла назначения.

-s HH:MM, --stop-at HH:MM

Остановить передачу в HH часов, MM минут. Если вместо HH:MM указать +N , то передача будет остановлена через N секунд.

-S, --timesync

Включить поддержку протокола синхронизации времени. Эта опция несовместима со стандартом протокола ZMODEM.

--syslog[=off]

Включить или выключить ведение системного журнала. Значение по умолчанию устанавливается при настройке перед компилляцией. Опция игнорируется, если поддержка системного журнала не была включена в программу при компилляции.

-t TIM, --timeout TIM

Изменить время ожидания на TIM десятых долей секунды.

-T, --turbo

Не экранировать некоторые символы (^P, ^P|0x80, telenet escape sequence [CR + @]). Это увеличит производительность примерно на 1 процент и, в общем случае, не должно привести к неприятностям (но нужно быть осторожным - ^P может использоваться при соединении через сервер терминалов).

--tcp

Попробовать установить TCP/IP соединение. lsz попросит принимающий модем установить TCP/IP соединение. Соединение (с указанным адресом / портом) устанавливается ZMODEM программами. Как правило, эта опция не используется, так как lrzsz - единственная ZMODEM программа, понимающая, что нужно делать для установления соединения. Возможно, вы пожелаете воспользоваться этой опцией, если две программы соединены (стандартный ввод/вывод) через медленное или ненадежное сетевое соединение. Использование этой опции несколько рискованно с точки зрения безопасности - кто-либо еще может подсоединиться к используемому порту. Более подробно об этом можно посмотреть в разделеБЕЗОПАСНОСТЬ.

--tcp-client ADDRESS:PORT

Действовать как TCP/IP клиент: соединиться с указанным портом.

--tcp-server

Действовать как сервер: открыть сокет; вывести указания; ждать соединения. Обычно эта опция не используется, так как lrzsz - единственная ZMODEM программа, понимающая, что нужно делать для установки соединения. Можно указать эту опцию, если по какой-либо причине необходимо воспользоваться протоколом ZMODEM, но нельзя использовать опцию --tcp программы lsz (возможно, потому что telnet не позволяет запустить локальную программу с переназначенным на удаленную сторону стандартным вводом/выводом). Если вы воспользовались этой опцией, то вам необходимо запустить lsz с опцией --tcp-client ADDRESS:PORT. lrz при запуске выведет адрес и порт. Использование этой опции несколько рискованно с точки зрения безопасности - кто-либо еще может подсоединиться к используемому порту. Более подробно об этом можно посмотреть в разделе БЕЗОПАСНОСТЬ.

-u

Удалить файл после успешного окончания передачи.

-U, --unrestrict

Выключить ограниченный режим (если работать под restricted shell, то сделать это невозможно).

-w N, --windowsize N

Ограничить размер окна передачи N байтами (ZMODEM).

-v, --verbose

Выводить подробную информацию в стандартный поток ошибок.

-X, --xmodem

Использовать протокол XMODEM.

-y, --overwrite

Указать приемнику о перезаписи существующих файлов.

-Y, --overwrite-or-skip

Указать приемнику о перезаписи существующих файлов и пропуске всех файлов с тем же путем, что и у файла назначения.

--ymodem

Использовать протокол ZMODEM.

-Z, --zmodem

Использовать протокол ZMODEM.

БЕЗОПАСНОСТЬ

Ограниченный режим может быть включен опцией R. Кроме того, lrz будет работать в ограниченном режиме, если определит, что была запущена под restricted shell, а также если установлена переменная окружения ZMODEM_RESTRICTED.

Ограниченный режим может быть выключен опцией U, если только работа производится не из restricted shell.

Использование опций

--tcp-client или --tcp-server влечет за собой некоторый риск, с точки зрения безопасности, так как кто-либо может подсоединиться к порту и забрать данные.

ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ

ZNULLS

Используется для указания количества null-символов, посылаемых перед кадром ZDATA.

SHELL

lsz распознает restricted shell, если эта переменная содержит rsh или rksh

ZMODEM_RESTRICTED

Если эта переменная установлена, lrz будет работать в ограниченном режиме.

TMPDIR

Если эта переменная установлена, то ее значение используется в качестве каталога, в котором будет лежать файл, высылаемый по запросу timesync .

TMP

используется вместо TMPDIR, если TMPDIR не установлена. Если не указана ни та, ни другая переменная, то будет использован каталог /tmp.

ПРИМЕРЫ

% sz -Yan *.c *.h
Передает все .c и .h файлы, которые существуют на обеих системах и являются более новыми на передающей системе, чем соответствующие им на принимающей. При передаче производится преобразование файлов из текстового формата Unix в текстовый формат DOS.
$ sz -Yan file1.c file2.c file3.c foo.h baz.h (для VMS)

Передача команд по протоколу ZMODEM (Unix -> 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"
Этот фрагмент Makefile-а использует sz для передачи Professional-YAM команд, меняющих текущий диск и каталог. Далее, sz передаёт файлы .me из каталога $YD, указывая приемнику перезаписывать старые файлы и преобразовывать концы строк из формата Unix в формат PC-DOS. Третья строка передает файлы .exe. Четвертая и пятая строки указывют Pro-YAM сменить каталог и запустить пакетный файл PC-DOS insms. Так как исполнение пакетного файла может занять значительное время, то используется опция -i для немедленного выхода из sz.

Передача файла по протоколу XMODEM (Unix -> Crosstalk)
% sx -a foo.c
ESC
rx foo.c
Три вышеуказанные команды используются для передачи файла с Unix на PC и Crosstalk. При этом sz преобразует строки в формат DOS (CR/LF). Эта комбинация работает намного медленнее и не так надежно, как ZMODEM.

ВЕРСИЯ ДЛЯ VMS

Текущая версия для VMS не поддерживает XMODEM, XMODEM-1k

или YMODEM.

Стандартный ввод/вывод VMS C и RMS могут

взаимодействовать, изменяя содержимое файла.

Index

НАЗВАНИЕ

СИНТАКСИС

ОПИСАНИЕ

ОПЦИИ

БЕЗОПАСНОСТЬ

ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ

ПРИМЕРЫ

ВЕРСИЯ ДЛЯ VMS