/*
 * CDDL HEADER START
 *
 * The contents of this file are subject to the terms of the
 * Common Development and Distribution License (the "License").
 * You may not use this file except in compliance with the License.
 *
 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
 * or http://www.opensolaris.org/os/licensing.
 * See the License for the specific language governing permissions
 * and limitations under the License.
 *
 * When distributing Covered Code, include this CDDL HEADER in each
 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
 * If applicable, add the following below this CDDL HEADER, with the
 * fields enclosed by brackets "[]" replaced with your own identifying
 * information: Portions Copyright [yyyy] [name of copyright owner]
 *
 * CDDL HEADER END
 */
/*
 * Copyright (c) 2004, 2011, Oracle and/or its affiliates. All rights reserved.
 */

/*
 * This library can either be used stand-alone or as plugin
 * to the libusb wrapper library.
 * The libusb API 0.1.0.10 has been implemented using all original code
 * which was not derived from opensource.
 *
 * XXX issues:
 *	- timeout thru signal
 *	- usb_interrupt/bulk_write/read should have common code
 */

#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
#include <unistd.h>
#include <string.h>
#include <fcntl.h>
#include <sys/time.h>
#include <dirent.h>
#include <stdarg.h>
#include <strings.h>
#include <sys/stat.h>
#include <regex.h>

#include <sys/usb/clients/ugen/usb_ugen.h>
#include "usb.h"
#include "libusbugen_impl.h"

/* global variables */
usb_bus_t *usb_busses = NULL;
const char *libusb_version = "1.1";

/* error handling */
static	char usb_error_string[1024];
static	int usb_error_errno;
static	usb_error_type_t usb_error_type = USB_ERROR_TYPE_NONE;

/* debugging */
static	int libusb_debug = DEBUG_NONE;

/* api binding */
static	int libusb_api = API_RELAXED;

/* internal function prototypes */
static	void usb_error_str(int x, char *format, ...);
static	int usb_error(int x);
static	void usb_dprintf(int level, char *format, ...);
static	void usb_dump_data(char *data, int size);

static	int usb_open_ep0(usb_dev_handle_impl_t *hdl);
static	void usb_close_ep0(usb_dev_handle_impl_t *hdl);
static	int usb_check_access(usb_dev_handle *dev);
static	int usb_search_dev_usb(usb_device_t **new_devices);
static	int usb_do_io(int fd, int stat_fd, char *data, size_t size, int flag);
static	int usb_send_msg(int fd, int stat_fd, int requesttype, int request,
	int value, int index, char *data, int size);
static	int usb_check_device_and_status_open(usb_dev_handle *dev,
	int ep, int ep_type, int mode);
static	int usb_get_status(int fd);
static	void usb_set_ep_iface_alts(usb_dev_handle_impl_t *hdl,
	usb_dev_handle_info_t *info, int index, int interface, int alternate);

static	int usb_setup_all_configs(usb_dev_handle_impl_t *hdl);
static	void usb_free_all_configs(usb_device_t *device);
static	int usb_parse_config(usb_dev_handle_impl_t *hdl, uint_t index);
static	void usb_free_config(usb_device_t *device, uint_t index);
static	int usb_parse_interface(usb_dev_handle_impl_t *hdl, uint_t index,
	uint_t iface, char *cloud);
static	void usb_free_interface(usb_device_t *device, uint_t index,
	uint_t iface);
static	int usb_parse_alternate(usb_dev_handle_impl_t *hdl, uint_t index,
	uint_t iface, uint_t alt, char *cloud);
static	void usb_free_alternate(usb_device_t *device, uint_t index,
	uint_t iface, uint_t alt);
static	int usb_parse_endpoint(usb_dev_handle_impl_t *hdl, int index,
	int iface, int alt, int ep, char *cloud);
static	void usb_find_extra(uchar_t *buf, size_t buflen,
	unsigned char **extra, int *extralen);

static	void usb_close_all_eps(usb_dev_handle_impl_t *hdl);
static	void usb_add_device(usb_device_t **list, usb_device_t *dev);
static	void usb_remove_device(usb_device_t **list, usb_device_t *dev);
static	int usb_check_device_in_list(usb_device_t *list, usb_device_t *dev);

static	void usb_free_dev(usb_device_t *dev);
static	void usb_free_bus(usb_bus_t *bus);

static size_t usb_parse_dev_descr(uchar_t *buf, size_t buflen,
	struct usb_device_descriptor *ret_descr, size_t	ret_buf_len);
static size_t usb_parse_cfg_descr(uchar_t *buf, size_t buflen,
	usb_cfg_descr_t	*ret_descr, size_t ret_buf_len,
	unsigned char **extra, int *extralen);
static size_t usb_parse_if_descr(uchar_t *buf, size_t buflen,
	uint_t if_number, uint_t alt_if_setting,
	usb_if_descr_t *ret_descr, size_t ret_buf_len,
	unsigned char **extra, int *extralen);
static size_t usb_parse_ep_descr(uchar_t *buf, size_t buflen,
	uint_t if_number, uint_t alt_if_setting, uint_t ep_index,
	usb_ep_descr_t *ret_descr, size_t ret_buf_len,
	unsigned char **extra, int *extralen);
static uchar_t usb_ep_index(uint8_t ep_addr);

/*
 * libusb_init:
 *
 * Returns: 0 or ENOSUP if we cannot support any bus
 */
int
libusb_init(void)
{
	return (0);
}

/*
 * libusb_fini:
 *
 * Returns: always returns 0
 */
int
libusb_fini(void)
{
	return (0);
}

/*
 * Entry points:
 *
 * usb_set_debug:
 *	sets debug level for tracing
 */
void
usb_set_debug(int level)
{
	if (getenv("SUN_LIBUSBUGEN_DEBUG")) {

		level =	atoi(getenv("SUN_LIBUSBUGEN_DEBUG"));

	} else if (getenv("SUN_LIBUSB_DEBUG")) {

		level = atoi(getenv("SUN_LIBUSB_DEBUG"));
	}

	if (level < 0)
		return;

	libusb_debug = level;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_set_debug(): "
	    "Setting debugging level to %d (%s)\n",
	    level, level ? "on" : "off");
}

/*
 * usb_init:
 *	not much to initialize. just set debug level
 */
void
usb_init(void)
{
	if (getenv("LIBUSB_API_STRICT")) {
		libusb_api = API_STRICT;
	}

	usb_set_debug(libusb_debug);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_init(): "
	    "libusb version=%s\n", libusb_version);
}

/*
 * usb_get_busses:
 * Returns: usb_busses pointer
 */
usb_bus_t *
usb_get_busses(void)
{
	return (usb_busses);
}

/*
 * usb_find_busses:
 *	finds all busses in the system. On solaris we have
 *	only one flat name space, /dev/usb
 *
 * Returns: change in number of busses or negative errno
 */
int
usb_find_busses(void)
{
	usb_bus_t *bus;

	/* we only have one name space for all USB busses */
	if (usb_busses == NULL) {
		/* never freed */
		if ((bus = calloc(sizeof (*bus), 1)) == NULL) {

			return (usb_error(ENOMEM));
		}

		(void) strncpy(bus->dirname, "/dev/usb",
		    sizeof (bus->dirname));

		usb_dprintf(DEBUG_FUNCTIONS, "usb_find_busses(): "
		    "found %s\n", bus->dirname);

		usb_busses = bus;

		return (1);
	}

	return (0);
}

/*
 * usb_find_devices:
 *	finds all devices that have appeared and removes devices
 *	from the list that are no longer there
 *
 * Returns: change in number of devices or a negative errno
 */
int
usb_find_devices(void)
{
	int i, rval, found;
	int changes = 0;
	usb_device_t *new_devices;
	usb_device_t *dev, *next_dev, *new, *next_new;

	new_devices = NULL;

	rval = usb_search_dev_usb(&new_devices);
	if (rval != 0) {

		return (usb_error(rval));
	}

	/* is any of devices on the new list also on the old list? */
	for (dev = usb_busses->devices; dev != NULL; dev = next_dev) {
		next_dev = dev->next;
		found = 0;
		for (new = new_devices; new != NULL; new = next_new) {
			next_new = new->next;
			if (strncmp(dev->filename, new->filename,
			    sizeof (dev->filename)) == 0) {
				usb_remove_device(&new_devices, new);
				usb_free_dev(new);
				found++;
				break;
			}
		}

		/* the device must have been hot removed */
		if (!found) {
			usb_remove_device(&usb_busses->devices, dev);
			usb_free_dev(dev);
		}
	}

	/* add all new_devices to the old_devices list */
	usb_dprintf(DEBUG_DETAILED, "moving new to old\n");

	for (new = new_devices; new != NULL; new = next_new) {
		next_new = new->next;
		usb_remove_device(&new_devices, new);
		usb_add_device(&usb_busses->devices, new);
		(void) usb_close(usb_open(new));
		changes++;
	}

	usb_dprintf(DEBUG_DETAILED, "usb_devices list:\n");
	for (i = 0, dev = usb_busses->devices; dev != NULL;
	    i++, dev = next_dev) {
		next_dev = dev->next;
		usb_dprintf(DEBUG_DETAILED, "%d: %s\n", i, dev->filename);
	}

	return (changes);
}

/*
 * usb_device:
 *	 included because sane uses this
 * Returns: usb_device structure associated with handle
 */
struct usb_device *
usb_device(usb_dev_handle *dev)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;

	return ((hdl != NULL) ? hdl->device : NULL);
}

/*
 * usb_open:
 *	opens the device for access
 *
 * Returns: a usb device handle or NULL
 */
