serialport 4.9.0

A cross-platform low-level serial port library.
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

//! Internal convenience wrappers for using `flock`.

use crate::{Error, ErrorKind, Result};
use nix::fcntl::FlockArg;
use std::os::unix::prelude::*;

/// Convenience method to acquire an exclusive lock using flock
///
/// This is used ensure that no other applications are using the port. This requires that the other
/// application also uses flock, so this does not work with all applications.
pub(crate) fn lock_exclusive(fd: RawFd) -> Result<()> {
    nix::fcntl::flock(fd, FlockArg::LockExclusiveNonblock).map_err(|e| {
        if e == nix::errno::Errno::EWOULDBLOCK {
            Error::new(
                ErrorKind::NoDevice,
                "Unable to acquire exclusive lock on serial port",
            )
        } else {
            e.into()
        }
    })
}

/// Convenience method to acquire a shared lock using flock
///
/// With the shared lock, other applications are able to use the port as well, if they're also
/// using a shared lock, but this makes sure that they cannot acquire an exclusive lock while we're
/// using the port.
pub(crate) fn lock_shared(fd: RawFd) -> Result<()> {
    nix::fcntl::flock(fd, FlockArg::LockSharedNonblock).map_err(|e| {
        if e == nix::errno::Errno::EWOULDBLOCK {
            Error::new(
                ErrorKind::NoDevice,
                "Unable to acquire shared lock on serial port",
            )
        } else {
            e.into()
        }
    })
}