Linux command: ls

If you use Linux, you use ls. It is one of the first commands every new user learns, and one of the last commands an experienced administrator gives up. You type it on your laptop, on a web server over SSH, and inside a tiny rescue shell when something has gone wrong.

2. Where the Name Comes From

The name ls is short for list, as in "list directory contents".

ls  =  LiSt

Why drop the vowels? Early Unix was typed on slow teletype terminals, where every keystroke was printed onto paper one character at a time. Short commands saved time and ink. This is also why so many core commands are two letters: cp (copy), mv (move), rm (remove), cd (change directory), and ls (list). Short names were simply the house style.

That habit has lasted for fifty years. Once a command name is in everybody's muscle memory, there is no good reason to make it longer. So ls stays ls.

4. Simple Use Cases

4.1 The Simplest Possible Use

Type ls with nothing after it. It lists the current directory. In the examples below, the line that starts with $ is what you type, and the lines under it are what the system prints back.

$ ls
Documents  Downloads  Music  Pictures  notes.txt  todo.md

Three things happen by default:

• Entries are sorted alphabetically.
• They are arranged in columns to fit the width of your terminal.
• Hidden files are not shown (more on those in a moment).

4.2 Pointing ls at a Path

You can tell ls exactly what to look at, instead of the current directory:

$ ls /etc                 # a specific directory by absolute path
$ ls Documents            # a subfolder by relative path
$ ls notes.txt            # confirm a single file exists
$ ls Documents Downloads  # several things at once

This gives you a quick test. If ls shows the name, the file exists and you are allowed to read the directory. If it returns an error, you either have the wrong path or you do not have permission.

4.3 Seeing Hidden Files: -a

Files whose names begin with a dot (.) are "hidden" by convention. They are usually configuration files you do not need to see every day. The -a flag (short for all) reveals them:

$ ls -a
.   ..   .bashrc   .config   .ssh   Documents   notes.txt

A leading dot is just a naming convention that ls honours; there is nothing magic about the file itself. If the two extra entries . and .. get in your way, use -A ("almost all"), which shows hidden files but hides . and ...

4.4 The Long Format: -l

This is the flag you will use most. The -l flag (short for long) shows one file per line, with full details:

$ ls -l
drwxr-xr-x  2 peter staff  4096 Jun  1 09:14 Documents
-rw-r--r--  1 peter staff  1234 May 28 17:02 notes.txt

Each column has a fixed meaning. Read them from left to right:

ls -l is the difference between "what is here?" and "tell me everything about what is here".

6. Advanced Use Cases

6.1 Reading the Permission String

The first column of ls -l packs a lot of information into ten characters. Read it in four chunks:

 -    rwx    r-x    r--
 |     |      |      |
type owner  group  others

The first character is the file type. The next nine are three groups of rwx (read, write, execute) for the owner, the group, and everyone else. A dash means the permission is absent. So rwxr-xr-- reads as: the owner can do everything, the group can read and run, and others can only read.

The very first character tells you what kind of thing each entry is:

You can see the rarer types in the /dev directory:

$ ls -l /dev | head
crw-rw-rw-  1 root root 1, 3 Jun  2 08:00 null
brw-rw----  1 root disk 8, 0 Jun  2 08:00 sda

Running this once makes the Unix idea that "everything is a file" suddenly click.

6.2 Recursive Listing: -R

The -R flag (short for recursive) walks into every subdirectory and lists it too:

$ ls -R Documents
Documents:
invoices  letters  notes.txt

Documents/invoices:
2025.pdf  2026.pdf

Documents/letters:
draft.md

Be careful: ls -R / tries to list your entire filesystem. Always pair -R with a path you actually mean. For real searching, find is the better tool.

6.3 Globbing: The Shell Does the Matching

When you type ls *.txt, it is the shell, not ls, that expands *.txt into a list of matching names before ls ever runs.

$ ls *.txt           # all .txt files in this directory
$ ls Doc*            # anything starting with "Doc"
$ ls report-?.md     # ? matches exactly one character
$ ls *.{jpg,png}     # brace expansion: jpg AND png

The command ls itself has no idea what * means. That is why ls *.txt reports "No such file" when nothing matches: there was simply nothing for the shell to hand to ls.

6.4 Piping ls Into Other Tools

Because ls just prints text, it composes neatly with the rest of the Unix toolbox. This is where everyday administration work happens:

$ ls | wc -l                 # count the items in a directory
$ ls -lt | head              # the 10 most recently changed
$ ls -lhS | head             # the biggest files
$ ls -1 | grep -i invoice    # filter the listing

One warning: parsing ls output inside scripts is fragile, because filenames can contain spaces and even newlines. For scripting, prefer shell globs (for f in *.txt) or find -print0. For interactive use at the keyboard, piping ls is perfectly fine.

6.5 The Aliases Everyone Makes

Almost every Linux user defines a few shortcuts in ~/.bashrc:

alias ll='ls -lh'
alias la='ls -lah'
alias l='ls -CF'

After that, typing ll gives you the long, human-readable listing without thinking. You can check what an alias does with type ll. To run the real, unaliased command (for example to get clean output for a pipe), put a backslash in front of it or use command:

$ alias ls                 # often: alias ls='ls --color=auto'
$ \ls                      # run the real ls, ignoring the alias
$ command ls               # the same, more explicitly

8. Best Practices

• Look before you act. Run ls before you copy, move, or delete. It is read-only and cannot hurt anything, so use it freely to confirm you are in the right place.
• Learn two combinations by heart. Internalise ls -lah (everything, with readable sizes) and ls -ltr (oldest to newest, newest at the bottom). Together they cover the vast majority of daily needs.
• Use -d */ to list folders only when a directory is crowded with files.
• Do not parse ls in scripts. For automation, use shell globs (for f in *.log) or find -print0. Save ls for interactive use.
• Reach for the manual without hesitation. The habit that separates beginners from professionals is not memorising every flag; it is typing man ls the moment a question comes up.

$ man ls                            # the full manual page
$ ls --help                         # a quick flag summary (GNU)
$ info coreutils 'ls invocation'    # the verbose GNU manual

10. Summary

The ls command looks tiny, but it is a complete window into how Linux works.

• ls means "list". It dates back to Unix in 1971, with roots in Multics before that, and runs on every Unix-like system today.
• It is read-only and safe, which makes it the perfect command to explore an unfamiliar system with.
• -a reveals hidden files, -l gives the long format, and -h makes sizes readable. ls -lah combines all three.
• The long format's first column encodes the file type and permissions, for example drwxr-xr-x.
• Sort with -t (time), -S (size), and -r (reverse). The combination ls -ltr is the everyday classic.
• Go deeper with -R (recursive), -i (inodes, which explain hard links), -d (the directory itself), and the -u / -c alternate times.
• Globbing such as ls *.txt is done by the shell, not by ls. And ls composes cleanly with wc, head, and grep.
• Know where ls stops: find for searching, stat for one file, and tree for a tree view.
• When in doubt, type man ls.

This is the quick reference worth keeping:

ls           show what is here
ls -a        include hidden files
ls -lh       details with readable sizes
ls -lah      all of the above at once
ls -ltr      oldest to newest (newest at the bottom)
ls -lhS      biggest files first
ls -ld */    only the directories, themselves
ls -li       with inode numbers (and spot hard links)
ls -R DIR    recursively, into every subfolder