media: uvcvideo: Fix comment blocks style

	data[bit >> 3] &= ~(1 << (bit & 7));

}

/* Extract the bit string specified by mapping->offset and mapping->size

/*

 * Extract the bit string specified by mapping->offset and mapping->size

 * from the little-endian data stored at 'data' and return the result as

 * a signed 32bit integer. Sign extension will be performed if the mapping

 * references a signed data type.

	return value;

}

/* Set the bit string specified by mapping->offset and mapping->size

/*

 * Set the bit string specified by mapping->offset and mapping->size

 * in the little-endian data stored at 'data' to the value 'value'.

 */

static void uvc_set_le_value(struct uvc_control_mapping *mapping,

	int offset = mapping->offset;

	u8 mask;

	/* According to the v4l2 spec, writing any value to a button control

	/*

	 * According to the v4l2 spec, writing any value to a button control

	 * should result in the action belonging to the button control being

	 * triggered. UVC devices however want to see a 1 written -> override

	 * value.

			    UVC_VC_EXTENSION_UNIT)

				return ret;

			/* GET_RES is mandatory for XU controls, but some

			/*

			 * GET_RES is mandatory for XU controls, but some

			 * cameras still choke on it. Ignore errors and set the

			 * resolution value to zero.

			 */

		uvc_ctrl_fill_event(handle->chain, &ev, ctrl, mapping, val,

				    changes);

		/* Mark the queue as active, allowing this initial

		   event to be accepted. */

		/*

		 * Mark the queue as active, allowing this initial event to be

		 * accepted.

		 */

		sev->elems = elems;

		v4l2_event_queue_fh(sev->fh, &ev);

	}

		if (!ctrl->initialized)

			continue;

		/* Reset the loaded flag for auto-update controls that were

		/*

		 * Reset the loaded flag for auto-update controls that were

		 * marked as loaded in uvc_ctrl_get/uvc_ctrl_set to prevent

		 * uvc_ctrl_get from using the cached value, and for write-only

		 * controls to prevent uvc_ctrl_set from setting bits not

			return -ERANGE;

		value = mapping->menu_info[xctrl->value].value;

		/* Valid menu indices are reported by the GET_RES request for

		/*

		 * Valid menu indices are reported by the GET_RES request for

		 * UVC controls that support it.

		 */

		if (mapping->data_type == UVC_CTRL_DATA_TYPE_BITMASK &&

		break;

	}

	/* If the mapping doesn't span the whole UVC control, the current value

	/*

	 * If the mapping doesn't span the whole UVC control, the current value

	 * needs to be loaded from the device to perform the read-modify-write

	 * operation.

	 */

	unsigned int size;

	unsigned int i;

	/* Most mappings come from static kernel data and need to be duplicated.

	/*

	 * Most mappings come from static kernel data and need to be duplicated.

	 * Mappings that come from userspace will be unnecessarily duplicated,

	 * this could be optimized.

	 */

	const struct uvc_control_mapping *mend =

		mapping + ARRAY_SIZE(uvc_ctrl_mappings);

	/* XU controls initialization requires querying the device for control

	/*

	 * XU controls initialization requires querying the device for control

	 * information. As some buggy UVC devices will crash when queried

	 * repeatedly in a tight loop, delay XU controls initialization until

	 * first use.

	return V4L2_YCBCR_ENC_DEFAULT;  /* Reserved */

}

