Provided by: manpages-es-extra_0.8a-17_all bug

NOMBRE

       gpm - una utilidad para cortar y pegar y un servidor de ratón para las consolas virtuales

SINOPSIS

       gpm [ opciones ]

DESCRIPCIÓN

       Este  paquete  intenta ser un servidor de raton útil para las aplicaciones que se ejecutan
       en la consola de Linux. Está basado en el paquete llamado "selección", y algunas partes de
       su  código  provienen  de  dicho  paquete.   Este  paquete está pensado para reemplazar el
       paquete "selección" como mecanismo de cortar y pegar; además ofrece  mejoras  adicionales.
       El  paquete  "seleccion"  ofrecía  una primera implementación del método de cortar y pegar
       para Linux usando dos botones del ratón,  así,  la  memoria  intermedia  usada  al  cortar
       todavía  se  sigue  denominando  buffer  de  selección  o  simplemente "selección" en este
       documento.  La información contenida en este documento ha sido  extraida  del  fichero  de
       Texinfo, que es la fuente de información recomendada actualmente.

       El ejecutable de gpm actúa como un demonio (así que gpmd sería un nombre más acertado para
       él). Esta sección describe las opciones de la línea de comando de gpm,  mientras  que  los
       detalles internos son comentados en la siguiente sección.

       Debido  a  las restricciones impuestas por la llamada a sistema ioctl(TIOCLINUX), gpm debe
       ser ejecutado por el superusuario. Dichas restricciones fueron añadidas  a  partir  de  la
       versión  1.1  del  kernel  para  solucionar  un  agujero  de  seguridad relacionado con la
       selección y el vaciado de memoria en pantalla.

       El servidor puede  ser  configurado  según  las  preferencias  del  usuario,  y  cualquier
       aplicación  que  utilice el ratón seguirá las preferencias dictaminadas al servidor. Desde
       la versión 1.02, el comportamiento del ratón puede ser reconfigurado por cada usuario  que
       entre en la consola del sistema. Véase la descripción del parámetro ``-q''.

       Igualmente,  desde  la versión 0.97, el servidor se pone a si mismo en segundo plano. Para
       matar el servidor gpm, simplemente se  puede  ejecutar  con  el  parámetro  -k,  de  todas
       maneras, "killall gpm" puede ser otra solución.

