Obtener ayuda sobre los comandos de Linux

Introducción

Los usuarios experimentados de Linux no memorizan cada comando ni todas sus opciones. Saben cómo preguntarle al sistema qué significa un nombre, encontrar un resumen breve de uso, abrir la documentación completa y buscar en los manuales por tema.

Este laboratorio continúa directamente con las operaciones básicas de archivos. Investigarás comandos conocidos como cd, ls y cp, y después guardarás pequeños archivos de evidencia en /home/labex/project/command-help. Al finalizar, una sintaxis desconocida será una cuestión de documentación, no un obstáculo.

Identificar qué significa un nombre de comando

En este paso, distinguirás entre funciones integradas del shell, alias y archivos ejecutables antes de elegir la fuente de ayuda adecuada.

Accede al espacio de trabajo del laboratorio:

cd /home/labex/project/command-help

Algunos comandos están integrados en el shell porque necesitan modificar el propio shell. Pregúntale al shell qué es cd:

type cd

Deberías ver una salida que contenga:

cd is a shell builtin

Otros nombres pueden ser alias —sustituciones breves configuradas por el shell— o programas externos almacenados como archivos. Inspecciona ls:

type ls

Según la configuración del shell, la salida puede identificar un alias o la ruta de un ejecutable. Usa type -a para mostrar todas las formas coincidentes que el shell puede encontrar:

type -a ls

command -V proporciona otra descripción fácil de leer:

command -V cp

command -v muestra el comando o la ruta que el shell elegiría realmente:

command -v cp

Guarda un breve informe de clasificación. El primer > crea o reemplaza el informe; cada >> posterior añade la salida de otro comando sin borrar las líneas anteriores:

type cd > command-types.txt
type ls >> command-types.txt
command -V cp >> command-types.txt

cat command-types.txt

El informe debería identificar cd como una función integrada y describir tanto ls como cp. Conocer el tipo de comando resulta útil porque las funciones integradas del shell suelen utilizar help, mientras que los programas externos normalmente admiten --help y páginas del manual.

Leer la ayuda rápida y la sintaxis de uso

En este paso, usarás la ayuda integrada y --help, y aprenderás a interpretar la notación habitual de una línea de uso.

Como cd es una función integrada del shell, pídele a Bash su documentación mediante help:

help cd

La primera línea comienza con un patrón de uso similar a cd [-L|[-P ...]] [dir]. Todavía no necesitas comprender todas las opciones. Concéntrate en la estructura: primero aparece el nombre del comando y los elementos entre corchetes son opcionales.

Los programas externos suelen admitir --help. La ayuda completa de ls es extensa, así que este es el primer uso deliberado de una tubería en el curso. Una tubería se escribe como |. El comando de la izquierda escribe la salida normal y el comando de la derecha recibe esa salida como entrada. Aquí, head -n 8 conserva únicamente las ocho primeras líneas:

ls --help | head -n 8

La primera línea tiene esta forma general:

Usage: ls [OPTION]... [FILE]...

[OPTION]... significa cero o más opciones. [FILE]... significa cero o más argumentos de archivo o directorio. Los corchetes describen la sintaxis; no debes escribirlos literalmente.

Consulta la ayuda rápida para copiar archivos:

cp --help | head -n 8

Guarda las primeras líneas de ambos comandos con etiquetas de sección. > inicia un archivo nuevo, mientras que >> añade cada sección posterior:

echo "=== ls ===" > quick-help.txt
ls --help | head -n 3 >> quick-help.txt
echo "=== cp ===" >> quick-help.txt
cp --help | head -n 3 >> quick-help.txt

cat quick-help.txt

Este pequeño archivo no sustituye al texto completo de ayuda; demuestra que puedes encontrar y reconocer las líneas de uso de los comandos.

Navegar por una página del manual

En este paso, usarás el visor interactivo man y aprenderás qué significan las secciones del manual.

Abre la página del manual de ls:

man ls

El manual se abre en un paginador, normalmente less. Practica estas teclas dentro del visor:

• Flecha abajo: bajar una línea;
• Espacio: avanzar una pantalla;
• b: retroceder una pantalla;
• escribe /sort y pulsa Enter: buscar sort hacia adelante;
• n: ir a la siguiente coincidencia;
• q: salir y volver al indicador del shell.

El encabezado normalmente muestra LS(1). El número corresponde a una sección del manual. La sección 1 contiene comandos habituales para usuarios; otras secciones abarcan llamadas al sistema, funciones de biblioteca, formatos de configuración y comandos de administración.

Usa man -f para obtener una descripción de una sola línea, también conocida como consulta “whatis”:

man -f ls

Guarda un fragmento no interactivo de la misma página del manual. Lee esta tubería de izquierda a derecha: -P cat hace que man imprima el contenido en lugar de abrir un paginador, col -b elimina los caracteres de control de formato del terminal, head -n 20 conserva veinte líneas y > almacena el flujo final:

man -P cat ls | col -b | head -n 20 > ls-man-excerpt.txt

cat ls-man-excerpt.txt

Deberías ver el encabezado del manual, el nombre, la sinopsis y el comienzo de la descripción. Esto confirma que las vistas interactivas y no interactivas proceden de la misma documentación.

Descubrir comandos por tema

En este paso, usarás apropos cuando conozcas la tarea, pero no el nombre del comando.

apropos busca en las descripciones breves almacenadas en la base de datos del manual. Busca documentación relacionada con contraseñas:

apropos password | head -n 15

Cada resultado contiene el nombre de un manual, su sección entre paréntesis y una breve descripción. Uno de los resultados debería describir passwd.

Busca temas relacionados con archivos:

apropos file | head -n 20

Las palabras clave generales devuelven muchos resultados. Una frase más específica puede ser más útil:

apropos "copy files"

También puedes filtrar un resultado amplio. La opción -i hace que grep ignore las mayúsculas y minúsculas, mientras que -m 5 detiene la búsqueda después de cinco líneas coincidentes:

apropos file | grep -i -m 5 'copy'

Guarda la búsqueda completa sobre contraseñas para examinarla más adelante:

apropos password > password-topics.txt

grep -E '^passwd|change.*password' password-topics.txt | head

Si apropos no encuentra nada en un sistema recién instalado, puede ser necesario ejecutar sudo mandb para actualizar la base de datos del manual. En este laboratorio, la base de datos se preparó automáticamente, pero recordar esta relación te ayudará a solucionar problemas con la herramienta en otros entornos.

Resumen

Has aprendido una estrategia de ayuda reutilizable: usa type o command -V para identificar un nombre, help o --help para consultar rápidamente la sintaxis, man para acceder a la documentación completa y apropos cuando conozcas el tema, pero no el comando. Estas herramientas eliminan la necesidad de memorizar todas las opciones y te preparan para investigar comandos desconocidos durante el resto del curso.