ls.1

.\" Copyright (c) 2001-2003 The Open Group, All Rights Reserved 
.TH "LS" 1P 2003 "IEEE/The Open Group" "POSIX Programmer's Manual"
.\" ls 
.SH PROLOG
This manual page is part of the POSIX Programmer's Manual.
The Linux implementation of this interface may differ (consult
the corresponding Linux manual page for details of Linux behavior),
or the interface may not be implemented on Linux.
.SH NAME
ls \- list directory contents
.SH SYNOPSIS
.LP
\fBls\fP \fB[\fP\fB-CFRacdilqrtu1\fP\fB][\fP\fB-H | -L\fP
\fB][\fP\fB-fgmnopsx\fP\fB][\fP\fIfile\fP\fB...\fP\fB]\fP
.SH DESCRIPTION
.LP
For each operand that names a file of a type other than directory
or symbolic link to a directory, \fIls\fP shall write the
name of the file as well as any requested, associated information.
For each operand that names a file of type directory, \fIls\fP
shall write the names of files contained within the directory as well
as any requested, associated information. If one of the
\fB-d\fP, \fB-F\fP, or \fB-l\fP options are specified, and one of
the \fB-H\fP or \fB-L\fP options are not specified, for each
operand that names a file of type symbolic link to a directory, \fIls\fP
shall write the name of the file as well as any
requested, associated information. If none of the \fB-d\fP, \fB-F\fP,
or \fB-l\fP options are specified, or the \fB-H\fP or
\fB-L\fP options are specified, for each operand that names a file
of type symbolic link to a directory, \fIls\fP shall write the
names of files contained within the directory as well as any requested,
associated information.