usb_dev_handle *
usb_open(usb_device_t *dev)
{
	usb_dev_handle_impl_t	*hdl;
	usb_dev_handle_info_t	*info;
	int			i, rval;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_open():\n");

	if (usb_check_device_in_list(usb_busses->devices,
	    dev) == 0) {
		usb_dprintf(DEBUG_ERRORS, "usb_open(): "
		    "illegal usb_device pointer\n");

		return (NULL);
	}

	/* create a handle and info structure */
	if ((hdl = calloc(sizeof (*hdl), 1)) == NULL) {

		return (NULL);
	}
	hdl->device = dev;
	if ((info = calloc(sizeof (*info), 1)) == NULL) {
		free(hdl);

		return (NULL);
	}

	hdl->info = info;

	/* set all file descriptors to "closed" */
	for (i = 0; i < USB_MAXENDPOINTS; i++) {
		hdl->info->ep_fd[i] = -1;
		hdl->info->ep_status_fd[i] = -1;
		if (i > 0) {
			hdl->info->ep_interface[i] = -1;
		}
	}

	/* open default control ep and keep it open */
	if ((rval = usb_open_ep0(hdl)) != 0) {
		usb_dprintf(DEBUG_ERRORS, "usb_open_ep0 failed: %d\n", rval);
		free(info);
		free(hdl);

		return (NULL);
	}

	/*
	 * setup config info: trees of configs, interfaces, alternates
	 * and endpoints structures
	 */
	if (usb_setup_all_configs(hdl) != 0) {
		usb_free_all_configs(hdl->device);
		usb_close_ep0(hdl);
		free(info);
		free(hdl);

		return (NULL);
	}

	/* set when the app claims an interface */
	info->configuration_value =
	    info->claimed_interface = info->alternate = -1;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_open(): hdl=0x%x\n", (int)hdl);

	return ((usb_dev_handle *)hdl);
}

/*
 * usb_close:
 *	closes the device and free resources
 *
 * Returns: 0
 */
int
usb_close(usb_dev_handle *dev)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_close(): hdl=0x%x\n", hdl);

	if (hdl) {
		info = hdl->info;

		usb_dprintf(DEBUG_DETAILED,
		    "usb_close(): claimed %d\n",
		    info->claimed_interface);

		if (info->claimed_interface != -1) {
			(void) usb_release_interface(dev,
			    info->claimed_interface);
		}
		usb_close_all_eps(hdl);
		usb_close_ep0(hdl);

		free(info);
		free(hdl);

		return (0);
	}

	return (usb_error(EINVAL));
}

/*
 * usb_control_msg:
 *	sends a control message
 *
 * Returns: actual number of data bytes transferred or
 *	    a negative errno
 */
/*ARGSUSED*/
int
usb_control_msg(usb_dev_handle *dev, int requesttype, int request,
    int value, int index, char *data, int size, int timeout)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int additional;
	int rval;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_control_msg():\n");

	if ((hdl == NULL) || (size < 0)) {

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/*
	 * no need to do validation since ep0 is always open and
	 * we do not need to claim an interface first
	 *
	 * usb_send_msg returns #bytes xferred or negative errno
	 */
	rval = usb_send_msg(info->ep_fd[0], info->ep_status_fd[0],
	    requesttype, request, value, index, data, size);

	/* less than setup bytes transferred? */
	if (rval < 8) {
		usb_error_str(errno,
		    "error sending control message: %d", rval);

		return ((rval >= 0) ?
		    usb_error(EIO) : usb_error(-rval));
	}

	rval -= 8; /* substract setup length */

	/* for IN requests, now transfer the remaining bytes */
	if ((size) && (requesttype & USB_DEV_REQ_DEV_TO_HOST)) {
		additional = usb_do_io(info->ep_fd[0],
		    info->ep_status_fd[0], data, size, READ);
	} else {
		additional = rval;
	}

	usb_dprintf(DEBUG_FUNCTIONS,
	    "usb_control_msg(): additional 0x%x bytes\n", additional);

	return (additional);
}

/*
 * usb_bulk_write:
 *	writes to a bulk endpoint
 *
 * Returns: actual number of data bytes transferred or negative errno
 */
