CUPS – Como Depurar Inspección de Problemas
Biblioteca SANE, bibliotecas de comunicación y backends pueden encender y apagar bitácoras de depuración por medio de variables SANE_DEBUG_*
del entorno.
Las variables del entorno comunes:
-
SANE_DEBUG_DLL
- habilita depuración de biblioteca SANE -
SANE_DEBUG_SANEI_USB
: habilita depuración de biblioteca de comunicación para USB; añada la variable de entorno si su dispositivo está conectado por medio de cable USB -
SANE_DEBUG_SANEI_TCP
- habilite biblioteca de comunicación de depuración para sin cable/ethernet; añada la variable del entorno si su dispositivo está conectado por Wifi o Ethernet
Las variables de entorno para habilitar la depuración de backends específicos tienen una estructura: SANE_DEBUG_<backend_name>
, por lo que la variable de entorno para el backend HPAIO, por ejemplo, es SANE_DEBUG_HPAIO*
.
Puede encontrar cuales soportes de backend SANE que su dispositivo aquí. Si su dispositivo es HP y no está mantenido por airscan en segundo plano o cualquier otro SANE en segundo plano, puede ser mantenido por el segundo plano desde el paquete hpaio, consulte el listado de dispositivos mantenidos aquí.
Depurar el descubrimiento del escáner
Si no ve su escáner en la aplicación de escaneo, entonces depurar de proceso de descubrir está en proceso. Prefiero utilizar scanimage
en los ejemplos, pero los pasos similares pueden ser aplicados para cada aplicación de escaneado como xsane
, scanadf
, simple-scan
, etc.
Necesitará utilizar variables del entorno cuando inicie una aplicación de escáner (scanimage
en este caso). Las variables del entorno utilizadas con el comando scanimage
depende de como su escáner está conectado y cual segundo plano admite para soportarlo. Por tanto para obtener bitácoras depurativas para dispositivo HP LaserJet, conectado por medio de Ethernet/Wifi y admitido por segundo plano de HPAIO, utilice el comando:
$ SANE_DEBUG_DLL=255 SANE_DEBUG_HPAIO=255 SANE_DEBUG_SANEI_TCP=255 scanimage -L &> salida_descubierta
o, p.ej., si tiene CanoScan 8600F, conectado por USB y admitido por segundo plano de genesys, utilice el comando:
$ SANE_DEBUG_DLL=255 SANE_DEBUG_GENESYS=255 SANE_DEBUG_SANEI_USB=255 scanimage -L &> salida_descubierta
Adjunte el archivo creado discovery_output
como un adjunto para el ticket de bugzilla.
Depurar proceso de escaneo
Si el escaner es encontrado, pero un suceso ocurre durante el mismo escaneo, necesitamos depurar el proceso del escaneo mismo, el cual significa que depurar comunicación entre los segundos planos y el escáner cuando inicia el escaneo de un documento.
La misma depuración del escaneo mismo parece similar al descubrimiento: configure las variables del entorno antes de ejecutar la aplicación de comando/escáner y captura bitácoras en un archivo. El comando posible puede ser (p.ej. si tiene escáner de red admitido por segundo plano de HPAIO):
$ SANE_DEBUG_DLL=255 SANE_DEBUG_HPAIO=255 SANE_DEBUG_SANEI_TCP=255 xsane &> debug_log
o (una vez encuentra fuera el uri del disposiitvo desde scanimage -L
: consulte la siguiente sección):
$ SANE_DEBUG_DLL=255 SANE_DEBUG_HPAIO=255 SANE_DEBUG_SANEI_TCP=255 scanimage -d <device_uri> > out.pnm 2> debug_log
, donde sustituya <device_uri>
para el url del dispositivo actual, p.e. 'hpaio:/net/laserjet_m1536dnf_mfp?ip=192.168.1.112'.
Por favor adjunte el archivo creado: debug_log
: como un adjunto para el ticket de bugzilla.
Obtener un uri de dispositivo escáner
Este punto es básicamente un manual sobre como obtener un uri de escáner para depurar el mismo escaneado por medio de scanimage
. No necesita proporcionar un uri de escáner en aplicaciones de IGU como xsane
o simple-scan
, porque la aplicación lo hará por usted o puede elegir el escáner por una pulsación de ratón.
El comando scanimage -L
devuelve una salida donde el uri de dispositivo del dispositivo es mostrado, p.ej.:
$ scanimage -L device `v4l:/dev/video0' is a Noname Integrated Camera: Integrated C virtual device device `hpaio:/net/laserjet_m1536dnf_mfp?ip=192.168.1.112&queue=false' is a Hewlett-Packard laserjet_m1536dnf_mfp all-in-one
p.ej. la cadena 'hpaio:/net/laserjet_m1536dnf_mfp?ip=192.168.1.112&queue=false' es un uri de dispositivo para escáner Hewlett-Packard laserjet_m1536dnf_mfp todo en uno.
Depurar escáner HP si está mantenido por HPLIP
El paquete hplip no tiene bitácora unificada, por tanto algunas bitácoras salen del segundo plano de HPAIO a la salida estándar y las bitácoras utilizadas internas de HP vienen al diario. Por tanto necesitamos capturar ambos para obtener el comprender la situación.
Puede ser hecho de esta manera:
-
iniciar capturando bitácoras del diario en segundo plano:
$ journalctl -f > journal_logs &
$ kill `pidof journalctl`
luego adjunte el archivo creado -journal_logs
- al ticket de Bugzilla. Realice solo una acción por captura; es decir, si se le solicita que adjunte archivos de registro para la detección y el escaneo de escáneres HP compatibles con hplip, deberá adjuntar cuatro archivos: discovery_output
, journal_logs
para detección de salida, debug_logs
y journal_logs
para los registros de depuración.
Depuración de sane-airscan
Si su dispositivo es compatible con eSCL o WSD (puede consultarlo sobre especificaciones del dispositivo; busque los protocolos mencionados o AirScan), su función de escaneo es compatible con sane-airscan. En cuanto a la depuración, además del registro habitual, sane-airscan recopila un volcado de comunicación y una imagen de salida, lo cual resulta útil durante la investigación.
la depuración de sane-airscan puede ser habilitado en /etc/sane.d/airscan.conf
configurando:
[debug] trace = /ruta/a/dir/donde/debugfiles/serán/guardados enable = true
Cómo dividir bitácoras (logs)
En caso de que su registro de depuración sea demasiado grande para que Bugzilla lo adjunte (porque su problema no ocurre con las configuraciones más bajas o los registros son grandes incluso con las configuraciones más bajas), divida los registros en tres archivos como este:
$ grep dll debug_log > debug_log_dll $ grep <conexión> debug_log > debug_log_connection $ grep <fondo> debug_log > debug_log_backend
<backend> es el nombre del segundo plano el cual admite su escáner (pixma, genesys, plustek, hpaio, airscan etc.), <connection> es el tipo de conexión que utiliza para su dispositivo (tcp, usb).
La división hace que la investigación más dificultosa (la persona necesita tener tres archivos abiertos a la vez), por tanto divide las bitácoras solo si el archivo de bitácora es demasiado grande.
Want to help? Learn how to contribute to Fedora Docs ›