Programación Web » Administrar un sitio Web » Unidad 6. UNIX/Linux:

El manual en línea UNIX

Manual de UNIX

Esta sección y la siguiente introducen los diferentes mecanismos de documentación que existen en UNIX y Linux. Es muy importante moverse con agilidad entre ellos, ya que representan una ayuda valiosa para cualquier usuario de UNIX.

Cualquier sistema UNIX tiene incorporado un manual en línea que siempre resulta accesible desde cualquier terminal.

Si en algún momento necesita información sobre la sintaxis de una orden o sobre un determinado programa, el manual en línea debería ser siempre la primera fuente de información y consulta.

En realidad el manual en línea consiste en una colección de archivos almacenados en el disco que contiene la documentación de las órdenes UNIX.

Para acceder al manual en línea sólo tiene que teclear la palabra man desde la línea de órdenes indicando el tema sobre el que quiere ayuda. Por ejemplo, si teclea:

$ man ls

obtendrá la primera página del manual para la orden ls.

NAME
       ls - list directory contents

SYNOPSIS
       ls [OPTION]... [FILE]...

DESCRIPTION
       List  information  about  the FILEs (the current directory by default).
       Sort entries alphabetically if none of -cftuvSUX nor --sort  is  speci‐
       fied.

       Mandatory  arguments  to  long  options are mandatory for short options
       too.

       -a, --all
              do not ignore entries starting with .

       -A, --almost-all
              do not list implied . and ..

       --author
              with -l, print the author of each file

       -b, --escape
              print C-style escapes for nongraphic characters

       --block-size=SIZE
              scale   sizes   by   SIZE   before   printing    them.     E.g.,
              `--block-size=M'  prints sizes in units of 1,048,576 bytes.  See
              SIZE format below.

       -B, --ignore-backups
              do not list implied entries ending with ~

       -c     with -lt: sort by, and show, ctime (time of last modification of
              file  status  information)  with -l: show ctime and sort by name
              otherwise: sort by ctime, newest first

Puede decirse que la orden man es la más importante de todas las órdenes UNIX ya que permite conocer los detalles de cualquier otra orden. Incluso puede obtener ayuda sobre cómo usar el propio manual tecleando:

$ man man

Como curiosidad debe saber que en las primeras versiones de UNIX, cuando éste era un producto exclusivo de los laboratorios Bell de AT&T, la numeración para las versiones del sistema operativo coincidía precisamente con el número de edición del manual. Así por ejemplo se habla de UNIX Quinta Edición, UNIX sexta edición, etc.

IMPORTANTE: Aunque actualmente existen mucha documentación dedicada a UNIX, algunos son específicos para las versiones de distintos fabricantes, sólo hay un manual en línea. Lo que quiere decir que esté en el sistema que esté siempre tendrá disponible el manual en línea en el que realiza sus consultas. Así cuando alguien dice que va a utilizar el manual para buscar ayuda sobre alguna orden todo el mundo sabe que está haciendo uso de la orden man.

Existe una versión del manual específica para el sistema de ventanas X.Windows:

x-man

Los contenidos mostrados por este programa son exactamente los mismos que los que produce la orden man; las únicas diferencias se refieren al aspecto visual, ya que emplea distintos tipos de letra, lo cual le da una apariencia mucho más agradable.

La organización del manual en línea es realmente como la de una gran enciclopedia, con gran cantidad de entradas colocadas siguiendo un orden alfabético y con un término por cada orden.

Sin embargo, las páginas del manual no se encuentran numeradas, es decir, no podría por ejemplo ir a la página 3 del libro, y tampoco existe una tabla de contenidos o un índice.

La información del manual se encuentra organizada de otra manera, empleando distintas capas más apropiadas para la utilidad que se le supone.

Tradicionalmente el manual se encuentra dividido en 8 secciones, mostradas a continuación:

Sección

Descripción

(1)

Órdenes

(2)

Llamadas al sistema

(3)

Funciones de librería

(4)

Archivos especiales

(5)

Formatos de ficheros

(6)

Juegos

(7)

Información de diversa índole

(8)

Ordenes para el mantenimiento del sistema

IMPORTANTE: Si quiere saber más sobre las secciones y la forma de uso del manual en línea ejecute la orden:

$ man enter

Para saber más sobre una sección en concreto puede pedir su página de introducción. Por ejemplo, para la sección 3 teclearía:

$ man 3 enter

La orden whatis

Cuando se utiliza man para consultar el funcionamiento o la sintaxis de una orden el sistema le muestra toda la documentación completa que está disponible sobre ella.

Sin embargo, en ocasiones querrá conocer simplemente una pequeña descripción orientativa sobre lo que hace la orden.

Una forma de evitar que se muestre toda la información en la pantalla es utilizar el parámetro -f al invocar al manual en línea. Por ejemplo:

$ man -f time

muestra un resumen de la función de la orden time, indicando en una línea cada referencia encontrada en el manual y entre paréntesis el número de sección donde se encuentra:

akus@akus-System-Product-Name:~$ man -f time
time (2)             - get time in seconds
time (7)             - overview of time and timers
time (1)             - run programs and summarize system resource usage

La orden man con la opción -f es equivalente a la orden whatis. Por ejemplo:

$ whatis time

produce el mismo resultado que man -f time

La orden whatis busca la palabra suministrada por todo el manual y resulta útil para ver un pequeño resumen sobre cada una de las referencias encontradas. Por ejemplo:

$ whatis enter

muestra la siguiente salida:

akus@akus-System-Product-Name:~$ whatis
whatis ¿qué?

Para que la orden whatis funcione correctamente es necesario que el administrador haya preparado las páginas de manual de una forma determinada. Si este no es el caso no podrá utilizar esta orden.

El Proyecto de Documentación de Linux

El proyecto de documentación de Linux (Linux Documentation Project o LDP, como se le nombre frecuentemente) es un proyecto coordinado por los desarrolladores de Linux cuyo objeto es proporcionar toda la documentación posible sobre este sistema operativo en las formas más diversas, desde documentación en línea, como páginas de manuales o documentos para Texinfo, hasta manuales impresos que cubran todas las áreas de inteŕes como instalación, uso y ejecución de Linux.

Todo el mundo puede colaborar, en principio, y formar parte de este proyecto sin ánimo de lucro. Puede consultar la página Web del LDP para ampliar la información sobre este tema y conocer las evoluciones del Proyecto de Documentación.

Buscar documentación por Internet

La red de Internet es la fuente de información por excelencia. A ella se debe, en gran medida, el auge de Linux y su gran difusión. Por ello siempre debe considerarla como una opción importante cuando cuando necesite documentación.

Además de las miles de páginas Web existentes sobre Linux, encontrará también todo tipo de programas y herramientas de utilidad. Mediante el correo electrónico y los foros de discusión de Usenet podrá proponer cuestiones a los usuarios experimentados.

A pesar de todo no debe de abusar de esta posibilidad. Intente resolver los problemas por Usted mismo, consultando los manuales y la información disponible antes de preguntar.

Muchas veces la solución a su problema se encontrará documentada en algún manual. Si hace una pregunta demasiado simple a un usuario experimentado  probablemente le responda: RTFM. Son las iniciales de Read The Fuckin' Manual (lee el $%&” manual).

Suele utilizarse para indicar que la duda es demasiado sencilla y se puede resolver fácilmente examinando la documentación.

En ningún caso debe tomarse como una ofensa, ya que forma parte de la jerga de UNIX. Precisamente para este tipo de preguntas resultan particularmente interesantes las colecciones FAQs y HOWTOs.

El manual en línea UNIX. Esta sección y la siguiente introducen los diferentes mecanismos de documentación que existen en UNIX y Linux. Es muy importante moverse con agilidad entre ellos, ya que representan una ayuda valiosa para cualquier usuario de UNIX. Publicado por en enero 14, 2014

Tags: manual, en linea, documentación, UNIX, GNU, Linux

Artículos de navegación

Acerca del Profesor

Adrián Delgado Rodríguez

Ingeniero en Computación, docente por convicción y apasionado por la programación Web.

Actualmente trabaja como Profesor para en el Centro Universitario de la Costa de la Universidad de Guadalajara y como Desarrollador Web.

Síguenos:

 

Ver el perfil completo de Hugo Adrián Delgado Rodríguez (akus.net).

Deja un comentario





Diseño de páginas Web en Puerto Vallarta y Bahía de Banderas akus.net
subir

Síguenos en Facebook

Artículo de la semana

Cómo iniciar una página WebMetodología para la creación de sitios

Comprende las fases de Análisis, Planificación, Contenido, Diseño. ¿Qué método utilizas?