diff options
Diffstat (limited to '')
| -rw-r--r-- | misc-utils/namei.1 | 123 | ||||
| -rw-r--r-- | misc-utils/namei.1.adoc | 83 |
2 files changed, 206 insertions, 0 deletions
diff --git a/misc-utils/namei.1 b/misc-utils/namei.1 new file mode 100644 index 0000000..7022297 --- /dev/null +++ b/misc-utils/namei.1 @@ -0,0 +1,123 @@ +'\" t +.\" Title: namei +.\" Author: [see the "AUTHOR(S)" section] +.\" Generator: Asciidoctor 2.0.15 +.\" Date: 2022-08-04 +.\" Manual: User Commands +.\" Source: util-linux 2.38.1 +.\" Language: English +.\" +.TH "NAMEI" "1" "2022-08-04" "util\-linux 2.38.1" "User Commands" +.ie \n(.g .ds Aq \(aq +.el .ds Aq ' +.ss \n[.ss] 0 +.nh +.ad l +.de URL +\fI\\$2\fP <\\$1>\\$3 +.. +.als MTO URL +.if \n[.g] \{\ +. mso www.tmac +. am URL +. ad l +. . +. am MTO +. ad l +. . +. LINKSTYLE blue R < > +.\} +.SH "NAME" +namei \- follow a pathname until a terminal point is found +.SH "SYNOPSIS" +.sp +\fBnamei\fP [options] \fIpathname\fP... +.SH "DESCRIPTION" +.sp +\fBnamei\fP interprets its arguments as pathnames to any type of Unix file (symlinks, files, directories, and so forth). \fBnamei\fP then follows each pathname until an endpoint is found (a file, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and starts following it, indenting the output to show the context. +.sp +This program is useful for finding "too many levels of symbolic links" problems. +.sp +For each line of output, \fBnamei\fP uses the following characters to identify the file type found: +.sp +.if n .RS 4 +.nf +.fam C + f: = the pathname currently being resolved + d = directory + l = symbolic link (both the link and its contents are output) + s = socket + b = block device + c = character device + p = FIFO (named pipe) + \- = regular file + ? = an error of some kind +.fam +.fi +.if n .RE +.sp +\fBnamei\fP prints an informative message when the maximum number of symbolic links this system can have has been exceeded. +.SH "OPTIONS" +.sp +\fB\-l\fP, \fB\-\-long\fP +.RS 4 +Use the long listing format (same as \fB\-m \-o \-v\fP). +.RE +.sp +\fB\-m\fP, \fB\-\-modes\fP +.RS 4 +Show the mode bits of each file type in the style of \fBls\fP(1), for example \(aqrwxr\-xr\-x\(aq. +.RE +.sp +\fB\-n\fP, \fB\-\-nosymlinks\fP +.RS 4 +Don\(cqt follow symlinks. +.RE +.sp +\fB\-o\fP, \fB\-\-owners\fP +.RS 4 +Show owner and group name of each file. +.RE +.sp +\fB\-v\fP, \fB\-\-vertical\fP +.RS 4 +Vertically align the modes and owners. +.RE +.sp +\fB\-x\fP, \fB\-\-mountpoints\fP +.RS 4 +Show mountpoint directories with a \(aqD\(aq rather than a \(aqd\(aq. +.RE +.sp +\fB\-h\fP, \fB\-\-help\fP +.RS 4 +Display help text and exit. +.RE +.sp +\fB\-V\fP, \fB\-\-version\fP +.RS 4 +Print version and exit. +.RE +.SH "BUGS" +.sp +To be discovered. +.SH "AUTHORS" +.sp +The original \fBnamei\fP program was written by \c +.MTO "rogers\(atamadeus.wr.tek.com" "Roger Southwick" "." +.sp +The program was rewritten by Karel Zak \c +.MTO "kzak\(atredhat.com" "Karel Zak" "." +.SH "SEE ALSO" +.sp +\fBls\fP(1), +\fBstat\fP(1), +\fBsymlink\fP(7) +.SH "REPORTING BUGS" +.sp +For bug reports, use the issue tracker at \c +.URL "https://github.com/util\-linux/util\-linux/issues" "" "." +.SH "AVAILABILITY" +.sp +The \fBnamei\fP command is part of the util\-linux package which can be downloaded from \c +.URL "https://www.kernel.org/pub/linux/utils/util\-linux/" "Linux Kernel Archive" "."
\ No newline at end of file diff --git a/misc-utils/namei.1.adoc b/misc-utils/namei.1.adoc new file mode 100644 index 0000000..c8a317d --- /dev/null +++ b/misc-utils/namei.1.adoc @@ -0,0 +1,83 @@ +//po4a: entry man manual += namei(1) +:doctype: manpage +:man manual: User Commands +:man source: util-linux {release-version} +:page-layout: base +:command: namei + +== NAME + +namei - follow a pathname until a terminal point is found + +== SYNOPSIS + +*namei* [options] _pathname_... + +== DESCRIPTION + +*namei* interprets its arguments as pathnames to any type of Unix file (symlinks, files, directories, and so forth). *namei* then follows each pathname until an endpoint is found (a file, a directory, a device node, etc). If it finds a symbolic link, it shows the link, and starts following it, indenting the output to show the context. + +This program is useful for finding "too many levels of symbolic links" problems. + +For each line of output, *namei* uses the following characters to identify the file type found: + +.... + f: = the pathname currently being resolved + d = directory + l = symbolic link (both the link and its contents are output) + s = socket + b = block device + c = character device + p = FIFO (named pipe) + - = regular file + ? = an error of some kind +.... + +*namei* prints an informative message when the maximum number of symbolic links this system can have has been exceeded. + +== OPTIONS + +*-l*, *--long*:: +Use the long listing format (same as *-m -o -v*). + +*-m*, *--modes*:: +Show the mode bits of each file type in the style of *ls*(1), for example 'rwxr-xr-x'. + +*-n*, *--nosymlinks*:: +Don't follow symlinks. + +*-o*, *--owners*:: +Show owner and group name of each file. + +*-v*, *--vertical*:: +Vertically align the modes and owners. + +*-x*, *--mountpoints*:: +Show mountpoint directories with a 'D' rather than a 'd'. + +include::man-common/help-version.adoc[] + +== BUGS + +To be discovered. + +== AUTHORS + +The original *namei* program was written by mailto:rogers@amadeus.wr.tek.com[Roger Southwick]. + +The program was rewritten by Karel Zak mailto:kzak@redhat.com[Karel Zak]. + +== SEE ALSO + +*ls*(1), +*stat*(1), +*symlink*(7) + +include::man-common/bugreports.adoc[] + +include::man-common/footer.adoc[] + +ifdef::translation[] +include::man-common/translation.adoc[] +endif::[] |