Specify where the database is created and under what name. Add text value lookup examples, including quoting, escaping and regular expression cases. Trivial fixes.
Signed-off-by: Massimo Pegorer <[email protected]> --- doc/develop/qconfig.rst | 24 +++++++++++++++++++----- 1 file changed, 19 insertions(+), 5 deletions(-) diff --git a/doc/develop/qconfig.rst b/doc/develop/qconfig.rst index a18f32470ca..e3b6d3cecc6 100644 --- a/doc/develop/qconfig.rst +++ b/doc/develop/qconfig.rst @@ -26,9 +26,10 @@ How does it work? When building a database (`-b`), this tool runs configuration and builds include/autoconf.mk for every defconfig. The config options defined in Kconfig -appear in the .config file (unless they are hidden because of unmet dependency.) +appear in the .config file (unless they are hidden because of unmet dependency). On the other hand, the config options defined by board headers are seen -in include/autoconf.mk. +in include/autoconf.mk. The tool must be run at the top of source directory +where it stores the database file named qconfig.db. When resyncing defconfigs (`-s`) the .config is synced by "make savedefconfig" and the defconfig is updated with it. @@ -81,7 +82,7 @@ Each term is CONFIG name, with or without a tilde (~) prefix. The tool searches for boards which match the CONFIG name, or do not match if tilde is used. For example, to find boards which enabled CONFIG_SCSI but not CONFIG_BLK:: - tools/qconfig.py -f SCSI ~BLK + ./tools/qconfig.py -f SCSI ~BLK 3 matches pg_wcom_seli8_defconfig highbank_defconfig pg_wcom_expu1_defconfig @@ -95,10 +96,23 @@ boards with an empty string for `CONFIG_DEFAULT_FDT_FILE`:: This finds boards which have a value for SYS_MAXARGS other than 64:: ./tools/qconfig.py -f ~SYS_MAXARGS=64 - cfg CONFIG_SYS_MAXARGS 281 matches ... +Text values can be looked for too, including regular expressions, but taking +care of needed quoting and escaping. E.g.:: + + ./tools/qconfig.py -f TPL_LDSCRIPT='"arch/arm/cpu/u-boot-spl.lds"' + 0 matches + + ./tools/qconfig.py -f TPL_LDSCRIPT='"arch/.*/cpu/u-boot-spl.lds"' + 22 matches + ... + + ./tools/qconfig.py -f TPL_LDSCRIPT='"arch/\$\(ARCH\)/cpu/u-boot-spl.lds"' + 22 matches + ... + Finding implied CONFIGs ----------------------- @@ -245,4 +259,4 @@ Available options To see the complete list of supported options, run:: - tools/qconfig.py -h + ./tools/qconfig.py -h --- base-commit: bd2f5794b7e24c62042abb1921f9c2039b920e02 change-id: 20261003-qconfigdoc-fe844c4f241f Best regards, -- Massimo Pegorer <[email protected]>
