.\" Generated by scdoc 1.11.5
.\" 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\-READ" "1" "2026\-09\-01"
.PP
.SH NAME
.PP
\fBsyd\-read\fR \- Print resolved symbolic links or canonical file names
.PP
.SH SYNOPSIS
.PP
\fBsyd\-read\fR \fI[\-hmnzBDFMNPRUX]\fR \fI[\-c n]\fR \fI[\-d dir]\fR \fI[\-p pid]\fR \fIpath.\&.\&.\&\fR
.PP
.SH DESCRIPTION
.PP
The \fBsyd\-read\fR utility prints resolved symbolic links or canonical file
names.\& By default last component may exist, other components must
exist.\&
.PP
.SH OPTIONS
.PP
.TS
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx
l lx.
T{
\fB\-h\fR
T}	T{
Display help.\&
T}
T{
\fB\-c\fR \fBn\fR
T}	T{
Cycle through the path list \fBn\fR times, useful for benchmarking.\&
T}
T{
\fB\-d\fR \fBdir\fR
T}	T{
Resolve relative to the given directory.\&
T}
T{
\fB\-p\fR \fBpid\fR
T}	T{
Resolve from the perspective of the given process ID.\&
T}
T{
\fB\-m\fR
T}	T{
All components of the paths must exist, conflicts with \fB\-M\fR.\&
T}
T{
\fB\-M\fR
T}	T{
Last component must not exist, other components must exist, conflicts with \fB\-m\fR.\&
T}
T{
\fB\-B\fR
T}	T{
Resolve beneath the given directory, useful with \fB\-d dir\fR.\& Implies \fB\-P\fR, conflicts with \fB\-R\fR.\&
T}
T{
\fB\-R\fR
T}	T{
Treat the given directory as root directory, useful with \fB\-d dir\fR.\& Implies \fB\-P\fR, conflicts with \fB\-B\fR.\&
T}
T{
\fB\-D\fR
T}	T{
Do not traverse through ".\&.\&" components.\&
T}
T{
\fB\-X\fR
T}	T{
Do not traverse through mount points.\&
T}
T{
\fB\-F\fR
T}	T{
Do not follow symbolic links for any of the path components.\&
T}
T{
\fB\-N\fR
T}	T{
Do not follow symbolic links for the last path component.\&
T}
T{
\fB\-P\fR
T}	T{
Do not resolve /proc magic symbolic links.\&
T}
T{
\fB\-U\fR
T}	T{
Resolve unsafe /proc magic symbolic links.\&
T}
T{
\fB\-n\fR
T}	T{
Do not output the trailing delimiter.\&
T}
T{
\fB\-z\fR
T}	T{
End each output line with NUL not newline.\&
T}
.TE
.sp 1
.SH SEE ALSO
.PP
\fIsyd\fR(1), \fIsyd\fR(2), \fIsyd\fR(5), \fIreadlink\fR(1), \fIrealpath\fR(3)
.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 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.\&