SYD-FD(1) General Commands Manual SYD-FD(1)

syd-fd - Interact with remote file descriptors

syd-fd [-h] [-p pid] [-f remote_fd[:local_fd]]... {command [args...]}

The syd-fd utility can be used to interact with remote file descriptors on Linux systems. Given only a PID argument with -p, it lists the open files of the process with the given PID in line-oriented compact JSON format. Given no PID argument it lists the open files of the current process. The -f argument can be used to transfer remote file descriptors using pidfd_getfd(2) which requires Linux>=5.6. Optionally a comma-delimited local file descriptor may be specified as target fd. Specify rand as target to duplicate the file descriptor to a random available file descriptor slot. If a command is given it is executed and the file descriptors are transferred to the process. If no command is given "/bin/sh" is executed.

-h Display help.
-p pid Specify process ID. If not given, list fds of current process.
-f remote_fd[:local_fd] Specify remote fd to transfer. Optionally specify comma-separated local fd as target, or rand for random target.

syd-fd exits with the same exit code as the command.

syd(1), syd(2), syd(5), syd-lock(1), syd-pds(1), pidfd_getfd(1)

syd homepage: https://sydbox.exherbo.org/

Maintained by Ali Polatel. Up-to-date sources can be found at https://gitlab.exherbo.org/sydbox/sydbox.git and 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.

2025-06-12