u-boot/doc/usage/cmd
AKASHI Takahiro 36e45f69c4 cmd: dm: allow for selecting uclass and device
The output from "dm tree" or "dm uclass" is a bit annoying
if the number of devices available on the system is huge.
(This is especially true on sandbox when I debug some DM code.)

With this patch, we can specify the uclass name or the device
name that we are interested in in order to limit the output.

For instance,

=> dm uclass usb
uclass 121: usb
0     usb@1 @ 0bcff8b0, seq 1

uclass 124: usb

=> dm tree usb:usb@1
 Class     Index  Probed  Driver                Name
-----------------------------------------------------------
 usb           0  [   ]   usb_sandbox           usb@1
 usb_hub       0  [   ]   usb_hub               `-- hub
 usb_emul      0  [   ]   usb_sandbox_hub           `-- hub-emul
 usb_emul      1  [   ]   usb_sandbox_flash             |-- flash-stick@0
 usb_emul      2  [   ]   usb_sandbox_flash             |-- flash-stick@1
 usb_emul      3  [   ]   usb_sandbox_flash             |-- flash-stick@2
 usb_emul      4  [   ]   usb_sandbox_keyb              `-- keyb@3

If you want forward-matching against a uclass or udevice name,
you can specify "-e" option.

=> dm uclass -e usb
uclass 15: usb_emul
0     hub-emul @ 0bcffb00, seq 0
1     flash-stick@0 @ 0bcffc30, seq 1
2     flash-stick@1 @ 0bcffdc0, seq 2
3     flash-stick@2 @ 0bcfff50, seq 3
4     keyb@3 @ 0bd000e0, seq 4

uclass 64: usb_mass_storage

uclass 121: usb
0     usb@1 @ 0bcff8b0, seq 1

uclass 122: usb_dev_generic

uclass 123: usb_hub
0     hub @ 0bcff9b0, seq 0

uclass 124: usb

=> dm tree -e usb
 Class     Index  Probed  Driver                Name
-----------------------------------------------------------
 usb           0  [   ]   usb_sandbox           usb@1
 usb_hub       0  [   ]   usb_hub               `-- hub
 usb_emul      0  [   ]   usb_sandbox_hub           `-- hub-emul
 usb_emul      1  [   ]   usb_sandbox_flash             |-- flash-stick@0
 usb_emul      2  [   ]   usb_sandbox_flash             |-- flash-stick@1
 usb_emul      3  [   ]   usb_sandbox_flash             |-- flash-stick@2
 usb_emul      4  [   ]   usb_sandbox_keyb              `-- keyb@3

