02 Man Pages

Man Pages

Tabla de Contenidos

• Qué es un Man Page
• Cómo Visualizar los Man Pages
• Secciones dentro de un Man Page
  • NAME
  • SYNOPSIS
  • DESCRIPTION
  • OPTIONS
  • FILES
  • AUTHOR
  • REPORTING BUGS
  • COPYRIGHT
  • SEE ALSO
• Organización de Man Pages por Secciones
• Referencias

Qué es un Man Page

Los manual pages o simplemente man pages ―introducidos por UNIX ― son manuales de comandos. Estos man pages son usados para describir la funcionalidad de un comando. Proveen una descripción básica de un comando, su propósito, detalles, opciones disponibles, etc.

Note

Los man pages son almacenados comúnmente en el directorio /usr/share/man, o en sistemas Unix-like viejos en el directorio /usr/share/man.

Cómo Visualizar los Man Pages

Para mostrar el man page de un comando se utiliza el comando man de la siguiente manera:

man comando

Por ejemplo:

man rm

Important

el comando man utiliza el comando less para mostrar los man pages. Si no sabes cómo navegar a través less, puedes presionar la tecla h para mostrar información de ayuda.

Secciones dentro de un Man Page

Tip

Para más información, puedes ejecutar el comando man 7 man-pages.

Las secciones dentro de un man page pueden cambiar según el comando, sin embargo, por lo general, los man pages suelen compartir las siguientes secciones:

• NAME
• SYNOPSIS
• DESCRIPTION
• OPTIONS
• FILES
• AUTHOR
• REPORTING BUGS
• COPYRIGHT
• SEE ALSO

Note

Todos los ejemplos mostrados son respecto al man page del comando rm, a excepción del ejemplo de la sección FILES, el cual pertenece al man page del comando passwd.

NAME

Muestra el nombre del comando y una breve descripción.

NAME
     rm - remove files or directories

SYNOPSIS

Provee ejemplos de cómo ejecutar el comando. Las opciones y argumentos que se encuentran dentro de corchetes [], son opcionales, en caso contrario, significa que son obligatorias.

SYNOPSIS
     rm [OPTION]... [FILE]...

DESCRIPTION

Provee una descripción más detallada sobre el comando.

DESCRIPTION
     This manual page documents the GNU version of rm.  rm removes each
     specified file.  By default, it does not remove directories.
     ...

OPTIONS

Muestra las opciones disponibles para el comando; asimismo muestra una breve una descripción de estos. Por lo general, esta información se encuentra en la sección de DESCRIPTION, en lugar de una sección OPTIONS a parte.

OPTIONS
     Remove (unlink) the FILE(s).

     -f, --force
            ignore nonexistent files and arguments, never prompt

     -i     prompt before every removal
    ...

FILES

Lista los archivos relacionados con el comando, tal como archivos de configuración del comando o del sistema; asimismo muestra una breve descripción de estos. Por lo general, esta información se encuentra en la sección de DESCRIPTION, en lugar de una sección FILES a parte.

FILES
     /etc/passwd
         User account information.

     /etc/shadow
         Secure user account information.

     /etc/pam.d/passwd
         PAM configuration for passwd.

AUTHOR

Provee el nombre de los autores del man page y, algunas veces, cómo contactarlos.

AUTHOR
     Written by Paul Rubin, David MacKenzie, Richard M. Stallman, and Jim
     Meyering.

REPORTING BUGS

Provee detalles de cómo reportar problemas con el comando.

REPORTING BUGS
     GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
     Report any translation bugs to <https://translationproject.org/team/>

COPYRIGHT

Provee información básica del copyright.

COPYRIGHT
     Copyright © 2025 Free Software Foundation, Inc.  License GPLv3+: GNU
     GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
     This is free software: you are free to change and redistribute it.
     There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

Provee información acerca de dónde puedes buscar información adicional o relacionada al comando, como comandos relacionados.

SEE ALSO
     unlink(1), unlink(2), chattr(1), shred(1)

     Full documentation <https://www.gnu.org/software/coreutils/rm>
     or available locally via: info '(coreutils) rm invocation'

Organización de Man Pages por Secciones

Tip

Para más información, puedes ejecutar el comando man 7 man-pages.

Existen diferentes tipos de man pages organizados por secciones. Los man pages mostrados previamente son comandos generales (o comandos de usuario), pertenecientes a la sección 1. Existen varias secciones, tal como se muestra en la tabla siguiente:

Sección	Contenidos
1	Comandos generales (herramientas y utilidades)
2	Llamadas del sistema y números de error
3	Funciones de librerías de C
3p	Guía de referencia de programadores de perl(1)
4	Archivos especiales, tal como dispositivos, nodos y drivers
5	Formatos de archivos
6	Juegos
7	Varios (Miscellaneous)
8	Comandos de administración del sistema
9	Rutinas del Kernel

Tip

Al buscar un man page podemos especificar una sección específica (útil cuando el mismo nombre aparece en varias secciones). Por ejemplo:

man 5 passwd

Referencias

• GoalKicker (s.f.). Section 1.4: Basic Linux Utilities. Linux Notes for Professionals (pp. 4-5). https://goalkicker.com/LinuxBook

• Shotts, W. (2019). Working With Commands. The Linux Command Line (2nd ed., pp. 39-48). No Starch Press.

• NetDevGroup (s.f.). Getting Help. https://portal.netdevgroup.com/learn/fb477d77-7adb-4d85-8db3-72f500f60315/eng5GheM93/?xid=eyJpZCI6Imx0aTFwMy1sYXVuY2gtZjhiZDFmNTgtNzM4NS00ZmJjLTk2YTgtODc0NmEwMDY3YmVlIiwiY29udGV4dF9pZCI6ImZiNDc3ZDc3LTdhZGItNGQ4NS04ZGIzLTcyZjUwMGY2MDMxNSIsInJvbGUiOiJTIiwidXNlcl9pZCI6IjZiYzBiM2NkYmY1MDRhMTViZDU1NTUyODcwNGFkMjgyIn0:1udtAB:pzr7aYnkXVrQFxh5MvDGcR_NUXal2ev8SHzx_WkO3H8