[A04] Buscando ayuda: RTFM

  • octubre 25, 2019
  • | 696 palabras
  • | 4 minutos de lectura

En el siguiente episodio veremos como utilizar los famosos manuales para comprender el uso de los comandos en GNU/Linux. No nos debemos de aprender todas las funcionalidades de un comando de memoria, ya que disponemos de una serie de documentación llamados man que nos dan información de como usarlos y de todas las opciones que tienen.

La ayuda propia de los comandos

Como mencionaba anteriormente, no es posible conocer todas las opciones y funcionalidades que tienen algunos comandos. Por suerte en GNU/Linux disponemos de un parámetro llamado --help que llama a una función donde se muestra la ayuda del comando. En algunas ocasiones esta ayuda es de forma resumida, ya que algunos comandos necesitarían hasta dos páginas para mostrar toda la ayuda y uso del comando.

Si bien es cierto, algunos comandos no disponen de la opción --help y nos mostrará lo siguiente:

La ayuda interna de la Shell

Los comandos internos no aceptan el parámetro --help, pero para estos comandos el intérprete de comandos propone un comando help. Si se utiliza de forma aislada, proporciona la lista de los comandos internos. Si le proporcionar como parámetro el nombre de un comando interno, aparece la ayuda correspondiente. de esta manera, puede aprender que pwd admite dos parámetros adicionales:

  • -L: Muestra el valor de $PWD si es el nombre del directorio de trabajo actual.
  • -P: Muestra el directorio físico, sin ningún tipo de enlace simbólico.

El manual en línea

En ocasiones, las dos formas de ayuda que hemos explicado son insuficientes, es por eso que tenemos que hacer uso del manual de Unix. Este manual es estándar para todos los Unix y no importa cuál sea el shell, ya que se trata de un comando externo.

Para acceder a estos manuales, hay que hacerlo mediante el comando man:

Por lo general, la estructura de todos estos manuales suele ser la misma y se compone de varias secciones entre las cuales están las siguientes, aunque no están todas obligatoriamente:

  • Nombre: nombre y descripción del comando.
  • Sinopsis: Sintaxis general, parámetros y argumentos aceptados.
  • Descripción: Instrucciones detalladas del funcionamiento del comando y de los argumentos principales.
  • Opciones: Descripción detallada de cada parámetro posible, en general en forma de lista.
  • Ejemplos: El manual puede proporcionar ejemplos concretos de uso del comando.
  • Entorno: El comando puede funcionar de manera diferente dependiendo de los valores que adopten algunas de las variables del shell.
  • Conformidad: El comando se ajusta a unas recomendaciones o normas (por ejemplo POSIX).
  • Errores/Bugs: El comando puede a veces funcionar mal en casos puntuales que se pueden enumerar en este sitio.
  • Diagnóstico/retorno: El comando, según su resultado, puede devolver códigos de errores significativos cuyo valor permite determinal el tipo de problema.
  • Ver también: Lista de los comandos relacionados con el programa que puede interesas al usuario.

Para movernos dentro de la ayuda, es bastante sencillo y aquí tienes algunas teclas interesantes para moverte:

  • La barra espaciadora desplaza una página completa.
  • La tecla [Intro] desplaza linea por linea
  • Las teclas [Arriba] y [Abajo] (las flechas) desplazan una linea arriba o abajo.
  • Las teclas [Re Pág] y [Av Pág] desplazan media página arriba o abajo.
  • Las teclas [Inicio] y [Fin] hacen exactamente lo que se espera de ellas.
  • La tecla / permite una búsqueda. /toto busca toto en todo el texto del manual. Para moverse en las búsquedas, podemos pulsar n para buscar la siguiente coincidencia y [Mayus] + n busca la anterior.
  • La tecla q sale de la ayuda y vuelve a la Shell.

Buscar correspondencia

A veces puede pasar, que no nos acordemos de un comando pero si parte del texto que se debe de ejecutar, para ello podemos usar la opción -k del comando man seguido de la palabra que recordamos:

Las páginas info

También existe otro comando llamado info que permite leer las páginas en formato info. Este formato implica tener una mejor estructura, ofrecen vínculos, un índice y menús.

Buscar ayuda en Internet

En Internet hay gran cantidad de información útil para poder ser utilizada a tu favor, por eso siempre es importante leer las documentaciones oficiales de los programas que instalemos, allí tendremos todo lo que necesitamos. Además de algunos foros que aún siguen activos.

T3rr0rz0n3 @t3rr0rz0n3
SysAdmin & Developer Web. Autor de #voidNull, #entreBits. #Cafe #Gatos #Beer #HeavyMetal