/* ARGSUSED */
int
usb_bulk_write(usb_dev_handle *dev, int ep, char *data, int size,
    int timeout)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int sent, rval;
	int ep_index = usb_ep_index(ep);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_bulk_write(): ep=0x%x\n", ep);

	if ((hdl == NULL) || (data == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_bulk_write(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/* do some validation first */
	if ((rval = usb_check_device_and_status_open(dev, ep,
	    USB_ENDPOINT_TYPE_BULK, O_WRONLY)) != 0) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_check_device_and_status_open() failed\n");

		return (usb_error(rval));
	}

	/* now write out the bytes */
	sent = usb_do_io(info->ep_fd[ep_index], info->ep_status_fd[ep_index],
	    data, size, WRITE);

	return (sent);
}

/*
 * usb_bulk_read:
 *	reads from a bulk endpoint
 *
 * Returns: actual number of data bytes transferred or negative errno
 */
/* ARGSUSED */
int
usb_bulk_read(usb_dev_handle *dev, int ep, char *data, int size,
    int timeout)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int ep_index, received, rval;

	ep |= USB_ENDPOINT_IN;
	ep_index = usb_ep_index(ep);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_bulk_read(): ep=0x%x\n", ep);

	if ((hdl == NULL) || (data == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_bulk_read(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/* do some validation first */
	if ((rval = usb_check_device_and_status_open(dev, ep,
	    USB_ENDPOINT_TYPE_BULK, O_RDONLY)) != 0) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_check_device_and_status_open() failed\n");

		return (usb_error(rval));
	}

	/* now read in the bytes */
	received = usb_do_io(info->ep_fd[ep_index],
	    info->ep_status_fd[ep_index],
	    data, size, READ);

	return (received);
}

/*
 * usb_interrupt_write:
 *	writes data to an interrupt endpoint
 *
 * Returns: actual number of data bytes transferred or negative errno
 */
/* ARGSUSED */
int
usb_interrupt_write(usb_dev_handle *dev, int ep, char *data, int size,
    int timeout)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int sent, rval;
	int ep_index = usb_ep_index(ep);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_interrupt_write(): ep=0x%x\n", ep);

	if ((hdl == NULL) || (data == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_interrupt_write(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/* do some validation first */
	if ((rval = usb_check_device_and_status_open(dev, ep,
	    USB_ENDPOINT_TYPE_INTERRUPT, O_WRONLY)) != 0) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_check_device_and_status_open() failed\n");

		return (usb_error(rval));
	}

	/* now transfer the bytes */
	sent = usb_do_io(info->ep_fd[ep_index],
	    info->ep_status_fd[ep_index],
	    data, size, WRITE);

	return (sent);
}

/*
 * usb_interrupt_read:
 *	reads data from an interrupt endpoint
 *
 * Returns: actual number of data bytes transferred or negative errno
 */
/* ARGSUSED */
int
usb_interrupt_read(usb_dev_handle *dev, int ep, char *data, int size,
    int timeout)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int ep_index, received, rval;

	ep |= USB_ENDPOINT_IN;
	ep_index = usb_ep_index(ep);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_interrrupt_read(): ep=0x%x\n", ep);

	if ((hdl == NULL) || (data == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_interrupt_read(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/* do some validation first */
	if ((rval = usb_check_device_and_status_open(dev, ep,
	    USB_ENDPOINT_TYPE_INTERRUPT, O_RDONLY)) != 0) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_check_device_and_status_open() failed\n");

		return (usb_error(rval));
	}

	/* now transfer the bytes */
	received = usb_do_io(info->ep_fd[ep_index],
	    info->ep_status_fd[ep_index],
	    data, size, READ);

	/* close the endpoint so we stop polling the endpoint now */
	(void) close(info->ep_fd[ep_index]);
	(void) close(info->ep_status_fd[ep_index]);
	info->ep_fd[ep_index] = -1;
	info->ep_status_fd[ep_index] = -1;

	return (received);
}

/*
 * usb_get_string:
 *	gets a raw unicode string
 *
 * Returns: number of bytes transferred or negative errno
 */
int
usb_get_string(usb_dev_handle *dev, int index, int langid, char *buf,
    size_t buflen)
{
	/*
	 * We can't use usb_get_descriptor() because it's lacking the index
	 * parameter. This will be fixed in libusb 1.0
	 */
	usb_dprintf(DEBUG_FUNCTIONS,
	    "usb_get_string(): index=%d langid=0x%x len=%d\n",
	    index, langid, buflen);

	if ((dev == NULL) || (buf == NULL) || (buflen == 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_get_string(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}


	return (usb_control_msg(dev, USB_DEV_REQ_DEV_TO_HOST,
	    USB_REQ_GET_DESCRIPTOR, (USB_DT_STRING << 8) + index,
	    langid, buf, (int)buflen, 1000));
}

/*
 * usb_get_string_simple:
 *	gets a cooked ascii string
 *
 * Returns:  number of bytes transferred or negative errno
 */
int
usb_get_string_simple(usb_dev_handle *dev, int index, char *buf,
    size_t buflen)
{
	char tbuf[256];
	int ret, langid, si, di;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_get_string_simple(): index=%d\n",
	    index);

	if ((dev == NULL) || (buf == NULL) || (buflen == 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_get_string_simple(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}

	(void) memset(buf, 0, buflen);

	/*
	 * Asking for the zero'th index is special - it returns a string
	 * descriptor that contains all the language IDs supported by the
	 * device. Typically there aren't many - often only one. The
	 * language IDs are 16 bit numbers, and they start at the third byte
	 * in the descriptor. See USB 2.0 specification, section 9.6.7, for
	 * more information on this.
	 */
	ret = usb_get_string(dev, index, 0, tbuf, sizeof (tbuf));
	usb_dprintf(DEBUG_DETAILED, "usb_get_string() returned %d\n", ret);

	if (ret < 4) {
		langid = 0x409;
	} else {
		langid = tbuf[2] | (tbuf[3] << 8);
	}

	usb_dprintf(DEBUG_DETAILED, "using langid=0x%x\n", langid);

	ret = usb_get_string(dev, index, langid, tbuf, sizeof (tbuf));
	if (ret < 0) {

		return (ret);
	}
	if (tbuf[1] != USB_DT_STRING) {

		return (-EIO);
	}
	if (tbuf[0] > ret) {

		return (-EFBIG);
	}

	for (di = 0, si = 2; si < tbuf[0]; si += 2) {
		if (di >= ((int)buflen - 1)) {
			break;
		}

		if (tbuf[si + 1]) {  /* high byte */
			buf[di++] = '?';
		} else {
			buf[di++] = tbuf[si];
		}
	}

	buf[di] = 0;

	return (di);
}

/*
 * usb_get_descriptor_by_endpoint:
 * usb_get_descriptor:
 *	get a descriptor. by_endpoint does not appear to make
 *	much sense.
 *
 * Returns: number of bytes transferred or negative errno
 */
int
usb_get_descriptor_by_endpoint(usb_dev_handle *udev, int ep,
    uchar_t type, uchar_t index, void *buf, int size)
{
	if ((udev == NULL) || (buf == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_get_descriptor_by_endpoint(): "
		    "NULL handle or data\n");

		return (usb_error(EINVAL));
	}

	(void) memset(buf, 0, size);

	return (usb_control_msg(udev,
	    ep | USB_ENDPOINT_IN, USB_REQ_GET_DESCRIPTOR,
	    (type << 8) + index, 0, buf, size, 1000));
}

int
usb_get_descriptor(usb_dev_handle *udev, uchar_t type,
    uchar_t index, void *buf, int size)
{
	if ((udev == NULL) || (buf == NULL) || (size <= 0)) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_get_string_simple(): NULL handle or data\n");

		return (usb_error(EINVAL));
	}

	(void) memset(buf, 0, size);

	return (usb_control_msg(udev,
	    USB_ENDPOINT_IN, USB_REQ_GET_DESCRIPTOR,
	    (type << 8) + index, 0, buf, size, 1000));
}

/*
 * usb_set_altinterface:
 *	switches to the alternate interface for the device
 *	Note that ugen does not really need this. It does implicit
 *	cfg and alt switches when the endpoint is opened.
 *
 * Returns: 0 or negative errno
 */
/* ARGSUSED */
int
usb_set_altinterface(usb_dev_handle *dev, int alt)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	usb_device_specific_t *dev_specific;
	int index, iface, err;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_set_altinterface(): "
	    "hdl=0x%x alt=%d\n", hdl, alt);

	if (hdl == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_set_altinterface(): NULL handle\n");

		return (usb_error(EINVAL));
	}

	info = hdl->info;

	if (libusb_api == API_RELAXED) {
		if (info->claimed_interface == -1) {
			/*
			 * usb_claim_interface() should always be called
			 * prior usb_set_altinterface(), but some apps
			 * do not do this, hence we call it here assuming
			 * the default interface.
			 */
			if ((err = usb_claim_interface(dev, 0))) {

				return (err);
			}
		}
	}

	iface = info->claimed_interface;
	dev_specific = (usb_device_specific_t *)(hdl->device->dev);

	usb_dprintf(DEBUG_DETAILED, "claimed=%d, cfgvalue=%d, hdl=0x%x\n",
	    info->claimed_interface, info->configuration_value,
	    dev_specific->claimed_interfaces[iface], hdl);

	if ((info->claimed_interface == -1) ||
	    (info->configuration_value == -1) ||
	    (hdl != dev_specific->claimed_interfaces[iface])) {

		return (usb_error(EACCES));
	}

	usb_close_all_eps(hdl);

	/* find the conf index */
	for (index = 0; index < hdl->device->descriptor.bNumConfigurations;
	    index++) {
		if (info->configuration_value ==
		    hdl->device->config[index].bConfigurationValue) {
			break;
		}
	}

	usb_dprintf(DEBUG_DETAILED,
	    "cfg value=%d index=%d, iface=%d, alt=%d #alts=%d\n",
	    info->configuration_value, index, iface, alt,
	    hdl->device->config[index].interface[iface].num_altsetting);

	if ((alt < 0) || (alt >= hdl->device->
	    config[index].interface[iface].num_altsetting)) {

		return (usb_error(EINVAL));
	}

	info->alternate = alt;

	usb_set_ep_iface_alts(hdl, info, index, iface, alt);

	return (0);
}

/*
 * usb_set_configuration:
 *	sets the configuration for the device.
 *	ugen implicitly switches configuration and rejects
 *	set configuration requests
 *
 * Returns: 0
 */
/* ARGSUSED */
int
usb_set_configuration(usb_dev_handle *dev, int configuration)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	int index, i;

	usb_dprintf(DEBUG_FUNCTIONS,
	    "usb_set_configuration(): config = %d\n", configuration);

	if (hdl == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_set_configuration(): NULL handle\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	/* find the conf index */
	for (index = 0; index < hdl->device->descriptor.bNumConfigurations;
	    index++) {
		if (configuration ==
		    hdl->device->config[index].bConfigurationValue) {
			break;
		}
	}

	if (index >= hdl->device->descriptor.bNumConfigurations) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_set_configuration(): invalid\n");

		return (usb_error(EINVAL));
	}

	usb_close_all_eps(hdl);
	info->configuration_value = configuration;
	info->configuration_index = index;

	/* reset ep arrays */
	for (i = 0; i < USB_MAXENDPOINTS; i++) {
		info->ep_interface[i] = -1;
	}
	if (info->claimed_interface != -1) {
		(void) usb_release_interface(dev, info->claimed_interface);
	}

	return (0);
}

/*
 * usb_clear_halt:
 *	clears a halted endpoint
 *	ugen has auto clearing but we send the request anyways
 *
 * Returns: 0 or negative errno
 */
/* ARGSUSED */
int
usb_clear_halt(usb_dev_handle *dev, unsigned int ep)
{
	int rval;
	int index = usb_ep_index(ep);
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_clear_halt(): ep=0x%x\n", ep);

	if (dev == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_clear_halt(): NULL handle\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;

	usb_dprintf(DEBUG_DETAILED, "index=0x%x, ep_intf=%d\n",
	    index, info->ep_interface[index]);

	if (info->ep_interface[index] == -1) {

		return (usb_error(EINVAL));
	}


	/* only check for ep > 0 */
	if (ep && ((rval = usb_check_access(dev) != 0))) {

		return (usb_error(rval));
	}

	rval = usb_control_msg(dev,
	    USB_DEV_REQ_HOST_TO_DEV | USB_RECIP_ENDPOINT,
	    USB_REQ_CLEAR_FEATURE, 0, ep, NULL, 0, 0);

	if (rval < 0) {
		usb_error_str(errno, "could not clear feature on ep=0x%x", ep);
	}

	return (rval);
}

/*
 * usb_claim_interface:
 *	ugen does not have a claim interface concept but all endpoints
 *	are opened exclusively. This provides some exclusion. However,
 *	the interrupt IN endpoint is closed after the read
 *
 * Returns: 0 or negative errno
 */
int
usb_claim_interface(usb_dev_handle *dev, int interface)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	usb_device_specific_t *dev_specific;
	int index;

	if (hdl == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_claim_interface(): NULL handle\n");

		return (usb_error(EINVAL));
	}
	info = hdl->info;
	dev_specific = (usb_device_specific_t *)(hdl->device->dev);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_claim_interface(): hdl=0x%x: "
	    "interface = %d\n", hdl, interface);

	if (info->configuration_value == -1) {
		index = 0;
	} else {
		/* find the conf index */
		for (index = 0;
		    index < hdl->device->descriptor.bNumConfigurations;
		    index++) {
			if (info->configuration_value ==
			    hdl->device->config[index].bConfigurationValue) {
				break;
			}
		}
	}
	info->configuration_value =
	    hdl->device->config[index].bConfigurationValue;
	info->configuration_index = index;

	usb_dprintf(DEBUG_DETAILED, "configuration_value=%d, index=%d\n",
	    info->configuration_value, index);

	/* is this a valid interface? */
	if ((interface < 0) || (interface > 255) ||
	    (interface >= hdl->device->config[index].bNumInterfaces)) {

		return (usb_error(EINVAL));
	}

	/* already claimed? */
	if (dev_specific->claimed_interfaces[interface] == hdl) {

		return (0);
	}

	if (info->claimed_interface != -1) {

		return (usb_error(EBUSY));
	}

	if (dev_specific->claimed_interfaces[interface] != 0) {

		return (usb_error(EBUSY));
	}

	usb_dprintf(DEBUG_DETAILED, "usb_claim_interface(): hdl=0x%x: "
	    "interface = %d, claimed by this udev=%d, by hdl=0x%x\n",
	    hdl, interface, info->claimed_interface,
	    dev_specific->claimed_interfaces[interface]);


	info->claimed_interface = interface;
	info->alternate = 0;
	dev_specific->claimed_interfaces[interface] = hdl;

	usb_set_ep_iface_alts(hdl, info, index, interface, 0);

	return (0);
}

/*
 * usb_release_interface:
 *	releases the acquired interface
 *
 * Returns: 0 or negative errno
 */
/* ARGSUSED */
int
usb_release_interface(usb_dev_handle *dev, int interface)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info;
	usb_device_specific_t *dev_specific;

	if (hdl == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_release_interface(): NULL handle\n");

		return (usb_error(EINVAL));
	}

	info = hdl->info;
	dev_specific = (usb_device_specific_t *)(hdl->device->dev);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_release_interface(): hdl=0x%x: "
	    "interface = %d\n", hdl, interface);

	if ((info->claimed_interface == -1) ||
	    (info->claimed_interface != interface)) {

		return (usb_error(EINVAL));
	}

	usb_dprintf(DEBUG_DETAILED, "usb_release_interface(): hdl=0x%x: "
	    "interface = %d, claimed by this udev=%d, by hdl=0x%x\n",
	    hdl, interface, info->claimed_interface,
	    dev_specific->claimed_interfaces[interface]);

	dev_specific->claimed_interfaces[interface] = 0;
	info->claimed_interface = -1;

	return (0);
}

/*
 * usb_resetep
 *	resets the endpoint
 *
 * Returns: 0 or negative errno
 */
int
usb_resetep(usb_dev_handle *dev, unsigned int ep)
{
	usb_dprintf(DEBUG_FUNCTIONS, "usb_resetep(): ep=0x%x\n", ep);

	return (usb_clear_halt(dev, ep));
}

/*
 * usb_reset:
 *	resets the device
 * Returns: -ENOTSUP
 */
/* ARGSUSED */
int
usb_reset(usb_dev_handle * dev)
{
	int rval;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_reset():\n");

	if (dev == NULL) {
		usb_dprintf(DEBUG_ERRORS,
		    "usb_reset(): NULL handle\n");

		return (usb_error(EINVAL));
	}

	if ((rval = usb_check_access(dev)) != 0) {

		return (usb_error(rval));
	}

	return (usb_error(ENOTSUP));
}

/*
 * Helper functions
 *
 * usb_send_msg:
 *	creates setup data and send it
 *
 * Returns: number of bytes transferred or negative errno
 */
