Quick take: The man command opens the manual page for a command: man ls. Inside, scroll with the arrows or Space, search with /term, and quit with q. It is the authoritative, offline help for almost every command.
Introduction
The man command (manual) is the built-in, offline documentation system of Linux. Almost every command, configuration file, and system call has a man page describing its options and behaviour in detail. Learning to read man pages makes you self-sufficient — the answer is usually one man away.
This guide covers opening and navigating man pages, searching within and across them, and understanding the numbered manual sections.
Syntax
The basic syntax of the man command is:
man [SECTION] PAGEUnderstanding Manual Sections
Man pages are grouped into numbered sections, and the same name can appear in several. The common ones are:
| Section | Contents |
|---|---|
| 1 | User commands (ls, grep, ssh) |
| 5 | File formats and configuration (crontab, fstab) |
| 8 | System administration commands (mount, systemctl) |
That is why man crontab shows the command but man 5 crontab shows the file format. If unsure which sections exist, run man -f name.
Common Options and Parameters
The most useful options and parameters for the man command:
| Option | Description |
|---|---|
| man cmd | Open the manual page for a command. |
| /term | Search forward within the page (n for next match). |
| q | Quit the manual viewer. |
| Space / b | Page down / page up. |
| man -k word | Search page descriptions by keyword (apropos). |
| man -f cmd | Show a one-line description (whatis). |
| man N cmd | Open the page from a specific section, e.g. man 5 crontab. |
| man man | Read the manual about man itself. |
Practical Examples
Real man commands you can run today:
# Open the manual for a command
man ls
# Open a specific section (5 = file formats)
man 5 crontab
# Search page descriptions by keyword
man -k 'copy files'
# Show a one-line summary
man -f grep
# Inside a page: search for the -r option
/ -rBeyond man: help, --help, and tldr
man pages are thorough but dense, and they do not cover everything. Three companions fill the gaps:
- --help — almost every command prints a concise option summary with
command --help, faster than opening the full manual. - help — shell built-ins like
cd,export, andaliashave no man page; usehelp cdinstead. - tldr — the community tldr pages show a handful of real-world examples for a command, which is often exactly what you need. Install it with your package manager, then run
tldr tar.
A good habit is to skim --help for a quick reminder, open man when you need the complete reference, and check tldr when you just want a working example to copy.
Tips and Best Practices
- Inside a man page, type
/then your term to jump straight to an option instead of scrolling. - Use
man -k keyword(apropos) when you do not know the command name — it searches descriptions. - For a quick, example-led alternative, install
tldr; man pages are complete but dense.
Final Thoughts
The man command is the single most empowering tool in Linux — it makes you independent of search engines for command help. Learn to open pages, search within them with /, and pick the right section, and every command on the system documents itself. When man feels too dense, man -k and the community tldr pages fill the gap.
FAQ: man Command in Linux
How do I read the manual for a command?+
Run man followed by the command name, for example man ls. Scroll with the arrow keys or Space, and press q to quit.
How do I search inside a man page?+
Type / followed by your search term and press Enter, then press n to jump to the next match. Press q to exit when done.
What do the section numbers in man mean?+
They group pages by type: section 1 is user commands, 5 is file formats and configuration, and 8 is system administration. man 5 crontab shows the file format while man crontab shows the command.
How do I find a command when I only know what it does?+
Use man -k keyword (also called apropos) to search the one-line descriptions of all man pages, for example man -k 'list directory'.
What if a command has no man page?+
Many shell built-ins use help name instead (for example help cd), and many tools support --help for a quick summary. The tldr project also offers concise, example-based pages.
Need help with Linux servers or infrastructure?
Work directly with Muhammad Irfan Aslam for Linux, Ubuntu, Docker, DevOps, cloud, CI/CD, or infrastructure support.
Hire Me for Support