Tutorials : The Linux man pages

 

The Linux man pages (short for "manual pages") are the built-in, definitive documentation system for Linux and Unix-like operating systems. Think of them as the ultimate, offline cheat sheet for every command, system call, and configuration file on your system.

 

Here is a quick guide on how to navigate, read, and master them.

How to Read a Man Page

To open a manual page, you just use the man command followed by the command you want to learn about:

Bash

man ls

Once inside a man page, the layout generally follows a standardized structure to help you find information quickly:

• NAME: The name of the command and a one-line summary of what it does.

• SYNOPSIS: The syntax guide. It shows exactly how to structure the command, including required arguments and optional flags.

• DESCRIPTION: A detailed explanation of what the tool does.

• OPTIONS: An alphabetical list of all the flags/options you can use (e.g., -l, --help) and how they alter the command's behavior.

• EXAMPLES: Practical use cases (sadly, not all man pages have this, but it's gold when they do).

• SEE ALSO: Related commands or files you might find useful.

The 8 Standard Manual Sections

The manual is divided into numbered sections. This prevents confusion when a command and a concept share the same name (for example, passwd is both a command you run and a file in /etc/).

Section	Content Type	Examples
1	User Commands	ls, cd, grep, mkdir
2	System Calls	Kernel functions like open(), fork()
3	C Library Functions	Standard C library functions like printf()
4	Special Files	Device drivers and files in /dev
5	File Formats	Configurations like /etc/passwd or /etc/fstab
6	Games	Text-based games and screensavers
7	Miscellanea	Overviews of concepts, protocols (e.g., man 7 ip)
8	System Administration	Commands usually reserved for root (e.g., iptables, reboot)

Pro-Tip: If you want to look up a specific section, put the number before the command. For example, man passwd opens the section 1 user command, but man 5 passwd opens the configuration file explanation.

Navigating the Interface

Man pages open using a terminal pager (usually less). You can move around using these basic keyboard shortcuts:

• Arrow Keys / Page Up / Page Down: Scroll line by line or page by page.

• Spacebar: Move down one full screen.

• / followed by a keyword: Search for a specific word down the page (Press n to find the next occurrence, N for the previous).

• q: Quit and return to your terminal prompt.

Finding the Right Page When You're Lost

If you can't remember the exact name of a command, you can search the man pages using keywords:

• man -k <keyword> (or the shortcut command apropos <keyword>): Searches the short descriptions of every man page and returns a list of matching commands.

  • Example: apropos "copy files" will point you directly to cp.