blob: 3923cdc6d9459952a44670ab90d1087afcac4913 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
|
#!/usr/bin/env bash
# usb_dyndbg.sh — toggle kernel dynamic-debug on USB drivers (host or gadget
# side); run with sudo. Flips +p/-p only on an allowlisted set of USB modules,
# so it can't reach arbitrary kernel debug or unrelated subsystems.
#
# Usage:
# sudo usb_dyndbg.sh on <module>... # enable +p (e.g. usbcore xhci_hcd)
# sudo usb_dyndbg.sh off <module>... # disable -p
# sudo usb_dyndbg.sh status [module] # show enabled sites (or one module's sites)
set -euo pipefail
CTL=/sys/kernel/debug/dynamic_debug/control
# Allowlist: USB core + host-controller + common class drivers, plus the
# gadget/UDC side of a Linux peer (dwc2/dwc3, udc_core, libcomposite).
ALLOW='usbcore xhci_hcd xhci_pci xhci_pci_renesas ehci_hcd ehci_pci ohci_hcd ohci_pci uhci_hcd dwc2 dwc3 cdc_acm usb_storage uas libcomposite udc_core'
die() { echo "usb_dyndbg: $*" >&2; exit 1; }
usage() {
echo "usage: usb_dyndbg.sh {on|off} <module>... modules: $ALLOW" >&2
echo " usb_dyndbg.sh status [module]" >&2
exit 2
}
allowed() { local m; for m in $ALLOW; do [ "$m" = "$1" ] && return 0; done; return 1; }
[ -e "$CTL" ] || die "dynamic_debug unavailable (need CONFIG_DYNAMIC_DEBUG + debugfs mounted)"
action=${1:-}; shift || true
case "$action" in
on|off)
[ "$#" -ge 1 ] || usage
flag='+p'; [ "$action" = off ] && flag='-p'
for m in "$@"; do allowed "$m" || die "module not allowlisted: $m"; done
for m in "$@"; do echo "module $m $flag" > "$CTL"; echo "dynamic debug $action: $m"; done
;;
status)
m=${1:-}
if [ -n "$m" ]; then
allowed "$m" || die "module not allowlisted: $m"
grep -E "\[$m\]" "$CTL" || echo "(no sites for $m)"
else
grep -E '=p( |$)' "$CTL" || echo "(no print sites enabled)"
fi
;;
*)
usage
;;
esac
|