static int
usb_send_msg(int fd, int stat_fd, int requesttype, int request, int value,
    int index, char *data, int size)
{
	uint8_t req[8];
	int rval;

	usb_dprintf(DEBUG_DETAILED, "usb_send_msg():\n"
	    "\trequesttype 0x%x\n"
	    "\trequest	   0x%x\n"
	    "\tvalue	   0x%x\n"
	    "\tindex	   0x%x\n"
	    "\tsize	   0x%x\n",
	    requesttype, request, value, index, size);

	req[0] = (uint8_t)requesttype;
	req[1] = (uint8_t)request;
	req[2] = (uint8_t)value;
	req[3] = (uint8_t)(value >> 8);
	req[4] = (uint8_t)index;
	req[5] = (uint8_t)(index >> 8);
	req[6] = (uint8_t)size;
	req[7] = (uint8_t)(size >> 8);

	if (requesttype & USB_DEV_REQ_DEV_TO_HOST) {
		rval = usb_do_io(fd, stat_fd, (char *)&req,
		    sizeof (req), WRITE);
	} else {
		/* append the write data */
		char *buffer;

		if ((buffer = malloc(size + 8)) == NULL) {

			return (usb_error(ENOMEM));
		}

		(void) memcpy(buffer, &req, 8);
		(void) memcpy(&buffer[8], data, size);
		rval = usb_do_io(fd, stat_fd, buffer,
		    (uint_t)sizeof (req) + size, WRITE);
		free(buffer);
	}
	usb_dprintf(DEBUG_FUNCTIONS, "usb_send_msg(): rval=%d\n", rval);

	return (rval);
}

/*
 * usb_do_io:
 *	performs i/o to/from an endpoint and check the
 *	status of the device if error or short xfer.
 *
 * Returns: bytes transferred or negative errno
 */
static int
usb_do_io(int fd, int stat_fd, char *data, size_t size, int flag)
{
	int error;
	ssize_t ret;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_do_io(): size=0x%x flag=%d\n",
	    size, flag);

	if (size == 0) {

		return (0);
	}

	switch (flag) {
	case READ:
		ret = read(fd, data, size);
		usb_dump_data(data, (int)size);
		break;
	case WRITE:
		usb_dump_data(data, (int)size);
		ret = write(fd, data, size);
		break;
	}
	if (ret < 0) {
		int save_errno = errno;

		/* usb_get_status will do a read and overwrite errno */
		error = usb_get_status(stat_fd);
		usb_error_str(save_errno, "error %d doing io: errno=%d",
		    error, save_errno);

		return (-save_errno);
	}

	usb_dprintf(DEBUG_FUNCTIONS, "usb_do_io(): amount=%d\n", ret);

	return ((int)ret);
}

/*
 * usb_check_access:
 *	basically checks if the interface has been claimed
 *
 * Returns: 0 or EACCES/EINVAL
 */
static int
usb_check_access(usb_dev_handle *dev)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info = hdl->info;

	if (hdl == NULL) {

		return (EINVAL);
	}
	info = hdl->info;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_check_access(): "
	    "hdl=0x%x conf=%d claimed=%d alternate=%d\n",
	    (int)hdl, info->configuration_value,
	    info->claimed_interface, info->alternate);

	if ((info->configuration_value == -1) ||
	    (info->claimed_interface == -1) ||
	    (info->alternate == -1)) {

		return (EACCES);
	}

	return (0);
}

/*
 * usb_set_ep_iface_alts:
 *	initialize ep_interface arrays
 */
static void
usb_set_ep_iface_alts(usb_dev_handle_impl_t *hdl, usb_dev_handle_info_t *info,
    int index, int interface, int alternate)
{
	struct usb_interface_descriptor *if_descr;
	struct usb_endpoint_descriptor *ep_descr;
	int i;

	/* reinitialize endpoint arrays */
	for (i = 0; i < USB_MAXENDPOINTS; i++) {
		info->ep_interface[i] = -1;
	}

	/*
	 * for the current config, this interface and alt,
	 * which endpoints are available
	 */
	if_descr = &hdl->device->config[index].interface[interface].
	    altsetting[alternate];

	usb_dprintf(DEBUG_DETAILED, "cfg%d.%d.%d has %d endpoints\n",
	    info->configuration_value, interface, alternate,
	    if_descr->bNumEndpoints);

	for (i = 0; i < if_descr->bNumEndpoints; i++)  {
		ep_descr = &hdl->device->config[index].interface[interface].
		    altsetting[alternate].endpoint[i];
		info->ep_interface[usb_ep_index(
		    ep_descr->bEndpointAddress)] = interface;
	}

	usb_dprintf(DEBUG_DETAILED, "ep_interface:\n");
	for (i = 0; i < USB_MAXENDPOINTS; i++) {
		usb_dprintf(DEBUG_DETAILED, "%d ",
		    info->ep_interface[i]);
	}
	usb_dprintf(DEBUG_DETAILED, "\n");
}

/*
 * usb_check_device_and_status_open:
 *	Make sure that the endpoint and status device for the endpoint
 *	can be opened, or have already been opened.
 *
 * Returns: errno
 */
static int
usb_check_device_and_status_open(usb_dev_handle *dev, int ep, int ep_type,
    int mode)
{
	usb_dev_handle_impl_t *hdl = (usb_dev_handle_impl_t *)dev;
	usb_dev_handle_info_t *info = hdl->info;
	char *filename, *statfilename, cfg_num[16], alt_num[16];
	int fd, fdstat, index, rval;

	index = usb_ep_index(ep);

	usb_dprintf(DEBUG_FUNCTIONS,
	    "usb_check_device_and_status_open(): "
	    "ep=0x%x mode=%d index=%d\n", ep, mode, index);

	if ((rval = usb_check_access(dev)) != 0) {

		return (rval);
	}

	if ((index < 0) || (index > 31)) {

		return (EINVAL);
	}

	usb_dprintf(DEBUG_DETAILED, "claimed=%d ep_interface=%d\n",
	    info->claimed_interface, info->ep_interface[index]);

	if (info->claimed_interface != info->ep_interface[index]) {

		return (EINVAL);
	}

	if ((info->ep_fd[index] > 0) && (info->ep_status_fd[index] > 0)) {

		return (0);
	}

	if (ep == 0) {
		/* should already be open */

		return (0);
	}

	if ((filename = malloc(PATH_MAX+1)) == NULL) {

		return (ENOMEM);
	}
	if ((statfilename = malloc(PATH_MAX+1)) == NULL) {
		free(filename);

		return (ENOMEM);
	}

	usb_dprintf(DEBUG_DETAILED, "cfgvalue=%d\n",
	    info->configuration_value);

	/* create filename */
	if (info->configuration_index > 0) {
		(void) snprintf(cfg_num, sizeof (cfg_num), "cfg%d",
		    info->configuration_value);
	} else {
		(void) memset(cfg_num, 0, sizeof (cfg_num));
	}

	if (info->alternate > 0) {
		(void) snprintf(alt_num, sizeof (alt_num), ".%d",
		    info->alternate);
	} else {
		(void) memset(alt_num, 0, sizeof (alt_num));
	}

	(void) snprintf(filename, PATH_MAX, "%s/%s/%sif%d%s%s%d",
	    hdl->device->bus->dirname, hdl->device->filename,
	    cfg_num, info->ep_interface[index],
	    alt_num, (ep & USB_EP_DIR_MASK) ? "in" :
	    "out", (ep & USB_EP_NUM_MASK));

	usb_dprintf(DEBUG_DETAILED,
	    "usb_check_device_and_status_open: %s\n", filename);

	/*
	 * for interrupt IN endpoints, we need to enable one xfer
	 * mode before opening the endpoint
	 */
	(void) snprintf(statfilename, PATH_MAX, "%sstat", filename);

	if ((ep_type == USB_ENDPOINT_TYPE_INTERRUPT) &&
	    (ep & USB_ENDPOINT_IN)) {
		char control = USB_EP_INTR_ONE_XFER;
		ssize_t count;

		/* open the status device node for the ep first RDWR */
		if ((fdstat = open(statfilename, O_RDWR)) == -1) {
			usb_error_str(errno, "can't open %s RDWR: %d",
			    statfilename, errno);

			/* might be an older ugen version, try RDONLY */
			if ((fdstat = open(statfilename,
			    O_RDONLY)) == -1) {
				usb_error_str(errno,
				    "can't open %s RDONLY: %d",
				    filename, errno);
				free(filename);
				free(statfilename);

				return (errno);
			}
		} else {
			count = write(fdstat, &control, sizeof (control));

			if (count != 1) {
				/* this should have worked */
				usb_error_str(errno, "can't write to %s: %d",
				    filename, errno);
				free(filename);
				free(statfilename);
				(void) close(fdstat);

				return (errno);
			}
		}
	} else {
		if ((fdstat = open(statfilename, O_RDONLY)) == -1) {
			usb_error_str(errno, "can't open %s: %d",
			    statfilename, errno);
			free(filename);
			free(statfilename);

			return (errno);
		}
	}

	/* open the ep */
	if ((fd = open(filename, mode)) == -1) {
		usb_error_str(errno, "can't open %s: %d",
		    filename, errno);
		(void) close(fdstat);
		free(filename);
		free(statfilename);

		return (errno);
	}

	free(filename);
	free(statfilename);
	info->ep_fd[index] = fd;
	info->ep_status_fd[index] = fdstat;


	return (0);
}

/*
 * usb_ep_index:
 *	creates an index from endpoint address that can
 *	be used to index into endpoint lists
 *
 * Returns: ep index (a number between 0 and 31)
 */
static uchar_t
usb_ep_index(uint8_t ep_addr)
{
	return ((ep_addr & USB_EP_NUM_MASK) +
	    ((ep_addr & USB_EP_DIR_MASK) ? 16 : 0));
}

/*
 * usb_open_ep0:
 *	opens default pipe
 *
 * Returns: errno
 */
static int
usb_open_ep0(usb_dev_handle_impl_t *hdl)
{
	char *filename;
	usb_device_specific_t *dev_specific =
	    (usb_device_specific_t *)(hdl->device->dev);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_open_ep0():\n");

	if (dev_specific->ep0_fd) {
		dev_specific->ref_count++;
		hdl->info->ep_fd[0] = dev_specific->ep0_fd;
		hdl->info->ep_status_fd[0] = dev_specific->ep0_fd_stat;

		usb_dprintf(DEBUG_DETAILED,
		    "usb_open_ep0(): already open, ref=%d\n",
		    dev_specific->ref_count);

		return (0);
	}

	if ((filename = malloc(PATH_MAX+1)) == NULL) {

		return (ENOMEM);
	}

	(void) snprintf(filename, PATH_MAX, "%s/%s/cntrl0",
	    hdl->device->bus->dirname, hdl->device->filename);

	usb_dprintf(DEBUG_DETAILED, "opening %s\n", filename);

	hdl->info->ep_fd[0] = open(filename, O_RDWR);
	if (hdl->info->ep_fd[0] < 0) {
		usb_dprintf(DEBUG_ERRORS, "opening ep0 failed, %d\n",
		    hdl->info->ep_fd[0]);
		free(filename);

		return (errno);
	}

	(void) snprintf(filename, PATH_MAX, "%s/%s/cntrl0stat",
	    hdl->device->bus->dirname, hdl->device->filename);

	usb_dprintf(DEBUG_DETAILED, "opening %s\n", filename);

	hdl->info->ep_status_fd[0] = open(filename, O_RDONLY);
	if (hdl->info->ep_status_fd[0] < 0) {
		free(filename);

		return (errno);
	}

	/* allow sharing between multiple opens */
	dev_specific->ep0_fd = hdl->info->ep_fd[0];
	dev_specific->ep0_fd_stat = hdl->info->ep_status_fd[0];
	dev_specific->ref_count++;

	usb_dprintf(DEBUG_DETAILED, "ep0 opened\n");

	free(filename);

	return (0);
}

