Esta es mi Flor de Loto!!

"Missit me Dominus"

Empezare mi primer blog, de manera dividida, para empezar kiero agradecer a CHCH la oportunidad de participar en este proyecto, desde un principio me parecio de lo mas chido el poder compartir con todos varios puntos de vistas, codigo fuente, etc etc etc. Es una gran idea la que se ocurrio compadre!!.
Ahora bien, ya que he dado las gracias a CHCH, me gustaria compartir con uds, un articulo creo k demasiado geek:
Como la mayoria de uds, han de saber, mi area de especilizacion son los sitsemas operativos basados en la arquitectura *IX (Unix, Linux, Solaris, etc), y actualmente me encuentro en capacitacion para obtener mi certificacion como Ingeniero Red Hat (aunk he de aclarar k no es precisamente mi distribucion favoriata, son pateticos , para mi, los paquetes RPM pero eso es de otra entrada), y estoy desarrollando ahora varios proyectos sobre las plataformas LINUX, y si algo debemos tener en cuenta al desarrollar cualquier tipo de sistema, es en la comodidad del usuario al poder tener acceso a la documentacion, en los sistemas *IX, esto es posible atraves de las paginas del manual, las paginas info, y las paginas HOWTO.
Asi, despues de este combo mareador, les mostrare la forma de crear paginas de manual, que puedan ser llamadas atraves de man _SU COMANDO_.
En primer lugar debemos recordar, que las paginas del manual, se encuentran divididas en 9 secciones, cada una de ellas tienen un significado especial:

1. Comando y programas de usuario
2. Comandos del nucleo
3. Llamadas a bibliotecas proporcionadas por programas como "C"
4. Unidades y Archivos especiasles
5. Formas y Convenciones de archivos
6. Juegos
7. Paquetes de macros
8. Comando de administracion de sistemas
9. Rutinas adicionales de nucleo

Una vez revisada la introduccion pasemos a lo interesante, lo primero que se necesita saber, es el esquema tipico de una pagina del manual:

* NAME. Especifica el nombre del comando o programa
* SYNOPSIS. Como invocar al comando con la lista de todas las opciones y argumentos.
* DESCRIPTION. Un breve resumen del comando.
* RETURN VALUES. Los valores que devuelve el programa o la biblioteca, y las situaciones en que se devuelvem dichos valores.
* EXIT STATUS. Usada en lugar de RETURN VALUES.
* OPTIONS. Una lista alfabetica de las opciones y agumentos.
* USAGE. Listado de la gramatica del programa.
* FILES. Lista de los archivos que usa el comando.
* ENVIRONMENT. Lista de las variables de entorno que usa
* DIAGNOSTICS. Lista de los mensajes de error del programa
* SECURITY. Explica problemas de seguridad
* CONFORMING TO. Enumera los estandares en que esta basado.
* NOTES. Informacion en general k no se ajusta a las secciones
* BUGS. Fallos y problemas del programa
* AUTHOR. Nombre del autor o encargado de mantenimiento del programa
* SEE ALSO. Referencias cruzadas a otros programas o comandos.

La unica seccion obligatoria es NAME, pk es usada por varias herramientas como makewhatis y apropos.
La manera de crear una pagina del manual, es atraves de la utilidad groff, Groff, toma un esqueleto y lo convierte en una pagina con un formato "bonito", o mejor dicho elegante.
Los comando basicos de groff son:

* .B --->Negrita
* .BI --> Negrita Cursiva
* .I ----> Cursiva
* .S ----> Pequeña
* .SM --> Muy pequeña
* .PP ---> Comienzo de un nuevo parrafo
* .RS i --> Comienza un sangrado relativo a i pulgadas a la derecha, por omision es 1/2 pulgada en cada nuevo parrafo.
* .RE ---> Filaniza un sangrado relativo

Para ver el eskeleto de la aplicacion en su forma final podemos usar el siguiente comando:
"groff -T ascii -man nombrePagina.numeroManual".
Como ejemplo kreare una muy pkña pagina de manual:

.\Este es un comentario abarca toda la linea
.TH sexo 1 "20-Feb-07"
.SH NAME
Sexo
.SH SYNOPSIS
Sexo persona1 persona2 [persona...] [--use condon, lubricante, vaselina]
.SH DESCRIPTION
.B El sexo
envia señales a todo el cuerpo para tener una fabulosa experiencia, que relaja, adormece, y desestresa, y estudios recientes han confirmado que ademas hacer el amor no engorda, al contrario es el mejor ejercicio existente.
.SH OPCIONES
.B --use
.RS 1
.BI condon
Provoca que los espermatozoides no sigan el camino impuesto por la naturaleza, evita embarazos y enfermedades en un 98% aprox.
.BI lubricante
Por si lo k kieren es sexo rudo, que mas que un buen lubricante para no lastimarte.
.BI vaselina
Por si eres gay (como kerubin) una buena dosis de vaselina te salva de una terrible irritacion como la del chaparro.
.RE
.B persona1, persona2
Son los incolucrados en el acto, que pueden pertenecer al mismo sexo, o a diferente, recordemos que es necesario ser como minimo dos personas, pero pueden participar mas en un solo acto.
.SH AUTHOR
Pagina de Manual mantenida por NataS::: The Lord of Chaos.

Para poder tener la pagina del manual funcionando para cualquier usuario solo es necesario darle permisos de lectura a todos (chmod 422) y escritura exclusiva al owner (k debe ser root). Ademas deben localizarse estas paginas en /usr/share/man/man(seccion)/pagina.[tgz|bzip|tar]
Si kieren mas informacion consulta las paginas del manual de man, groff, y f

Bueno este fue mi primer entrada, la ntea es una mamada, y dude k muchos la hayan leido hasta a mi me dio hueva hacerlo, sin embargo si se dedicaran al desarrollo es una forma de hacer manuales en linea de manera rapida y sencilla.
Para el proximo posteo (se dice asi?) pienso hablarles un poco sobre exploits sobre ejecutables suid ROOT y desbordamientos de pila para poder acceder a una shell root, es una manera divertida de poder acceder a la makina y ser el dueño total de ella.

Comentarios, mentadas de madre, ya saben a donde mandaralas o comentarlas.