v/os at 7280d4c95a48419dcf7bfe5e47c0b8dcd95af4b9 - v

mirror/v

mirror of https://github.com/vlang/v.git synced 2023-08-10 21:13:21 +03:00

History

Vincenzo Palazzo b01f71d9da io: migrate the `Reader` API to `Result` instead of `Option` (#15229 )		2022-08-08 02:33:25 +03:00
..
bare
cmdline
filelock
font
notify
args.v
const_nix.c.v
const_windows.c.v
const.v
environment_test.v
environment.c.v
environment.js.v
fd.c.v
file_test.v	io: migrate the `Reader` API to `Result` instead of `Option` (#15229 )	2022-08-08 02:33:25 +03:00
file.c.v	io: migrate the `Reader` API to `Result` instead of `Option` (#15229 )	2022-08-08 02:33:25 +03:00
file.js.v
filepath_test.v
filepath_windows.v
filepath.v
find_abs_path_of_executable_test.v
glob_test.v
inode_test.v
inode.c.v
open_uri_default.c.v
open_uri_windows.c.v
os_android_outside_termux.c.v
os_darwin.c.v
os_js.js.v
os_linux.c.v
os_nix.c.v
os_structs_dirent_default.c.v
os_structs_sigaction_default.c.v
os_structs_stat_default.c.v
os_structs_stat_linux.c.v
os_structs_utsname_default.c.v
os_test.v
os_windows.c.v
os.c.v
os.js.v
os.v
process_nix.c.v
process_test.v
process_windows.c.v
process.c.v
process.js.v
process.v
README.md
signal_test.v
signal.c.v
signal.js.v
signal.v

README.md

Description:

os provides common OS/platform independent functions for accessing command line arguments, reading/writing files, listing folders, handling processes etc.

A few os module functions can lead to the TOCTOU vulnerability if used incorrectly. TOCTOU (Time-of-Check-to-Time-of-Use problem) can occur when a file, folder or similar is checked for certain specifications (e.g. read, write permissions) and a change is made afterwards. In the time between the initial check and the edit, an attacker can then cause damage. The following example shows an attack strategy on the left and an improved variant on the right so that TOCTOU is no longer possible.

Example Hint: os.create() opens a file in write-only mode

Possibility for TOCTOU attack

if os.is_writable("file"){

    // >> time to make a quick attack (e.g. symlink /etc/passwd to >file<) <<

    mut f := os.create('path/to/file') ?
        // <do something with file>
    f.close()
}

TOCTOU not possible

mut f := os.create('path/to/file') or {
    println("file not writable")
}

// >> do someting with file; file is locked <<

f.close()

Proven affected functions
The following functions should be used with care and only when used correctly.

os.is_readable()
os.is_writable()
os.is_executable()
os.is_link()

README.md

Description:

Security advice related to TOCTOU attacks