Interactuando con el bash man page.
La mayoría de las
distribuciones de GNU/Linux incluyen un manual de los comandos, así
como las vastas utilerías incluías en la distribución. Si estás
en contacto con sistemas GNU/Linux debes familiarizarte con los
manuales en línea de comandos. La información que brindan es
invaluable, especialmente cuando estás buscando alguna opción de un
comando habitual o intentas comprender un comando por completo nuevo.
El
comando man es provee acceso a la ayuda
mencionada, misma que está instalada en el sistema de archivos, por
tanto, no es necesaria una conexión activa a Internet. Es lo más
elemental. La forma más sencilla de utilizarlo es escribir en
el prompt la palabra man seguida
del nombre del comando.
$ man comando
Es importante decir que el manual de los comandos
desplegado en bash no es un ‘paso a paso’ ni
tampoco es la documentación más extensiva que podemos encontrar. Es
una referencia rápida para utilizar los comandos y utilitarias en el
menor tiempo posible con una breve explicación de los puntos más
importantes a considerar tanto en su ejecución como en su
interpretación.
Cuando
se despliega la ayuda en la terminal, son visualizadas por
los pagers. Un pager es la utilidad
que permite navegar entre la documentación. La tecla con la que se
navega es con space. Para recorrer línea a línea se
usa la tecla enter o las flechas de
desplazamiento.
Como
era de esperarse, la ayuda en CLI también tiene su manual, el cual
se consulta de manera idéntica a los demás comandos.
$ man man
Nombre. Despliega el nombre del comando y una descripción sucinta.
Sinopsis. Muestra la sintaxis del comando.
Configuración. Provee información de la configuración.
Descripción. Describe el comando de manera general.
Opciones. Describe las opciones que tiene el comando (banderas).
Estatus de terminación. Define los códigos de terminación.
Valores de retorno. Describe los valores de retorno del comando.
Errores. Provee información sobre errores.
Ambiente. Describe las variables de ambiente utilizadas.
Archivos. Describe los archivos utilizados por el comandos.
Versiones. Muestra la versión del comando.
Bugs. Provee información para reportar errores en el comando.
Ejemplo. Muestra algunas maneras de utilizar el comando con sus banderas.
Autores. Muestra la información de los desarrolladores del comando.
Derechos de autor. Despliega los derechos de autor del código del comando.
Ver también. Es información de comandos similares.
Cabe
señalar que no todos los comandos en GNU/Linux tienen manual o no
siguen la convención antes mencionada.
También
existen la secciones del manual, las cuales se dividen en los
siguientes propósitos. Si no se especifica un número se utiliza la
entrada 1.
1 Programas ejecutables y guiones del intérprete de órdenes
2 Llamadas del sistema (funciones servidas por el núcleo)
3 Llamadas de la biblioteca (funciones contenidas en las bibliotecas del sistema)
4 Ficheros especiales (se encuentran generalmente en /dev)
5 Formato de ficheros y convenios p.ej. I/etc/passwd
6 Juegos
7 Paquetes de macros y convenios p.ej. man(7), groff(7).
8 Órdenes de admistración del sistema (generalmente solo son para root)
9 Rutinas del núcleo [No es estándar]
n nuevo [obsoleto]
l local [obsoleto]
p público [obsoleto]
o viejo [obsoleto]
$ man 2 syscall
La manera más rápida de ubicar el man
page de un comando que no sabemos a ciencia cierta su
nombre, es por medio de:
$ man -k criterio
$ man -k sort
Por supuesto que no es la única manera de obtener
información, al menos hay dos más: con el comando info y
con la bandera help de cada comando.
Comentarios
Publicar un comentario