[fprint] Domains Errors and Complete error codes List

[Benjamin Berg]

Hi,

we have two main error domains inside libfprint. Those are
FP_DEVICE_RETRY and FP_DEVICE_ERROR which identify soft errors and hard
errors.

We do however currently expose the underlying error from e.g. libusb if
such an error occur. Any such error needs to be be considered
equivalent to FP_DEVICE_ERROR, FP_DEVICE_ERROR_GENERAL.

(Except of course G_IO_ERROR, G_IO_ERROR_CANCELLED which has the same
semantics as usual and will be returned if the API user cancelled the
operation.)


In the unplug case the behaviour depends on the libfprint version.
There were changes and we added FP_DEVICE_ERROR_REMOVED which should be
returned in most cases after an unplug has happened.

Note that the documentation was missing the "device-removed"/"device-
added" and "removed" signals for FpContext and FpDevice respectively. I
have now updated the website, see:
  https://fprint.freedesktop.org/libfprint-dev/FpDevice.html#FpDevice-removed

Benjamin

On Tue, 2021-03-16 at 23:58 +0000, Carlos Garcia wrote:
>  
> Hi everyone I have some questions about Gerror for FpDevice.
>  
> I tried some error conditions related to unplugging the device and then
> I have different errors.
>  
> For example:
>  
> Unplug the device when capture I have:
>  
>        codes: 3
>     domain: 121
>    message: Endpoint stalled or request not supported
> reproduce: When WAIT_FOR_FINGER_ON unplug device.
>  
>           code: 4
>      domain: 121
>    message: No such device (it may have been disconnected) [-4]
> reproduce: Open device then unplug and next plug again. Start capture
> process.
>  
>  
>         codes: 8
>     domain: 121
>    message: msg transfer failed
> reproduce: Using a VM with VirtualBox remove the device from USB
> devices menu.
>  
>  
> I saw that other domains such as G_IO_ERROR or G_USB_DEVICE_ERROR or
> G_LIB_USB may also be reported.
> I also saw that code 4 represents a GLIB error code but code 3 and 8 is
> not aG_IO_ERROR orG_USB_DEVICE_ERROR
> I known exists the FpDeviceRetry domain.
>  
> So my questions are:
>  
> Who represents de 121 domain?
> Is there a complete list of libfprint error codes and domains?
>  
>  
> Thanks
>  
>  
>  
>  
> Sent from Mail for Windows 10
>  
> _______________________________________________
> fprint mailing list
> fprint at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/fprint

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 833 bytes
Desc: This is a digitally signed message part
URL: <https://lists.freedesktop.org/archives/fprint/attachments/20210317/c78f61fe/attachment.sig>