/*
 * usb_close_ep0:
 *	closes default ep0
 */
static void
usb_close_ep0(usb_dev_handle_impl_t *hdl)
{
	usb_device_specific_t *dev_specific =
	    (usb_device_specific_t *)(hdl->device->dev);

	usb_dprintf(DEBUG_FUNCTIONS, "usb_close_ep0():\n");

	if (dev_specific->ep0_fd) {
		if (--(dev_specific->ref_count) > 0) {
			usb_dprintf(DEBUG_DETAILED,
			    "usb_close_ep0(): ref_count=%d\n",
			    dev_specific->ref_count);

			return;
		}
	}

	if (hdl->info->ep_fd[0] != -1) {
		(void) close(hdl->info->ep_fd[0]);
		hdl->info->ep_fd[0] = -1;
	}
	if (hdl->info->ep_status_fd[0] != -1) {
		(void) close(hdl->info->ep_status_fd[0]);
		hdl->info->ep_status_fd[0] = -1;
	}
	dev_specific->ep0_fd = 0;
	dev_specific->ep0_fd_stat = 0;
}

/*
 * usb_close_all_eps:
 *	closes all open endpoints except 0
 */
static void
usb_close_all_eps(usb_dev_handle_impl_t *hdl)
{
	int i;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_close_all_eps():\n");

	for (i = 1; i < USB_MAXENDPOINTS; i++) {
		if (hdl->info->ep_fd[i] != -1) {
			(void) close(hdl->info->ep_fd[i]);
			hdl->info->ep_fd[i] = -1;
		}
		if (hdl->info->ep_status_fd[i] != -1) {
			(void) close(hdl->info->ep_status_fd[i]);
			hdl->info->ep_status_fd[i] = -1;
		}
	}
}

/*
 * usb_setup_all_configs:
 *	parses config cloud for each config
 *
 * Returns: errno
 */
static int
usb_setup_all_configs(usb_dev_handle_impl_t *hdl)
{
	char buffer[USB_DEV_DESCR_SIZE];
	int rval, len;
	uint_t index;

	if (hdl->device->config) {

		return (0);
	}

	usb_dprintf(DEBUG_FUNCTIONS, "usb_setup_all_configs():\n");

	/* get device descriptor */
	rval = usb_control_msg((usb_dev_handle *)hdl,
	    USB_DEV_REQ_DEV_TO_HOST | USB_TYPE_STANDARD,
	    USB_REQ_GET_DESCRIPTOR, USB_DESCR_TYPE_SETUP_DEV,
	    0, buffer, USB_DEV_DESCR_SIZE, 0);

	usb_dprintf(DEBUG_DETAILED, "dev descr rval=%d\n", rval);

	if (rval != USB_DEV_DESCR_SIZE) {

		return (EIO);
	}

	/* parse device descriptor */
	rval = (int)usb_parse_dev_descr((uchar_t *)buffer, sizeof (buffer),
	    (struct usb_device_descriptor *)&hdl->device->descriptor,
	    sizeof (struct usb_device_descriptor));

	usb_dprintf(DEBUG_DETAILED, "parse dev descr rval=%d\n", rval);

	if (rval != (int)sizeof (struct usb_device_descriptor)) {

		return (EIO);
	}

	/* allocate config array */
	len = (int) sizeof (struct usb_config_descriptor) *
	    hdl->device->descriptor.bNumConfigurations;

	if ((hdl->device->config = calloc(len, 1)) == NULL) {

		return (ENOMEM);
	}

	/* parse each config cloud */
	for (index = 0; index < hdl->device->descriptor.bNumConfigurations;
	    index++) {
		if ((rval = usb_parse_config(hdl, index)) != 0) {

			return (rval);
		}
	}

	return (0);
}

/*
 * usb_free_all_configs:
 *	frees all allocated resources
 */
static void
usb_free_all_configs(usb_device_t *dev)
{
	uint_t index;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_free_all_configs(): "
	    "dev=0x%x config=0x%x #conf=%d\n",
	    dev, dev->config, dev->descriptor.bNumConfigurations);

	if (dev->config) {
		for (index = 0; index < dev->descriptor.bNumConfigurations;
		    index++) {
			usb_free_config(dev, index);
		}
		free(dev->config);
		dev->config = NULL;
	}
}

/*
 * usb_parse_config:
 *	parse config descriptor and get cloud
 *
 * Returns: errno
 */
static int
usb_parse_config(usb_dev_handle_impl_t *hdl, uint_t index)
{
	int rval;
	uint_t iface, len;
	char buffer[USB_CFG_DESCR_SIZE];
	char *cloud;
	unsigned char *extra;
	int extralen;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_parse_config(): index=%d\n",
	    index);

	rval = usb_control_msg((usb_dev_handle *)hdl,
	    USB_DEV_REQ_DEV_TO_HOST | USB_TYPE_STANDARD,
	    USB_REQ_GET_DESCRIPTOR, USB_DESCR_TYPE_SETUP_CFG | index,
	    0, buffer, USB_CFG_DESCR_SIZE, 0);

	usb_dprintf(DEBUG_DETAILED, "config descr rval=%d expecting %d\n",
	    rval, USB_CFG_DESCR_SIZE);

	if (rval < USB_CFG_DESCR_SIZE) {

		return (EIO);
	}

	rval = (int)usb_parse_cfg_descr((uchar_t *)buffer, sizeof (buffer),
	    (usb_cfg_descr_t *)&hdl->device->config[index],
	    sizeof (usb_cfg_descr_t), &extra, &extralen);

	usb_dprintf(DEBUG_DETAILED, "config descr rval=%d expecting %d\n",
	    rval, sizeof (usb_cfg_descr_t));

	if (rval < USB_CFG_DESCR_SIZE) {

		return (EIO);
	}

	usb_dprintf(DEBUG_DETAILED,
	    "cfg%d: len=%d type=%d total=%d #if=%d cf=%d\n", index,
	    hdl->device->config[index].bLength,
	    hdl->device->config[index].bDescriptorType,
	    hdl->device->config[index].wTotalLength,
	    hdl->device->config[index].bNumInterfaces,
	    hdl->device->config[index].bConfigurationValue);

	if ((cloud = malloc(hdl->device->config[index].wTotalLength)) ==
	    NULL) {

		return (ENOMEM);
	}

	/* get complete cloud */
	rval = usb_control_msg((usb_dev_handle *)hdl,
	    USB_DEV_REQ_DEV_TO_HOST | USB_TYPE_STANDARD,
	    USB_REQ_GET_DESCRIPTOR, USB_DESCR_TYPE_SETUP_CFG | index,
	    0, (char *)cloud,
	    hdl->device->config[index].wTotalLength, 0);

	if (rval != hdl->device->config[index].wTotalLength) {
		free(cloud);

		return (EIO);
	}

	/* parse descriptor again to get extra descriptors */
	rval = (int)usb_parse_cfg_descr((uchar_t *)cloud,
	    hdl->device->config[index].wTotalLength,
	    (usb_cfg_descr_t *)&hdl->device->config[index],
	    sizeof (usb_cfg_descr_t), &extra, &extralen);

	if (extralen) {
		usb_dprintf(DEBUG_DETAILED,
		    "cfg%d: extra descriptors length=%d:\n",
		    index, extralen);
		usb_dump_data((char *)extra, extralen);

		if ((hdl->device->config[index].extra =
		    calloc(extralen, 1)) == NULL) {
			free(cloud);

			return (ENOMEM);
		}

		(void) memcpy(hdl->device->config[index].extra, extra,
		    extralen);
		hdl->device->config[index].extralen = extralen;
	}

	/* allocate interface array */
	len = hdl->device->config[index].bNumInterfaces *
	    (int)sizeof (struct usb_interface);
	if ((hdl->device->config[index].interface = calloc(len, 1)) ==
	    NULL) {
		free(cloud);

		return (ENOMEM);
	}

	for (iface = 0; iface < hdl->device->config[index].bNumInterfaces;
	    iface++) {
		rval = usb_parse_interface(hdl, index, iface, cloud);
		if (rval != 0) {
			free(cloud);

			return (rval);
		}
	}
	free(cloud);

	return (0);
}

/*
 * usb_free_config:
 *	frees all allocated config resources
 */
static void
usb_free_config(usb_device_t *device, uint_t index)
{
	uint_t iface;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_free_config(): index=%d\n",
	    index);

	if (device->config[index].interface) {
		for (iface = 0; iface < device->config[index].bNumInterfaces;
		    iface++) {
			usb_free_interface(device, index, iface);
		}
		if (device->config[index].extralen) {
			free(device->config[index].extra);
		}
		free(device->config[index].interface);
	}
}

/*
 * usb_parse_interface:
 *	parse an interface descriptor
 *
 * Returns: errno
 */
