add cpu id warning

braindigitalis · braindigitalis · commit 27a4feb40599 · 2025-07-31T21:50:54.000Z
diff --git a/include/pci.h b/include/pci.h
@@ -283,6 +283,11 @@ bool pci_enable_msix(pci_dev_t device, uint32_t vector, uint16_t entry, uint32_t
  * @param handler  Interrupt service routine to register.
  * @param context  Opaque pointer passed to the ISR when the interrupt fires.
  *
+ * @warning The lapic_id parameter must be a valid Local APIC ID
+ *          corresponding to an online CPU. Passing an invalid or
+ *          offline APIC ID will result in undefined behaviour and
+ *          may cause interrupts to be lost.
+ *
  * @return The assigned interrupt vector (64–255 if MSI/MSI-X was used,
  *         or IRQ_START + line if falling back to legacy INTx).
  *

Original file line number	Diff line number	Diff line change
`@@ -283,6 +283,11 @@ bool pci_enable_msix(pci_dev_t device, uint32_t vector, uint16_t entry, uint32_t`
`283`	`283`	`* @param handler Interrupt service routine to register.`
`284`	`284`	`* @param context Opaque pointer passed to the ISR when the interrupt fires.`
`285`	`285`	`*`
	`286`	`+ * @warning The lapic_id parameter must be a valid Local APIC ID`
	`287`	`+ * corresponding to an online CPU. Passing an invalid or`
	`288`	`+ * offline APIC ID will result in undefined behaviour and`
	`289`	`+ * may cause interrupts to be lost.`
	`290`	`+ *`
`286`	`291`	`* @return The assigned interrupt vector (64–255 if MSI/MSI-X was used,`
`287`	`292`	`* or IRQ_START + line if falling back to legacy INTx).`
`288`	`293`	`*`