drivers/usb/usbip/vudc_dev.c
Source file repositories/reference/linux-study-clean/drivers/usb/usbip/vudc_dev.c
File Facts
- System
- Linux kernel
- Corpus path
drivers/usb/usbip/vudc_dev.c- Extension
.c- Size
- 12821 bytes
- Lines
- 640
- Domain
- Driver Families
- Bucket
- drivers/usb
- Inferred role
- Driver Families: implementation source
- Status
- source implementation candidate
Why This File Exists
Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Repeatable hardware-adapter layer. Deep compatibility for every driver is out of scope; this atlas records patterns, probe lifecycles, bus glue, IRQ/DMA usage, and links back to core abstractions.
- Uses kernel synchronization; read lock ordering, sleepability, and interrupt context assumptions before translating.
- Allocates kernel memory; connect allocation flags and lifetime to context constraints.
- Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.
Dependency Surface
linux/device.hlinux/kernel.hlinux/list.hlinux/platform_device.hlinux/usb.hlinux/usb/gadget.hlinux/usb/hcd.hlinux/kthread.hlinux/file.hlinux/byteorder/generic.husbip_common.hvudc.h
Detected Declarations
function Copyrightfunction free_urbpfunction free_urbp_and_urbfunction nukefunction stop_activityfunction list_for_each_entry_safefunction vgadget_get_framefunction vgadget_set_selfpoweredfunction vgadget_pullupfunction vgadget_udc_startfunction vgadget_udc_stopfunction vep_enablefunction vep_disablefunction vep_free_requestfunction vep_queuefunction vep_dequeuefunction vep_set_halt_and_wedgefunction vep_set_haltfunction vep_set_wedgefunction vudc_shutdownfunction vudc_device_resetfunction vudc_device_unusablefunction put_vudc_devicefunction init_vudc_hwfunction cleanup_vudc_hwfunction vudc_probefunction vudc_remove
Annotated Snippet
if (ret) {
dev_err(&udc->gadget.dev, "Unable go get desc: %d", ret);
goto unlock;
}
spin_unlock_irqrestore(&udc->lock, flags);
usbip_start_eh(&udc->ud);
} else {
/* Invalidate descriptors */
udc->desc_cached = 0;
spin_unlock_irqrestore(&udc->lock, flags);
usbip_event_add(&udc->ud, VUDC_EVENT_REMOVED);
usbip_stop_eh(&udc->ud); /* Wait for eh completion */
}
return 0;
unlock:
spin_unlock_irqrestore(&udc->lock, flags);
return 0;
}
static int vgadget_udc_start(struct usb_gadget *g,
struct usb_gadget_driver *driver)
{
struct vudc *udc = usb_gadget_to_vudc(g);
unsigned long flags;
spin_lock_irqsave(&udc->lock, flags);
udc->driver = driver;
udc->pullup = udc->connected = udc->desc_cached = 0;
spin_unlock_irqrestore(&udc->lock, flags);
return 0;
}
static int vgadget_udc_stop(struct usb_gadget *g)
{
struct vudc *udc = usb_gadget_to_vudc(g);
unsigned long flags;
spin_lock_irqsave(&udc->lock, flags);
udc->driver = NULL;
spin_unlock_irqrestore(&udc->lock, flags);
return 0;
}
static const struct usb_gadget_ops vgadget_ops = {
.get_frame = vgadget_get_frame,
.set_selfpowered = vgadget_set_selfpowered,
.pullup = vgadget_pullup,
.udc_start = vgadget_udc_start,
.udc_stop = vgadget_udc_stop,
};
/* endpoint ops */
static int vep_enable(struct usb_ep *_ep,
const struct usb_endpoint_descriptor *desc)
{
struct vep *ep;
struct vudc *udc;
unsigned int maxp;
unsigned long flags;
ep = to_vep(_ep);
udc = ep_to_vudc(ep);
if (!_ep || !desc || ep->desc || _ep->caps.type_control
|| desc->bDescriptorType != USB_DT_ENDPOINT)
return -EINVAL;
if (!udc->driver)
return -ESHUTDOWN;
spin_lock_irqsave(&udc->lock, flags);
maxp = usb_endpoint_maxp(desc);
_ep->maxpacket = maxp;
ep->desc = desc;
ep->type = usb_endpoint_type(desc);
ep->halted = ep->wedged = 0;
spin_unlock_irqrestore(&udc->lock, flags);
return 0;
}
Annotation
- Immediate include surface: `linux/device.h`, `linux/kernel.h`, `linux/list.h`, `linux/platform_device.h`, `linux/usb.h`, `linux/usb/gadget.h`, `linux/usb/hcd.h`, `linux/kthread.h`.
- Detected declarations: `function Copyright`, `function free_urbp`, `function free_urbp_and_urb`, `function nuke`, `function stop_activity`, `function list_for_each_entry_safe`, `function vgadget_get_frame`, `function vgadget_set_selfpowered`, `function vgadget_pullup`, `function vgadget_udc_start`.
- Atlas domain: Driver Families / drivers/usb.
- Implementation status: source implementation candidate.
- Synchronization appears in or near this file; preserve lock ordering, sleepability, and interrupt-context constraints.
Implementation Notes
- This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
- Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
- Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.