Signed-off-by: AKASHI Takahiro <takahiro.akashi@linaro.org>
Reviewed-by: Simon Glass <sjg@chromium.org>
2023-09-23 12:31:25 -06:00
..
acpi.rst acpi: Add a comment to set the acpi tables 2023-07-17 17:08:44 +08:00
addrmap.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
armffa.rst arm_ffa: introduce armffa command 2023-08-08 10:22:03 -04:00
askenv.rst doc: man-page for the env command 2022-04-15 11:23:02 +02:00
base.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
bdinfo.rst doc: example heading should be h2 2023-01-27 18:31:59 +01:00
bind.rst doc: bind man-page 2023-06-23 15:53:10 +02:00
blkcache.rst doc: man-page for blkcache 2023-01-20 16:38:52 +01:00
bootd.rst Documentation: man-page for command bootd 2022-11-16 08:34:06 +01:00
bootdev.rst bootstd: Update documentation for new features 2023-01-23 18:11:41 -05:00
bootefi.rst cmd/bootefi: correct command syntax 2022-05-28 10:59:27 +02:00
bootflow.rst bootstd: Add a command to read all files for a bootflow 2023-08-11 07:33:38 -06:00
booti.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
bootm.rst doc: Improve documentation for the bootm command 2023-06-23 16:28:13 +02:00
bootmenu.rst menu: remove CTRL+C to quit 2023-02-10 13:05:39 +01:00
bootmeth.rst bootstd: Rename distro and syslinux to extlinux 2023-05-13 09:52:32 -04:00
bootz.rst doc: man-page for bootz command 2022-06-19 15:53:09 +02:00
button.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
cat.rst cmd: cat: add new command 2022-10-11 15:40:48 -04:00
cbsysinfo.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
cedit.rst expo: cedit: Support reading settings from CMOS RAM 2023-08-25 13:54:33 -04:00
cls.rst doc: man-page for cls 2022-10-10 16:34:25 +02:00
cmp.rst doc: in cmp man-page replace 'tuples' by 'values' 2022-11-22 12:00:01 +01:00
coninfo.rst doc: coninfo man-page 2023-04-08 07:44:33 +02:00
conitrace.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
cp.rst doc: man-page for cp 2023-05-04 09:57:43 +02:00
cyclic.rst cyclic: Add documentation 2022-09-13 16:01:44 -04:00
dm.rst cmd: dm: allow for selecting uclass and device 2023-09-23 12:31:25 -06:00
ebtupdate.rst Merge branch 'master' of https://source.denx.de/u-boot/custodians/u-boot-tegra 2023-02-23 17:40:18 -05:00
echo.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
efi.rst efi: Support showing tables 2023-03-25 11:07:22 +01:00
eficonfig.rst doc: eficonfig: add description for UEFI Secure Boot Configuration 2022-12-02 19:17:25 +01:00
env.rst doc: man-page for the env command 2022-04-15 11:23:02 +02:00
event.rst Merge branch 'next' 2022-04-04 10:48:44 -04:00
exception.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
exit.rst cmd: exit: Fix return value propagation out of environment scripts 2023-01-11 15:02:24 -05:00
extension.rst doc: usage: Update the extension command title 2022-03-31 19:06:16 +02:00
false.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
fatinfo.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
fatload.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
fdt.rst fdt: Show a message when the working FDT changes 2022-10-17 21:17:12 -06:00
font.rst doc: update font man-page 2023-01-27 18:31:59 +01:00
for.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
fwu_mdata.rst FWU: cmd: Add a command to read FWU metadata 2022-10-31 14:47:33 -04:00
gpio.rst doc: Add gpio status output fields description 2022-09-01 07:21:25 +02:00
gpt.rst cmd: gpt: Add command to swap partition order 2023-09-11 16:27:49 -04:00
host.rst dm: Add documentation for host command and implementation 2022-11-07 16:24:30 -07:00
imxtract.rst doc: man-page for imxtract 2023-06-16 06:45:19 +02:00
load.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
loadb.rst doc: fix typo loady in loadb man-page 2023-07-01 17:00:52 +02:00
loadm.rst cmd: load: add load command for memory mapped 2022-06-22 11:35:47 -04:00
loads.rst doc: loads man-page 2023-07-01 17:00:52 +02:00
loadx.rst doc: loadx man-page 2023-06-02 10:59:15 +02:00
loady.rst doc: fix loady man-page 2023-06-02 10:59:15 +02:00
mbr.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
md.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
mmc.rst doc: mmc: drop 0x prefixes in read/write examples 2023-05-04 09:57:43 +02:00
mtest.rst doc: man-page for mtest 2023-01-27 18:31:59 +01:00
mtrr.rst x86: mtrr: Add documentation 2023-07-17 17:08:44 +08:00
panic.rst doc: man-page for panic command 2023-03-13 13:56:14 +01:00
part.rst part: Allow setting the partition-table type 2023-07-17 17:12:06 +08:00
pause.rst cmd: Add pause command 2022-09-02 13:40:42 -04:00
pinmux.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
printenv.rst doc: correct heading level in printenv man-page 2022-12-20 16:06:48 +01:00
pstore.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
qfw.rst qfw: Show the file address if available 2023-07-17 17:12:07 +08:00
read.rst doc: document read/write commands 2023-03-17 16:10:42 -04:00
reset.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
rng.rst doc: rng: Add documentation for the rng command 2022-08-02 23:50:02 +03:00
saves.rst doc: saves man-page 2023-07-01 17:00:52 +02:00
sbi.rst doc: update sbi command example 2022-11-06 10:50:04 +01:00
scp03.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
seama.rst cmd: Add a SEAMA image load command 2023-02-06 17:10:15 -05:00
setexpr.rst doc: complete setexpr configuration information 2023-02-10 13:05:39 +01:00
sf.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
size.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
sleep.rst doc: sleep man-page 2023-01-27 18:31:59 +01:00
sm.rst doc/usage: cmd: sm: documentation efusedump cmd 2023-01-17 09:27:17 +01:00
sound.rst cmd: allow sound command to play multiple sounds 2022-12-20 16:06:48 +01:00
source.rst Prepare v2023.07-rc6 2023-07-05 11:28:55 -04:00
temperature.rst doc: cmd: temperature: add documentation 2022-10-11 15:40:48 -04:00
tftpput.rst Pull request for efi-2022-10-rc5 2022-09-09 15:07:05 -04:00
trace.rst trace: Update documentation 2023-02-11 12:22:35 -05:00
true.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
ums.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
unbind.rst doc: unbind man-page 2023-06-23 15:53:10 +02:00
ut.rst test: Add a way to detect a test that breaks another 2022-11-07 16:24:30 -07:00
wdt.rst doc: usage: Group all shell command docs into cmd/ sub-directory 2022-03-31 19:06:16 +02:00
wget.rst doc: improve wget man-page 2022-12-29 10:51:50 +01:00
write.rst doc: document read/write commands 2023-03-17 16:10:42 -04:00
xxd.rst cmd: xxd: add new command 2022-10-11 15:40:48 -04:00