As well-known, lrzsz is a very handy tool to transfer files along with the existing terminal. It is so convenient that after I implemented the ZMODEM feature in putty-nd, I seldom use other tools to transfer files.
Then, why do I make another implementation of it? Well, as a user, I have a lot of thinking, like what if it can blablabla or why can't it be blablabla. Those thinking keep following me and someday I couldn't stand for it and downloaded its source code. Sadly I gave up before I got drowned in the source code(Sorry to say that, it is my problem). And the worst thing is, this happened again and again. To get out of this dilemma, I decide to re-implement it again.
I have some tools on hand, the FSM and the multi-jobs Processor in C++. So it is written in C++. I have written build scripts in plain Makefile, so it is not autoconf. It is a utility tool, which means it must not occupy lots of resources from the other logical server. So it is a single thread.
As it is a long time after the ZMODEM protocol was invented, rzsz-nd starts from a basic feature, which is sending/receiving plain file in ZMODEM, without any conversion and encryption. For the other features in ZMODEM or YMODEM/XMODEM, will be gone with the wind if no one bring it back in the future. I have implemented some more features and protocol extensions, which are detailed in the following chapter.
All the sequence diagrams are written in mermaid. A better formatted version of this file can be reached via my blog.
The original ZMODEM protocol is available via the link or the markdown version. And the simple workflow comes follows.
sequenceDiagram
participant client
participant server
server->>client: ZRQINIT
client->>server: ZRINIT
server->>client: ZFILE
client->>server: ZRPOS
server->>client: ZDATA(ZCRCG... ZCRCE)
server->>client: ZEOF
client->>server: ZRINIT
server->>client: FIN
client->>server: FIN
sequenceDiagram
participant client
participant server
server->>client: ZRINIT
client->>server: ZFILE
server->>client: ZRPOS
client->>server: ZDATA(ZCRCG... ZCRCE)
client->>server: ZEOF
server->>client: ZRINIT
client->>server: ZCOMPL
client->>server: FIN
server->>client: FIN
The feature is already supported in the ZMODEM protocol. I just send the relative path of the file as its filename. The server/client check the '/' character and make the directory. However, the empty directory is ignored at the moment.
sequenceDiagram
participant client
participant server
server->>client: ZRQINIT
loop each file
client->>server: ZRINIT
server->>client: ZFILE
client->>server: ZRPOS
server->>client: ZDATA(ZCRCG... ZCRCE)
server->>client: ZEOF
end
server->>client: FIN
client->>server: FIN
sequenceDiagram
participant client
participant server
server->>client: ZRINIT
loop each file
client->>server: ZFILE
server->>client: ZRPOS
client->>server: ZDATA(ZCRCG... ZCRCE)
client->>server: ZEOF
server->>client: ZRINIT
end
client->>server: ZCOMPL
client->>server: FIN
server->>client: FIN
The file cursor position in ZMODEM protocol message(ZRPOS/ZDATA/ZACK/ZEOF) is defined as 4 bytes, which limits the file size max to 4 GB. In order to achieve this feature, a 64bit binary frame with CRC32 is defined. When the cursor position is larger than 4 GB, the 64bit binary frame will be used while the rest is as it was.
#define ZBIN64 'D'
struct frame64_tag{
unsigned char type;
unsigned char flag[8];
uint32_t crc;
};
typedef struct frame64_tag frame64_t;
2 extra messages ZCOMMAND(ZCOMMAND_CHECK_LEN) and ZACK(pos) are involved.
sequenceDiagram
participant client
participant server
server->>client: ZRQINIT
client->>server: ZRINIT
server->>client: ZFILE
opt file exist on client
Note left of client: calc the CRC32 of the existing the file content.
client->>server: ZCOMMAND_CHECK_LEN(CRC32, len)
Note right of server: verify the CRC32 of the file heading content in len length. ack with the same length if ok, otherwise 0.
server->>client: ZACK(len)
end
Note left of client: start transmitting at the responsed length or 0.
client->>server: ZRPOS(len)
server->>client: ZDATA(ZCRCG... ZCRCE)
server->>client: ZEOF
client->>server: ZRINIT
server->>client: FIN
client->>server: FIN
sequenceDiagram
participant client
participant server
server->>client: ZRINIT
client->>server: ZFILE
opt file exist on client
Note right of server: calc the CRC32 of the existing the file content.
server->>client: ZCOMMAND_CHECK_LEN
Note left of client: verify the CRC32 of the file heading content in len length. ack with the same length if ok, otherwise 0.
client->>server: ZACK(len)
end
Note right of server: start transmitting at the responsed length or 0.
server->>client: ZRPOS(len)
client->>server: ZDATA(ZCRCG... ZCRCE)
client->>server: ZEOF
server->>client: ZRINIT
client->>server: ZCOMPL
client->>server: FIN
server->>client: FIN
The options are added to update client/server working directory, and preset the rz files to avoid the file selection. Please refer to the usage chapter for the details.
Type make to build release version. And make install to install it to /usr/local/bin.
make
make install
Type make debug to build a debug version.
make debug
[ludong@VM-0-17-centos rzsz-nd]$ ./sz --help
USAGE:
./sz [-s <directory path>] [-c <directory path>] [-l <filename>] [-d
<int:0-5>] [--] [--version] [-h] <string[]> ...
Where:
-s <directory path>, --server-working-dir <directory path>
Depending on ZVERSION:1, set the working directory on the server side.
It is current directory if not set.
-c <directory path>, --client-working-dir <directory path>
Depending on ZVERSION:1, set the working directory on the client side.
It is desktop if not set.
-l <filename>, --log <filename>
File to log
-d <int:0-5>, --debug <int:0-5>
set debug level. 0: TRACE; 1: DEBUG; 2: INFO; 3: WARN; 4: ERROR; 5:
FATAL;
--, --ignore_rest
Ignores the rest of the labeled arguments following this flag.
--version
Displays version information and exits.
-h, --help
Displays usage information and exits.
<string[]> (accepted multiple times)
(required) files to sent
Send file(s) with ZMODEM protocol.
[ludong@VM-0-17-centos rzsz-nd]$ ./rz --help
USAGE:
./rz [-f] [-p <directory/file path>] [-s <directory path>] [-c
<directory path>] [-l <filename>] [-d <int:0-5>] [--] [--version]
[-h]
Where:
-f, --rz-folder-mode
rz folder mode, make client to select folder.
-p <directory/file path>, --preset-files <directory/file path>
Depending on ZVERSION:1, preset rz files splited by '#' to skip file
selection
-s <directory path>, --server-working-dir <directory path>
Depending on ZVERSION:1, set the working directory on the server side.
It is current directory if not set.
-c <directory path>, --client-working-dir <directory path>
Depending on ZVERSION:1, set the working directory on the client side.
It is desktop if not set.
-l <filename>, --log <filename>
File to log
-d <int:0-5>, --debug <int:0-5>
set debug level. 0: TRACE; 1: DEBUG; 2: INFO; 3: WARN; 4: ERROR; 5:
FATAL;
--, --ignore_rest
Ignores the rest of the labeled arguments following this flag.
--version
Displays version information and exits.
-h, --help
Displays usage information and exits.
Receive file(s) with ZMODEM protocol.
Except for extra permissions from Dong Lu(noodle1983@126.com), this software is released under version 3 of the GNU General Public License (GPLv3).
| module | license |
|---|---|
| tclap | MIT License |
| base64 | GPL-2.0 |
| flatbuffers | Apache-2.0 |
| lz4 | BSD 2-Clause license |
| {fmt} | MIT License |