summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorHannu Lounento <hannu.lounento@vaisala.com>2023-06-08 14:42:13 +0300
committerSteve Sakoman <steve@sakoman.com>2023-06-21 04:00:58 -1000
commitab6c16cb554fa352d268c04769258f1c51ffc16d (patch)
tree7cd620a536c883c16e2d76fa60d5550393eb8105
parent17760d65dd5df960e3dfb09cbd2224096504047b (diff)
downloadpoky-ab6c16cb554fa352d268c04769258f1c51ffc16d.tar.gz
profile-manual: fix blktrace remote usage instructions
The references to the target and host systems (i.e. the client and server respectively) were swapped in the instructions. Also, there's no need to specify the device node on the server command line that is run on the host system. The previous, incorrect, instructions resulted typically in: target# blktrace -l /dev/mmcblk1 server: waiting for connections... and host$ blktrace -d /dev/mmcblk2 -h target Invalid path /dev/mmcblk2 specified: 2/No such file or directory unless the same device node happened to exist on the host system. Based on target# blktrace --version blktrace version 2.0.0 and host$ blktrace --version blktrace version 2.0.0 (From yocto-docs rev: 6d16d2bde0aa32276a035ee49703e6eea7c7b29a) Signed-off-by: Hannu Lounento <hannu.lounento@vaisala.com> Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com> Signed-off-by: Steve Sakoman <steve@sakoman.com>
-rw-r--r--documentation/profile-manual/usage.rst19
1 files changed, 10 insertions, 9 deletions
diff --git a/documentation/profile-manual/usage.rst b/documentation/profile-manual/usage.rst
index 5758b92852..3c9321f09c 100644
--- a/documentation/profile-manual/usage.rst
+++ b/documentation/profile-manual/usage.rst
@@ -2401,20 +2401,21 @@ tracer writes to, blktrace provides a way to trace without perturbing
2401the traced device at all by providing native support for sending all 2401the traced device at all by providing native support for sending all
2402trace data over the network. 2402trace data over the network.
2403 2403
2404To have blktrace operate in this mode, start blktrace on the target 2404To have blktrace operate in this mode, start blktrace in server mode on the
2405system being traced with the -l option, along with the device to trace:: 2405host system, which is going to store the captured data::
2406 2406
2407 root@crownbay:~# blktrace -l /dev/sdc 2407 $ blktrace -l
2408 server: waiting for connections... 2408 server: waiting for connections...
2409 2409
2410On the host system, use the -h option to connect to the target system, 2410On the target system that is going to be traced, start blktrace in client
2411also passing it the device to trace:: 2411mode with the -h option to connect to the host system, also passing it the
2412device to trace::
2412 2413
2413 $ blktrace -d /dev/sdc -h 192.168.1.43 2414 root@crownbay:~# blktrace -d /dev/sdc -h 192.168.1.43
2414 blktrace: connecting to 192.168.1.43 2415 blktrace: connecting to 192.168.1.43
2415 blktrace: connected! 2416 blktrace: connected!
2416 2417
2417On the target system, you should see this:: 2418On the host system, you should see this::
2418 2419
2419 server: connection from 192.168.1.43 2420 server: connection from 192.168.1.43
2420 2421
@@ -2424,7 +2425,7 @@ In another shell, execute a workload you want to trace. ::
2424 Connecting to downloads.yoctoproject.org (140.211.169.59:80) 2425 Connecting to downloads.yoctoproject.org (140.211.169.59:80)
2425 linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA 2426 linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA
2426 2427
2427When it's done, do a Ctrl-C on the host system to stop the 2428When it's done, do a Ctrl-C on the target system to stop the
2428trace:: 2429trace::
2429 2430
2430 ^C=== sdc === 2431 ^C=== sdc ===
@@ -2432,7 +2433,7 @@ trace::
2432 CPU 1: 4109 events, 193 KiB data 2433 CPU 1: 4109 events, 193 KiB data
2433 Total: 11800 events (dropped 0), 554 KiB data 2434 Total: 11800 events (dropped 0), 554 KiB data
2434 2435
2435On the target system, you should also see a trace summary for the trace 2436On the host system, you should also see a trace summary for the trace
2436just ended:: 2437just ended::
2437 2438
2438 server: end of run for 192.168.1.43:sdc 2439 server: end of run for 192.168.1.43:sdc