package PVE::API2::Hardware::USB;

use strict;
use warnings;

use PVE::JSONSchema qw(get_standard_option);

use PVE::SysFSTools;

use base qw(PVE::RESTHandler);

__PACKAGE__->register_method({
    name => 'usbscan',
    path => '',
    method => 'GET',
    description => "List local USB devices.",
    protected => 1,
    proxyto => "node",
    permissions => {
	check => ['perm', '/', ['Sys.Modify']],
    },
    parameters => {
	additionalProperties => 0,
	properties => {
	    node => get_standard_option('pve-node'),
	},
    },
    returns => {
	type => 'array',
	items => {
	    type => "object",
	    properties => {
		busnum => { type => 'integer'},
		class => { type => 'integer'},
		devnum => { type => 'integer'},
		level => { type => 'integer'},
		manufacturer => { type => 'string', optional => 1 },
		port => { type => 'integer'},
		prodid => { type => 'string'},
		product => { type => 'string', optional => 1 },
		serial => { type => 'string', optional => 1 },
		speed => { type => 'string'},
		usbpath => { type => 'string', optional => 1},
		vendid => { type => 'string'},
	    },
	},
    },
    code => sub {
	my ($param) = @_;

	return PVE::SysFSTools::scan_usb();
    }
});