From mboxrd@z Thu Jan 1 00:00:00 1970 X-GM-THRID: 7032209666543190016 X-Received: by 2002:a05:6000:15c8:: with SMTP id y8mr5659967wry.101.1637313905728; Fri, 19 Nov 2021 01:25:05 -0800 (PST) X-BeenThere: isar-users@googlegroups.com Received: by 2002:a05:600c:ad6:: with SMTP id c22ls6712663wmr.1.canary-gmail; Fri, 19 Nov 2021 01:25:04 -0800 (PST) X-Google-Smtp-Source: ABdhPJyg7gKxvOlW+clOVt/WMO55RDqyx+poyP7dCWwzOy+xgAlx9qWtsqQCe0Rd5Mh56iqy7cr5 X-Received: by 2002:a05:600c:a0b:: with SMTP id z11mr5055761wmp.147.1637313904595; Fri, 19 Nov 2021 01:25:04 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1637313904; cv=none; d=google.com; s=arc-20160816; b=cF6MmRyecXGrQm5It9BMNHrcljHs8kfquTYHuKPMdqUEL4T8UWL8DhP1V/z4dYkePL WXX/Y1xObvxg76HvTVmG7nYw5a72CEOh84WT0NAQfJi+mlNUUGKeEZaxMf3CqY8xdGxS sCApxY3u9OnTXeTqc+nQY1qjnA22JMXymLvHdzzlCfoULEo/wcfS5NYISQINzujHJZ2V NxD6NXZ0PNQmgeK3TS1dfHVZL2qbTlwKMFchGayOzgUHi/X1WYvolYu2jaYeN0n221q8 AYRIxhwPgcns80OEeMmfIXxRV08n5Wecu7gOyYTGKK8+g5hbViSQv8ED74FCK3WrrmtN pcrA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:to:from; bh=d6Fk36WNCDHrVAvzD2+iuiTEXxEQP3ucC0jkyXEM764=; b=FAsWUFP7PNCxO5N4ye2IWJ5dk6+QqFCvUh9fkATNcuXdAp3B1hLBRD31gT+VTW2eT4 1ju/835K+9iCtE6IrAK2sAlbbbdCZXVmHtM1/MhvKAWWxsro6ffWNji43fGldr5whp3V QL2BBWFasaAxCtVBGU7IS4bi3c1CLKikskRhWKTx5VXN5RsJxY5eE6lbnDPR/pGoq+iI +CvlAFPIP9Nrb6tF3j0BSDS7Xy5Y/740ObklHcye9YI790WBmxNI4/YsuaJGo9h6+Mlt tacjnUY46GEAgzgLIhHieJYSPS7/HLWxd/W7N5J5dLu5cVPQXS9JsuoIOHI7BCVJrOHC F2JA== ARC-Authentication-Results: i=1; gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Return-Path: Received: from shymkent.ilbers.de (shymkent.ilbers.de. [85.214.156.166]) by gmr-mx.google.com with ESMTPS id p11si773446wms.3.2021.11.19.01.25.04 for (version=TLS1_2 cipher=ECDHE-ECDSA-CHACHA20-POLY1305 bits=256/256); Fri, 19 Nov 2021 01:25:04 -0800 (PST) Received-SPF: pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) client-ip=85.214.156.166; Authentication-Results: gmr-mx.google.com; spf=pass (google.com: domain of ubely@ilbers.de designates 85.214.156.166 as permitted sender) smtp.mailfrom=ubely@ilbers.de Received: from baighyz.m.ilbers.de (host-80-81-17-52.static.customer.m-online.net [80.81.17.52]) (authenticated bits=0) by shymkent.ilbers.de (8.15.2/8.15.2/Debian-8) with ESMTPSA id 1AJ9OxJa020762 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT) for ; Fri, 19 Nov 2021 10:25:04 +0100 From: Uladzimir Bely To: isar-users@googlegroups.com Subject: [PATCH v3 5/5] doc: Add buildstats section in user manual Date: Fri, 19 Nov 2021 10:24:59 +0100 Message-Id: <20211119092459.27376-6-ubely@ilbers.de> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20211119092459.27376-1-ubely@ilbers.de> References: <20211119092459.27376-1-ubely@ilbers.de> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED autolearn=unavailable autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on shymkent.ilbers.de X-TUID: /giLxksZ5xKA Signed-off-by: Uladzimir Bely --- doc/user_manual.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/doc/user_manual.md b/doc/user_manual.md index 535d456a..5d3b6c9f 100644 --- a/doc/user_manual.md +++ b/doc/user_manual.md @@ -17,6 +17,7 @@ Copyright (C) 2016-2019, ilbers GmbH - [Add a New Image](#add-a-new-image) - [Add a New Image Type](#add-a-new-image-type) - [Add a Custom Application](#add-a-custom-application) + - [Build statistics collection](#build-statistics-collection) - [Enabling Cross-compilation](#isar-cross-compilation) - [Using ccache for custom packages](#using-ccache-for-custom-packages) - [Create an ISAR SDK root filesystem](#create-an-isar-sdk-root-filesystem) @@ -859,6 +860,27 @@ Such single debs can be included if need be. You just need to write a recipe that just fetches those debs to its `WORKDIR` and deploys them. They can then be installed via `IMAGE_INSTALL`. Have a look at `prebuilt-deb`. +--- + +## Build statistics collection + +While isar is building the system, build statistics is collected in +`tmp/buildstats/` directory. This functionality is implemented in +`buildstats` class, and is enabled by `USE_BUILDSTATS= "1"` in `local.conf`. + +The collected statistics can be represented visually by using +`pybootchartgui.py` script (borrowed from OpenEmbedded): +``` +../scripts/pybootchartgui/pybootchartgui.py tmp/buildstats/20210911054429/ -f pdf -o ~/buildstats.pdf +``` + +NOTE: `python3-cairo` package is required for `pybootchartgui.py` to work: +``` +sudo apt-get install python3-cairo +``` + +--- + ## Isar Cross-compilation ### Motivation -- 2.20.1