Comando man

Comando man

El comando man (manual) es la herramienta integrada de documentación y ayuda en sistemas Unix y Linux. Permite consultar los manuales de referencia detallados de cualquier comando, utilidad, función de programación o archivo de configuración disponible en el sistema operativo, ofreciendo explicaciones exhaustivas sobre su sintaxis, opciones y comportamiento.

Categoría Ayuda y documentación
Disponible en Linux (man-db) / Unix / macOS
Equivalente en Windows help [comando] (CMD), Get-Help [comando] (PowerShell)
Sustituye a Antiguos sistemas de ayuda textual. Actualmente coexiste con herramientas modernas como tldr o info.
¿Requiere permisos de administrador? No, cualquier usuario del sistema puede consultar los manuales libremente.

¿Qué significa su nombre?

MAN procede directamente de la abreviatura en inglés de Manual (Manual de usuario).

Representa la enciclopedia oficial y tradicional del sistema operativo Unix, diseñada para proporcionar documentación técnica precisa y estandarizada directamente en la terminal sin necesidad de recurrir a fuentes externas o conexiones a internet.

¿Para qué sirve?

El comando man sirve para consultar la documentación oficial de cualquier orden o programa instalado en el equipo. Detalla de forma metódica qué hace un comando, qué parámetros o banderas acepta, cómo se combinan, ejemplos de uso y archivos relacionados.

Es el recurso de consulta indispensable para cualquier administrador de sistemas o desarrollador cuando necesita recordar la sintaxis exacta de una utilidad compleja o descubrir opciones avanzadas que rara vez se utilizan en el día a día.

Sintaxis

man [sección] [comando]

Las secciones tradicionales en las que se divide el manual de Linux son:

Sección Descripción
1 Programas ejecutables o comandos de la terminal (ej. man 1 ls).
5 Formatos de archivos de configuración y convenciones (ej. man 5 passwd).
8 Comandos de administración del sistema y demonios (ej. man 8 iptables).

Comandos más utilizados

Comando Descripción
man ls Muestra el manual completo de referencia del comando ls.
man -k [palabra] Busca comandos cuyas descripciones contengan una palabra clave específica (equivalente a apropos).
man 5 crontab Consulta el manual de un archivo de configuración específico en lugar de un comando.
man -f [comando] Muestra una descripción breve de una línea sobre el comando indicado.

Equivalencia con otros sistemas

Acción Linux antiguo Linux actual Windows
Ver ayuda de comando man [comando] man [comando] / [comando] --help help [comando] / Get-Help [comando]
Buscar comando por palabra man -k man -k / apropos Get-Help *palabra*
Ver ayuda rápida resumida [comando] -h [comando] --help [comando] /?

Ejemplos

Consultar el manual detallado del comando grep

man grep

Buscar comandos relacionados con una palabra clave (ej. red)

man -k network

Consultar el manual de un archivo de configuración (sección 5)

man 5 hosts

Ejemplo de salida

GREP(1)                  General Commands Manual                 GREP(1)

NAME
       grep, egrep, fgrep - print lines matching a pattern

SYNOPSIS
       grep [OPTIONS] PATTERN [FILE...]

DESCRIPTION
       grep searches for PATTERNS in each file.  ...

¿Cómo interpretar la salida?

  • GREP(1): nombre del comando y sección del manual entre paréntesis (en este caso, sección 1 de comandos de usuario).
  • NAME: nombre y breve resumen funcional de la utilidad.
  • SYNOPSIS: resumen de la sintaxis y estructura de argumentos aceptados.
  • DESCRIPTION: explicación detallada del funcionamiento, lógica y comportamiento del programa.

Atajos de navegación dentro de man

  • Barra espaciadora o AvPág: avanzar una página hacia abajo.
  • Tecla B o RePág: retroceder una página hacia arriba.
  • Barra diagonal (/) seguido de texto: buscar una palabra específica dentro del manual.
  • Tecla N: saltar a la siguiente coincidencia de la búsqueda.
  • Tecla Q: salir del manual y regresar a la terminal (quit).

Errores habituales

  • Intentar salir del manual pulsando la tecla Enter o combinaciones como Ctrl + C, cuando la forma correcta de cerrar la interfaz de lectura es pulsando la tecla q.
  • Desconocimiento de que un comando puede tener múltiples entradas en distintas secciones (por ejemplo, un comando de usuario y una llamada al sistema con el mismo nombre).

Conceptos relacionados

  • Paginador (Less)
  • Páginas de manual (Manpages)
  • Secciones del manual
  • Ayuda integrada
  • Documentación técnica

Comandos relacionados

    info
    apropos
    whatis
    tldr
    help

Curiosidades

Las páginas de manual (manpages) son tan respetadas en la cultura Unix que existe una gran comunidad de entusiastas dedicados a mejorarlas. Incluso existe una variante moderna llamada tldr (Too Long; Didn't Read) que prescinde de los manuales mastodónticos de man para ofrecer únicamente ejemplos prácticos y directos de los comandos más habituales.

Prácticas propuestas

  1. Ejecuta el comando man man para leer la página de manual del propio comando de ayuda y descubrir opciones adicionales.
  2. Consulta el manual del comando ls y practica la navegación hacia abajo utilizando la barra espaciadora y saliendo con la tecla q.
  3. Utiliza la función de búsqueda interna dentro del manual de grep pulsando / y escribiendo una palabra clave (ej. recursive) para localizarla rápidamente.
  4. Prueba a utilizar la opción man -k combinada con un término genérico (como compression) para listar comandos orientados a comprimir archivos.
  5. Comprueba la descripción rápida de una línea de un comando utilizando la opción man -f [comando] (o su equivalente directo whatis).
  6. Si dispones de un entorno Windows, compara la profundidad de la documentación de man ejecutando el comando Get-Help Get-Process -Detailed en PowerShell.

Consejo: Acostúmbrate a consultar man antes de buscar tutoriales en internet; contiene la información técnica más precisa, actualizada y adaptada exactamente a la versión de los programas instalados en tu sistema.