diff options
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 |
