Comando man en Linux
| Categorías General, Linux | Fecha 31-07-2009 | Comentario 0
Anteriormente habia mostrado ejemplos de algunos manuales de comandos de bash. Hoy pondré otro ejemplo, tomado nuevamente desde el mismo bash.
$ man man
NOMBRE
man – una interfaz de los manuales de referencia electrónicos
SINOPSIS
man [-c|-w|-tZT dispositivo] [-adhu7V] [-m sistema[,...]] [-L locale] [-p cadena] [-M ruta] [-P paginador] [-r prompt] [-S lista] [-e extension]
[[sección] pagina …] …
man -l [-7] [-tZT dispositivo] [-p cadena] [-P paginador] [-r prompt] fichero …
man -k [-M ruta] palabra_clave …
man -f [-M ruta] pagina …
DESCRIPCIÓN
man es el paginador del manual del sistema. Las páginas usadas como argumentos al ejecutar man suelen ser normalmente nombres de programas, útiles
o funciones. La página de manual associada con cada uno de esos argumentos es buscada y presentada. Si la llamada da también la sección, man
buscará sólo en dicha sección del manual. Normalmente, la búsqueda se lleva a cabo en todas las secciones de manual disponibles según un orden
predeterminado, y sólo se presenta la primera página encontrada, incluso si esa página se encuentra en varias secciones.
La siguiente tabla muestra los números de sección del manual y los tipos de páginas que contienen.
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]
Una página de manual tiene varias partes.
Éstas están etiquetadas como NOMBRE, SINOPSIS, DESCRIPCIÓN, OPCIONES, FICHEROS, VÉASE TAMBIÉN, BUGS, y AUTOR.
En la sección SINOPSIS se siguen los siguientes convenios que pueden servir de guía para otras secciones.
texto en negrita debe teclear esto exactamente.
texto en cursiva reemplace esto por el argumento apropiado.
[-abc] uno o todos los argumentos entre corchetes son opcionales.
-a|-b las opciones separadas por | no pueden
usarse conjuntamente.
argumento … argumento es repetible.
[expresión] … la expresión entre corchetes completa
es repetible.
El ejemplo del empleo de la orden o función debe recogerá todos los posibles usos. En algunos casos es recomendable ilustrar algunos usos exclu‐
sivos como se puede ver en la SINOPSIS de esta página de manual.
EJEMPLOS
man ls
Presenta la página de manual del elemento (programa) ls.
man -a intro
Presenta, secuencialmente, todas las páginas de intro disponibles en el manual. Entre página y página se puede decidir saltar a la siguiente o
salir del paginador completamente.
man -t alias | lpr -Pps
Formatea la página de manual referenciada por ‘alias’, generalmente una página de manual de tipo shell, usando el formato predeterminado troff
o groff y redirige la salida a la impresora llamada ps. La salida predeterminada de groff generalmente es PostScript. man –help debería
informarle de que procesador está siendo usado con la opción -t
man -l -Tdvi ./foo.1x.gz > ./foo.1x.dvi
Esta orden descomprime y formatea el fichero fuente nroff de la página de manual ./foo.1x.gz y lo convierte en un fichero con formato indepen‐
diente de dispositivo (dvi). Es necesario usar la redirección pues la opción -T dirige la salida al stdout sin paginador. La salida puede
verse mediante un programa como xdvi o puede incluso convertirse al formato PostScript usando un programa como dvips.
man -k printf
Busca la palabra clave printf entre las descripciones breves y las páginas de manual y presenta todas las que casen.
man -f smail
Busca las páginas de manual referenciadas por smail e imprime la descripcion breve de las que encuentre.
Esto es una parte del texto que se muestra al escribir el comando “man man” que es un manual del mismo comando “man”.
