Cerramos del 10/08 al 18/08. Los pedidos cursados a partir del 09/08 a las 12.00 hora de España peninsular se tramitarán el 19/08/2024.
Cerramos del 10/08 al 18/08. Los pedidos cursados a partir del 09/08 a las 12.00 hora de España peninsular se tramitarán el 19/08/2024.
  1. Libros
  2. Linux
  3. Documentación
Extrait - Linux Principios básicos de uso del sistema (8ª edición)
Extractos del libro
Linux Principios básicos de uso del sistema (8ª edición)
2 opiniones
Volver a la página de compra del libro

Documentación

Introducción

Este capítulo proporciona al lector los medios para ir más lejos y encontrar información que no figura en esta obra; saber buscar en la documentación aumenta en gran medida la autonomía de los usuarios.

En teoría es posible encontrar toda la información expuesta aquí en la documentación GNU/Linux proporcionada con el sistema.

Manual

Con la mayor parte de distribuciones GNU/Linux se instala un manual electrónico.

1. Secciones

Este manual trata diferentes puntos, como los comandos y su sintaxis, los archivos de configuración del sistema, las bibliotecas estándar de programación...

Para ello, el manual se divide en nueve secciones principales:

  • Sección 1: comandos de usuario.

  • Sección 2: llamadas al sistema.

  • Sección 3: bibliotecas de programación (libc, Perl, SSL, Tcl).

  • Sección 4: archivos especiales y dispositivos.

  • Sección 5: archivos de configuración, formatos y convenciones.

  • Sección 6: juegos.

  • Sección 7: varios.

  • Sección 8: comandos de administración.

  • Sección 9: rutinas del núcleo.

Las secciones 1 y 8, que describen el conjunto de comandos disponibles en GNU/Linux, son las más importantes.

2. Comando man

El acceso a una página del manual se realiza lanzando el comando man y especificando, como argumento en la línea de comandos, el término buscado. Este término corresponde al nombre del comando, del archivo o bien de la biblioteca de programación para lo que se busca información.

Así, para mostrar la página del manual sobre el comando finger visto anteriormente:

$ man finger 

Aparece la página siguiente:

 
NOMBRE 
       finger - buscar información sobre un usuario. 
 
SINOPSIS 
       finger [-lmps] [user...] [user@host...]  
 
DESCRIPCIÓN  
       finger muestra información sobre los usuarios. 
 
       Opciones: 
 
       -s   finger muestra el nombre de login, el nombre real, el ordenador 
            y la autorización de escritura (” * ” significa que la escritura 
            sobre el ordenador está prohibida), el tiempo de inactividad, 
            la fecha de login, la dirección y el número de teléfono del 
            trabajo....

Documentación Info

1. Comando info

El comando info es una herramienta que agrupa básicamente la misma información contenida en las páginas del manual. Su principal ventaja, respecto a man, es que presenta los datos de forma jerárquica y con vínculos entre sí.

Para acceder a la documentación "Info", basta con escribir el comando info:

$ info 

Aparece la visualización siguiente:

File: dir,     Node: Top,       This is the top of the INFO tree. 

This is the Info main menu (aka directory node). 
A few useful Info commands: 
  'q' quits; 
  'H' lists all Info commands; 
  'h' starts the Info tutorial; 
  'mTexinfo RET' visits the Texinfo manual, etc. 

* Menu: 

Archiving 
* Cpio: (cpio).                 Copy-in-copy-out archiver to tape or disk. 
* Tar: (tar).                   Making tape (or disk) archives. 

Basics 
* Common options: (coreutils)Common options. 
* Coreutils: (coreutils).       Core GNU (file, text, shell) utilities. 
* Date input formats: (coreutils)Date input formats. 
* File permissions: (coreutils)File permissions. 
                                Access modes. 
* Finding files: (find).        Operating on files matching certain criteria. 
-----Info: (dir)Top, 282 lines --Top----------------------------------------------- 
Welcome to Info version 6.4. Type H for help, h for tutorial.File: dir       Node: 

Nos encontramos aquí en la raíz de la jerarquía (File: dir) y los enlaces (precedidos por el carácter *) apuntan a los diferentes nodos de los archivos de documentación "Info".

Un nodo puede considerarse como un capítulo dentro de un archivo de documentación. Puede existir un árbol de nodos, y por lo tanto capítulos y subcapítulos, en un mismo archivo de documentación.

Para llamar al comando...

Opción --help de los comandos en Linux

Además de las páginas del manual y de la documentación "Info" que ya hemos visto, los comandos GNU que se encuentran en Linux aceptan habitualmente la opción --help.

Los comandos invocados con esta opción devuelven una sucinta ayuda que describe la sintaxis general del comando y las opciones más utilizadas; por ejemplo:

$ wc -help 
 
Usage: wc [OPCION]... [ARCHIVO]... 
  or: wc [OPCION]... --referencia=ARCHIVO-R ARCHIVO... 
