man

man

The man command in Unix and Linux stands for "manual" and is used to display the user manual of any command that we can run on the terminal. It provides detailed information about the command, including its options, syntax, description, and examples. This is an essential tool for users who need to understand how to use various commands.

Basic Usage

The syntax for the man command is:

man [command]

Examples

Displaying the Manual for a Command

To view the manual for a specific command, simply type man followed by the command name:

man ls

This will open the manual page for the ls command.

Navigating the Manual Pages

  • Space: Move to the next page.

  • b: Move to the previous page.

  • q: Quit the manual page viewer.

  • /search_term: Search for a term within the manual page.

  • n: Move to the next occurrence of the search term.

  • N: Move to the previous occurrence of the search term.

  • h: Display help about navigation commands.

Sections of the Manual

The manual pages are divided into several sections. Each section contains a specific type of information:

  1. General Commands: User commands (e.g., ls, cd).

  2. System Calls: Functions provided by the kernel (e.g., fork, exec).

  3. Library Functions: Functions provided by the system libraries (e.g., printf, malloc).

  4. Special Files: Files found in /dev (e.g., null, zero).

  5. File Formats and Conventions: (e.g., /etc/passwd, /etc/fstab).

  6. Games: (e.g., fortune).

  7. Miscellaneous: (e.g., man, info).

  8. System Administration Tools: (e.g., systemctl, journalctl).

  9. Kernel Routines: (e.g., kernel functions).

Viewing a Specific Section

To view the manual for a specific section, provide the section number before the command:

This will display the manual page for the passwd file format, not the passwd command.

Practical Use Cases

Learning Command Usage

If you're unsure how to use a command or what options it supports, you can read its manual page:

This will show you how to use grep, including its options and examples.

Understanding Configuration Files

Manual pages are also available for many configuration files, providing detailed descriptions of the file's syntax and usage:

This will display information about the /etc/fstab file format.

Debugging Scripts

When writing scripts, you can use the man command to check the exact syntax and options of commands you are using:

This ensures you use the correct options and understand the command's behavior.

Advanced Options

The man command has several options that can enhance its usage:

  • -k: Search the manual page names and descriptions (apropos command).

  • -f: Equivalent to whatis, it displays a brief description of the command.

  • -a: Display all manual pages matching the command name, one after another.

  • -P: Specify the pager program to use.

Searching for a Term

To search for a term across all manual pages:

For example, to find all commands related to "network":

Displaying a Brief Description

To display a brief description of a command:

This might output:

Conclusion

The man command is an indispensable tool for any Unix or Linux user. It provides comprehensive documentation for commands, system calls, library functions, configuration files, and more. By mastering the man command, you can gain a deeper understanding of the system, troubleshoot issues effectively, and use commands more efficiently. Whether you're a beginner or an experienced user, the manual pages are a valuable resource for learning and reference. If you have any further questions or need assistance with anything else, feel free to ask!

help

man

PreviousmakemapNextmanpath

Last updated