/* Simplify a fraction using a simple continued fraction decomposition. The

/*

 * Simplify a fraction using a simple continued fraction decomposition. The

 * idea here is to convert fractions such as 333333/10000000 to 1/30 using

 * 32 bit arithmetic only. The algorithm is not perfect and relies upon two

 * arbitrary parameters to remove non-significative terms from the simple

	if (an == NULL)

		return;

	/* Convert the fraction to a simple continued fraction. See

	/*

	 * Convert the fraction to a simple continued fraction. See

	 * https://mathforum.org/dr.math/faq/faq.fractions.html

	 * Stop if the current term is bigger than or equal to the given

	 * threshold.

	kfree(an);

}

/* Convert a fraction to a frame interval in 100ns multiples. The idea here is

/*

 * Convert a fraction to a frame interval in 100ns multiples. The idea here is

 * to compute numerator / denominator * 10000000 using 32 bit fixed point

 * arithmetic only.

 */

	    numerator/denominator >= ((u32)-1)/10000000)

		return (u32)-1;

	/* Divide both the denominator and the multiplier by two until

	/*

	 * Divide both the denominator and the multiplier by two until

	 * numerator * multiplier doesn't overflow. If anyone knows a better

	 * algorithm please let me know.

	 */

		format->bpp = buffer[21];

		/* Some devices report a format that doesn't match what they

		/*

		 * Some devices report a format that doesn't match what they

		 * really send.

		 */

		if (dev->quirks & UVC_QUIRK_FORCE_Y8) {

	buflen -= buffer[0];

	buffer += buffer[0];

	/* Parse the frame descriptors. Only uncompressed, MJPEG and frame

	/*

	 * Parse the frame descriptors. Only uncompressed, MJPEG and frame

	 * based formats have frame descriptors.

	 */

	while (buflen > 2 && buffer[1] == USB_DT_CS_INTERFACE &&

		}

		frame->dwFrameInterval = *intervals;

		/* Several UVC chipsets screw up dwMaxVideoFrameBufferSize

		/*

		 * Several UVC chipsets screw up dwMaxVideoFrameBufferSize

		 * completely. Observed behaviours range from setting the

		 * value to 1.1x the actual frame size to hardwiring the

		 * 16 low bits to 0. This results in a higher than necessary

			frame->dwMaxVideoFrameBufferSize = format->bpp

				* frame->wWidth * frame->wHeight / 8;

		/* Some bogus devices report dwMinFrameInterval equal to

		/*

		 * Some bogus devices report dwMinFrameInterval equal to

		 * dwMaxFrameInterval and have dwFrameIntervalStep set to

		 * zero. Setting all null intervals to 1 fixes the problem and

		 * some other divisions by zero that could happen.

			*(*intervals)++ = interval ? interval : 1;

		}

		/* Make sure that the default frame interval stays between

		/*

		 * Make sure that the default frame interval stays between

		 * the boundaries.

		 */

		n -= frame->bFrameIntervalType ? 1 : 2;

		return -ENOMEM;

	}

	/* The Pico iMage webcam has its class-specific interface descriptors

	/*

	 * The Pico iMage webcam has its class-specific interface descriptors

	 * after the endpoint descriptors.

	 */

	if (buflen == 0) {

			break;

		case UVC_VS_FORMAT_DV:

			/* DV format has no frame descriptor. We will create a

			/*

			 * DV format has no frame descriptor. We will create a

			 * dummy frame descriptor with a dummy frame interval.

			 */

			nformats++;

		if (buffer[1] != 0x41 || buffer[2] != 0x01)

			break;

		/* Logitech implements several vendor specific functions

		/*

		 * Logitech implements several vendor specific functions

		 * through vendor specific extension units (LXU).

		 *

		 * The LXU descriptors are similar to XU descriptors

			return -EINVAL;

		}

		/* Make sure the terminal type MSB is not null, otherwise it

		/*

		 * Make sure the terminal type MSB is not null, otherwise it

		 * could be confused with a unit.

		 */

		type = get_unaligned_le16(&buffer[4]);

	int buflen = alts->extralen;

	int ret;

	/* Parse the default alternate setting only, as the UVC specification

	/*

	 * Parse the default alternate setting only, as the UVC specification

	 * defines a single alternate setting, the default alternate setting

	 * zero.

	 */

		buffer += buffer[0];

	}

	/* Check if the optional status endpoint is present. Built-in iSight

	/*

	 * Check if the optional status endpoint is present. Built-in iSight

	 * webcams have an interrupt endpoint but spit proprietary data that

	 * don't conform to the UVC status endpoint messages. Don't try to

	 * handle the interrupt endpoint for those cameras.

		if (!UVC_ENTITY_IS_OTERM(term))

			continue;

		/* If the terminal is already included in a chain, skip it.

		/*

		 * If the terminal is already included in a chain, skip it.

		 * This can happen for chains that have multiple output

		 * terminals, where all output terminals beside the first one

		 * will be inserted in the chain in forward scans.

		if (ret < 0)

			return ret;

		/* Register a metadata node, but ignore a possible failure,

		/*

		 * Register a metadata node, but ignore a possible failure,

		 * complete registration of video nodes anyway.

		 */

		uvc_meta_register(stream);

