// .\" @(#)enum-dir.1 9.99 95/02/11 DCC;
// .TH enum-dir 1 "11 february 1995"
// .SH NAME
// enum-dir \- enumerates directory entries
// .SH SYNOPSIS
// .B enum-dir [\-type 
// .IR fdleo]
// [\-showType] [\-followLinks] [
// .IR dirpath]
// .SH DESCRIPTION
// .IX  enum-dir
// .LP
// .B enum-dir
// prints out the names of selected entries of the directory
// .IR dirpath,
// which defaults to the current directory.
// .LP
// The names are printed one per line.
// .SH OPTIONS
// .TP
// .BI \-type " typecodes"
// Prints only entries of the specified types:
// .LP
// .RS 7
// .PD 0
// .TP 4
// \f4f\f1
// regular files;
// .TP
// \f4d\f1
// directories (except 
// \f1`\f4\&.\f1'
// and
// \f1`\f4\&.\&.\f1')
// .TP
// \f4l\f1
// symbolic links;
// .TP
// \f4e\f1
// errors (entries that can't be stat'ed);
// .TP
// \f4o\f1
// other entries (
// \f1`\f4\&.\f1'
// and
// \f1`\f4\&.\&.\f1',
// special files, pipes, etc.).
// .PD
// .RE
// .IP
// The default is to print all entries. 
// .IP       
// The type is determined by calling
// .BR lstat (2)
// on the entry.  If the call fails, then (and only then)
// the type is 
// \f1`\f4e\f1'.
// .TP
// .B \-showType
// Precedes each entry with its type code, according to the table above, 
// and a single space.
// .TP
// .B \-followLinks
// If given, the entry type is determined with 
// .BR stat (2) 
// instead of 
// .BR lstat (2).  
// .IP
// The net effect is that the type of symbolic link entries will
// be the type of their ultimate targets, rather than 
// \f1`\f4l\f1'.
// In
// particular, if that target does not exist, or is unreachable,
// the entry type will be
// \f1`\f4e\f1'.
// .SH SEE ALSO
// The world ouside.
// .SH AUTHOR
// J. Stolfi, DCC/Unicamp, February 1995.
// .\"	@(#)enum-dir.1
// .\".Ee