'\" t
.\" @(#)  /u/des/src/seepath/seepath.man  1.1  98/01/14  20:38:56
.\" Copyright (c) 1998, Daniel E. Singer
.\" All Rights Reserved
.\" view this document using [tn]roff with the -man option
.TH seepath 1 "06 January 1998" "ToolMan"
.\" ------------------------------------------------------------------------
.\" define string D to be a dash appropriate for nroff or troff
.if n .ds D -
.if t .ds D \-
.SH NAME
seepath \- see status of each component of a path
.SH SYNOPSIS
.BR seepath " [ " \*Df|F " ] [ "
.\" ====================================================================
.\" 
.\" Usage:  seepath [-f|-F] [-h] [path]
.\" 
.\" 		-f	follow links that occur as the final component
.\" 			of the path only;
.\" 		-F	list out links in gory detail, ie, follow links
.\" 			that occur anywhere in the path; overrides -f;
.\" 		-h	print help message and exit;
.\" 		path	the file or path to analyze; default is current
.\" 			directory;
.\" 
.\" ====================================================================
.IR path " | " file " ]"
.br
.B seepath \*Dh
.\" ------------------------------------------------------------------------
.SH DESCRIPTION
.B seepath
is a tool for analyzing a UNIX path by showing status information
for each component of the path.
The status information is shown via the
.BR ls (1)
command with its
.B \*Dl
option.
.\" ------------------------------------------------------------------------
.SH OPTIONS
The following options are supported:
.TP 10
.B \*Df
Follow links that occur as the final component of the path only.
.TP
.B \*DF
List out links in gory detail; ie, follow links
that occur anywhere in the path.  Overrides
.BR \*Df .
.TP
.BR \*Dh
Help, just print an informational message and exit.
.\" ------------------------------------------------------------------------
.SH OPERANDS
The following operands are supported:
.TP 10
.IR file " or " path
The name of a file or directory, including any relative or direct path
to one of these.
When omitted, defaults to the current directory.
.\" ------------------------------------------------------------------------
.SH EXAMPLES
.TS
tab (;) ;
lp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1
lp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1 sp-0 1
lp-0 1 np-0 1 lp-0 1 lp-0 1 np-0 1 lp-0 1 np-0 1 np-0 1 lp-0 1 .
example% \fBseepath \*DF /usr/local/X\fR
seepath: /usr/local/X
drwxr\*Dxr\*Dx;25;root;root;512;Oct;25;14:39;/
drwxrwxr\*Dx;32;root;sys;1024;Feb;17;1997;usr/
lrwxrwxrwx;1;root;other;15;Feb;17;1997;local \*D> /auto/pkg/local/
drwxr\*Dxr\*Dx;25;root;root;512;Oct;25;14:39;/
dr\*Dxr\*Dxr\*Dx;2;root;root;5;Jan;7;16:35;auto/
drwxrwxr\*Dx;321;root;lab;16384;Jan;6;12:43;pkg/
drwxrwxr\*Dx;18;lab;lab;8192;Oct;29;04:05;local/
lrwxr\*Dxr\*Dx;1;lab;lab;9;Feb;14;1997;X \*D> ./X11R6.1/
drwxrwxr\*Dx;18;lab;lab;8192;Oct;29;04:05;./
drwxr\*Dxr\*Dx;6;lab;lab;8192;Feb;14;1997;X11R6.1/
.TE
.\" ------------------------------------------------------------------------
.SH DIAGNOSTICS
Returns \fB0\fR if no problems encountered.
.br
Returns \fBnon-zero\fR for any file or directory access errors.
.\" ------------------------------------------------------------------------
.SH "SEE ALSO"
.BR ls (1),
.BR sh (1),
.br
\*(lqToolMan:  Upcoming Tools; Analyzing Paths\*(rq,
\fI;login:\fR magazine (USENIX Association), February 1998.
.\" ------------------------------------------------------------------------
.SH BUGS
.PP
\fBseepath\fP uses paths exactly as given.  It makes no attempt to
shorten the path by removing components such as \*(lq..\*(rq.
.PP
\fBseepath\fP is a shell script, and makes a best guess at which flags
to use with the
.BR ls (1)
command.  This might fail on some systems.
.PP
\fBseepath\fP will sometimes produce its own diagnostic output in
addition to that produced by the external commands it employs.
.\" ------------------------------------------------------------------------
.SH AUTHOR
\fBseepath\fR was written at the Department
of Computer Science at Duke University, by Daniel E. Singer
(a.k.a. ToolMan).