Actualizado el 14-01-2007
versión para imprimir
Ayuda en linux
--help
Posiblemente la primera opción de ayuuda en linux, al menos para programas ejecutados desde la linea de comandos, sea la propia ayuda del programa. Prueba a teclear comando --help|more y veras en pantalla una breve descripción del programa y de sus opciones.
man pages
La forma mas rapida y completa de obtener ayuda en linux es acudir a las man pages. Como contrapartida, la información no está presentada de forma exactamente intuitiva y puede ser un poco frustrante si no sabes siquiera donde empezar a buscar.
Para invocar la ayuda, desde una terminal escribe man comando, donde comando es el item sobre el que deseas ayuda. Por ejemplo teclea en una terminal: man rpm
RPM(8) Red Hat Linux RPM(8)
NAME
rpm - RPM Package Manager
SYNOPSIS
QUERYING AND VERIFYING PACKAGES:
rpm {-q|--query} [select-options] [query-options]
rpm {-V|--verify} [select-options] [--nodeps] [--nofiles] [--nomd5]
[--noscripts]
rpm {-K|--checksig} [--nogpg] [--nopgp] [--nomd5] PACKAGE_FILE ...
INSTALLING, UPGRADING, AND REMOVING PACKAGES:
rpm {-i|--install} [install-options] PACKAGE_FILE ...
rpm {-U|--upgrade} [install-options] PACKAGE_FILE ...
rpm {-F|--freshen} [install-options] PACKAGE_FILE ...
rpm {-e|--erase} [--allmatches] [--nodeps] [--noscripts] [--notriggers]
[--repackage] [--test] PACKAGE_NAME ...
Manual page rpm(8) line 1
Cuando, como en este caso, el texto de ayuda termina con tres puntos (...) quiere decir que no se muestra todo el texto. Para avanzar pulsa la barra espaciadora (o la tecla de avance pagina) y para retroceder, retroceder pagina. Para salir cuando hayas terminado, pulsa q
Detrás del nombre del comando sobre el que se está mostrando la ayuda pueden aparecer numeros o letras: en el ejemplo que estamos viendo o RPM(8). Este número (o letra) indica la sección del manual en la que nos encontramos.
Las páginas man se distribuyen junto con el programa al que sirven de ayuda, por lo que normalmente solo tendrás instaladas las man pages de los programas instalados, y será ayuda adecuada a la versión instalada.
Organización de las páginas man
Para Linux tódas las páginas man son parte del mismo manual, estructurado en secciones:
- Sección 1 programas ejecutables, comandos de la shell
- Sección 2 LLamadas del sistema
- Sección 3 LLamadas de bibliotecas
- Sección 4 Archivos especiales (en /dev)
- Sección 5 Formatos de archivo y convenciones
- Sección 6 Juegos
- Sección 7 Miscelanea
- Sección 8 Administración del sistema
- Sección 9 rutinas del núcleo no standard
- Sección n documentación nueva no ubicada aun (n de nueva; en desuso)
- Sección o documentación antigua mantenida temporalmente (o de old, en desuso)
- Sección l documentación local, específica del sistema (l de local, en desuso)
Es frecuente que algunas páginas man estén en varias secciones, si se llaman sin mas parámetros, se mostrará la pagina de la primera sección que se encuentre. Si queremos saben en que secciones mirar podemos usar man -f item_a_buscar:
ignacio@localhost:~$ man -f ls ls (1) - list directory contents ignacio@localhost:~$ man -f man man (1) - an interface to the on-line reference manuals man (7) - macros to format man pages
Puedes indicar la sección que quieres leer: man 7 man.
Convenciones de sintaxis en man
Normalmente todas las páginas man tienen la misma estructura, comenzando con el nombre del item sobre el que trata la página, y sinopsis donde se suele incluir un esquema de la sintaxis:nombre_comando [indicadores opcionales] otros elementos.
El texto en negrita representa lo que debe teclear el usuario; las palabras en cursiva o subrayadas son parámetros o argumentos debiendo escribir el valor en su lugar
Los indicadores opcionales se suelen indicar mediante letras encerradas en corchetes, y puedes escribirlos juntos o separados: rpm -Va o también rpm -V -a. Normalmente cada delimitador tiene versión corta y larga. En este caso la larga sería
rpm --verify --all.
Si encuentras varios elementos opcionales encerrados en corchetes y separados entre si por una barra vertical | esto te indica que no puedes usar estos elementos juntos. Y en cuanto a los argumentos, si incluyen unos puntos suspensivos quiere decir que puedes incluir varios. La página man también te informará si los argumentos van separados por espacios o comas.
a propósito de ...
apropos o su equivalente man -k te permite buscar en man palabras clave (en inglés).
whatis y su equivalente man -f son muy parecidos a apropos pero solo buscan resultados entre los nombres de programas.
man pages en html
Si deseas ver las páginas de man en tu navegador, puedes desde consultarlas online, en alguno de los muchos sitios dedicados a ello (por ejemplo usa el enlace que hay arriba a la derecha en esta página), o puedes leer las de tu ordenador desde el ordenador Konqueror, escribiendo en la barra de direcciones man: comando. Desde la linea de terminal tambien puedes pasar una página man a html con man2html. Este programa tiene distintas formas de uso, pero quizás la mas sencilla sea simplemente (tras instalarlo) apuntar tu navegador a http://localhost/cgi-bin/man/man2html y empezar a usarlo (solamente para las man en inglés).
info
Las páginas de información que puedes invocar con info suelen ser mas detalladas que man, y contienen hipervínculos que la hacen navegable
El visor de ayuda info tiene sus propios comandos por lo que aprender a moverte entre sus archgivos de ayuda puede ser un poco difícil. El propìo visor de info trae un manual que puedes invocar tecleando info -h
A continuación los comandos mas usuales para usar info:
| Función | Tecla | Uso |
| Comandos de programa y ventana: |
||
| Quit |
q |
Salir de info |
| Help |
h |
Te muestra un tutorial para moverte en info |
| Referencia de comandos | ? |
Muestra un esquema de las opciones y comandos de info |
| Cambiar de ventana |
C-x o |
Si la pantalla de info esta dividida en varias ventanas, te permite cambiar a otra ventana. |
| Borrar la ventana | C-x 0 |
control - x - cero. |
| Borrar todas las ventanas de info menos la presente | C-x 1 |
control - x - uno |
| Comandos de navegación | ||
| Next node |
n |
Avanzas al nodo siguiente en el mismo nivel |
| Previous node |
p |
Retrocedes al nodo anterior en el mismo nivel. El orden de los nodos está preestablecido y no depende del orden en que vayas leyendo nodos. |
| Up to parent node |
u |
Sube al nodo superior jerárquico |
| Last node visited |
l |
Vuelve al nodo anteriormente visitado |
| Beginning of node |
b | va al inicio del nodo actual. |
| Top of node |
t |
va al primer nodo del nivel |
| menu |
m |
muestra un menu de nodos |
| directory node |
d |
nodo directorio |
| Seguir referencias | Enter |
Pulsando Enter con el cursor en una linea que comience con un * (y no sea el menu) te llevara al nodo referenciado en la linea. |
| Desplazamiento del texto | ||
| abajo 1 linea |
tecla Abajo |
|
| Arriba 1 linea |
tecla Arriba |
|
| Bajar varias lineas | barra espaciadora |
|
| Arriba varias lineas |
tecla Retroceso (y tecla DEL) | |
Al igual que las páginas man, puedes usar konqueror para verlas en html: escribe en su barra de direcciones info: comando
Y tambien puedes instalar info2www y navegar por las páginas info desde la dirección http://localhost/cgi-bin/info2www
How to
Los how to son documentos que explican como poder ejecutar determinada tardea en Linux. Por ejemplo, como hacer que el CD sea reconocido, o como conectar tu modem etc
Posiblemente tengas algunos instalados en tu sistema, típicamente en /usr/doc/HOWTO, o /usr/share/doc/HOWTO/ y tambien diseminados por la red. Puedes ver mas abajo en enlaces relacionados alguna página recopilatoria
Otras ayudas
Puedes buscar documentación adicional en usr/doc. Además es práctica habitual en todas las distribuciones linux que el navegador de internet predeterminado del sistema tenga como página de inicio un archivo con notas acerca de dicha distribución, con enlaces a FAQs y grupos de ayuda. Por su parte los sistemas de escritorio mas conocidos como KDE o Gnome también disponen de ayudas accesibles desde sus propios menus.