static int
usb_parse_interface(usb_dev_handle_impl_t *hdl, uint_t index, uint_t iface,
    char *cloud)
{
	usb_if_descr_t if_descr;
	int rval;
	uint_t alt, max_alt, len;
	unsigned char *extra;
	int extralen;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_parse_interface(): "
	    "index=%d, iface=%d\n", index, iface);

	/* count the number of alternates for this interface */
	for (max_alt = alt = 0; alt < USB_MAXALTSETTING; alt++) {
		rval = (int)usb_parse_if_descr((uchar_t *)cloud,
		    hdl->device->config[index].wTotalLength,
		    iface, alt, &if_descr, sizeof (if_descr),
		    &extra, &extralen);

		usb_dprintf(DEBUG_DETAILED, "usb_parse_interface: "
		    "alt %d: rval=%d expecting %d\n",
		    alt, rval, sizeof (if_descr));

		if (rval != (int)sizeof (if_descr)) {

			break;
		}
		max_alt = alt;
	}

	usb_dprintf(DEBUG_DETAILED,
	    "usb_parse_interface: max_alt=%d\n", max_alt);

	/* allocate alt interface setting array */
	len = ++max_alt * (int)sizeof (struct usb_interface_descriptor);
	if ((hdl->device->config[index].interface[iface].altsetting =
	    calloc(len, 1)) == NULL) {

		return (ENOMEM);
	}
	hdl->device->config[index].interface[iface].num_altsetting =
	    max_alt;
	for (alt = 0; alt < max_alt; alt++) {
		rval = usb_parse_alternate(hdl, index, iface, alt, cloud);
		if (rval != 0) {

			return (rval);
		}
	}

	return (0);
}

/*
 * usb_free_interface:
 *	frees interface resources
 *
 * Returns: errno
 */
static void
usb_free_interface(usb_device_t *device, uint_t index, uint_t iface)
{
	uint_t alt, max_alt;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_free_interface(): "
	    "index=%d, iface=%d\n", index, iface);

	if (device->config[index].interface[iface].altsetting) {
		max_alt = device->config[index].interface[iface].
		    num_altsetting;
		for (alt = 0; alt < max_alt; alt++) {
			usb_free_alternate(device, index, iface, alt);
		}
		free(device->config[index].interface[iface].altsetting);
	}
}

/*
 * usb_parse_alternate:
 *	parses each alternate descriptor
 *
 * Returns: errno
 */
static int
usb_parse_alternate(usb_dev_handle_impl_t *hdl, uint_t index, uint_t iface,
    uint_t alt, char *cloud)
{
	uint_t ep, len;
	usb_if_descr_t if_descr;
	int rval;
	unsigned char *extra;
	int extralen;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_parse_alternate(): "
	    "index=%d, iface=%d, alt=%d\n", index, iface, alt);

	rval = (int)usb_parse_if_descr((uchar_t *)cloud,
	    hdl->device->config[index].wTotalLength,
	    iface, alt, &if_descr, sizeof (if_descr), &extra, &extralen);

	if (rval != (int)sizeof (if_descr)) {
		usb_dprintf(DEBUG_ERRORS, "usb_parse_alternate: rval=%d\n",
		    rval);

		return (EIO);
	}

	usb_dprintf(DEBUG_DETAILED,
	    "cfg%d.if%d.%d: len=%d type=%d num=%d alt=%d #ep=%d c=%d"
	    " sc=%d p=%d i=%d\n", index, iface, alt,
	    if_descr.bLength,
	    if_descr.bDescriptorType,
	    if_descr.bInterfaceNumber,
	    if_descr.bAlternateSetting,
	    if_descr.bNumEndpoints,
	    if_descr.bInterfaceClass,
	    if_descr.bInterfaceSubClass,
	    if_descr.bInterfaceProtocol,
	    if_descr.iInterface);

	(void) memcpy(
	    &hdl->device->config[index].interface[iface].altsetting[alt],
	    &if_descr, sizeof (if_descr));

	if (extralen) {
		usb_dprintf(DEBUG_DETAILED,
		    "cfg%d.if%d.%d: extralen=%d:\n", index, iface, alt,
		    extralen);
		usb_dump_data((char *)extra, extralen);

		if ((hdl->device->config[index].interface[iface].
		    altsetting[alt].extra = calloc(extralen, 1)) == NULL) {

			return (ENOMEM);
		}
		(void) memcpy(
		    hdl->device->config[index].interface[iface].
		    altsetting[alt].extra, extra, extralen);
		hdl->device->config[index].interface[iface].
		    altsetting[alt].extralen = extralen;
	}

	if (if_descr.bNumEndpoints == 0) {

		return (0);
	}

	/* allocate endpoint array for this alternate */
	len = if_descr.bNumEndpoints *
	    (int)sizeof (struct usb_endpoint_descriptor);
	if ((hdl->device->config[index].interface[iface].altsetting[alt].
	    endpoint = calloc(len, 1)) == NULL) {

		return (ENOMEM);
	}

	for (ep = 0; ep < if_descr.bNumEndpoints; ep++) {
		rval = usb_parse_endpoint(hdl, index, iface, alt, ep, cloud);

		if (rval != 0) {

			return (rval);
		}
	}

	return (0);
}

/*
 * usb_free_alternate:
 *	frees all alternate resources
 */
static void
usb_free_alternate(usb_device_t *device, uint_t index, uint_t iface,
	uint_t alt)
{
	usb_dprintf(DEBUG_FUNCTIONS, "usb_free_alternate(): "
	    "index=%d, iface=%d, alt=%d\n", index, iface, alt);

	if (device->config[index].interface[iface].altsetting[alt].
	    endpoint) {
		uint_t ep;
		struct usb_interface_descriptor *if_descr =
		    &device->config[index].
		    interface[iface].altsetting[alt];

		for (ep = 0; ep < if_descr->bNumEndpoints; ep++) {
			if (if_descr->extralen) {
				free(if_descr->extra);
			}
		}

		if (device->config[index].interface[iface].altsetting[alt].
		    extralen) {
			free(device->config[index].interface[iface].
			    altsetting[alt].extra);
		}
		free(device->config[index].interface[iface].altsetting[alt].
		    endpoint);
	}
}

/*
 * usb_parse_endpoint:
 *	 parses an endpoint descriptor
 *
 * Returns: errno
 */
static int
usb_parse_endpoint(usb_dev_handle_impl_t *hdl, int index, int iface,
    int alt, int ep, char *cloud)
{
	usb_ep_descr_t ep_descr;
	int rval;
	unsigned char *extra;
	int extralen;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_parse_endpoint(): "
	    "index=%d, iface=%d, alt=%d, ep=0x%x\n",
	    index, iface, alt, ep);

	rval = (int)usb_parse_ep_descr((uchar_t *)cloud,
	    hdl->device->config[index].wTotalLength,
	    iface, alt, ep, &ep_descr, sizeof (ep_descr),
	    &extra, &extralen);

	if (rval < USB_EP_DESCR_SIZE) {
		usb_dprintf(DEBUG_ERRORS, "usb_parse_endpoint: rval=%d, "
		    "expecting %d\n", rval, USB_EP_DESCR_SIZE);

		return (rval);
	}

	usb_dprintf(DEBUG_DETAILED,
	    "\tl=%d t=%d a=0x%x attr=0x%x max=%d int=%d\n",
	    ep_descr.bLength, ep_descr.bDescriptorType,
	    ep_descr.bEndpointAddress, ep_descr.bmAttributes,
	    ep_descr.wMaxPacketSize, ep_descr.bInterval);

	(void) memcpy(&hdl->device->
	    config[index].interface[iface].altsetting[alt].endpoint[ep],
	    &ep_descr, sizeof (ep_descr));

	if (extralen) {
		usb_dprintf(DEBUG_DETAILED,
		    "cfg%d.if%d.%d.ep%d: extralen=%d:\n",
		    index, iface, alt, ep, extralen);
		usb_dump_data((char *)extra, extralen);

		if ((hdl->device->config[index].interface[iface].
		    altsetting[alt].endpoint[ep].extra =
		    calloc(extralen, 1)) == NULL) {

			return (ENOMEM);
		}
		(void) memcpy(hdl->device->config[index].interface[iface].
		    altsetting[alt].endpoint[ep].extra, extra, extralen);
		hdl->device->config[index].interface[iface].
		    altsetting[alt].endpoint[ep].extralen = extralen;
	}

	return (0);
}

/*
 * usb_add_device:
 *	adds dev to the beginning of the list
 */
static void
usb_add_device(usb_device_t **list, usb_device_t *dev)
{
	if (*list) {
		dev->next = *list;
		dev->next->prev = dev;
	} else {
		dev->next = NULL;
	}
	dev->prev = NULL;
	*list = dev;
}

/*
 * usb_remove_device:
 *	removes dev from a list
 */
static void
usb_remove_device(usb_device_t **list, usb_device_t *dev)
{
	if (dev->prev) {
		dev->prev->next = dev->next;
	} else {
		*list = dev->next;
	}
	if (dev->next) {
		dev->next->prev = dev->prev;
	}
	dev->prev = dev->next = NULL;
}

/*
 * usb_check_device_in_list:
 *	checks if dev is in list
 *
 * Returns: 1 (yes), 0 (no)
 */
static int
usb_check_device_in_list(usb_device_t *list, usb_device_t *dev)
{
	usb_device_t *d = list;

	while (d != NULL) {
		if (d == dev) {

			return (1);
		}
		d = d->next;
	}

	return (0);
}

/*
 * usb_free_bus:
 *	frees the entire bus structure, not used, just for
 *	completeness
 */
static void
usb_free_bus(usb_bus_t *bus)
{
	free(bus);
}

/*
 * usb_free_dev:
 *	frees all configs and then the device structure itself
 */
static void
usb_free_dev(usb_device_t *dev)
{
	usb_dprintf(DEBUG_FUNCTIONS, "usb_free_dev(): 0x%x\n", (int)dev);

	usb_free_all_configs(dev);
	free(dev->dev);
	free(dev);
}

/*
 * usb_get_device_status:
 *	gets status of device
 *
 * Returns: ugen dev status values
 */
static int
usb_get_device_status(int fd)
{
	int status, error;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_get_device_status():\n");

	error = (int)read(fd, &status, (size_t)sizeof (status));
	if (error != (int)sizeof (status)) {
		usb_error_str(errno, "Could not read device status: %d",
		    error);

		return (USB_DEV_STAT_UNAVAILABLE);
	} else {
		switch (status) {
		case USB_DEV_STAT_ONLINE:
			usb_dprintf(DEBUG_DETAILED, "Device is available\n");
			break;
		case USB_DEV_STAT_DISCONNECTED:
			usb_dprintf(DEBUG_DETAILED, "Device has been "
			    "disconnected\n");
			break;
		case USB_DEV_STAT_RESUMED:
			usb_dprintf(DEBUG_DETAILED,
			    "Device has been resumed\n");
			break;
		case USB_DEV_STAT_UNAVAILABLE:
			usb_dprintf(DEBUG_DETAILED,
			    "Device is powered down\n");
			break;
		default:
			usb_dprintf(DEBUG_DETAILED,
			    "Device status=%d\n", status);
		}
	}

	return (status);
}