COMANDOS ESPECIALES

       La  versión  1.10  introduce  la  capacidad  de  ejecutar comandos especiales bajo ciertas
       circunstancias. Por defecto, estos comandos especiales son rebotar  y  parar  el  sistema,
       pero  el  usuario  puede  especificar  cualquier  otro comando.  La posibilidad de invocar
       comandos usando el ratón es muy útil para programadores, ya que permite rebotar o parar el
       sistema  de  manera ordenada cuando el teclado está bloqueado y no hay red disponible para
       devolver el sistema a un estado consistente.

       Los comandos especiales son ejecutados haciendo un triple clic sobre los botones izquierdo
       y  derecho  a  la vez (un evento poco probable durante el uso normal del ratón). La manera
       más fácil de realizar un triple clic es pulsar uno de los dos botones y  hacer  un  triple
       clic  sobre el otro. Cuando se ejecuta esta acción, se pasa a un modo de trabajo especial,
       un mensaje aparece en la consola y el altavoz del sistema emite dos pitidos (si  se  tiene
       altavoz); si el usuario suelta todos los botones y pulsa otra vez sobre uno de ellos antes
       de tres segundos, entonces el comando especial asociado al botón es ejecutado.

       Los comandos especiales ejecutados por defecto son:

       botón izquierdo:
              Rebotar el sistema mediante el envío de una señal al proceso init

       botón central (si existe):
              Ejecutar `/sbin/shutdown -h now'

       botón derecho:
              Ejecutar `/sbin/shutdown -r now'

       El parámetro -S de la línea  de  comandos  habilita  los  comandos  especiales  y  permite
       modificar los tres especificados por defecto. Para usar los comandos especiales propuestos
       por defecto, usar  `-S  ""'  (es  decir,  especificar  un  argumento  vacío  a  -S).  Para
       especificar  otros  comandos,  usar una lista separada por el carácter dos puntos (:) para
       especificar  los  comandos  asociados  a  los  botones  izquierdo,   central   y   derecho
       respectivamente.  Si  alguno de los comandos está vacío, será interpretado como `enviar un
       signal al proceso init'. En vez de ejecutar comandos  externos,  este  comportamiento  tan
       particular  está soportado por que algunas situaciones extrañas pueden llevar al sistema a
       un estado tal que sea imposible ejecutar más  programas  mediante  la  llamada  a  sistema
       fork();  ante  esta  improbable  situación,  el usuario será capaz de apagar el sistema de
       manera ordenada. Matar el proceso init desde un proceso que se esté ejecutando es la única
       manera de lograrlo.

       Como  ejemplo,  `-S  ":telinit  1:/sbin/halt"',  asocia el envío de la señal para matar al
       proceso init al botón izquierdo, pasar a modo monousuario al botón  central,  y  parar  el
       sistema al botón derecho.

       Evidentemente, los administradores del sistema tendrán que ir con cuidado con los comandos
       especiales, ya que gpm  se  ejecuta  con  los  permisos  del  superusuario.  Los  comandos
       especiales  están pensados para ordenadores donde el ratón está disponible únicamente para
       usuarios de confianza.

OPCIONES DE LA LÍNEA DE COMANDOS

       Las opciones de la línea de comandos disponibles son las siguientes:

       -a acel
              Fija la aceleración usada cuando se mueve el ratón por un tiempo superior  a  delta
              (ver -d)

       -A     Arranca  el  servidor  con la opción de pegar desactivada. Esta opción está pensada
              como una medida de seguridad; un posible ataque al sistema podria ser introducir un
              comando  desagradable en el buffer de selección (rm -rf /) incluyendo el retorno de
              carro final, en este caso cualquier víctima que pulsase el botón central del  ratón
              ..  Con  el  tiempo  necesario,  esperamos  desarrollar un mecanismo más general de
              envejecimiento; el demonio de gpm vaciará automáticamente el buffer de selección al
              pasar  un  periodo  de  inactividad  (edad).  A  partir  de  la  versión 1.15.7, se
              proporciona un programa trivial llamado "disable-paste", que ejecuta "gpm  -A  -q".
              Esto  es  así por que el último comando, al igual que "gpm -q" en general, necesita
              los privilegios del superusuario; "disable-paste" se instala con el bit  de  setuid
              activado  hacia  el  superusuario.  La  siguiente  secuencia  puede  ser añadida en
              /etc/profile si se permite trabajar a diversos usuarios en la consola.

       case $( /usr/bin/tty ) in
       /dev/tty[0-9]*) /usr/bin/disable-paste ;;
       esac

       -b baudios
              Fija la velocidad en baudios.

       -B secuencia
              Fija la secuencia de los botones. ``123'' es la secuencia normal, ``321'' puede ser
              útil  para  los  usuarios  zurdos,  y  ``132''puede  ser  útil  con los ratones que
              únicamente  poseen  dos  botones  (especialmente  dentre  de  Emacs).   Todas   las
              permutaciones posibles son permitidas.

       -d delta
              Fija  el  valor  delta. Cuando se mueve el ratón por un tiempo superior a delta, el
              parámetro acel es usado como factor multiplicativo. (Debe ser 2 o superior)

       -D     No ejecutar automáticamente en segundo plano cuando el programa comienza, y mostrar
              los  mensajes  a  la salida de error estándar y no mediante el mecanismo de syslog.
              Este parámetro es útil para corregir errores; en  versiones  anteriores,  se  hacía
              mediante una opción en tiempo de compilación.

       -g número
              Con  dispositivos  de  planeo, emula el botón especificado con un ligero golpe.  El
              número debe ser 1, 2 o 3, y se refiere al número antes que se haya remapeado con el
              parámetro -B. Esta opción se aplica a los decodificadores mman y ps2.  Por defecto,
              no se emula ningún botón, ya que el efecto de golpe ligero en los dispositivos  ps2
              es incompatible con algunos ratones ps2 normales.

       -h     Imprime por pantalla un resumen de los parámetros de la línea de comandos.

       -i intervalo
              Fija  el  intervalo  a usar como el límite superior para los clics múltiples. Si el
              intervalo entre que se aprieta el botón y se suelta es  menor  que  el  límite,  la
              pulsación  se  considera  como  un  doble  o  triple  clic.  El  tiempo  se mide en
              milisegundos.

       -k     Mata un gpm que se esté ejecutando. Este parámetro puede ser usado si se  posee  un
              ratón  del  tipo  "busmouse" antes de entrar en Xwindow (a menos que se use -R o la
              limitación de apertura única (single-open) sea eliminada  del  núcleo  del  sistema
              operativo)

       -l juego_de_carácteres
              Especifica  la tabla de traducción de inword(). El parámetro juego_de_carácteres es
              una lista de carácteres. "-" se usa para especificar un rango y " como secuencia de
              escape  del  siguiente  carácter o para especificar códigos octales.  Únicamente se
              pueden especificar carácteres  visibles,  ya  que  los  carácteres  de  control  no
              aparecen en la memoria de vídeo en modo texto, una vez que el texto seleccionado ha
              sido cortado.

       -m nombre_de_fichero
              Especifica el nombre del fichero correspondiente al  ratón.  Por  defecto  se  coge
              /dev/mouse.

       -M     Activa  el  modo  múltiple.  El demonio leera dos dispositivos de ratón diferentes.
              Cualquier opción especificada a posteriori  se  referirá  al  segundo  dispositivo,
              mientras   que   las  opciones  especificadas  a  priori  se  referirán  al  primer
              dispositivo. Esta opción automáticamente actica la opción ``repetir'' (-R)

       -o líneas
              Conmuta las líneas del módem. El argumento "líneas" puede ser  ``dtr'',  ``rts''  o
              ``both''.  Este  parámetro  es necesario para algunos ratones extraños conectados a
              través de la línea serie.

       -p     Especifica  que  el  puntero  sea  visible  mientras  se  selecciona.  Este  es  el
              comportamiento  de  selection-1.7,  pero  a  veces  confunde. El comportamiento por
              defecto es no enseñar el puntero, la cual cosa tambien puede confundir.

       -q     Acaba después de cambiar el comportamiento del ratón. Este parámetro  está  pensado
              para permitir a los usuarios modificar el estado del ratón (-a, -B, -d, -i, -l, -p,
              -r, -V, -A) sin rearrancar el servidor. Como este parámetro  requiere  permisos  de
              superusuario,  el  administrador  del sistema pueden usar los bits de "setuid" para
              permitir su uso por parte de los usuarios. El cambio de los  parámetros  del  ratón
              está  solamente  permitido  desde  una  de las consolas virtuales. Las opciones son
              trasferidas únicamente al primer ratón.

       -r numero
              Fija la sensibilidad del ratón. Una sensibilidad mayor  provoca  que  el  ratón  se
              mueva más rápido.

       -R     Provoca  que  gpm  se comporte como un repetidos: cualquier dato recibido del ratón
              mientras se está en modo gráfico será reenviado al  fichero  /dev/gpmdata,  que  se
              comporta  como  una  cola  (fifo),  siguiendo  el  protocolo  "mouse-system".  Esto
              significa que se puede configurar el servidor X para que utilice este fichero  como
              dispositivo  de ratón. Este parámetro es útil para los usuarios que posean un ratón
              del tipo "bus-mouse", ya que podrán invalidar la limitación de abrir únicamente  un
              raton  (single-open). También una manera sencilla de manejar esos estúpidos ratones
              con modo dual, que te obligan a mantener apretado  el  botón  central  mientras  se
              cambia el modo de vídeo. Este parámetro se activa si se utiliza el parámetro -M.

       -s número
              Fija la velocidad de muestreo para el ratón.

       -S comandos
              Permite  los  comandos especiales, y opcionalmente define los comandos propios como
              una lista separada por el  carácter  dos  puntos  (:).  Ver  más  arriba  para  una
              explicación detallada de los comandos especiales.

       -t nombre
              Especifica el tipo de ratón. Usar "-t help"  para obtener una lista de los tipos de
              ratón permitidos.

       -v     Imprime información sobre la versión y acaba.

       -V incremento de información
              Especifica el nivel máximo de mensajes que serán mostrados. Así, un número positivo
              tiene  el  efecto  de  incrementar  el número de mensajes de información mostrados.
              También se puede especificar un valor negativo  para  silenciar  el  programa;  sin
              embargo,  nótese que debido a las reglas de  getopt(3) , un valor negativo debe ser
              especificado justo detrás del parámetro, sin ningún espacio  entre  ellos  (o  sea,
              -V-1 pero no -V -1). El valor numérico es opcional y su valor por defecto es 1.

       -2     Obliga  a  que  el ratón tenga dos botones. Esto significa que el botón central, si
              existe en el ratón, se comportará exactamente igual que el botón de la derecha.

       -3     Obliga a que el ratón tenga tres botones. Por defecto el ratón se supone que tendrá
              dos  botones  hasta  que  se  pulsa el botón central. Si realmente existen los tres
              botones, el de la derecha es usado para extender la selección, y  el  central  para
              pegarla.   ¡Cuidado!  si  se utiliza el parámetro -3 con ratones de dos botones, no
              será posible pegar la selección que se haya hecho.

MODO DE OPERACIÓN

       Para seleccionar texto, pulsar el botón izquierdo y arrastrar el  ratón.   Para  pegar  el
       texto seleccionado, en la misma u otra consola, pulsar el botón central.  El botón derecho
       es usado para extender la selección, como en `xterm'.

       En los  ratones  de  dos  botones  se  utiliza  el  botón  derecho  para  pegar  el  texto
       seleccionado.

       Los dobles y triples clics seleccionan toda la palabra y toda la línea respectivamente. Se
       recomienda el uso de la opción `-P' para obtener un efecto visual mejor.

       Si se selecciona un espacio en blanco al final de una oración, y no hay ningún otro  texto
       hasta  el final de la línea, el resto de la línea será seleccionado automáticamente. Si se
       selecciona un grupo de líneas, los espacios del final de cada línea serán  eliminados  del
       buffer de selección.

       Cualquier salida que se haga a la consola virtual que tenga una selección de texto marcada
       hará que la marca de texto seleccionado sea eliminada de la pantalla a fin de mantener  la
       integridad de la misma, aunque el contenido del buffer de selección no se verá afectado.

       El  mecanismo  de  selección es desactivado si la consola virtual pasa a modo gráfico, por
       ejemplo cuando se ejecuta X11, y se restaura cuando  se  vuelve  a  modo  texto.  (Ver  la
       sección de errores más abajo)

ERRORES

       El  servidor gpm puede tener algunos problemas cuando interactúa con las X: si el ratón es
       un dispositivo de apertura  única  (single-open),  un  ratón  del  tipo  "bus-mouse",  por
       ejemplo,  se  debería  manar gpm antes de ejecutar las X, o usar la opción ``-R'' (ver más
       arriba). Para matar al servidor gpm simplemente  invocar  gpm  -k.  Este  problema  no  es
       aplicable a ratones conectados al puerto serie.

       Dos  instancias  de  gpm  no  pueden  ejecutarse en el mismo sistema. Si se dispone de dos
       ratones, usar la opción ``-M'' (ver más arriba).

       Cuando la consola actual está en modo gráfico, gpm duerme hasta que se vuelve a modo texto
       (a  menos  que  se especifique -R). Así, no responderá a los clientes. De todas formas, es
       poco probable que los clientes que estén impacientes esperando al ratón  molesten  en  las
       consolas distintas a la actual.

       Las  versiones  anteriores  a  la  1.0 de gpm tienen problemas con las versiones 1.2.9 del
       kernel, ya que los clientes tienen que tener permisos de escritura sobre  /dev/gpmctl.  Se
       debería  invocar chmod sobre dicho nodo o instalar la versión 1.0 o posteriores de gpm (si
       tienes este documento, tienes la versión actualizada)

AUTORES

       Andrew Haylett <ajh@gec-mrc.co.uk> (el código de selección original)
       Alessandro Rubini <rubini@linux.it> (nuevas características)

       Muchos, muchos colaboradores, tanto del paquete "selection" como de gpm.

MANTENIMIENTO

       Desde la versión 1.14 yo realizo exclusivamente el mantenimiento. Ian  Zimmerman  y  Prosa
       Inc respaldarán el desarrollo de gpm. El punto de contacto oficial es actualmente la lista
       de correo gpm@animal.unipv.it, gracias a mi Universidad, la cual generosamente  acoge  las
       discusiones sobre gpm. La lista es gestionada por SmartList y todos sois bienvenidos.

FICHEROS

       /dev/mouse        El dispositivo de ratón por defecto
       /var/run/gpm.pid  El PID del servidor gpm en ejecución
       /dev/gpmctl       Un enchufe (socket) de control para
                         los clientes
       /dev/gpmdata      La cola que se comporta como demonio
                         `repetidor' (-R)

VÉASE TAMBIÉN

        mev(1)        Un ejemplo de cliente para el demonio gpm.
        gpm-root(1)   Un manejador para controlar los eventos
                      del ratón.
       El  fichero  de  info  sobre  `gpm',  el  cual  da información más completa y explica como
       construir un cliente de gpm.