USBGetDevices.h revision 37c53e9b2c955f92dff6f11aff63809004945f17
/* $Id$ */
/** @file
* VirtualBox Linux host USB device enumeration.
*/
/*
* Copyright (C) 2006-2010 Oracle Corporation
*
* This file is part of VirtualBox Open Source Edition (OSE), as
* available from http://www.virtualbox.org. This file is free software;
* General Public License (GPL) as published by the Free Software
* Foundation, in version 2 as it comes in the "COPYING" file of the
* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
*/
#ifndef ___USBGetDevices_h
# define ___USBGetDevices_h
/**
* Free all the members of a USB device created by the Linux enumeration code.
* @note this duplicates a USBProxyService method which we needed access too
* without pulling in the rest of the proxy service code.
*
* @param pDevice Pointer to the device.
*/
{
}
/**
* Free one USB device created by the Linux enumeration code.
* @note this duplicates a USBProxyService method which we needed access too
* without pulling in the rest of the proxy service code.
*
* @param pDevice Pointer to the device.
*/
{
}
/**
* Free a linked list of USB devices created by the Linux enumeration code.
* @param pHead Pointer to the first device in the linked list
*/
{
while (pHead)
{
}
}
/**
* Check whether a USB device tree root is usable
* @param pcszRoot the path to the root of the device tree
* @param fIsDeviceNodes whether this is a device node (or usbfs) tree
* @note returns a pointer into a static array so it will stay valid
*/
extern bool USBProxyLinuxCheckDeviceRoot(const char *pcszRoot,
bool fIsDeviceNodes);
#ifdef UNIT_TEST
/**
* Specify the list of devices that will appear to be available through
* usbfs during unit testing (of USBProxyLinuxGetDevices)
* @param pacszDeviceAddresses NULL terminated array of usbfs device addresses
*/
extern void TestUSBSetAvailableUsbfsDevices(const char **pacszDeviceAddresses);
/**
* Specify the list of files that access will report as accessible (at present
* we only do accessible or not accessible) during unit testing (of
* USBProxyLinuxGetDevices)
* @param pacszAccessibleFiles NULL terminated array of file paths to be
* reported accessible
*/
extern void TestUSBSetAccessibleFiles(const char **pacszAccessibleFiles);
#endif
/**
* Get the list of USB devices supported by the system. Should be freed using
* @a deviceFree or something equivalent.
* @param pcszDevicesRoot the path to the root of the device tree
* @param fUseSysfs whether to use sysfs (or usbfs) for enumeration
*/
bool fUseSysfs);
#endif /* ___USBGetDevices_h */