/*
 * usb_search_dev_usb:
 *	finds all names of devices in the /usb/dev tree
 *	this will be the VID/PID and instance no
 *
 * Returns: errno
 */
static int
usb_search_dev_usb(usb_device_t **new_devices)
{
	DIR			*dir, *subdir;
	struct dirent		*dir_entry, *subdir_entry;
	char			*device, *filename;
	usb_bus_t		*bus = usb_busses;
	struct stat		statbuf;
	regex_t			regex;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_search_dev_usb():\n");

	if ((device = malloc(PATH_MAX+1)) == NULL) {

		return (ENOMEM);
	}

	if ((filename = malloc(PATH_MAX+1)) == NULL) {
		free(device);

		return (ENOMEM);
	}

	if (!(dir = opendir(bus->dirname))) {
		free(device);
		free(filename);

		usb_error_str(errno,
		    "couldn't opendir %s: %d", bus->dirname, errno);

		return (errno);
	}

	/* make sure we only open ugen directories */
	if ((regcomp(&regex, "/dev/usb/[0-9a-f]+[.][0-9a-f]+",
	    REG_EXTENDED) != 0)) {

		return (EINVAL);
	}

	/* search for devices */
	while ((dir_entry = readdir(dir)) != NULL) {

		usb_dprintf(DEBUG_FUNCTIONS, "usb_search_dev_usb(): dir=%s\n",
		    dir_entry->d_name);

		if (dir_entry->d_name[0] == '.') {
			continue;
		}
		(void) snprintf(device, PATH_MAX, "%s/%s", bus->dirname,
		    dir_entry->d_name);

		/*
		 * make sure we don't accidentily open /dev/usb/hid* nodes
		 * which will get them unlinked from the virtual console
		 */
		if (lstat(device, &statbuf) == -1) {
			continue;
		}
		if (!S_ISDIR(statbuf.st_mode)) {
			continue;
		}

		if (regexec(&regex, device, 0, NULL, 0) != 0) {
			continue;
		}

		usb_dprintf(DEBUG_FUNCTIONS, "checking %s\n", device);

		/* need to search instances */
		if (!(subdir = opendir(device))) {
			continue;
		}

		while ((subdir_entry = readdir(subdir)) != NULL) {
			usb_device_t *dev;
			usb_device_specific_t *dev_specific;
			int fd;

			if (subdir_entry->d_name[0] == '.') {
				continue;
			}

			if ((dev = calloc(sizeof (*dev), 1)) == NULL) {
				free(device);
				free(filename);
				regfree(&regex);
				(void) closedir(subdir);
				(void) closedir(dir);

				return (ENOMEM);
			}
			if ((dev_specific = calloc(sizeof (*dev_specific),
			    1)) == NULL) {
				free(device);
				free(filename);
				free(dev);
				regfree(&regex);
				(void) closedir(subdir);
				(void) closedir(dir);

				return (ENOMEM);
			}

			dev->dev = (void *)dev_specific;
			dev->bus = bus;
			(void) snprintf(dev->filename, PATH_MAX, "%s/%s",
			    dir_entry->d_name, subdir_entry->d_name);

			/* See if the device is online */
			(void) snprintf(filename, PATH_MAX, "%s/%s/devstat",
			    bus->dirname, dev->filename);

			usb_dprintf(DEBUG_DETAILED, "filename %s\n", filename);
			usb_dprintf(DEBUG_DETAILED, "dev filename %s\n",
			    dev->filename);

			if ((fd = open(filename, O_RDONLY|O_EXCL)) < 0) {
				usb_dprintf(DEBUG_ERRORS,
				    "usb_search_dev_usb: Couldn't open %s\n",
				    filename);
				free(dev_specific);
				free(dev);
				continue;
			}
			if (usb_get_device_status(fd) != USB_DEV_STAT_ONLINE) {
				(void) close(fd);
				usb_error_str(EIO, "Device %s is not online",
				    dev->filename);

				free(dev_specific);
				free(dev);
				continue;
			}
			(void) close(fd);

			usb_add_device(new_devices, dev);
		}

		(void) closedir(subdir);
	}

	regfree(&regex);
	free(filename);
	free(device);
	(void) closedir(dir);

	return (0);
}

/*
 * usb_get_status:
 *	gets status of endpoint
 *
 * Returns: ugen's last cmd status
 */
static int
usb_get_status(int fd)
{
	int status, error;

	usb_dprintf(DEBUG_FUNCTIONS, "usb_get_status(): fd=%d\n", fd);

	error = (int)read(fd, &status, sizeof (status));
	if (error == (int)sizeof (status)) {
		switch (status) {
		case USB_LC_STAT_NOERROR:
			usb_dprintf(DEBUG_DETAILED, "No Error\n");
			break;
		case USB_LC_STAT_CRC:
			usb_dprintf(DEBUG_ERRORS, "CRC Timeout Detected\n");
			break;
		case USB_LC_STAT_BITSTUFFING:
			usb_dprintf(DEBUG_ERRORS, "Bit Stuffing Violation\n");
			break;
		case USB_LC_STAT_DATA_TOGGLE_MM:
			usb_dprintf(DEBUG_ERRORS, "Data Toggle Mismatch\n");
			break;
		case USB_LC_STAT_STALL:
			usb_dprintf(DEBUG_ERRORS, "End Point Stalled\n");
			break;
		case USB_LC_STAT_DEV_NOT_RESP:
			usb_dprintf(DEBUG_ERRORS, "Device is Not Responding\n");
			break;
		case USB_LC_STAT_PID_CHECKFAILURE:
			usb_dprintf(DEBUG_ERRORS, "PID Check Failure\n");
			break;
		case USB_LC_STAT_UNEXP_PID:
			usb_dprintf(DEBUG_ERRORS, "Unexpected PID\n");
			break;
		case USB_LC_STAT_DATA_OVERRUN:
			usb_dprintf(DEBUG_ERRORS, "Data Exceeded Size\n");
			break;
		case USB_LC_STAT_DATA_UNDERRUN:
			usb_dprintf(DEBUG_ERRORS, "Less data received\n");
			break;
		case USB_LC_STAT_BUFFER_OVERRUN:
			usb_dprintf(DEBUG_ERRORS, "Buffer Size Exceeded\n");
			break;
		case USB_LC_STAT_BUFFER_UNDERRUN:
			usb_dprintf(DEBUG_ERRORS, "Buffer Underrun\n");
			break;
		case USB_LC_STAT_TIMEOUT:
			usb_dprintf(DEBUG_ERRORS, "Command Timed Out\n");
			break;
		case USB_LC_STAT_NOT_ACCESSED:
			usb_dprintf(DEBUG_ERRORS, "Not Accessed by h/w\n");
			break;
		case USB_LC_STAT_UNSPECIFIED_ERR:
			usb_dprintf(DEBUG_ERRORS, "Unspecified Error\n");
			break;
		case USB_LC_STAT_NO_BANDWIDTH:
			usb_dprintf(DEBUG_ERRORS, "No Bandwidth\n");
			break;
		case USB_LC_STAT_HW_ERR:
			usb_dprintf(DEBUG_ERRORS,
			    "Host Controller h/w Error\n");
			break;
		case USB_LC_STAT_SUSPENDED:
			usb_dprintf(DEBUG_ERRORS, "Device was Suspended\n");
			break;
		case USB_LC_STAT_DISCONNECTED:
			usb_dprintf(DEBUG_ERRORS, "Device was Disconnected\n");
			break;
		case USB_LC_STAT_INTR_BUF_FULL:
			usb_dprintf(DEBUG_ERRORS,
			    "Interrupt buffer was full\n");
			break;
		case USB_LC_STAT_INVALID_REQ:
			usb_dprintf(DEBUG_ERRORS, "Request was Invalid\n");
			break;
		case USB_LC_STAT_INTERRUPTED:
			usb_dprintf(DEBUG_ERRORS, "Request was Interrupted\n");
			break;
		case USB_LC_STAT_NO_RESOURCES:
			usb_dprintf(DEBUG_ERRORS, "No resources available for "
			    "request\n");
			break;
		case USB_LC_STAT_INTR_POLLING_FAILED:
			usb_dprintf(DEBUG_ERRORS, "Failed to Restart Poll");
			break;
		default:
			usb_dprintf(DEBUG_ERRORS, "Error Not Determined %d\n",
			    status);
			break;
		}
	}

	return (status);
}

/*
 * Descriptor parsing functions, taken from USBA code
 *
 * usb_parse_data:
 *	take a raw buffer and pads it according to format
 *
 * Returns: USB_PARSE_ERROR or length parsed
 */
static size_t
usb_parse_data(char *format, uchar_t *data, size_t datalen,
    void *structure, size_t structlen)
{
	int	fmt;
	size_t	counter = 1;
	int	multiplier = 0;
	uchar_t	*dataend = data + datalen;
	char	*structstart = (char *)structure;
	void	*structend = (void *)((intptr_t)structstart + structlen);

	if ((format == NULL) || (data == NULL) || (structure == NULL)) {

		return (USB_PARSE_ERROR);
	}

	while ((fmt = *format) != '\0') {

		/*
		 * Could some one pass a "format" that is greater than
		 * the structlen? Conversely, one could pass a ret_buf_len
		 * that is less than the "format" length.
		 * If so, we need to protect against writing over memory.
		 */
		if (counter++ > structlen) {
			break;
		}

		if (fmt == 'c') {
			uint8_t	*cp = (uint8_t *)structure;

			cp = (uint8_t *)(((uintptr_t)cp + _CHAR_ALIGNMENT - 1) &
			    ~(_CHAR_ALIGNMENT - 1));
			if (((data + 1) > dataend) ||
			    ((cp + 1) > (uint8_t *)structend))
				break;

			*cp++ = *data++;
			structure = (void *)cp;
			if (multiplier) {
				multiplier--;
			}
			if (multiplier == 0) {
				format++;
			}
		} else if (fmt == 's') {
			uint16_t	*sp = (uint16_t *)structure;

			sp = (uint16_t *)
			    (((uintptr_t)sp + _SHORT_ALIGNMENT - 1) &
			    ~(_SHORT_ALIGNMENT - 1));
			if (((data + 2) > dataend) ||
			    ((sp + 1) > (uint16_t *)structend))
				break;

			*sp++ = (data[1] << 8) + data[0];
			data += 2;
			structure = (void *)sp;
			if (multiplier) {
				multiplier--;
			}
			if (multiplier == 0) {
				format++;
			}
		} else if (fmt == 'l') {
			uint32_t	*lp = (uint32_t *)structure;

			lp = (uint32_t *)
			    (((uintptr_t)lp + _INT_ALIGNMENT - 1) &
			    ~(_INT_ALIGNMENT - 1));
			if (((data + 4) > dataend) ||
			    ((lp + 1) > (uint32_t *)structend))
				break;

			*lp++ = (((((
			    (uint32_t)data[3] << 8) | data[2]) << 8) |
			    data[1]) << 8) | data[0];
			data += 4;
			structure = (void *)lp;
			if (multiplier) {
				multiplier--;
			}
			if (multiplier == 0) {
				format++;
			}
		} else if (fmt == 'L') {
			uint64_t	*llp = (uint64_t *)structure;

			llp = (uint64_t *)
			    (((uintptr_t)llp + _LONG_LONG_ALIGNMENT - 1) &
			    ~(_LONG_LONG_ALIGNMENT - 1));
			if (((data + 8) > dataend) ||
			    ((llp + 1) >= (uint64_t *)structend))
				break;

			*llp++ = (((((((((((((data[7] << 8) |
			    data[6]) << 8) | data[5]) << 8) |
			    data[4]) << 8) | data[3]) << 8) |
			    data[2]) << 8) | data[1]) << 8) |
			    data[0];
			data += 8;
			structure = (void *)llp;
			if (multiplier) {
				multiplier--;
			}
			if (multiplier == 0) {
				format++;
			}
		} else if (isdigit(fmt)) {
			multiplier = (multiplier * 10) + (fmt - '0');
			counter--;
			format++;
		} else {
			multiplier = 0;
			break;
		}
	}

	return ((intptr_t)structure - (intptr_t)structstart);
}

