Latinoamérica
de.novatoanovato@gmail.com

Comando -man-

Comando -man-

Comando man

Man es una herramienta de sistemas Unix que se utiliza para documentar y aprender sobre comandos, archivos, llamadas de sistema, etc., en un sistema operativo tal como GNU/Linux. Es la abreviatura de manual, proporciona información sobre el comando solicitado o permite a los usuarios buscar comandos relacionados con un determinada palabra clave.

Manual de manual

Como primera sugerencia, invitamos a leer el manual del manual, si, man dispone de su propio manual de uso para conoces las opciones y argumentes que pueden serte de utilidad a la hora de utilizar este comando.

Basta con ejecutar:

man man

Sintaxis

El comando “man” responde a la siguiente sintaxis:

man [comando]

Por ejemplo: invoquemos el manual del comando free, utilizado para ver el consumo me memoria RAM, les dejo un articulo sobre free para quien este interesado.

Interfaz de manual

Todas las páginas del manual siguen un formato prácticamente estándar, lo que ayuda a navegar por estos con mucha simpleza. Algunas de las que suelen estar presentes son:

1 – NOMBRE: El nombre del comando y una frase de una línea que enuncie su propósito.

2 – SINOPSIS: Una lista de las opciones y argumentos que toma el comando y sus parámetros, o la función.

3 – DESCRIPCIÓN: Una descripción más detallada del propósito y mecanismos del comando o función.

4 – OPCIONES: Descripciones de cada una de las opciones que toma el comando y que hacen.

5 – FICHEROS: Directorios de ficheros relacionados con el comando o función (archivos de configuración, bases de datos, etc).

6 – VÉASE TAMBIÉN: Una lista de comandos o funciones relacionadas.

7 – BUGS: Problemas del comando o función que están pendientes de ser resueltos. También conocido como KNOWN BUGS.

8 – AUTOR: Información sobre el programa, su pasado, sus términos de uso, y su/s creador/es.

Aprovechando el ejemplo del comando free, reconozcamos cada parte de su manual.

Nombre

Sinopsis

Descripción

Opciones

Ficheros

Véase también

Autores

Secciones del manual

También dentro del manual disponemos de 8 secciones enumeradas. Si no se especifica la sección, el comando man buscará en todas las secciones y mostrará el tema de la primera sección que lo contenga. En ocasiones el mismo programa posee diversas secciones de manual, cuando esto ocurre suele mostrar un mensaje indicando la sección, como man(1) y man(7), o exit(1) y exit(3).

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. Por ejemplo: /etc/passwd
6 – Juegos
7 – Paquetes de macros y convenios por ejemplo: man(7), groff(7).
8 – Órdenes de administración del sistema (generalmente solo son para root)

En algunos sistemas están disponibles también las siguientes secciones:

0 – Archivos de cabecera de la biblioteca estándar de C
9 – Rutinas del Kernel
n – Tcl/Tk
x – X Windows System

Y podemos acudir a cualquiera de ellas (si forman parte del manual) bajo la siguiente sintaxis:

man (n)[comando]

Siendo n el numero de sección que queremos leer.

Opciones del comando man

Como la gran mayoría de los comandos, man cuenta con una serie de opciones que nos van a permitir ser mas específicos con las salidas que este nos arroja.

Obtener breve descripcion del comando

La opción -f nos enseña una descripción breve desde la página del manual, si es que esta está disponible.

Para este ejemplo utilizaremos el comando find, que es una herramienta de lineas de comando para realizar búsquedas de archivos y directorios.

man -f find

Buscar manual por palabra clave

Aunque el comando man permite a los usuarios mostrar las páginas del manual, puede suceder que no se sepa en primera instancia el nombre exacto de la página del manual que queremos invocar. Pero este comando cuenta con el parámetro -k puede usarse para buscar en las descripciones de las páginas del manual por apariciones de una palabra clave que insertemos.

Es importante entender que la característica de búsqueda es proporcionada por una caché dedicada. Por defecto puede no tener ninguna cache creada y todas sus búsquedas generarán el resultado nada apropiado.

Para contar con esta opción, necesitamos generar la cache ejecutando.

mandb

Donde la salida nos indicara lo que fue añadido. En mi caso esta actualizado.

Buscaremos el comando ls, y agregaremos el parámetro | less, para que nos sea mas cómodo poder leer la salida en caso de que sea muy larga, otra cosa a tener en cuenta sobre esta salida, es que estará en orden alfabético.

man -k ls | less

Como podemos observar nos encontró el comando ls, al mismo tiempo nos indica a que sección pertenece ( sección 1: Programas ejecutables y guiones del intérprete de órdenes ) y nos brinda una breve descripcion del mismo.

ls (1) - listan los contenidos de directorios

No distinguir entre mayúsculas y minúsculas

Esta opción corre por defecto, podríamos no indicarla y obtendríamos el mismo resultado, pero no esta demás señalarlo, si el nombre del comando sobre el que realizamos la petición lo escribimos todo en mayúscula o entre mayúsculas y minúsculas igual no imprimirá la salida del manual, así mismo contamos con el parámetro -i para especificarlo. Veamos..

man -i ls
man -i LS

Distinguir entre mayúsculas y minúsculas

En caso de que necesitemos distinguir mayúsculas y minúsculas man cuenta con la opción -I, para realizar esta petición. Veamos como funciona…

man -I ls
man -I LS

Localizar fichero de manual

El comando man, también nos permite localizar el directorio donde este se encuentra, para esto nos brinda de la opción -w. Cabe resaltar que no enseña las páginas del manual, solo la localización del fichero. Busquemos la ruta del manual del comando find.

man -w find

Como podemos observar unicamente nos imprimirá la ruta del manual.

Conclusión

A nivel usuario, estas son las opciones que podrían ser mas relevantes para sacar provecho de nuestras paginas de manual. aunque man, cuenta con muchas mas en su propio manual.

man man

Puedes unírtenos en el grupo de Facebook GNU/Linux Para Todos
Grupo en Telegram Novato en Linux

Espero sea de utilidad.
Saludo. Cristian.

 

Deja un comentario

Tu dirección de correo electrónico no será publicada.