.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "SYD-FD" "1" "2025-06-12"
.PP
.SH NAME
.PP
syd-fd - Interact with remote file descriptors
.PP
.SH SYNOPSIS
.PP
\fBsyd-fd\fR \fI[-h]\fR \fI[-p pid]\fR \fI[-f remote_fd[:local_fd]]\fR.\&.\&.\& \fI{command [args.\&.\&.\&]}\fR
.PP
.SH DESCRIPTION
.PP
The \fBsyd-fd\fR utility can be used to interact with remote file
descriptors on Linux systems.\& Given only a PID argument with \fB-p\fR, 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 \fB-f\fR argument can be used to transfer remote
file descriptors using \fIpidfd_getfd\fR(2) which requires Linux>=5.\&6.\&
Optionally a comma-delimited local file descriptor may be specified as
target fd.\& Specify \fBrand\fR 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.\&
.PP
.SH OPTIONS
.PP
.TS
l lx
l lx
l lx.
T{
\fB-h\fR
T}	T{
Display help.\&
T}
T{
\fB-p\fR \fIpid\fR
T}	T{
Specify process ID.\& If not given, list fds of current process.\&
T}
T{
\fB-f\fR \fIremote_fd[:local_fd]\fR
T}	T{
Specify remote fd to transfer.\& Optionally specify comma-separated local fd as target, or \fBrand\fR for random target.\&
T}
.TE
.sp 1
.SH EXIT CODES
.PP
\fBsyd-fd\fR exits with the same exit code as the command.\&
.PP
.SH SEE ALSO
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIsyd-lock\fR(1), \fIsyd-pds\fR(1), \fIpidfd_getfd\fR(1)
.PP
\fBsyd\fR homepage: https://sydbox.\&exherbo.\&org/
.PP
.SH AUTHORS
.PP
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.\&