NAME

usbd_status — USB device drivers interface return status values

SYNOPSIS

#include <dev/usb/usbdi.h>

DESCRIPTION

This documents the full list of return values used by the generic USB code. Interface-specific definitions will be given with interface.

RETURN VALUES

Return values are split into two main groups: expected values and error values.

There are only two expected values:

USBD_NORMAL_COMPLETION

The operation completed successfully.

USBD_IN_PROGRESS

The operation was successfully submitted, usually part of an asynchronous operation.

These are the error values:

USBD_PENDING_REQUESTS

The requested operation could not be completed due to pending requests, usually from a pipe close operation.

USBD_NOT_STARTED

The initial status of a USB transfer. See usbdi(9) for more details about USB transfers.

USBD_INVAL

Invalid arguments were supplied for the requested operation.

USBD_NOMEM

No memory could be allocated.

USBD_CANCELLED

The USB transfer has been cancelled, and not completed.

USBD_BAD_ADDRESS

The requested USB pipe could not be found. See usbdi(9) for more details about USB pipes.

USBD_IN_USE

The requested operation could not be performed due to the device having active connections, such as USB audio device currently playing.

USBD_NO_ADDR

USB bus has reached its maximum limit of devices.

USBD_SET_ADDR_FAILED

Call to usbd_set_address() failed during new USB device discovery.

USBD_NO_POWER

New device has requested more power than is available.

USBD_TOO_DEEP

New USB Hub too deep from the root.

USBD_IOERROR

Non-specific error happened during IO.

USBD_NOT_CONFIGURED

USB device is not configured; it has no configuration descriptor.

USBD_TIMEOUT

Operation timed out.

USBD_SHORT_XFER

USB transfer succeeded but not all requested data was returned.

USBD_STALLED

USB controller has stalled (controller specific.)

USBD_INTERRUPTED

Process was interrupted by external means (such as a signal) while waiting for a transfer to complete.

SEE ALSO

usb(4), usbdi(9)

HISTORY

This usbd_status interface first appeared in NetBSD 1.4.