USBD_STATUS(9)

USBD_STATUS(9) | Kernel Developer's Manual | USBD_STATUS(9)

# 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.

May 12, 2012 | NetBSD 11.0