Orange Pi5 kernel

^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   1) // SPDX-License-Identifier: GPL-2.0-or-later
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   2) //
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   3) // Validation of USB-audio class descriptors
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   4) //
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   5) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   6) #include <linux/init.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   7) #include <linux/usb.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   8) #include <linux/usb/audio.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300   9) #include <linux/usb/audio-v2.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  10) #include <linux/usb/audio-v3.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  11) #include <linux/usb/midi.h>
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  12) #include "usbaudio.h"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  13) #include "helper.h"
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  14) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  15) struct usb_desc_validator {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  16) 	unsigned char protocol;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  17) 	unsigned char type;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  18) 	bool (*func)(const void *p, const struct usb_desc_validator *v);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  19) 	size_t size;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  20) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  21) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  22) #define UAC_VERSION_ALL		(unsigned char)(-1)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  23) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  24) /* UAC1 only */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  25) static bool validate_uac1_header(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  26) 				 const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  27) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  28) 	const struct uac1_ac_header_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  29) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  30) 	return d->bLength >= sizeof(*d) &&
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  31) 		d->bLength >= sizeof(*d) + d->bInCollection;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  32) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  33) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  34) /* for mixer unit; covering all UACs */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  35) static bool validate_mixer_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  36) 				const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  37) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  38) 	const struct uac_mixer_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  39) 	size_t len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  40) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  41) 	if (d->bLength < sizeof(*d) || !d->bNrInPins)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  42) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  43) 	len = sizeof(*d) + d->bNrInPins;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  44) 	/* We can't determine the bitmap size only from this unit descriptor,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  45) 	 * so just check with the remaining length.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  46) 	 * The actual bitmap is checked at mixer unit parser.
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  47) 	 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  48) 	switch (v->protocol) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  49) 	case UAC_VERSION_1:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  50) 	default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  51) 		len += 2 + 1; /* wChannelConfig, iChannelNames */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  52) 		/* bmControls[n*m] */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  53) 		len += 1; /* iMixer */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  54) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  55) 	case UAC_VERSION_2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  56) 		len += 4 + 1; /* bmChannelConfig, iChannelNames */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  57) 		/* bmMixerControls[n*m] */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  58) 		len += 1 + 1; /* bmControls, iMixer */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  59) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  60) 	case UAC_VERSION_3:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  61) 		len += 2; /* wClusterDescrID */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  62) 		/* bmMixerControls[n*m] */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  63) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  64) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  65) 	return d->bLength >= len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  66) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  67) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  68) /* both for processing and extension units; covering all UACs */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  69) static bool validate_processing_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  70) 				     const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  71) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  72) 	const struct uac_processing_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  73) 	const unsigned char *hdr = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  74) 	size_t len, m;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  75) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  76) 	if (d->bLength < sizeof(*d))
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  77) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  78) 	len = sizeof(*d) + d->bNrInPins;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  79) 	if (d->bLength < len)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  80) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  81) 	switch (v->protocol) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  82) 	case UAC_VERSION_1:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  83) 	default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  84) 		/* bNrChannels, wChannelConfig, iChannelNames */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  85) 		len += 1 + 2 + 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  86) 		if (d->bLength < len + 1) /* bControlSize */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  87) 			return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  88) 		m = hdr[len];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  89) 		len += 1 + m + 1; /* bControlSize, bmControls, iProcessing */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  90) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  91) 	case UAC_VERSION_2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  92) 		/* bNrChannels, bmChannelConfig, iChannelNames */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  93) 		len += 1 + 4 + 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  94) 		if (v->type == UAC2_PROCESSING_UNIT_V2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  95) 			len += 2; /* bmControls -- 2 bytes for PU */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  96) 		else
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  97) 			len += 1; /* bmControls -- 1 byte for EU */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  98) 		len += 1; /* iProcessing */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300  99) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 100) 	case UAC_VERSION_3:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 101) 		/* wProcessingDescrStr, bmControls */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 102) 		len += 2 + 4;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 103) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 104) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 105) 	if (d->bLength < len)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 106) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 107) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 108) 	switch (v->protocol) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 109) 	case UAC_VERSION_1:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 110) 	default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 111) 		if (v->type == UAC1_EXTENSION_UNIT)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 112) 			return true; /* OK */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 113) 		switch (le16_to_cpu(d->wProcessType)) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 114) 		case UAC_PROCESS_UP_DOWNMIX:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 115) 		case UAC_PROCESS_DOLBY_PROLOGIC:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 116) 			if (d->bLength < len + 1) /* bNrModes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 117) 				return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 118) 			m = hdr[len];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 119) 			len += 1 + m * 2; /* bNrModes, waModes(n) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 120) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 121) 		default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 122) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 123) 		}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 124) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 125) 	case UAC_VERSION_2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 126) 		if (v->type == UAC2_EXTENSION_UNIT_V2)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 127) 			return true; /* OK */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 128) 		switch (le16_to_cpu(d->wProcessType)) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 129) 		case UAC2_PROCESS_UP_DOWNMIX:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 130) 		case UAC2_PROCESS_DOLBY_PROLOCIC: /* SiC! */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 131) 			if (d->bLength < len + 1) /* bNrModes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 132) 				return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 133) 			m = hdr[len];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 134) 			len += 1 + m * 4; /* bNrModes, daModes(n) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 135) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 136) 		default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 137) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 138) 		}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 139) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 140) 	case UAC_VERSION_3:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 141) 		if (v->type == UAC3_EXTENSION_UNIT) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 142) 			len += 2; /* wClusterDescrID */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 143) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 144) 		}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 145) 		switch (le16_to_cpu(d->wProcessType)) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 146) 		case UAC3_PROCESS_UP_DOWNMIX:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 147) 			if (d->bLength < len + 1) /* bNrModes */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 148) 				return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 149) 			m = hdr[len];
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 150) 			len += 1 + m * 2; /* bNrModes, waClusterDescrID(n) */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 151) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 152) 		case UAC3_PROCESS_MULTI_FUNCTION:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 153) 			len += 2 + 4; /* wClusterDescrID, bmAlgorighms */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 154) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 155) 		default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 156) 			break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 157) 		}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 158) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 159) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 160) 	if (d->bLength < len)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 161) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 162) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 163) 	return true;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 164) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 165) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 166) /* both for selector and clock selector units; covering all UACs */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 167) static bool validate_selector_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 168) 				   const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 169) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 170) 	const struct uac_selector_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 171) 	size_t len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 172) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 173) 	if (d->bLength < sizeof(*d))
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 174) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 175) 	len = sizeof(*d) + d->bNrInPins;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 176) 	switch (v->protocol) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 177) 	case UAC_VERSION_1:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 178) 	default:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 179) 		len += 1; /* iSelector */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 180) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 181) 	case UAC_VERSION_2:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 182) 		len += 1 + 1; /* bmControls, iSelector */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 183) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 184) 	case UAC_VERSION_3:
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 185) 		len += 4 + 2; /* bmControls, wSelectorDescrStr */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 186) 		break;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 187) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 188) 	return d->bLength >= len;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 189) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 190) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 191) static bool validate_uac1_feature_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 192) 				       const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 193) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 194) 	const struct uac_feature_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 195) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 196) 	if (d->bLength < sizeof(*d) || !d->bControlSize)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 197) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 198) 	/* at least bmaControls(0) for master channel + iFeature */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 199) 	return d->bLength >= sizeof(*d) + d->bControlSize + 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 200) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 201) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 202) static bool validate_uac2_feature_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 203) 				       const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 204) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 205) 	const struct uac2_feature_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 206) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 207) 	if (d->bLength < sizeof(*d))
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 208) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 209) 	/* at least bmaControls(0) for master channel + iFeature */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 210) 	return d->bLength >= sizeof(*d) + 4 + 1;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 211) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 212) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 213) static bool validate_uac3_feature_unit(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 214) 				       const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 215) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 216) 	const struct uac3_feature_unit_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 217) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 218) 	if (d->bLength < sizeof(*d))
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 219) 		return false;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 220) 	/* at least bmaControls(0) for master channel + wFeatureDescrStr */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 221) 	return d->bLength >= sizeof(*d) + 4 + 2;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 222) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 223) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 224) static bool validate_midi_out_jack(const void *p,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 225) 				   const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 226) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 227) 	const struct usb_midi_out_jack_descriptor *d = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 228) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 229) 	return d->bLength >= sizeof(*d) &&
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 230) 		d->bLength >= sizeof(*d) + d->bNrInputPins * 2;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 231) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 232) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 233) #define FIXED(p, t, s) { .protocol = (p), .type = (t), .size = sizeof(s) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 234) #define FUNC(p, t, f) { .protocol = (p), .type = (t), .func = (f) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 235) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 236) static const struct usb_desc_validator audio_validators[] = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 237) 	/* UAC1 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 238) 	FUNC(UAC_VERSION_1, UAC_HEADER, validate_uac1_header),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 239) 	FIXED(UAC_VERSION_1, UAC_INPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 240) 	      struct uac_input_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 241) 	FIXED(UAC_VERSION_1, UAC_OUTPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 242) 	      struct uac1_output_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 243) 	FUNC(UAC_VERSION_1, UAC_MIXER_UNIT, validate_mixer_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 244) 	FUNC(UAC_VERSION_1, UAC_SELECTOR_UNIT, validate_selector_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 245) 	FUNC(UAC_VERSION_1, UAC_FEATURE_UNIT, validate_uac1_feature_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 246) 	FUNC(UAC_VERSION_1, UAC1_PROCESSING_UNIT, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 247) 	FUNC(UAC_VERSION_1, UAC1_EXTENSION_UNIT, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 248) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 249) 	/* UAC2 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 250) 	FIXED(UAC_VERSION_2, UAC_HEADER, struct uac2_ac_header_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 251) 	FIXED(UAC_VERSION_2, UAC_INPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 252) 	      struct uac2_input_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 253) 	FIXED(UAC_VERSION_2, UAC_OUTPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 254) 	      struct uac2_output_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 255) 	FUNC(UAC_VERSION_2, UAC_MIXER_UNIT, validate_mixer_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 256) 	FUNC(UAC_VERSION_2, UAC_SELECTOR_UNIT, validate_selector_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 257) 	FUNC(UAC_VERSION_2, UAC_FEATURE_UNIT, validate_uac2_feature_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 258) 	/* UAC_VERSION_2, UAC2_EFFECT_UNIT: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 259) 	FUNC(UAC_VERSION_2, UAC2_PROCESSING_UNIT_V2, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 260) 	FUNC(UAC_VERSION_2, UAC2_EXTENSION_UNIT_V2, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 261) 	FIXED(UAC_VERSION_2, UAC2_CLOCK_SOURCE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 262) 	      struct uac_clock_source_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 263) 	FUNC(UAC_VERSION_2, UAC2_CLOCK_SELECTOR, validate_selector_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 264) 	FIXED(UAC_VERSION_2, UAC2_CLOCK_MULTIPLIER,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 265) 	      struct uac_clock_multiplier_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 266) 	/* UAC_VERSION_2, UAC2_SAMPLE_RATE_CONVERTER: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 267) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 268) 	/* UAC3 */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 269) 	FIXED(UAC_VERSION_2, UAC_HEADER, struct uac3_ac_header_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 270) 	FIXED(UAC_VERSION_3, UAC_INPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 271) 	      struct uac3_input_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 272) 	FIXED(UAC_VERSION_3, UAC_OUTPUT_TERMINAL,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 273) 	      struct uac3_output_terminal_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 274) 	/* UAC_VERSION_3, UAC3_EXTENDED_TERMINAL: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 275) 	FUNC(UAC_VERSION_3, UAC3_MIXER_UNIT, validate_mixer_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 276) 	FUNC(UAC_VERSION_3, UAC3_SELECTOR_UNIT, validate_selector_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 277) 	FUNC(UAC_VERSION_3, UAC_FEATURE_UNIT, validate_uac3_feature_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 278) 	/*  UAC_VERSION_3, UAC3_EFFECT_UNIT: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 279) 	FUNC(UAC_VERSION_3, UAC3_PROCESSING_UNIT, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 280) 	FUNC(UAC_VERSION_3, UAC3_EXTENSION_UNIT, validate_processing_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 281) 	FIXED(UAC_VERSION_3, UAC3_CLOCK_SOURCE,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 282) 	      struct uac3_clock_source_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 283) 	FUNC(UAC_VERSION_3, UAC3_CLOCK_SELECTOR, validate_selector_unit),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 284) 	FIXED(UAC_VERSION_3, UAC3_CLOCK_MULTIPLIER,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 285) 	      struct uac3_clock_multiplier_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 286) 	/* UAC_VERSION_3, UAC3_SAMPLE_RATE_CONVERTER: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 287) 	/* UAC_VERSION_3, UAC3_CONNECTORS: not implemented yet */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 288) 	{ } /* terminator */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 289) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 290) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 291) static const struct usb_desc_validator midi_validators[] = {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 292) 	FIXED(UAC_VERSION_ALL, USB_MS_HEADER,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 293) 	      struct usb_ms_header_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 294) 	FIXED(UAC_VERSION_ALL, USB_MS_MIDI_IN_JACK,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 295) 	      struct usb_midi_in_jack_descriptor),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 296) 	FUNC(UAC_VERSION_ALL, USB_MS_MIDI_OUT_JACK,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 297) 	     validate_midi_out_jack),
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 298) 	{ } /* terminator */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 299) };
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 300) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 301) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 302) /* Validate the given unit descriptor, return true if it's OK */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 303) static bool validate_desc(unsigned char *hdr, int protocol,
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 304) 			  const struct usb_desc_validator *v)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 305) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 306) 	if (hdr[1] != USB_DT_CS_INTERFACE)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 307) 		return true; /* don't care */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 308) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 309) 	for (; v->type; v++) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 310) 		if (v->type == hdr[2] &&
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 311) 		    (v->protocol == UAC_VERSION_ALL ||
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 312) 		     v->protocol == protocol)) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 313) 			if (v->func)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 314) 				return v->func(hdr, v);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 315) 			/* check for the fixed size */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 316) 			return hdr[0] >= v->size;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 317) 		}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 318) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 319) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 320) 	return true; /* not matching, skip validation */
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 321) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 322) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 323) bool snd_usb_validate_audio_desc(void *p, int protocol)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 324) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 325) 	unsigned char *c = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 326) 	bool valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 327) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 328) 	valid = validate_desc(p, protocol, audio_validators);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 329) 	if (!valid && snd_usb_skip_validation) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 330) 		print_hex_dump(KERN_ERR, "USB-audio: buggy audio desc: ",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 331) 			       DUMP_PREFIX_NONE, 16, 1, c, c[0], true);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 332) 		valid = true;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 333) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 334) 	return valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 335) }
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 336) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 337) bool snd_usb_validate_midi_desc(void *p)
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 338) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 339) 	unsigned char *c = p;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 340) 	bool valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 341) 
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 342) 	valid = validate_desc(p, UAC_VERSION_1, midi_validators);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 343) 	if (!valid && snd_usb_skip_validation) {
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 344) 		print_hex_dump(KERN_ERR, "USB-audio: buggy midi desc: ",
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 345) 			       DUMP_PREFIX_NONE, 16, 1, c, c[0], true);
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 346) 		valid = true;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 347) 	}
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 348) 	return valid;
^8f3ce5b39 (kx 2023-10-28 12:00:06 +0300 349) }