summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBenjamin Schubert <ben.c.schubert@gmail.com>2019-03-22 11:33:20 +0000
committerbst-marge-bot <marge-bot@buildstream.build>2019-03-29 11:19:49 +0000
commite378b57d5193d62164a0c6869289fe4c913d696c (patch)
tree121957d054ce3c876f1636d343a9f9e7da5d0039
parentd5d5ffd90fd3ae8cfd6efe4de31cb9fec3cbf696 (diff)
downloadbuildstream-bschubert/profiler-as-cm.tar.gz
Update documentation with the new profile changesbschubert/profiler-as-cm
-rw-r--r--CONTRIBUTING.rst24
1 files changed, 4 insertions, 20 deletions
diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst
index 8a1b7996a..c0dffe8c9 100644
--- a/CONTRIBUTING.rst
+++ b/CONTRIBUTING.rst
@@ -1742,32 +1742,16 @@ Profiling specific parts of BuildStream with BST_PROFILE
BuildStream can also turn on cProfile for specific parts of execution
using BST_PROFILE.
-BST_PROFILE can be set to a section name, or 'all' for all
-sections. There is a list of topics in `buildstream/_profile.py`. For
-example, running::
+BST_PROFILE can be set to a section name, or a list of section names separated
+by ":". You can also use "all" for getting all profiles at the same time.
+There is a list of topics in `buildstream/_profile.py`. For example, running::
BST_PROFILE=load-pipeline bst build bootstrap-system-x86.bst
will produce a profile in the current directory for the time take to
call most of `initialized`, for each element. These profile files
are in the same cProfile format as those mentioned in the previous
-section, and can be analysed with `pstats` or `pyflame`.
-
-
-Profiling the artifact cache receiver
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Since the artifact cache receiver is not normally run directly, it's
-necessary to alter the ForceCommand part of sshd_config to enable
-profiling. See the main documentation in `doc/source/artifacts.rst`
-for general information on setting up the artifact cache. It's also
-useful to change directory to a logging directory before starting
-`bst-artifact-receive` with profiling on.
-
-This is an example of a ForceCommand section of sshd_config used to
-obtain profiles::
-
- Match user artifacts
- ForceCommand BST_PROFILE=artifact-receive cd /tmp && bst-artifact-receive --pull-url https://example.com/ /home/artifacts/artifacts
+section, and can be analysed in the same way.
Managing data files