fcoreutils 0.22.0

High-performance GNU coreutils replacement with SIMD and parallelism
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
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

#!/usr/bin/env python3
"""Security tests for fmkdir — uses shared framework."""
import sys, os, tempfile
from shutil import which
sys.path.insert(0, os.path.join(os.path.dirname(__file__), '..', '..', 'tests'))
from security_framework import SecurityTestFramework

config = {
    'tool_name': 'mkdir',
    'bin_name': 'fmkdir',
    'gnu_path': '/usr/bin/mkdir',
    'bss_size': 4096,
    'max_binary_size': 30000,
    'test_args': ['/tmp/__fmkdir_security_test__'],
    'test_stdin': None,
}

def tool_specific_tests(fw):
    """13. Tool-specific: mkdir — directory creation behavior."""
    fw.log("\n=== Tool-Specific: mkdir ===")

    # Core mkdir behavior
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "basic_test")
        rc, out, err = fw.run_asm([testdir])
        fw.report_result(rc == 0, "mkdir: create directory -> exit 0")
        fw.report_result(os.path.isdir(testdir), "mkdir: directory actually created")

    # Already exists
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "exists_test")
        os.mkdir(testdir)
        rc, out, err = fw.run_asm([testdir])
        fw.report_result(rc == 1, "mkdir: already exists -> exit 1")
        fw.report_result(b"File exists" in err, "mkdir: EEXIST error message")

    # Nonexistent parent
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "noparent", "child")
        rc, out, err = fw.run_asm([testdir])
        fw.report_result(rc == 1, "mkdir: no parent -> exit 1")
        fw.report_result(b"No such file or directory" in err, "mkdir: ENOENT error message")

    # Multiple directories
    with tempfile.TemporaryDirectory() as tmpdir:
        dirs = [os.path.join(tmpdir, f"multi_{i}") for i in range(3)]
        rc, out, err = fw.run_asm(dirs)
        fw.report_result(rc == 0, "mkdir: multiple dirs -> exit 0")
        fw.report_result(all(os.path.isdir(d) for d in dirs), "mkdir: all dirs created")

    # -p creates parent chain
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "p_test", "a", "b", "c")
        rc, out, err = fw.run_asm(["-p", testdir])
        fw.report_result(rc == 0, "mkdir: -p parent chain -> exit 0")
        fw.report_result(os.path.isdir(testdir), "mkdir: -p created all parents")

    # -p no error if exists
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "p_exists")
        os.mkdir(testdir)
        rc, out, err = fw.run_asm(["-p", testdir])
        fw.report_result(rc == 0, "mkdir: -p existing dir -> exit 0")

    # --parents long form
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "parents_test", "x", "y")
        rc, out, err = fw.run_asm(["--parents", testdir])
        fw.report_result(rc == 0, "mkdir: --parents long form -> exit 0")
        fw.report_result(os.path.isdir(testdir), "mkdir: --parents created dirs")

    # -v verbose
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "verbose_test")
        rc, out, err = fw.run_asm(["-v", testdir])
        fw.report_result(rc == 0, "mkdir: -v -> exit 0")
        fw.report_result(b"created directory" in err, "mkdir: -v produces verbose output")
        expected_msg = f"mkdir: created directory '{testdir}'".encode()
        fw.report_result(expected_msg in err, "mkdir: -v format matches GNU")

    # -m mode
    with tempfile.TemporaryDirectory() as tmpdir:
        testdir = os.path.join(tmpdir, "mode_test")
        rc, out, err = fw.run_asm(["-m", "755", testdir])
        fw.report_result(rc == 0, "mkdir: -m 755 -> exit 0")
        if os.path.isdir(testdir):
            perms = oct(os.stat(testdir).st_mode & 0o777)
            fw.report_result(perms == "0o755", f"mkdir: -m 755 permissions correct ({perms})")
        else:
            fw.report_result(False, "mkdir: -m 755 dir not created")

    # Error message format
    rc, out, err = fw.run_asm(["/tmp/nonexistent_format_specific/child"])
    fw.report_result(b"mkdir: cannot create directory '" in err, "mkdir: error format correct")

    # mkdir syscall (strace)
    if which("strace"):
        with tempfile.TemporaryDirectory() as tmpdir:
            testdir = os.path.join(tmpdir, "strace_mkdir")
            cmd = ["strace", "-e", "trace=mkdir", fw.bin_path, testdir]
            rc, out, err = fw.run(cmd)
            err_text = err.decode(errors="replace")
            fw.report_result("mkdir(" in err_text, "mkdir: uses mkdir() syscall")

if __name__ == '__main__':
    # Clean up test dir that may exist from test_args
    test_dir = config['test_args'][0]
    try:
        os.rmdir(test_dir)
    except OSError:
        pass
    fw = SecurityTestFramework(config)
    fw.run_all(tool_specific_fn=tool_specific_tests)
    # Clean up
    try:
        os.rmdir(test_dir)
    except OSError:
        pass