ls Command in Linux: List Files and Directories

When working in a Linux terminal, you will often need to check what a directory contains or inspect a file’s permissions and ownership. The ls command handles these everyday tasks and can also show hidden files, sort entries, and display directory trees.

This guide explains how to use the ls command with practical examples, including the options you will use most often in daily work.

How to Use the ls Command #

The syntax for the ls command is as follows:

ls [OPTIONS] [FILES]

When used without options or arguments, ls displays a list of the names of all non-hidden files in the current working directory , formatted into columns:

ls

The files are sorted by name and shown in as many columns as can fit across your terminal:

cache  db  empty  games  lib  local  lock  log  mail  opt  run  spool  tmp

To list files in a specific directory, pass the directory path as an argument. For example, the following command lists the contents of /etc:

ls /etc

You can also pass multiple directories and files separated by spaces:

ls /etc /var /etc/passwd

If the user you are logged in with does not have read permissions to the directory, you will get a message saying that ls cannot open the directory:

ls /root

ls: cannot open directory '/root': Permission denied

The sections below explain the options you will use most often.

Understanding ls -al and Long Format #

The default output shows only file and directory names. Use -l (lowercase L) when you also need permissions, ownership, size, and modification time:

ls -l /etc/hosts

-rw-r--r-- 1 root root 337 Oct  4 11:31 /etc/hosts

The output contains the file type and permissions, hard link count, owner, group, size, modification time, and file name.

The first character identifies the file type. In this example, - indicates a regular file. Common values are:

• - - Regular file.
• b - Block special file.
• c - Character special file.
• d - Directory.
• l - Symbolic link.
• p - FIFO or named pipe.
• s - Socket.

The next nine characters show permissions for the owner, group, and others. Each set normally uses the following characters:

• r - Permission to read the file.
• w - Permission to write to the file.
• x - Permission to execute the file.
• - - The permission is not granted.

An s or S in an execute position indicates a set-user-ID or set-group-ID bit. A t or T in the final position indicates the sticky bit. See the chmod command guide for a full explanation of these special permissions.

In the example, rw-r--r-- means that the owner can read and write the file, while the group and others can only read it. The number 1 is the hard link count. The two root fields are the owner and group, followed by the file size in bytes.

Add -h to display larger sizes with units such as K, M, and G:

ls -lh /usr/bin/bash

-rwxr-xr-x 1 root root 1.3M Mar 31  2024 /usr/bin/bash

The exact size and date depend on your system. You can change file ownership with the chown command.

The frequently searched ls -al command combines -a and -l, showing hidden entries in long format:

ls -al

Short options can appear in either order, so ls -al and ls -la produce the same listing.

Show Hidden Files with -a and -A #

By default, the ls command will not show hidden files. In Linux, a hidden file is any file that begins with a dot (.).

To display all files, including hidden files, use -a. Here we combine it with -l so the hidden entries also show their permissions and ownership:

ls -la ~/

drwxr-x--- 10 linuxize  linuxize  4096 Feb 12 16:28 .
drwxr-xr-x 18 linuxize  linuxize  4096 Dec 26 09:21 ..
-rw-------  1 linuxize  linuxize  1630 Nov 18  2017 .bash_history
drwxr-xr-x  2 linuxize  linuxize  4096 Jul 20  2018  bin
drwxr-xr-x  2 linuxize  linuxize  4096 Jul 20  2018  Desktop
drwxr-xr-x  4 linuxize  linuxize  4096 Dec 12  2017 .npm
drwx------  2 linuxize  linuxize  4096 Mar  4  2018 .ssh

The output includes . for the current directory and .. for its parent. To show hidden files without these two entries, use -A:

ls -lA ~/

List Directory Information (-d) #

By default, ls lists the contents of a directory. To show information about the directory itself rather than its contents, use the -d option.

This is most useful when combined with -l to inspect a directory’s permissions without seeing everything inside it:

ls -ld /var/www

drwxr-xr-x 4 root root 4096 Jan 12 10:42 /var/www

Append Type Indicators (-F) #

The -F option appends a character to each entry that indicates its type:

• / - Directory.
• * - Executable file.
• @ - Symbolic link.
• | - FIFO.
• = - Socket.

To show all entries with type indicators:

ls -F /usr/bin

bash*  cat*  chmod*  ls*  mkdir*  python3@  ...

This makes it easy to distinguish directories from executables at a glance without using the full long format.

Sort ls Output #

By default, ls sorts entries alphabetically by name according to the current locale. You can request name sorting explicitly with --sort=name:

ls --sort=name

Use -r to reverse the current order:

ls -r

If you need a predictable byte-by-byte order instead of locale-aware sorting, set LC_ALL to C for the command:

LC_ALL=C ls

The --sort option also supports extension, size, time, and version sorting:

• --sort=extension (or -X) - Sort alphabetically by extension.
• --sort=size (or -S) - Sort by file size, largest first.
• --sort=time (or -t) - Sort by modification time, newest first.
• --sort=version (or -v) - Sort version numbers naturally.

For example, the following command sorts /var by modification time and reverses the result, placing the oldest entries first:

ls -ltr /var

The size shown for a directory entry is not the total size of its contents. To get the size of a directory , use du.

A practical example would be to find recently modified config files:

ls -lt /etc/*.conf | head

List Subdirectories Recursively (-R) #

The -R option tells the ls command to display the contents of the subdirectories recursively:

ls -R

Combine recursion with long format and hidden files:

ls -lRa ~/Projects

Show One Entry Per Line #

The -1 option forces one entry per line, which makes interactive output easier to scan:

ls -1 /etc

Do not parse ls output in scripts because file names can contain spaces, newlines, and other special characters. To process arbitrary file names safely, use null-delimited output from find with xargs -0 . For example, this command runs file on each regular file in the current directory:

find . -maxdepth 1 -type f -print0 | xargs -0 -r file

Common ls Command Examples #

Short options can be combined after a single dash. The following examples cover the combinations you are most likely to need.

Show hidden files in long format with human-readable sizes:

ls -lah

Sort all entries by modification time, with the newest entries first:

ls -lat

Reverse time sorting to show the oldest entries first:

ls -latr

Sort entries by size, with the largest files first and readable size units:

ls -lhS

List a directory tree recursively in long format:

ls -lR /var/log

Use a shell glob to list only names matching a pattern, such as text files:

ls -l *.txt

Quick Reference #

For a printable quick reference, see the ls cheatsheet .

FAQ #

What does ls -al mean in Linux?
ls -al combines -a and -l. It displays hidden files, including . and .., in long format with permissions, ownership, size, and modification time.

What is the difference between ls -a and ls -A?
ls -a shows all entries, including . and ... ls -A shows hidden files but omits those two special directory entries.

How do I list files sorted by date, newest first?
Use ls -lt. Add -r to reverse the order and show oldest first: ls -ltr.

How do I sort ls output alphabetically by name?
Plain ls sorts by name according to your locale. Use ls --sort=name to request name sorting explicitly, or LC_ALL=C ls when you need predictable byte-by-byte ordering.

Conclusion #

The ls command is one of the most frequently used commands in Linux, and knowing its options well saves time every day. Pair it with find for searching and filtering, or with chmod when reviewing and adjusting file permissions.

About the authors

Dejan Panovski

Dejan Panovski is the founder of Linuxize, an RHCSA-certified Linux system administrator and DevOps engineer based in Skopje, Macedonia. Author of 800+ Linux tutorials with 20+ years of experience turning complex Linux tasks into clear, reliable guides.

View author page