mirrors/poky
1
0
Fork 0
mirror of https://git.yoctoproject.org/poky synced 2026-09-24 22:36:21 +02:00
Code Issues Packages Projects Releases Wiki Activity

documentation: use YOCTO_DL_URL

Browse Source 
(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>
This commit is contained in:
Jon Mason
2021-10-07 11:06:29 -04:00
committed by Richard Purdie
parent 58645b0586
commit 0638b77576
3 changed files with 26 additions and 26 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
documentation/profile-manual/usage.rst
View File

@@ -105,18 +105,18 @@ can be used in a very similar way to the whole host of supported BusyBox
applets in Yocto. :: applets in Yocto. ::
root@crownbay:~# rm linux-2.6.19.2.tar.bz2; \ root@crownbay:~# rm linux-2.6.19.2.tar.bz2; \
wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
The quickest and easiest way to get some basic overall data about what's The quickest and easiest way to get some basic overall data about what's
going on for a particular workload is to profile it using 'perf stat'. going on for a particular workload is to profile it using 'perf stat'.
'perf stat' basically profiles using a few default counters and displays 'perf stat' basically profiles using a few default counters and displays
the summed counts at the end of the run:: the summed counts at the end of the run::
root@crownbay:~# perf stat wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 root@crownbay:~# perf stat wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA
Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2':
4597.223902 task-clock # 0.077 CPUs utilized 4597.223902 task-clock # 0.077 CPUs utilized
23568 context-switches # 0.005 M/sec 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
the events related to kernel memory allocation/freeing along with cache the events related to kernel memory allocation/freeing along with cache
hits and misses:: hits and misses::
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 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
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% |***************************************************| 41727k 0:00:00 ETA
Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2':
5566 kmem:kmalloc 5566 kmem:kmalloc
125517 kmem:kmem_cache_alloc 125517 kmem:kmem_cache_alloc
@@ -181,7 +181,7 @@ executed in a new shell). perf collects samples until the process exits
and records them in a file named 'perf.data' in the current working and records them in a file named 'perf.data' in the current working
directory. :: directory. ::
root@crownbay:~# perf record wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 root@crownbay:~# perf record wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA 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
option, which will record not just the address of a sampled function, option, which will record not just the address of a sampled function,
but the entire callchain to the sampled function as well:: but the entire callchain to the sampled function as well::
root@crownbay:~# perf record -g wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 root@crownbay:~# perf record -g wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% |************************************************| 41727k 0:00:00 ETA
[ perf record: Woken up 3 times to write data ] [ 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
string before the colon in the Tracepoint events) and do a 'perf stat' string before the colon in the Tracepoint events) and do a 'perf stat'
run using only those wildcarded subsystems:: run using only those wildcarded subsystems::
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 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
Performance counter stats for 'wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2': Performance counter stats for 'wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2':
23323 skb:kfree_skb 23323 skb:kfree_skb
0 skb:consume_skb 0 skb:consume_skb
@@ -589,7 +589,7 @@ run using only those wildcarded subsystems::
Let's pick one of these tracepoints Let's pick one of these tracepoints
and tell perf to do a profile using it as the sampling event:: and tell perf to do a profile using it as the sampling event::
root@crownbay:~# perf record -g -e sched:sched_wakeup wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 root@crownbay:~# perf record -g -e sched:sched_wakeup wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
.. image:: figures/sched-wakeup-profile.png .. image:: figures/sched-wakeup-profile.png
:align: center :align: center
@@ -648,7 +648,7 @@ applicable to our workload::
root@crownbay:~# perf record -g -e skb:* -e net:* -e napi:* -e sched:sched_switch -e sched:sched_wakeup -e irq:* root@crownbay:~# perf record -g -e skb:* -e net:* -e napi:* -e sched:sched_switch -e sched:sched_wakeup -e irq:*
-e syscalls:sys_enter_read -e syscalls:sys_exit_read -e syscalls:sys_enter_write -e syscalls:sys_exit_write -e syscalls:sys_enter_read -e syscalls:sys_exit_read -e syscalls:sys_enter_write -e syscalls:sys_exit_write
wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
We can look at the raw trace output using 'perf script' with no We can look at the raw trace output using 'perf script' with no
arguments:: arguments::
@@ -885,7 +885,7 @@ To demonstrate this, open up one window and start the profile using the
In another window, run the wget test:: In another window, run the wget test::
root@crownbay:~# wget https://downloads.yoctoproject.org/mirror/sources/linux-2.6.19.2.tar.bz2 root@crownbay:~# wget &YOCTO_DL_URL;/mirror/sources/linux-2.6.19.2.tar.bz2
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA
@@ -2251,7 +2251,7 @@ of the block device you want to trace activity on::
In another shell, execute a workload you want to trace. :: In another shell, execute a workload you want to trace. ::
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 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
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA
@@ -2420,7 +2420,7 @@ On the target system, you should see this::
In another shell, execute a workload you want to trace. :: In another shell, execute a workload you want to trace. ::
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 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
Connecting to downloads.yoctoproject.org (140.211.169.59:80) Connecting to downloads.yoctoproject.org (140.211.169.59:80)
linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA linux-2.6.19.2.tar.b 100% \|*******************************\| 41727k 0:00:00 ETA

16
documentation/ref-manual/faq.rst
View File

@@ -302,10 +302,10 @@ attempt before any others by adding something like the following to the
``local.conf`` configuration file:: ``local.conf`` configuration file::
PREMIRRORS:prepend = "\ PREMIRRORS:prepend = "\
git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n"
These changes cause the build system to intercept Git, FTP, HTTP, and These changes cause the build system to intercept Git, FTP, HTTP, and
HTTPS requests and direct them to the ``http://`` sources mirror. You 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
file as long as the :term:`PREMIRRORS` server is current:: file as long as the :term:`PREMIRRORS` server is current::
PREMIRRORS:prepend = "\ PREMIRRORS:prepend = "\
git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n"
BB_FETCH_PREMIRRORONLY = "1" BB_FETCH_PREMIRRORONLY = "1"
These changes would cause the build system to successfully fetch source These changes would cause the build system to successfully fetch source

8
documentation/ref-manual/variables.rst
View File

@@ -5855,10 +5855,10 @@ system and gives an overview of their function and contents.
:term:`Build Directory`:: :term:`Build Directory`::
PREMIRRORS:prepend = "\ PREMIRRORS:prepend = "\
git://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ git://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
ftp://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ ftp://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
http://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n \ http://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n \
https://.*/.* https://downloads.yoctoproject.org/mirror/sources/ \n" https://.*/.* &YOCTO_DL_URL;/mirror/sources/ \n"
These changes cause the These changes cause the
build system to intercept Git, FTP, HTTP, and HTTPS requests and build system to intercept Git, FTP, HTTP, and HTTPS requests and