SYD-X(1)

NAME

syd-x - Check executability of files, list executables of processes

SYNOPSIS

syd-x [-hcv] [-l pid...] [files...]

DESCRIPTION

syd-x checks executability of the given files or lists executables of the given processes. The file executability check uses the execveat(2) system call with the flag "AT_EXECVE_CHECK" on Linux>=6.14 and falls back to the faccessat(2) system call with the flag "X_OK" on older Linux. If the -l option is specified, list mode is activated: all following arguments are interpreted as process IDs, not files. In list mode, executable file listing is done using the "PROCMAP_QUERY" ioctl(2) request on Linux>=6.11 and falls back to parsing the proc_pid_maps(5) file textually on older Linux.

OPTIONS

-h | Display help.
-c | Exit with success if the "AT_EXECVE_CHECK" flag is supported.
-l pid | Specify a process ID to list the executables of, may be repeated.
-v | Print file check status information on standard error.

EXIT STATUS

syd-x exits with 0 on success or with the errno(3) number on failure.

SEE ALSO

syd(1), syd(2), syd(5)

•   syd homepage: https://sydbox.exherbo.org/
•   Executability check: https://docs.kernel.org/next/userspace-api/check_exec.html

AUTHORS

Maintained by Ali Polatel. Up-to-date sources can be found at https://gitlab.exherbo.org/sydbox/sydbox.git and on Radicle at rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF. Bugs/patches can be submitted to https://gitlab.exherbo.org/groups/sydbox/-/issues. Discuss in #sydbox on Libera Chat or in #sydbox:mailstation.de on Matrix.