lrzsz2 0.7.1

ZMODEM file transfer utilities
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

// SPDX-License-Identifier: GPL-3-0-or-later
// Copyright (c) 2017-2020 Alexey Arbuzov
// Copyright (c) 2023-2025 Jarkko Sakkinen

use std::os::fd::BorrowedFd;
#[cfg(unix)]
use std::os::unix::io::AsRawFd;

/// Configure a terminal/device for raw serial communication suitable for ZMODEM
///
/// This sets the terminal to raw mode, which is necessary for binary protocols
/// like ZMODEM to work correctly over serial ports, PTYs, or stdin/stdout.
#[cfg(unix)]
pub fn configure_raw_mode(fd: BorrowedFd) -> std::io::Result<()> {
    use nix::sys::termios::{self, SetArg};

    let mut termios = termios::tcgetattr(fd).map_err(std::io::Error::other)?;

    termios::cfmakeraw(&mut termios);

    termios::tcsetattr(fd, SetArg::TCSANOW, &termios).map_err(std::io::Error::other)?;

    Ok(())
}

#[cfg(not(unix))]
pub fn configure_raw_mode(_fd: BorrowedFd) -> std::io::Result<()> {
    Ok(())
}

/// Configure a terminal/device for non-blocking I/O
#[cfg(unix)]
pub fn configure_nonblocking(fd: BorrowedFd) -> std::io::Result<()> {
    use nix::fcntl::{self, FcntlArg, OFlag};

    let flags = fcntl::fcntl(fd.as_raw_fd(), FcntlArg::F_GETFL).map_err(std::io::Error::other)?;
    let mut new_flags = OFlag::from_bits_truncate(flags);
    new_flags.insert(OFlag::O_NONBLOCK);
    fcntl::fcntl(fd.as_raw_fd(), FcntlArg::F_SETFL(new_flags)).map_err(std::io::Error::other)?;
    Ok(())
}

#[cfg(not(unix))]
pub fn configure_nonblocking(_fd: BorrowedFd) -> std::io::Result<()> {
    Ok(())
}