summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorJon Mason <jdmason@kudzu.us>2021-10-07 11:06:29 -0400
committerRichard Purdie <richard.purdie@linuxfoundation.org>2021-10-08 22:01:24 +0100
commit0638b77576c2454e325a6fded69fd93c3429eeab (patch)
treee5fc2b328adf5e7e7b47001f1d4f46e594e10c00 /documentation
parent58645b0586d56651d2fdcd154600f333ba63beaf (diff)
downloadpoky-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.rst28
-rw-r--r--documentation/ref-manual/faq.rst16
-rw-r--r--documentation/ref-manual/variables.rst8
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
105applets in Yocto. :: 105applets 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
110The quickest and easiest way to get some basic overall data about what's 110The quickest and easiest way to get some basic overall data about what's
111going on for a particular workload is to profile it using 'perf stat'. 111going 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
113the summed counts at the end of the run:: 113the 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
141the events related to kernel memory allocation/freeing along with cache 141the events related to kernel memory allocation/freeing along with cache
142hits and misses:: 142hits 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
181and records them in a file named 'perf.data' in the current working 181and records them in a file named 'perf.data' in the current working
182directory. :: 182directory. ::
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
219option, which will record not just the address of a sampled function, 219option, which will record not just the address of a sampled function,
220but the entire callchain to the sampled function as well:: 220but 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
527string before the colon in the Tracepoint events) and do a 'perf stat' 527string before the colon in the Tracepoint events) and do a 'perf stat'
528run using only those wildcarded subsystems:: 528run 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::
589Let's pick one of these tracepoints 589Let's pick one of these tracepoints
590and tell perf to do a profile using it as the sampling event:: 590and 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
653We can look at the raw trace output using 'perf script' with no 653We can look at the raw trace output using 'perf script' with no
654arguments:: 654arguments::
@@ -885,7 +885,7 @@ To demonstrate this, open up one window and start the profile using the
885 885
886In another window, run the wget test:: 886In 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
2252In another shell, execute a workload you want to trace. :: 2252In 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
2421In another shell, execute a workload you want to trace. :: 2421In 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
310These changes cause the build system to intercept Git, FTP, HTTP, and 310These changes cause the build system to intercept Git, FTP, HTTP, and
311HTTPS requests and direct them to the ``http://`` sources mirror. You 311HTTPS 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
342file as long as the :term:`PREMIRRORS` server is current:: 342file 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
351These changes would cause the build system to successfully fetch source 351These 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