[cygwin-apps/cygutils.git] / src / namei / namei.1

.\" 
.\" Version 1.4 of namei
.\"
.TH NAMEI 1 "Local"
.SH NAME
namei - follow a pathname until a terminal point is found
.SH SYNOPSIS
.B namei
.I [-mx]
.I pathname
.I "[ pathname ... ]"
.SH DESCRIPTION
.I Namei
uses its arguments as pathnames to any type
of Unix file (symlinks, files, directories, and so forth). 
.I Namei
then follows each pathname until a terminal 
point is found (a file, directory, char device, etc).
If it finds a symbolic link, we show the link, and start
following it, indenting the output to show the context.
.PP
This program is useful for finding a "too many levels of
symbolic links" problems.
.PP
For each line output,
.I namei
outputs a the following characters to identify the file types found:
.LP
.nf
   f: = the pathname we are currently trying to resolve
    d = directory
    l = symbolic link (both the link and it's contents are output)
    s = socket
    b = block device
    c = character device
    - = regular file
    ? = an error of some kind
.fi
.PP
.I Namei
prints an informative message when
the maximum number of symbolic links this system can have has been exceeded.
.SH OPTIONS
.TP 8
.B -x
Show mount point directories with a 'D', rather than a 'd'.
.TP 8
.B -m
Show the mode bits of each file type in the style of ls(1),
for example 'rwxr-xr-x'.
.SH AUTHOR
Roger Southwick  (rogers@amadeus.wr.tek.com)
.SH BUGS
To be discovered.
.SH CAVEATS
.I Namei
will follow an infinite loop of symbolic links forever.  To escape, use
SIGINT (usually ^C).
.SH "SEE ALSO"
ls(1), stat(1)
Commit	Line	Data
d4a28ab0 CW	1	.\"
	2	.\" Version 1.4 of namei
	3	.\"
	4	.TH NAMEI 1 "Local"
	5	.SH NAME
	6	namei - follow a pathname until a terminal point is found
	7	.SH SYNOPSIS
	8	.B namei
	9	.I [-mx]
	10	.I pathname
	11	.I "[ pathname ... ]"
	12	.SH DESCRIPTION
	13	.I Namei
	14	uses its arguments as pathnames to any type
	15	of Unix file (symlinks, files, directories, and so forth).
	16	.I Namei
	17	then follows each pathname until a terminal
	18	point is found (a file, directory, char device, etc).
	19	If it finds a symbolic link, we show the link, and start
	20	following it, indenting the output to show the context.
	21	.PP
	22	This program is useful for finding a "too many levels of
	23	symbolic links" problems.
	24	.PP
	25	For each line output,
	26	.I namei
	27	outputs a the following characters to identify the file types found:
	28	.LP
	29	.nf
	30	f: = the pathname we are currently trying to resolve
	31	d = directory
	32	l = symbolic link (both the link and it's contents are output)
	33	s = socket
	34	b = block device
	35	c = character device
	36	- = regular file
	37	? = an error of some kind
	38	.fi
	39	.PP
	40	.I Namei
	41	prints an informative message when
	42	the maximum number of symbolic links this system can have has been exceeded.
	43	.SH OPTIONS
	44	.TP 8
	45	.B -x
	46	Show mount point directories with a 'D', rather than a 'd'.
	47	.TP 8
	48	.B -m
	49	Show the mode bits of each file type in the style of ls(1),
	50	for example 'rwxr-xr-x'.
	51	.SH AUTHOR
	52	Roger Southwick (rogers@amadeus.wr.tek.com)
	53	.SH BUGS
	54	To be discovered.
	55	.SH CAVEATS
	56	.I Namei
	57	will follow an infinite loop of symbolic links forever. To escape, use
	58	SIGINT (usually ^C).
	59	.SH "SEE ALSO"
	60	ls(1), stat(1)