{

	struct uvc_device *dev = usb_get_intfdata(intf);

	/* Set the USB interface data to NULL. This can be done outside the

	/*

	 * Set the USB interface data to NULL. This can be done outside the

	 * lock, as there's no other reader.

	 */

	usb_set_intfdata(intf, NULL);

#include "uvcvideo.h"

/* Built-in iSight webcams implements most of UVC 1.0 except a

/*

 * Built-in iSight webcams implements most of UVC 1.0 except a

 * different packet format. Instead of sending a header at the

 * beginning of each isochronous transfer payload, the webcam sends a

 * single header per image (on its own in a packet), followed by

		buf->state = UVC_BUF_STATE_ACTIVE;

	}

	/* Mark the buffer as done if we're at the beginning of a new frame.

	/*

	 * Mark the buffer as done if we're at the beginning of a new frame.

	 *

	 * Empty buffers (bytesused == 0) don't trigger end of frame detection

	 * as it doesn't make sense to return an empty buffer.

		return -EAGAIN;

	}

	/* Copy the video data to the buffer. Skip header packets, as they

	/*

	 * Copy the video data to the buffer. Skip header packets, as they

	 * contain no data.

	 */

	if (!is_header) {

				urb->iso_frame_desc[i].status);

		}

		/* Decode the payload packet.

		/*

		 * Decode the payload packet.

		 *

		 * uvc_video_decode is entered twice when a frame transition

		 * has been detected because the end of frame can only be

		 * reliably detected when the first packet of the new frame

		kref_init(&buf->ref);

		list_add_tail(&buf->queue, &queue->irqqueue);

	} else {

		/* If the device is disconnected return the buffer to userspace

		/*

		 * If the device is disconnected return the buffer to userspace

		 * directly. The next QBUF call will fail with -ENODEV.

		 */

		buf->state = UVC_BUF_STATE_ERROR;

	spin_lock_irqsave(&queue->irqlock, flags);

	uvc_queue_return_buffers(queue, UVC_BUF_STATE_ERROR);

	/* This must be protected by the irqlock spinlock to avoid race

	/*

	 * This must be protected by the irqlock spinlock to avoid race

	 * conditions between uvc_buffer_queue and the disconnection event that

	 * could result in an interruptible wait in uvc_dequeue_buffer. Do not

	 * blindly replace this logic by checking for the UVC_QUEUE_DISCONNECTED

	case -ENOENT:		/* usb_kill_urb() called. */

	case -ECONNRESET:	/* usb_unlink_urb() called. */

	case -ESHUTDOWN:	/* The endpoint is being disabled. */

	case -EPROTO:		/* Device is disconnected (reported by some

				 * host controller). */

	case -EPROTO:		/* Device is disconnected (reported by some host controllers). */

		return;

	default:

	pipe = usb_rcvintpipe(dev->udev, ep->desc.bEndpointAddress);

	/* For high-speed interrupt endpoints, the bInterval value is used as

	/*

	 * For high-speed interrupt endpoints, the bInterval value is used as

	 * an exponent of two. Some developers forgot about it.

	 */

	interval = ep->desc.bInterval;