/*
 * usb_nth_descr:
 *	finds pointer to n-th descriptor of
 *	type descr_type, unless the end of the buffer or a descriptor
 *	of type	stop_descr_type1 or stop_descr_type2 is encountered first.
 *
 * Returns: returns pointer to n-th descriptor
 */
static uchar_t *
usb_nth_descr(uchar_t *buf, size_t buflen, int descr_type, uint_t n,
    int	stop_descr_type1, int stop_descr_type2)
{
	uchar_t	*bufstart = buf;
	uchar_t *bufend = buf + buflen;

	if (buf == NULL) {

		return (NULL);
	}

	while (buf + 2 <= bufend) {
		if ((buf != bufstart) && ((buf[1] == stop_descr_type1) ||
		    (buf[1] == stop_descr_type2))) {

			return (NULL);
		}

		if ((descr_type == USB_DESCR_TYPE_ANY) ||
		    (buf[1] == descr_type)) {
			if (n-- == 0) {

				return (buf);
			}
		}

		/*
		 * Check for a bad buffer.
		 * If buf[0] is 0, then this will be an infite loop
		 */
		INCREMENT_BUF(buf);
	}

	return (NULL);
}

/*
 * usb_parse_dev_descr:
 *	parse device descriptor
 *
 * Returns: #bytes parsed
 */
static size_t
usb_parse_dev_descr(uchar_t *buf, size_t buflen,
    struct usb_device_descriptor *ret_descr, size_t ret_buf_len)
{
	if ((buf == NULL) || (ret_descr == NULL) ||
	    (buflen < 2) || (buf[1] != USB_DESCR_TYPE_DEV)) {

		return (USB_PARSE_ERROR);
	}

	return (usb_parse_data("ccsccccssscccc",
	    buf, buflen, ret_descr, ret_buf_len));
}

/*
 * usb_parse_cfg_descr:
 *	parse config descriptor
 *
 * Returns: #bytes parsed
 */
static size_t
usb_parse_cfg_descr(uchar_t *buf, size_t buflen, usb_cfg_descr_t *ret_descr,
    size_t ret_buf_len, unsigned char **extra, int *extralen)
{
	size_t rval;

	if ((buf == NULL) || (ret_descr == NULL) ||
	    (buflen < 2) || (buf[1] != USB_DESCR_TYPE_CFG)) {

		return (USB_PARSE_ERROR);
	}

	rval = usb_parse_data("ccsccccc",
	    buf, buflen, ret_descr, ret_buf_len);

	usb_find_extra(buf, buflen, extra, extralen);

	return (rval);
}

/*
 * usb_parse_if_descr:
 *	parse interface descriptor
 *
 * Returns: #bytes parsed
 */
static size_t
usb_parse_if_descr(uchar_t *buf, size_t	buflen, uint_t if_number,
    uint_t alt_if_setting, usb_if_descr_t *ret_descr, size_t ret_buf_len,
    unsigned char **extra, int *extralen)
{
	uchar_t *bufend = buf + buflen;
	size_t rval;

	if ((buf == NULL) || (ret_descr == NULL)) {

		return (USB_PARSE_ERROR);
	}

	while (buf + 4 <= bufend) {
		if ((buf[1] == USB_DESCR_TYPE_IF) &&
		    (buf[2] == if_number) &&
		    (buf[3] == alt_if_setting)) {

			rval = usb_parse_data("ccccccccc",
			    buf, ((uintptr_t)bufend - (uintptr_t)buf),
			    ret_descr, ret_buf_len);

			usb_find_extra(buf,
			    ((uintptr_t)bufend - (uintptr_t)buf),
			    extra, extralen);

			return (rval);
		}

		/*
		 * Check for a bad buffer.
		 * If buf[0] is 0, then this will be an infinite loop
		 */
		INCREMENT_BUF(buf);
	}

	return (USB_PARSE_ERROR);
}


/*
 * usb_parse_ep_descr:
 *	parse config descriptor
 *	the endpoint index is relative to the interface. index 0 is
 *	the first endpoint
 *
 * Returns: #bytes parsed
 */
size_t
usb_parse_ep_descr(uchar_t *buf, size_t buflen, uint_t if_number,
    uint_t alt_if_setting, uint_t ep_index, usb_ep_descr_t *ret_descr,
    size_t ret_buf_len, unsigned char **extra, int *extralen)
{
	uchar_t *bufend = buf + buflen;
	size_t rval;

	if ((buf == NULL) || (ret_descr == NULL)) {

		return (USB_PARSE_ERROR);
	}

	while ((buf + 4) <= bufend) {
		if (buf[1] == USB_DESCR_TYPE_IF &&
		    buf[2] == if_number &&
		    buf[3] == alt_if_setting) {
			if ((buf = usb_nth_descr(buf,
			    (uintptr_t)bufend - (uintptr_t)buf,
			    USB_DESCR_TYPE_EP, ep_index,
			    USB_DESCR_TYPE_IF, -1)) == NULL) {

				break;
			}

			rval = usb_parse_data("ccccsccc", buf,
			    (uintptr_t)bufend - (uintptr_t)buf,
			    ret_descr, ret_buf_len);
			usb_find_extra(buf, (uintptr_t)bufend - (uintptr_t)buf,
			    extra, extralen);

			return (rval);
		}

		/*
		 * Check for a bad buffer.
		 * If buf[0] is 0, then this will be an infinite loop
		 */
		INCREMENT_BUF(buf);
	}

	return (USB_PARSE_ERROR);
}

/*
 * extra descriptor handling
 *
 * usb_find_extra:
 *	finds any non-standard descriptor after the current
 *	standard descriptor and puts a pointer in extra argument
 *	and the length in extralen
 */
static	void
usb_find_extra(uchar_t *buf, size_t buflen,
    unsigned char **extra, int *extralen)
{
	uchar_t *next = buf + buf[0];

	*extralen = 0;
	*extra = next;

	while (((uintptr_t)next - (uintptr_t)buf + 1) < buflen) {
		if ((next[1] == USB_DT_CONFIG) ||
		    (next[1] == USB_DT_INTERFACE) ||
		    (next[1] == USB_DT_ENDPOINT)) {
			*extralen = (int)((uintptr_t)next -
			    (uintptr_t)buf - buf[0]);

			return;
		}
		next += next[0];
	}
}

/*
 * error handling
 *
 * usb_strerror:
 *	lookup error string
 *
 * Returns: error string
 */
char *
usb_strerror(void)
{
	usb_dprintf(DEBUG_FUNCTIONS, "usb_strerror(): "
	    "usb_error_type=%d, errno=%d\n", usb_error_type, usb_error_errno);

	switch (usb_error_type) {
	case USB_ERROR_TYPE_NONE:
		return ("No error");

	case USB_ERROR_TYPE_STRING:
		return (usb_error_string);

	case USB_ERROR_TYPE_ERRNO:
		if (usb_error_errno > 0) {

			return (strerror(usb_error_errno));
		}
	default:
		break;
	}

	return ("Unknown error");
}

/*
 * usb_error:
 *	stores the error number in the global usb_error_errno
 *
 * Returns: negative error number
 */
static int
usb_error(int x)
{
	usb_dprintf(DEBUG_FUNCTIONS, "usb_error(): error=%d\n", x);

	usb_error_type = USB_ERROR_TYPE_ERRNO;
	usb_error_errno = x;

	return (-x);
}

/*
 * usb_error_str:
 *	creates error string
 */
static void
usb_error_str(int x, char *format, ...)
{
	va_list ap;

	va_start(ap, format);

	usb_error_type = USB_ERROR_TYPE_ERRNO;
	usb_error_errno = x;

	(void) vsnprintf(usb_error_string, sizeof (usb_error_string),
	    format, ap);

	usb_dprintf(DEBUG_ERRORS, "USB error (%d): %s\n", x, usb_error_string);

	va_end(ap);
}

/*
 * usb_dprintf:
 *	prints out tracing messages according to level
 */
static void
usb_dprintf(int level, char *format, ...)
{
	va_list ap;
	char buf[512];

	va_start(ap, format);

	(void) vsnprintf(buf, sizeof (buf), format, ap);
	if (libusb_debug >= level) {
		(void) fprintf(stderr, buf);
	}
	va_end(ap);
}

/*
 * usb_dump_data:
 *	print data buffer
 */
static void
usb_dump_data(char *data, int size)
{
	int i;

	if (libusb_debug >= DEBUG_DATA_DUMP) {
		(void) fprintf(stderr, "data dump:");
		for (i = 0; i < size; i++) {
			if (i % 16 == 0) {
				(void) fprintf(stderr, "\n%08x	", i);
			}
			(void) fprintf(stderr, "%02x ", (uchar_t)data[i]);
		}
		(void) fprintf(stderr, "\n");
	}
}