Muestra el número de nuevas líneas, palabras y bytes para cada ARCHIVO, 
y el número total de líneas si se especifica más de un ARCHIVO.  
Sin ARCHIVO, o cuando ARCHIVO es -, lee la entrada estándar. 
  -c, --bytes            muestra el número de bytes 
  -m, --chars            muestra el número de caracteres 
  -l, --lines            muestra el número de líneas 
      --files0-from=F    read input from the files specified by 
                           NUL-terminated...

Documentación HOWTO

A su manera, los documentos HOWTO aportan una mina de información al usuario que quiera dominar el sistema operativo con el que trabaja.

Estos documentos de varias páginas se refieren a temas específicos, como la impresión con Linux, la configuración de red del sistema o bien la administración de dispositivos SCSI.

También existen otros documentos, llamados "mini-HOWTO", más sucintos que los otros HOWTO.

Por citar sólo uno de estos documentos, el HOWTO Index recoge todos los HOWTO existentes y los clasifica por categorías, dando una descripción rápida de cada uno.

Estos archivos están disponibles en diferentes formatos:

.txt

Archivos en formato de texto.

.ps

Archivos PostScript imprimibles directamente en las impresoras que reconocen este formato.

.pdf

Archivos en formato Adobe PDF que pueden leerse con la herramienta xpdf en la interfaz gráfica.

.html

Páginas HTML legibles desde cualquier navegador web.

.tex y .dvi

Formatos de archivo asociados a las herramientas de paginación y publicación TeX y LaTeX.

Cuando están instalados en el equipo, se colocan generalmente en el directorio /usr/share/doc/HOWTO. Pero en este caso, el espacio ocupado es bastante notable.

Si no se encuentran en el equipo, es posible consultarlos en uno de los numerosos sitios espejo presentes en Internet y en especial en la dirección...

/usr/share/doc

Además de toda la documentación vista hasta ahora, los desarrolladores y editores de programas proporcionan generalmente una serie completa de documentos que describen su obra.

Esta documentación se encuentra en subdirectorios de /usr/share/doc/:

[javier]$ ls /usr/share/doc 
abattis-cantarell-fonts-0.0.10.1 
abrt-2.0.19 
acl-2.2.51 
aic94xx-firmware-30 
akonadi-1.8.1 
alsa-firmware-1.0.25 
alsa-lib-1.0.26 
alsa-plugins-pulseaudio-1.0.26 
alsa-tools-1.0.26.1 
alsa-utils-1.0.26 
anaconda-yum-plugins-1.0
anthy-9100h 
apper-0.8.0 
apr-1.4.6 
apr-util-1.4.1 
... 

Al igual que los HOWTO, los archivos se encuentran en diferentes formatos, por ejemplo:

[javier]$ pwd 
/usr/share/doc 
[javier]$ ls pam-1.1.6 
Copyright html Linux-PAM_SAG.txt rfc86.0.txt txts 
[javier]$ ls iproute-3.6.0 
COPYING README.decnet README.iproute2+ 
README README.distribution README.lnstat 

Internet

1. Sitios

Internet es una inmensa fuente de información; veamos una breve selección de sitios relacionados con los sistemas GNU/Linux.

Genéricos

https://www.gnu.org/home.es.html

  • Título: GNU’s Not Unix

  • Idioma: multilingüe

  • Descripción: sitio oficial del proyecto GNU.

https://www.tldp.org

  • Título: The Linux Documentation Project

  • Idioma: multilingüe

  • Descripción: sitio oficial que agrupa toda la documentación de Linux actualizada: HOWTO, guías, FAQ, páginas de manual...

Editores

https://www.redhat.com/es

  • Título: Red Hat España

  • Idioma: español

  • Descripción: editor de las distribuciones Red Hat Enterprise.

https://fedoraproject.org/

  • Título: Fedora

  • Idioma: multilingüe

  • Descripción: sitio oficial del proyecto Fedora.

https://www.debian.org

  • Título: Debian

  • Idioma: multilingüe

  • Descripción: editor de la distribución del mismo nombre.

https://www.suse.com/es-es/

  • Título: SUSE

  • Idioma: multilingüe

  • Descripción: editor de las distribuciones SuSE Linux.

https://es.opensuse.org/

  • Título: openSUSE España

  • Idioma: español

  • Descripción: sitio de la distribución libre openSUSE.

https://ubuntu.com/

  • Título: Ubuntu

  • Idioma: inglés

  • Descripción: editor de la distribución del mismo nombre.

2. Grupos de discusión

De entre todos los grupos de discusión...

Ejercicios

Ejercicio 1

Consulte la página del manual de los comandos vistos en los capítulos precedentes.

Solución

Ejecute el comando man con el nombre del comando que deseamos ver como argumento.

Ejercicio 2

Diríjase a la dirección web The Linux Documentation Project y consulte los índices para los diferentes tipos de documentación ofrecidos.

Solución

Vaya con su navegador a la dirección Web https://tldp.org:

images/03-02.png