From 706d5aacd7ab7b37c00df1a1b210e4ced06119e1 Mon Sep 17 00:00:00 2001 From: Andrew Geissler Date: Fri, 12 Feb 2021 15:55:30 -0600 Subject: Reset poky to before our libpam hacks Things got a bit out of synch with openbmc-config due to the libpam issues and the migration from the meta-* layers. Revert the two previous commits and then put the latest poky in with the libpam revert and get openbmc-config right again. Revert "Revert "libpam: update 1.3.1 -> 1.5.1"" This reverts commit 87ddd3eab4df68e624b5350ccaab28b3b97547c0. Revert "poky: subtree update:796be0593a..10c69538c0" This reverts commit c723b72979bfac6362509cf1fe086900f6641f28. Change-Id: I3a1f405193aee6a21fe0cd24be9927c143a23d9a Signed-off-by: Andrew Geissler --- poky/documentation/profile-manual/usage.rst | 49 +++++++++++++++-------------- 1 file changed, 25 insertions(+), 24 deletions(-) (limited to 'poky/documentation/profile-manual/usage.rst') diff --git a/poky/documentation/profile-manual/usage.rst b/poky/documentation/profile-manual/usage.rst index b401cf904..418f4e993 100644 --- a/poky/documentation/profile-manual/usage.rst +++ b/poky/documentation/profile-manual/usage.rst @@ -39,7 +39,7 @@ other tools when it seems useful to do so. The coverage below details some of the most common ways you'll likely want to apply the tool; full documentation can be found either within the tool itself or in the man pages at -`perf(1) `__. +`perf(1) `__. Perf Setup ---------- @@ -860,7 +860,7 @@ the right kind of trace data, higher-level profiling-type summaries can be derived from it. Documentation on using the `'perf script' python -binding `__. +binding `__. System-Wide Tracing and Profiling ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1136,31 +1136,32 @@ Perf Documentation Online versions of the man pages for the commands discussed in this section can be found here: -- The `'perf stat' manpage `__. +- The `'perf stat' manpage `__. - The `'perf record' - manpage `__. + manpage `__. - The `'perf report' - manpage `__. + manpage `__. -- The `'perf probe' manpage `__. +- The `'perf probe' manpage `__. - The `'perf script' - manpage `__. + manpage `__. - Documentation on using the `'perf script' python - binding `__. + binding `__. -- The top-level `perf(1) manpage `__. +- The top-level `perf(1) manpage `__. Normally, you should be able to invoke the man pages via perf itself e.g. 'perf help' or 'perf help record'. However, by default Yocto doesn't install man pages, but perf invokes the man pages for most help functionality. This is a bug and is being -addressed by a Yocto bug: :yocto_bugs:`Bug 3388 - perf: enable man pages for -basic 'help' functionality `. +addressed by a Yocto bug: `Bug 3388 - perf: enable man pages for basic +'help' +functionality `__. The man pages in text form, along with some other files, such as a set of examples, can be found in the 'perf' directory of the kernel tree: :: @@ -1718,7 +1719,7 @@ events': The tool is pretty self-explanatory, but for more detailed information on navigating through the data, see the `kernelshark -website `__. +website `__. ftrace Documentation -------------------- @@ -1736,19 +1737,19 @@ Documentation directory: :: There is a nice series of articles on using ftrace and trace-cmd at LWN: - `Debugging the kernel using Ftrace - part - 1 `__ + 1 `__ - `Debugging the kernel using Ftrace - part - 2 `__ + 2 `__ - `Secrets of the Ftrace function - tracer `__ + tracer `__ - `trace-cmd: A front-end for Ftrace `__ There's more detailed documentation kernelshark usage here: -`KernelShark `__ +`KernelShark `__ An amusing yet useful README (a tracing mini-HOWTO) can be found in ``/sys/kernel/debug/tracing/README``. @@ -1763,7 +1764,7 @@ gather/print/aggregate data extracted from the context they end up being invoked under. For example, this probe from the `SystemTap -tutorial `__ simply prints a +tutorial `__ simply prints a line every time any process on the system open()s a file. For each line, it prints the executable name of the program that opened the file, along with its PID, and the name of the file it opened (or tried to open), @@ -1936,11 +1937,11 @@ systemtap Documentation ----------------------- The SystemTap language reference can be found here: `SystemTap Language -Reference `__ +Reference `__ Links to other SystemTap documents, tutorials, and examples can be found here: `SystemTap documentation -page `__ +page `__ Sysprof ======= @@ -2214,7 +2215,7 @@ developers who are working in a Linux environment and are interested in efficient software tracing. For information on LTTng in general, visit the `LTTng -Project `__ site. You can find a "Getting +Project `__ site. You can find a "Getting Started" link on this site that takes you to an LTTng Quick Start. blktrace @@ -2365,7 +2366,7 @@ first part of the filenames: :: The report shows each event that was found in the blktrace data, along with a summary of the overall block I/O traffic during the run. You can look at the -`blkparse `__ manpage to learn the +`blkparse `__ manpage to learn the meaning of each field displayed in the trace listing. Live Mode @@ -2564,11 +2565,11 @@ blktrace Documentation Online versions of the man pages for the commands discussed in this section can be found here: -- https://linux.die.net/man/8/blktrace +- http://linux.die.net/man/8/blktrace -- https://linux.die.net/man/1/blkparse +- http://linux.die.net/man/1/blkparse -- https://linux.die.net/man/8/btrace +- http://linux.die.net/man/8/btrace The above manpages, along with manpages for the other blktrace utilities (btt, blkiomon, etc) can be found in the /doc directory of the blktrace -- cgit v1.2.3