.. index:: ls
.. _ls:

Directory Contents (ls)
--------------------------

:t:`Linux for Programmers and Users`, Section 3.14

.. program:: ls 
.. describe:: ls

    List directory contents

SYNOPSIS
   :command:`ls` [OPTION]... [FILE] ...


.. cmdoption:: -a, --all

    show hidden files that begin with a period

.. cmdoption:: -d, --directory

    list directory entries instead of contents

.. cmdoption:: -l

    long listing -- details described later

.. cmdoption:: -F, --classify

    append indicator (one of \*/=>@\|) to entries

.. cmdoption:: -i, --inode

    print the index (inode) number of each file

.. cmdoption:: -t

    sort by modification time

.. cmdoption:: -1

    print in one column instead of multiple

.. figure:: ls-l_fields.png
   :align: center

   Meaning of fileds in output of ``ls -l``