Revisión de las man de usbmgr
Hola a todos:
Iba a mirar la ayuda del bot de Heimy para estrenarlo, pero veo que no está
implementado lo del man :-( (¿Es fácil de añadir? ¿te podemos echar un cabo,
Heimy?)
Bueno, a lo que iba: estuve mirando por curiosidad las traducciones de las
man de usbmgr (me hizo gracia, porque las páginas originales en inglés las
tuve que escribir yo, y me picó la curiosidad por leerme «traducido» :-P )...
y algunas cosas que vi no me gustaron mucho.
Las he revisado, y mando parches para las tres. Algunas cosas son muy
discutibles, porque son de «gustos» míos, quizás, más que de correcciones
propiamente dichas. Bueno, Ruby, tú míralas y coge lo que te interese :-)
Saludos,
--
Esteban Manchado Velázquez <zoso*demiurgo*org> - http://www.demiurgo.org
No software patents in Europe! - eurolinux.org - proinnova.hispalinux.es
Join Amnesty International - http://www.amnesty.org/actnow
*** dump_usbdev.es.8.orig 2004-02-03 22:15:04.000000000 +0000
--- dump_usbdev.es.8 2004-02-03 22:32:37.000000000 +0000
***************
*** 1,23 ****
.TH "dump_usbdev" "8" "0.4.8" "Shuu Yamaguchi" "USB Utilities"
.SH "NOMBR"
.LP
! dump_usbdev \- Vuelca información de dispositivos USB conectados
.SH "SINOPSIS"
.LP
dump_usbdev [\-Vvds] [\fIfichero\fP]
.SH "DESCRIPCIÓN"
.LP
La herramienta \fBdump_usbdev\fP le ayuda al escribir el fichero
! \fIusbmgr.conf\fP. Despues que \fBusbmgr\fP ha sido iniciado, el
! ejecutar \fBdump_usbdev\fP volcará información sobre los dispositivos
! conectados en un formato apropiado para \fIusbmgr.conf\fP.
.LP
! Si usted conecta dispositivos USB al concentrador USB, usted verá una línea
! como la siguiente:I
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <nombre_modulo>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
Esta línea le ayudará a escribir su fichero \fI/etc/usbmgr/usbmgr.conf\fP.
--- 1,23 ----
.TH "dump_usbdev" "8" "0.4.8" "Shuu Yamaguchi" "USB Utilities"
.SH "NOMBR"
.LP
! dump_usbdev \- Vuelca información de los dispositivos USB conectados
.SH "SINOPSIS"
.LP
dump_usbdev [\-Vvds] [\fIfichero\fP]
.SH "DESCRIPCIÓN"
.LP
La herramienta \fBdump_usbdev\fP le ayuda al escribir el fichero
! \fIusbmgr.conf\fP. Después de iniciar \fBusbmgr\fP, ejecutar \fBdump_usbdev\fP
! volcará información sobre los dispositivos conectados en un formato apropiado
! para \fIusbmgr.conf\fP.
.LP
! Si usted conecta dispositivos USB al concentrador USB, verá una línea como la
! siguiente:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
Esta línea le ayudará a escribir su fichero \fI/etc/usbmgr/usbmgr.conf\fP.
***************
*** 31,44 ****
Modo detallado.
.TP
\fB\-d\fR
! Modo de depuración. Imprime detalles de data del dispositivo.
.TP
\fB\-s\fR
! Solamente imprime el número de los dispositivos, no el fichero de
! configuración completo.
.TP
\fIfichero\fR
! Especifíca un fichero alternativo desde donde leer la data, en lugar
del predeterminado \fI/proc/bus/usb/001/*\fP. Si no es una ruta absoluta
la toma como \fI/proc/bugs/usb/001/file\fP. El formato del fichero es una
serie de registros del tipo \fBusb_device_descriptor\fP.
--- 31,44 ----
Modo detallado.
.TP
\fB\-d\fR
! Modo de depuración. Imprime detalles de los datos del dispositivo.
.TP
\fB\-s\fR
! Solamente imprime el número de los dispositivos, no el texto completo para el
! fichero de configuración.
.TP
\fIfichero\fR
! Especifica un fichero alternativo desde donde leer la data, en lugar
del predeterminado \fI/proc/bus/usb/001/*\fP. Si no es una ruta absoluta
la toma como \fI/proc/bugs/usb/001/file\fP. El formato del fichero es una
serie de registros del tipo \fBusb_device_descriptor\fP.
***************
*** 54,93 ****
.LP
dump_usbdev
.LP
! Si usted quiere depurar su salida, usted puede crear un fichero
! apropiado como \fImyfile\fP y llamarlo de la siguiente forma:
.LP
! dump_usdev /path/to/myfile
.LP
En la siguiente salida:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <nombre_modulo>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
"class 0x9" significa concentrador USB. Si no hay dispositivos USB conectados.
! solamente aparecerá el concentrador raiz. Modificar "<nombre_modulo>"
completaría la configuración para este dispositivo (concentrador).
! En el caso de un concentrador, usted deberá cambiar "nombre_modulo" a "none"
! porque el manejador del concentrador esta incluido en usbcore.
.LP
! Luego de que un ratón USB ha sido conectado al concentrador, al ejecutar
\fBdump_usbdev\fP obtendrá lo siguiente:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <nombre_modulo>
! vendor 0x56e product 0x4 module <nombre_modulo>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
! La segunda línea es nueva. Esta es la información sobre el ratón USB.
! El ratón USB requiere los manejadores "hid" y "mousedev". Por lo tanto,
! "<modulo>" deberá ser cambiado a "hid , mousedev".
.LP
! De esta manera, el fichero \fIusbmgr.conf\fP se vería de como sigue:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
--- 54,94 ----
.LP
dump_usbdev
.LP
! Si usted quiere depurar su salida, puede crear un fichero
! apropiado llamado \fImifich\fP y ejecutar \fBdump_usbdev\fR de la siguiente
! forma:
.LP
! dump_usbdev /ruta/hasta/mifich
.LP
En la siguiente salida:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
"class 0x9" significa concentrador USB. Si no hay dispositivos USB conectados.
! solamente aparecerá el concentrador raiz. Modificar "<module_name>"
completaría la configuración para este dispositivo (concentrador).
! En el caso de un concentrador, debería cambiar "module_name" a "none"
! ya que el manejador del concentrador esta incluido en usbcore.
.LP
! Después de conectar un ratón USB al concentrador, al ejecutar
\fBdump_usbdev\fP obtendrá lo siguiente:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
! class 0x9 subclass 0x0 protocol 0x0 module <module_name>
! vendor 0x56e product 0x4 module <module_name>
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
! La segunda línea es nueva. Ésta es la información sobre el ratón USB.
! Los ratones USB requieren los manejadores "hid" y "mousedev". Por lo tanto,
! "<module_name>" deberá cambiarse a "hid , mousedev".
.LP
! De esta manera, el fichero \fIusbmgr.conf\fP se vería como sigue:
.LP
.nf
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
***************
*** 96,111 ****
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
! Usted deberá copiar esto en \fI/etc/usbmgr/usbmgr.conf\fP,
! y luego ejecutar \fBupdate_usbdb\fP para crear la data de
configuración.
.SH "AUTOR"
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual ha sido escrita por Esteban Manchado Velázquez
! <zoso@debian.org>, para el sistema Debian GNU/Linux (pero podría ser
! usado por otros).
.SH "TRADUCTOR"
.LP
Rudy Godoy <rudy@kernel\-panik.org>
--- 97,112 ----
\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-
.fi
.LP
! Debería copiar esto en \fI/etc/usbmgr/usbmgr.conf\fP
! y luego ejecutar \fBupdate_usbdb\fP para crear los datos de
configuración.
.SH "AUTOR"
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual (la original, en inglés) ha sido escrita por Esteban
! Manchado Velázquez <zoso@debian.org>, para el sistema Debian GNU/Linux (pero
! pueden usarla otros).
.SH "TRADUCTOR"
.LP
Rudy Godoy <rudy@kernel\-panik.org>
*** update_usbdb.es.8.orig 2004-02-03 21:49:20.000000000 +0000
--- update_usbdb.es.8 2004-02-03 22:14:52.000000000 +0000
***************
*** 1,33 ****
.TH "update_usbdb" "8" "0.4.8" "Shuu Yamaguchi" "USB Utilities"
.SH "NOMBRE"
.LP
! update_usbdb \- Órden para actualizar la data que usa usbmgr
.SH "SINOPSIS"
.LP
update_usbdb [\-dfhs] \fIfichero\fP
.SH "DESCRIPCIÓN"
.LP
! El comando \fBupdate_usbdb\fP crea la data del fichero de configuración
! (como una estructura de directorio bajo \fB/etc/usbmgr/{vendor,class}\fP)
! del fichero de configuración dado (usualmente \fB/etc/usbmgr/usbmgr.conf\fP).
! .LP
! La estructura del directorio es como sigue:
! .TP
! \fBvendor[/vendor\-ID[/product\-ID]/module]\fR
! Módulo(s) a ser cargados cuando se conecta un dispositivo USB que concuerde
! con el vendor.
.TP
\fBclass[/class\-ID[/subclass\-ID[/protocol\-ID]]/module]\fR
! Módulo(s) a ser cargado cuando se conecta un dispositivo USB y éste concuerda
! con class.
.TP
\fBvendor[/vendor\-ID[/product\-ID]/script]\fR
! Programa a ser ejecutado cuando se (des)conecta un dispositivo USB y éste
! concuerda con el vendor.
.TP
\fBclass[/class\-ID[/subclass\-ID[/protocol\-ID]]/script]\fR
! Programa a ser ejecutado cuando se (des)conecta un dispositivo USB y éste
! concuerda con class.
.SH "OPCIONES"
.LP
.TP
--- 1,33 ----
.TH "update_usbdb" "8" "0.4.8" "Shuu Yamaguchi" "USB Utilities"
.SH "NOMBRE"
.LP
! update_usbdb \- Orden para actualizar los datos que usa usbmgr
.SH "SINOPSIS"
.LP
update_usbdb [\-dfhs] \fIfichero\fP
.SH "DESCRIPCIÓN"
.LP
! La orden \fBupdate_usbdb\fP crea los datos de configuración (una estructura de
! directorios bajo \fB/etc/usbmgr/{vendor,class}\fP) a partir del fichero de
! configuración dado (generalmente \fB/etc/usbmgr/usbmgr.conf\fP).
! .LP
! La estructura de directorios es como sigue:
! .TP
! \fBfabricante[/fabricante\-ID[/product\-ID]/module]\fR
! Módulo(s) a cargar cuando se conecta un dispositivo USB que concuerde
! con el fabricante.
.TP
\fBclass[/class\-ID[/subclass\-ID[/protocol\-ID]]/module]\fR
! Módulo(s) a ser cargado(s) cuando se conecta un dispositivo USB y su clase
! concuerda con class\-ID.
.TP
\fBvendor[/vendor\-ID[/product\-ID]/script]\fR
! Programa a ejecutar cuando se (des)conecta un dispositivo USB y su fabricante
! concuerda con vendor\-ID.
.TP
\fBclass[/class\-ID[/subclass\-ID[/protocol\-ID]]/script]\fR
! Programa a ser ejecutado cuando se (des)conecta un dispositivo USB y su clase
! concuerda con class\-ID.
.SH "OPCIONES"
.LP
.TP
***************
*** 38,47 ****
Fuerza la actualización, aún cuando parezca no ser necesaria.
.TP
\fB\-h\fR
! Imprime ayuda \fBal syslog\fP, luego finaliza.
.TP
\fB\-s\fR
! No abre syslog en el inicio.
.SH "FICHEROS"
.LP
\fI/etc/usbmgr/usbmgr.conf\fP
--- 38,47 ----
Fuerza la actualización, aún cuando parezca no ser necesaria.
.TP
\fB\-h\fR
! Imprime la ayuda \fBen el syslog\fP, luego finaliza.
.TP
\fB\-s\fR
! No abre \fIsyslog\fP en el inicio.
.SH "FICHEROS"
.LP
\fI/etc/usbmgr/usbmgr.conf\fP
***************
*** 91,97 ****
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual ha sido escrita por Esteban Manchado Velázquez <zoso@debian.org>, para el sistema Debian GNU/Linux (pero podría ser usada por otros).
.SH "TRADUCTOR"
.LP
Traducción de Rudy Godoy <rudy@kernel\-panik.org>.
--- 91,99 ----
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual (la original en inglés) ha sido escrita por Esteban
! Manchado Velázquez <zoso@debian.org>, para el sistema Debian GNU/Linux (pero
! pueden usarla otros).
.SH "TRADUCTOR"
.LP
Traducción de Rudy Godoy <rudy@kernel\-panik.org>.
*** usbmgr.es.8.orig 2004-02-03 20:58:12.000000000 +0000
--- usbmgr.es.8 2004-02-03 21:48:14.000000000 +0000
***************
*** 1,20 ****
.TH "usbmgr" "8" "0.4.8" "Shuu Yamaguchi" "Herramientas USB"
.SH NOMBRE
.LP
! usbmgr \- Demonio para carga/descarga de módulos USB
.SH "SINOPSIS"
.LP
\fBusbmgr\fR [\-Vdnph] [\-D \fIn\fP] [\-c \fichero\fP] [\-t \fItiempo\fP]
.SH "DESCRIPCIÓN"
.LP
! El demonio \fBusbmgr\fR se encarga de cargar y descargar los módulos USB
! del núcleo cuando sea necesario.
.LP
! Cuando los dispositivos USB se conectan o desconectan al concentrador USB,
usbmgr trabaja de la siguiente manera, de acuerdo a la configuración:
.TP
a)
! Carga y descarga módulos del núcleo Linux.
.TP
b)
Ejecuta ficheros para configurar los dispositivos USB.
--- 1,20 ----
.TH "usbmgr" "8" "0.4.8" "Shuu Yamaguchi" "Herramientas USB"
.SH NOMBRE
.LP
! usbmgr \- Servicio para carga/descarga de módulos USB
.SH "SINOPSIS"
.LP
\fBusbmgr\fR [\-Vdnph] [\-D \fIn\fP] [\-c \fichero\fP] [\-t \fItiempo\fP]
.SH "DESCRIPCIÓN"
.LP
! El servicio \fBusbmgr\fR carga y descarga módulos USB del núcleo cuando se
! necesita.
.LP
! Cuando los dispositivos USB se conectan o desconectan al concentrador USB,
usbmgr trabaja de la siguiente manera, de acuerdo a la configuración:
.TP
a)
! Carga y descarga módulos del núcleo de Linux.
.TP
b)
Ejecuta ficheros para configurar los dispositivos USB.
***************
*** 28,43 ****
Modo depuración. Implica \fB\-n\fR.
.TP
\fB\-n\fR
! Modo de ejecución no-demonio.
.TP
\fB\-p\fR
No crea fichero PID.
.TP
\fB\-h\fR
! Imprime uso y finaliza.
.TP
\fB\-b\fR
! Sin pitido.
.TP
\fB\-D\fR \fIn\fP
Activa modo depuración, donde \fIn\fP es el nivel de depuración.
--- 28,43 ----
Modo depuración. Implica \fB\-n\fR.
.TP
\fB\-n\fR
! Modo de ejecución normal (es decir, no como servicio).
.TP
\fB\-p\fR
No crea fichero PID.
.TP
\fB\-h\fR
! Imprime instrucciones de uso y finaliza.
.TP
\fB\-b\fR
! No emite sonidos.
.TP
\fB\-D\fR \fIn\fP
Activa modo depuración, donde \fIn\fP es el nivel de depuración.
***************
*** 62,68 ****
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual ha sido escrita por Esteban Manchado Velázquez <zoso@debian.org>, para el sistema Debian GNU/Linux (pero podría ser usada por otros).
.SH "TRADUCTOR"
.LP
Traducción de Rudy Godoy <rudy@kernel\-panik.org>.
--- 62,70 ----
.LP
Shuu Yamaguchi <shuu@wondernetworkresources.com>
.LP
! Esta página de manual (la versión original inglesa) ha sido escrita por
! Esteban Manchado Velázquez <zoso@debian.org>, para el sistema Debian GNU/Linux
! (pero pueden usarla otros).
.SH "TRADUCTOR"
.LP
Traducción de Rudy Godoy <rudy@kernel\-panik.org>.
Reply to: