kci-dev
pulls from our Dashboard API. As of now, it is an EXPERIMENTAL tooling under development with close collaboration from Linux kernel maintainers.
KNOWN ISSUE: The Dashboard endpoint we are using returns a file of a few megabytes in size, so download may take a few seconds, slowing down your usage of
kci-dev results
. We are working on it.
kci-dev results trees
Shows a numeric summary of the build, boot and test results.
Example:
kci-dev results summary --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --commit d1486dca38afd08ca279ae94eb3a397f10737824
List builds results.
Example:
kci-dev results builds --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --commit d1486dca38afd08ca279ae94eb3a397f10737824
List boot results.
Example:
kci-dev results boots --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --latest
List test results.
Example:
kci-dev results tests --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --commit d1486dca38afd08ca279ae94eb3a397f10737824
Set the KCIDB origin desired. ‘maestro’ is the default.
The url of the tree to fetch results
The branch to get results for
Path of the local git repository
The tip of tree commit being tested. It needs to be the full commit hash.
Unfortunately the Dashboard API doesn’t support git tags as parameters yet.
Return results for the latest commit for the tree.
Example:
kci-dev results builds --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --latest
Filter results by the status: “all”, “pass”, “fail” or “inconclusive”.
(available for subcommands build
, boots
and tests
)
Example:
kci-dev results builds --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --latest --status=fail
Automatically download logs for results listed.
(available for subcommands build
, boots
and tests
)
Example:
kci-dev results builds --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --commit d1486dca38afd08ca279ae94eb3a397f10737824 --download-logs
Pass a YAML filter file to customize results. Only supports hardware and test name filtering at the moment.
See filter yaml example below:
(available for subcommands boots
and tests
)
hardware:
- radxa,rock2-square
- fsl,imx6q
- dell-latitude-3445-7520c-skyrim
test:
- kselftest.dt
- kselftest.iommu
Example:
kci-dev results boots --giturl 'https://git.kernel.org/pub/scm/linux/kernel/git/next/linux-next.git' --branch master --latest --filter=filter.yaml
If used without arguments, kci-dev results
subcommands will get KernelCI status
of local checked out git repository for commands that require a giturl and branch.
In the following example, kci-dev is used on a local linux repository folder.
This command work with every linux repository supported by KernelCI
linux git:(master)$ kci-dev results summary
git folder: None
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
branch: master
commit: fbfd64d25c7af3b8695201ebc85efe90be28c5a3
pass/fail/inconclusive
builds: 46/0/0
boots: 580/48/8
tests: 7858/6903/654
Get results automatically from a folder with a local linux repository.
kci-dev git:(master)$ kci-dev results summary --git-folder ../linux
git folder: ../linux
tree: https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
branch: master
commit: fbfd64d25c7af3b8695201ebc85efe90be28c5a3
pass/fail/inconclusive
builds: 46/0/0
boots: 580/48/8
tests: 7858/6903/654
In the case of the script not been able to get the current branch information,
like in the case of a detached HEAD, it is possible to specify a branch.
Like in the following case:
linux-cip git:(6077b17f20b1) kci-dev results summary --branch linux-5.10.y-cip
git folder: None
tree: https://git.kernel.org/pub/scm/linux/kernel/git/cip/linux-cip.git
branch: linux-5.10.y-cip
commit: 6077b17f20b1bcfeccaa23bc05573b938c47679d
pass/fail/inconclusive
builds: 21/0/0
boots: 440/36/18
tests: 1190/184/100