rusl 0.5.0

Rust linux interface layer
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

use sc::syscall;

use crate::platform::{Fd, Mode, AT_FDCWD};
use crate::string::unix_str::UnixStr;
use crate::Result;

/// Create a directory named `path`
/// See [linux documentation for details](https://man7.org/linux/man-pages/man2/mkdir.2.html)
/// # Errors
/// See above
#[inline]
pub fn mkdir(path: &UnixStr, mode: Mode) -> Result<()> {
    do_mkdir(AT_FDCWD, path, mode)
}

/// Create a directory named `path` with `dir_fd` as the root directory
/// See [linux documentation for details](https://man7.org/linux/man-pages/man2/mkdir.2.html)
/// # Errors
/// See above
pub fn mkdir_at(dir_fd: Fd, path: &UnixStr, mode: Mode) -> Result<()> {
    do_mkdir(dir_fd.0, path, mode)
}

#[inline(always)]
#[expect(clippy::inline_always)]
fn do_mkdir(dir_fd: i32, path: &UnixStr, mode: Mode) -> Result<()> {
    let res = unsafe { syscall!(MKDIRAT, dir_fd, path.as_ptr(), mode.bits()) };
    bail_on_below_zero!(res, "`MKDIRAT` syscall failed");
    Ok(())
}