diff options
author | Jon Mason <jdmason@kudzu.us> | 2021-10-07 11:06:29 -0400 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2021-10-08 22:01:24 +0100 |
commit | 0638b77576c2454e325a6fded69fd93c3429eeab (patch) | |
tree | e5fc2b328adf5e7e7b47001f1d4f46e594e10c00 /documentation | |
parent | 58645b0586d56651d2fdcd154600f333ba63beaf (diff) | |
download | poky-0638b77576c2454e325a6fded69fd93c3429eeab.tar.gz |
documentation: use YOCTO_DL_URL
(From yocto-docs rev: e3ad609d9fce8d6729bf6cb553993bddba1785ae)
Signed-off-by: Jon Mason <jdmason@kudzu.us>
Reviewed-by: Michael Opdenacker <michael.opdenacker@bootlin.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r-- | documentation/profile-manual/usage.rst | 28 | ||||
-rw-r--r-- | documentation/ref-manual/faq.rst | 16 | ||||
-rw-r--r-- | documentation/ref-manual/variables.rst | 8 |
3 files changed, 26 insertions, 26 deletions
diff --git a/documentation/profile-manual/usage.rst b/documentation/profile-manual/usage.rst index 0c21ab14de..3d2840884f 100644 --- a/documentation/profile-manual/usage.rst +++ b/documentation/profile-manual/usage.rst | |||
@@ -105,18 +105,18 @@ can be used in a very similar way to the whole host of supported BusyBox | |||
105 | applets in Yocto. :: | 105 | applets in Yocto. :: |
106 | 106 | ||
107 | root@crownbay:~# rm linux-2.6.19.2.tar.bz2; \ | 107 | root@crownbay:~# rm linux-2.6.19.2.tar.bz2; \ |
108 | wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 108 | wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
109 | 109 | ||
110 | The quickest and easiest way to get some basic overall data about what's | 110 | The quickest and easiest way to get some basic overall data about what's |
111 | going on for a particular workload is to profile it using 'perf stat'. | 111 | going on for a particular workload is to profile it using 'perf stat'. |
112 | 'perf stat' basically profiles using a few default counters and displays | 112 | 'perf stat' basically profiles using a few default counters and displays |
113 | the summed counts at the end of the run:: | 113 | the summed counts at the end of the run:: |
114 | 114 | ||
115 | root@crownbay:~# perf stat wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 115 | root@crownbay:~# perf stat wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
116 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 116 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
117 | linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA | 117 | linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA |
118 | 118 | ||
119 | Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': | 119 | Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2': |
120 | 120 | ||
121 | 4597.223902 task-clock # 0.077 CPUs utilized | 121 | 4597.223902 task-clock # 0.077 CPUs utilized |
122 | 23568 context-switches # 0.005 M/sec | 122 | 23568 context-switches # 0.005 M/sec |
@@ -141,11 +141,11 @@ by 'perf stat'. For example, suppose we wanted to see a summary of all | |||
141 | the events related to kernel memory allocation/freeing along with cache | 141 | the events related to kernel memory allocation/freeing along with cache |
142 | hits and misses:: | 142 | hits and misses:: |
143 | 143 | ||
144 | root@crownbay:~# perf stat -e kmem:* -e cache-references -e cache-misses wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 144 | root@crownbay:~# perf stat -e kmem:* -e cache-references -e cache-misses wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
145 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 145 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
146 | linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA | 146 | linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA |
147 | 147 | ||
148 | Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': | 148 | Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2': |
149 | 149 | ||
150 | 5566 kmem:kmalloc | 150 | 5566 kmem:kmalloc |
151 | 125517 kmem:kmem_cache_alloc | 151 | 125517 kmem:kmem_cache_alloc |
@@ -181,7 +181,7 @@ executed in a new shell). perf collects samples until the process exits | |||
181 | and records them in a file named 'perf.data' in the current working | 181 | and records them in a file named 'perf.data' in the current working |
182 | directory. :: | 182 | directory. :: |
183 | 183 | ||
184 | root@crownbay:~# perf record wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 184 | root@crownbay:~# perf record wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
185 | 185 | ||
186 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 186 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
187 | linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA | 187 | linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA |
@@ -219,7 +219,7 @@ between the new profile and the previous one is that we'll add the -g | |||
219 | option, which will record not just the address of a sampled function, | 219 | option, which will record not just the address of a sampled function, |
220 | but the entire callchain to the sampled function as well:: | 220 | but the entire callchain to the sampled function as well:: |
221 | 221 | ||
222 | root@crownbay:~# perf record -g wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 222 | root@crownbay:~# perf record -g wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
223 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 223 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
224 | linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA | 224 | linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA |
225 | [ perf record: Woken up 3 times to write data ] | 225 | [ perf record: Woken up 3 times to write data ] |
@@ -527,8 +527,8 @@ workload, so let's choose the most likely subsystems (identified by the | |||
527 | string before the colon in the Tracepoint events) and do a 'perf stat' | 527 | string before the colon in the Tracepoint events) and do a 'perf stat' |
528 | run using only those wildcarded subsystems:: | 528 | run using only those wildcarded subsystems:: |
529 | 529 | ||
530 | root@crownbay:~# perf stat -e skb:* -e net:* -e napi:* -e sched:* -e workqueue:* -e irq:* -e syscalls:* wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 530 | root@crownbay:~# perf stat -e skb:* -e net:* -e napi:* -e sched:* -e workqueue:* -e irq:* -e syscalls:* wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
531 | Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': | 531 | Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2': |
532 | 532 | ||
533 | 23323 skb:kfree_skb | 533 | 23323 skb:kfree_skb |
534 | 0 skb:consume_skb | 534 | 0 skb:consume_skb |
@@ -589,7 +589,7 @@ run using only those wildcarded subsystems:: | |||
589 | Let's pick one of these tracepoints | 589 | Let's pick one of these tracepoints |
590 | and tell perf to do a profile using it as the sampling event:: | 590 | and tell perf to do a profile using it as the sampling event:: |
591 | 591 | ||
592 | root@crownbay:~# perf record -g -e sched:sched_wakeup wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 592 | root@crownbay:~# perf record -g -e sched:sched_wakeup wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
593 | 593 | ||
594 | .. image:: figures/sched-wakeup-profile.png | 594 | .. image:: figures/sched-wakeup-profile.png |
595 | :align: center | 595 | :align: center |
@@ -648,7 +648,7 @@ applicable to our workload:: | |||
648 | 648 | ||
649 | root@crownbay:~# perf record -g -e skb:* -e net:* -e napi:* -e sched:sched_switch -e sched:sched_wakeup -e irq:* | 649 | root@crownbay:~# perf record -g -e skb:* -e net:* -e napi:* -e sched:sched_switch -e sched:sched_wakeup -e irq:* |
650 | -e syscalls:sys_enter_read -e syscalls:sys_exit_read -e syscalls:sys_enter_write -e syscalls:sys_exit_write | 650 | -e syscalls:sys_enter_read -e syscalls:sys_exit_read -e syscalls:sys_enter_write -e syscalls:sys_exit_write |
651 | wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 651 | wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
652 | 652 | ||
653 | We can look at the raw trace output using 'perf script' with no | 653 | We can look at the raw trace output using 'perf script' with no |
654 | arguments:: | 654 | arguments:: |
@@ -885,7 +885,7 @@ To demonstrate this, open up one window and start the profile using the | |||
885 | 885 | ||
886 | In another window, run the wget test:: | 886 | In another window, run the wget test:: |
887 | 887 | ||
888 | root@crownbay:~# wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 | 888 | root@crownbay:~# wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2 |
889 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 889 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
890 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA | 890 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA |
891 | 891 | ||
@@ -2251,7 +2251,7 @@ of the block device you want to trace activity on:: | |||
2251 | 2251 | ||
2252 | In another shell, execute a workload you want to trace. :: | 2252 | In another shell, execute a workload you want to trace. :: |
2253 | 2253 | ||
2254 | root@crownbay:/media/sdc# rm linux-2.6.19.2.tar.bz2; wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2; sync | 2254 | root@crownbay:/media/sdc# rm linux-2.6.19.2.tar.bz2; wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2; sync |
2255 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 2255 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
2256 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA | 2256 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA |
2257 | 2257 | ||
@@ -2420,7 +2420,7 @@ On the target system, you should see this:: | |||
2420 | 2420 | ||
2421 | In another shell, execute a workload you want to trace. :: | 2421 | In another shell, execute a workload you want to trace. :: |
2422 | 2422 | ||
2423 | root@crownbay:/media/sdc# rm linux-2.6.19.2.tar.bz2; wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2; sync | 2423 | root@crownbay:/media/sdc# rm linux-2.6.19.2.tar.bz2; wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2; sync |
2424 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) | 2424 | Connecting to downloads.yoctoproject.org (140.211.169.59:80) |
2425 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA | 2425 | linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA |
2426 | 2426 | ||
diff --git a/documentation/ref-manual/faq.rst b/documentation/ref-manual/faq.rst index 7b337dbf60..6f2970df23 100644 --- a/documentation/ref-manual/faq.rst +++ b/documentation/ref-manual/faq.rst | |||
@@ -302,10 +302,10 @@ attempt before any others by adding something like the following to the | |||
302 | ``local.conf`` configuration file:: | 302 | ``local.conf`` configuration file:: |
303 | 303 | ||
304 | PREMIRRORS:prepend = "\ | 304 | PREMIRRORS:prepend = "\ |
305 | git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 305 | git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
306 | ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 306 | ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
307 | http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 307 | http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
308 | https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" | 308 | https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n" |
309 | 309 | ||
310 | These changes cause the build system to intercept Git, FTP, HTTP, and | 310 | These changes cause the build system to intercept Git, FTP, HTTP, and |
311 | HTTPS requests and direct them to the ``http://`` sources mirror. You | 311 | HTTPS requests and direct them to the ``http://`` sources mirror. You |
@@ -342,10 +342,10 @@ You could make the following changes to the ``local.conf`` configuration | |||
342 | file as long as the :term:`PREMIRRORS` server is current:: | 342 | file as long as the :term:`PREMIRRORS` server is current:: |
343 | 343 | ||
344 | PREMIRRORS:prepend = "\ | 344 | PREMIRRORS:prepend = "\ |
345 | git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 345 | git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
346 | ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 346 | ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
347 | http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 347 | http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
348 | https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" | 348 | https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n" |
349 | BB_FETCH_PREMIRRORONLY = "1" | 349 | BB_FETCH_PREMIRRORONLY = "1" |
350 | 350 | ||
351 | These changes would cause the build system to successfully fetch source | 351 | These changes would cause the build system to successfully fetch source |
diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst index 52561f07ce..85f65cae35 100644 --- a/documentation/ref-manual/variables.rst +++ b/documentation/ref-manual/variables.rst | |||
@@ -5855,10 +5855,10 @@ system and gives an overview of their function and contents. | |||
5855 | :term:`Build Directory`:: | 5855 | :term:`Build Directory`:: |
5856 | 5856 | ||
5857 | PREMIRRORS:prepend = "\ | 5857 | PREMIRRORS:prepend = "\ |
5858 | git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 5858 | git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
5859 | ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 5859 | ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
5860 | http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ | 5860 | http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \ |
5861 | https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" | 5861 | https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n" |
5862 | 5862 | ||
5863 | These changes cause the | 5863 | These changes cause the |
5864 | build system to intercept Git, FTP, HTTP, and HTTPS requests and | 5864 | build system to intercept Git, FTP, HTTP, and HTTPS requests and |