Chapter 19. Generic Error Codes

Table 19.1. Generic error codes

EBADFThe file descriptor is not a valid.
EBUSYThe ioctl can't be handled because the device is busy. This is typically return while device is streaming, and an ioctl tried to change something that would affect the stream, or would require the usage of a hardware resource that was already allocated. The ioctl must not be retried without performing another action to fix the problem first (typically: stop the stream before retrying).
EFAULTThere was a failure while copying data from/to userspace, probably caused by an invalid pointer reference.
EINVALOne or more of the ioctl parameters are invalid or out of the allowed range. This is a widely used error code. See the individual ioctl requests for specific causes.
ENODEVDevice not found or was removed.
ENOMEMThere's not enough memory to handle the desired operation.
ENOTTYThe ioctl is not supported by the driver, actually meaning that the required functionality is not available, or the file descriptor is not for a media device.
ENOSPCOn USB devices, the stream ioctl's can return this error, meaning that this request would overcommit the usb bandwidth reserved for periodic transfers (up to 80% of the USB bandwidth).
ENOSYS or EOPNOTSUPPFunction not available for this device (dvb API only. Will likely be replaced anytime soon by ENOTTY).
EPERMPermission denied. Can be returned if the device needs write permission, or some special capabilities is needed (e. g. root)
EWOULDBLOCKOperation would block. Used when the ioctl would need to wait for an event, but the device was opened in non-blocking mode.

Note 1: ioctls may return other error codes. Since errors may have side effects such as a driver reset, applications should abort on unexpected errors.

Note 2: Request-specific error codes are listed in the individual requests descriptions.