Changes in .gitignore

41d7ea30 - lib: packing: add pack_fields() and unpack_fields()

Tue, 10 Dec 2024 20:27:12 +0000

lib: packing: add pack_fields() and unpack_fields()This is new API which caters to the following requirements:- Pack or unpack a large number of fields to/from a buffer with a small code footprint. The current alternative is to open-code a large number of calls to pack() and unpack(), or to use packing() to reduce that number to half. But packing() is not const-correct.- Use unpacked numbers stored in variables smaller than u64. This reduces the rodata footprint of the stored field arrays.- Perform error checking at compile time, rather than runtime, and return void from the API functions. Because the C preprocessor can't generate variable length code (loops), this is a bit tricky to do with macros. To handle this, implement macros which sanity check the packed field definitions based on their size. Finally, a single macro with a chain of __builtin_choose_expr() is used to select the appropriate macros. We enforce the use of ascending or descending order to avoid O(N^2) scaling when checking for overlap. Note that the macros are written with care to ensure that the compilers can correctly evaluate the resulting code at compile time. In particular, care was taken with avoiding too many nested statement expressions. Nested statement expressions trip up some compilers, especially when passing down variables created in previous statement expressions. There are two key design choices intended to keep the overall macro code size small. First, the definition of each CHECK_PACKED_FIELDS_N macro is implemented recursively, by calling the N-1 macro. This avoids needing the code to repeat multiple times. Second, the CHECK_PACKED_FIELD macro enforces that the fields in the array are sorted in order. This allows checking for overlap only with neighboring fields, rather than the general overlap case where each field would need to be checked against other fields. The overlap checks use the first two fields to determine the order of the remaining fields, thus allowing either ascending or descending order. This enables drivers the flexibility to keep the fields ordered in which ever order most naturally fits their hardware design and its associated documentation. The CHECK_PACKED_FIELDS macro is directly called from within pack_fields and unpack_fields, ensuring that all drivers using the API receive the benefits of the compile-time checks. Users do not need to directly call any of the macros directly. The CHECK_PACKED_FIELDS and its helper macros CHECK_PACKED_FIELDS_(0..50) are generated using a simple C program in scripts/gen_packed_field_checks.c This program can be compiled on demand and executed to generate the macro code in include/linux/packing.h. This will aid in the event that a driver needs more than 50 fields. The generator can be updated with a new size, and used to update the packing.h header file. In practice, the ice driver will need to support 27 fields, and the sja1105 driver will need to support 0 fields. This on-demand generation avoids the need to modify Kbuild. We do not anticipate the maximum number of fields to grow very often.- Reduced rodata footprint for the storage of the packed field arrays. To that end, we have struct packed_field_u8 and packed_field_u16, which define the fields with the associated type. More can be added as needed (unlikely for now). On these types, the same generic pack_fields() and unpack_fields() API can be used, thanks to the new C11 _Generic() selection feature, which can call pack_fields_u8() or pack_fields_16(), depending on the type of the "fields" array - a simplistic form of polymorphism. It is evaluated at compile time which function will actually be called.Over time, packing() is expected to be completely replaced either withpack() or with pack_fields().Signed-off-by: Vladimir Oltean Co-developed-by: Jacob Keller Signed-off-by: Jacob Keller Reviewed-by: Vladimir Oltean Link: https://patch.msgid.link/20241210-packing-pack-fields-and-ice-implementation-v10-3-ee56a47479ac@intel.comSigned-off-by: Jakub Kicinski List of files: /linux-6.15/scripts/.gitignore

a66d733d - rust: support running Rust documentation tests as KUnit ones

Tue, 18 Jul 2023 05:27:51 +0000

rust: support running Rust documentation tests as KUnit onesRust has documentation tests: these are typically examples ofusage of any item (e.g. function, struct, module...).They are very convenient because they are just writtenalongside the documentation. For instance: /// Sums two numbers. /// /// ``` /// assert_eq!(mymod::f(10, 20), 30); /// ``` pub fn f(a: i32, b: i32) -> i32 { a + b }In userspace, the tests are collected and run via `rustdoc`.Using the tool as-is would be useful already, since it allowsto compile-test most tests (thus enforcing they are keptin sync with the code they document) and run those that do notdepend on in-kernel APIs.However, by transforming the tests into a KUnit test suite,they can also be run inside the kernel. Moreover, the testsget to be compiled as other Rust kernel objects instead oftargeting userspace.On top of that, the integration with KUnit means the Rustsupport gets to reuse the existing testing facilities. Forinstance, the kernel log would look like: KTAP version 1 1..1 KTAP version 1 # Subtest: rust_doctests_kernel 1..59 # rust_doctest_kernel_build_assert_rs_0.location: rust/kernel/build_assert.rs:13 ok 1 rust_doctest_kernel_build_assert_rs_0 # rust_doctest_kernel_build_assert_rs_1.location: rust/kernel/build_assert.rs:56 ok 2 rust_doctest_kernel_build_assert_rs_1 # rust_doctest_kernel_init_rs_0.location: rust/kernel/init.rs:122 ok 3 rust_doctest_kernel_init_rs_0 ... # rust_doctest_kernel_types_rs_2.location: rust/kernel/types.rs:150 ok 59 rust_doctest_kernel_types_rs_2 # rust_doctests_kernel: pass:59 fail:0 skip:0 total:59 # Totals: pass:59 fail:0 skip:0 total:59 ok 1 rust_doctests_kernelTherefore, add support for running Rust documentation testsin KUnit. Some other notes about the current implementationand support follow.The transformation is performed by a couple scripts writtenas Rust hostprogs.Tests using the `?` operator are also supported as usual, e.g.: /// ``` /// # use kernel::{spawn_work_item, workqueue}; /// spawn_work_item!(workqueue::system(), || pr_info!("x"))?; /// # Ok::<(), Error>(()) /// ```The tests are also compiled with Clippy under `CLIPPY=1`, justlike normal code, thus also benefitting from extra linting.The names of the tests are currently automatically generated.This allows to reduce the burden for documentation writers,while keeping them fairly stable for bisection. This is animprovement over the `rustdoc`-generated names, which includethe line number; but ideally we would like to get `rustdoc` toprovide the Rust item path and a number (for multiple examplesin a single documented Rust item).In order for developers to easily see from which original linea failed doctests came from, a KTAP diagnostic line is printedto the log, containing the location (file and line) of theoriginal test (i.e. instead of the location in the generatedRust file): # rust_doctest_kernel_types_rs_2.location: rust/kernel/types.rs:150This line follows the syntax for declaring test metadata in theproposed KTAP v2 spec [1], which may be used for the proposedKUnit test attributes API [2]. Thus hopefully this will makemigration easier later on (suggested by David [3]).The original line in that test attribute is figured out byproviding an anchor (suggested by Boqun [4]). The original fileis found by walking the filesystem, checking directory prefixesto reduce the amount of combinations to check, and it is onlydone once per file. Ambiguities are detected and reported.A notable difference from KUnit C tests is that the Rust testsappear to assert using the usual `assert!` and `assert_eq!`macros from the Rust standard library (`core`). We providea custom version that forwards the call to KUnit instead.Importantly, these macros do not require passing context,unlike the KUnit C ones (i.e. `struct kunit *`). This makesthem easier to use, and readers of the documentation do not needto care about which testing framework is used. In addition, itmay allow us to test third-party code more easily in the future.However, a current limitation is that KUnit does not supportassertions in other tasks. Thus we presently simply print anerror to the kernel log if an assertion actually failed. Thisshould be revisited to properly fail the test, perhaps savingthe context somewhere else, or letting KUnit handle it.Link: https://lore.kernel.org/lkml/20230420205734.1288498-1-rmoar@google.com/ [1]Link: https://lore.kernel.org/linux-kselftest/20230707210947.1208717-1-rmoar@google.com/ [2]Link: https://lore.kernel.org/rust-for-linux/CABVgOSkOLO-8v6kdAGpmYnZUb+LKOX0CtYCo-Bge7r_2YTuXDQ@mail.gmail.com/ [3]Link: https://lore.kernel.org/rust-for-linux/ZIps86MbJF%2FiGIzd@boqun-archlinux/ [4]Signed-off-by: Miguel Ojeda Reviewed-by: David Gow Signed-off-by: Shuah Khan List of files: /linux-6.15/scripts/.gitignore

05e96e96 - kbuild: use git-archive for source package creation

Wed, 15 Mar 2023 15:50:18 +0000

kbuild: use git-archive for source package creationCommit 5c3d1d0abb12 ("kbuild: add a tool to list files ignored by git")added a new tool, scripts/list-gitignored. My intention was to createsource packages without cleaning the source tree, without relying on git.Linus strongly objected to it, and suggested using 'git archive' instead.[1] [2] [3]This commit goes in that direction - Remove scripts/list-gitignored.cand rewrites Makefiles and scripts to use 'git archive' for buildingDebian and RPM source packages. It also makes 'make perf-tar*-src-pkg'use 'git archive' again.Going forward, building source packages is only possible in a git-managedtree. Building binary packages does not require git.[1]: https://lore.kernel.org/lkml/CAHk-=wi49sMaC7vY1yMagk7eqLK=1jHeHQ=yZ_k45P=xBccnmA@mail.gmail.com/[2]: https://lore.kernel.org/lkml/CAHk-=wh5AixGsLeT0qH2oZHKq0FLUTbyTw4qY921L=PwYgoGVw@mail.gmail.com/[3]: https://lore.kernel.org/lkml/CAHk-=wgM-W6Fu==EoAVCabxyX8eYBz9kNC88-tm9ExRQwA79UQ@mail.gmail.com/Fixes: 5c3d1d0abb12 ("kbuild: add a tool to list files ignored by git")Fixes: e0ca16749ac3 ("kbuild: make perf-tar*-src-pkg work without relying on git")Suggested-by: Linus Torvalds Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

5c3d1d0a - kbuild: add a tool to list files ignored by git

Wed, 15 Feb 2023 01:20:23 +0000

kbuild: add a tool to list files ignored by gitIn short, the motivation of this commit is to build a source packagewithout cleaning the source tree.The deb-pkg and (src)rpm-pkg targets first run 'make clean' beforecreating a source tarball. Otherwise build artifacts such as *.o,*.a, etc. would be included in the tarball. Yet, the tarball ends upcontaining several garbage files since 'make clean' does not cleaneverything.Cleaning the tree every time is annoying since it makes the incrementalbuild impossible. It is desirable to create a source tarball withoutcleaning the tree.In fact, there are some ways to achieve this.The easiest solution is 'git archive'. 'make perf-tar*-src-pkg' usesit, but I do not like it because it works only when the source tree ismanaged by git, and all files you want in the tarball must be committedin advance.I want to make it work without relying on git. We can do this.Files that are ignored by git are generated files, so should be excludedfrom the source tarball. We can list them out by parsing the .gitignorefiles. Of course, .gitignore does not cover all the cases, but it workswell enough.tar(1) claims to support it: --exclude-vcs-ignores Exclude files that match patterns read from VCS-specific ignore files. Supported files are: .cvsignore, .gitignore, .bzrignore, and .hgignore.The best scenario would be to use 'tar --exclude-vcs-ignores', but thisoption does not work. --exclude-vcs-ignore does not understand any ofthe negation (!), preceding slash, following slash, etc.. So, this optionis just useless.Hence, I wrote this gitignore parser. The previous version [1], writtenin Python, was so slow. This version is implemented in C, so it worksmuch faster.I imported the code from git (commit: 23c56f7bd5f1), so we get the sameresult.This tool traverses the source tree, parsing all .gitignore files, andprints file paths that are ignored by git.The output is similar to 'git ls-files --ignored --directory --others--exclude-per-directory=.gitignore', except [1] Not sorted [2] No trailing slash for directories[2] is intentional because tar's --exclude-from option cannot handletrailing slashes.[How to test this tool] $ git clean -dfx $ make -s -j$(nproc) defconfig all # or allmodconifg or whatever $ git archive -o ../linux1.tar --prefix=./ HEAD $ tar tf ../linux1.tar | LANG=C sort > ../file-list1 # files emitted by 'git archive' $ make scripts_package HOSTCC scripts/list-gitignored $ scripts/list-gitignored --prefix=./ -o ../exclude-list $ tar cf ../linux2.tar --exclude-from=../exclude-list . $ tar tf ../linux2.tar | LANG=C sort > ../file-list2 # files emitted by 'tar' $ diff ../file-list1 ../file-list2 | grep -E '^(<|>)' < ./Documentation/devicetree/bindings/.yamllint < ./drivers/clk/.kunitconfig < ./drivers/gpu/drm/tests/.kunitconfig < ./drivers/hid/.kunitconfig < ./fs/ext4/.kunitconfig < ./fs/fat/.kunitconfig < ./kernel/kcsan/.kunitconfig < ./lib/kunit/.kunitconfig < ./mm/kfence/.kunitconfig < ./tools/testing/selftests/arm64/tags/ < ./tools/testing/selftests/arm64/tags/.gitignore < ./tools/testing/selftests/arm64/tags/Makefile < ./tools/testing/selftests/arm64/tags/run_tags_test.sh < ./tools/testing/selftests/arm64/tags/tags_test.c < ./tools/testing/selftests/kvm/.gitignore < ./tools/testing/selftests/kvm/Makefile < ./tools/testing/selftests/kvm/config < ./tools/testing/selftests/kvm/settingsThe source tarball contains most of files that are tracked by git. Yousee some diffs, but it is just because some .gitignore files are wrong. $ git ls-files -i -c --exclude-per-directory=.gitignore Documentation/devicetree/bindings/.yamllint drivers/clk/.kunitconfig drivers/gpu/drm/tests/.kunitconfig drivers/hid/.kunitconfig fs/ext4/.kunitconfig fs/fat/.kunitconfig kernel/kcsan/.kunitconfig lib/kunit/.kunitconfig mm/kfence/.kunitconfig tools/testing/selftests/arm64/tags/.gitignore tools/testing/selftests/arm64/tags/Makefile tools/testing/selftests/arm64/tags/run_tags_test.sh tools/testing/selftests/arm64/tags/tags_test.c tools/testing/selftests/kvm/.gitignore tools/testing/selftests/kvm/Makefile tools/testing/selftests/kvm/config tools/testing/selftests/kvm/settings[1]: https://lore.kernel.org/all/20230128173843.765212-1-masahiroy@kernel.org/Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

ec61452a - scripts: remove bin2c

Thu, 19 Jan 2023 07:12:15 +0000

scripts: remove bin2cCommit 80f8be7af03f ("tomoyo: Omit use of bin2c") removed the lastuse of bin2c.Signed-off-by: Masahiro Yamada Reviewed-by: Nicolas Schier Reviewed-by: Sedat Dilek List of files: /linux-6.15/scripts/.gitignore

c83b16ce - kbuild: rust: move rust/target.json to scripts/

Sat, 07 Jan 2023 09:45:45 +0000

kbuild: rust: move rust/target.json to scripts/scripts/ is a better place to generate files used treewide.With target.json moved to scripts/, you do not need to add target.jsonto no-clean-files or MRPROPER_FILES.'make clean' does not visit scripts/, but 'make mrproper' does.Signed-off-by: Masahiro Yamada Reviewed-by: Miguel Ojeda Tested-by: Miguel Ojeda List of files: /linux-6.15/scripts/.gitignore

9a8ff24c - scripts: add `generate_rust_target.rs`

Thu, 04 Aug 2022 10:20:37 +0000

scripts: add `generate_rust_target.rs`This script takes care of generating the custom target specificationfile for `rustc`, based on the kernel configuration.It also serves as an example of a Rust host program.A dummy architecture is kept in this patch so that a later patchadds x86 support on top with as few changes as possible.Reviewed-by: Kees Cook Co-developed-by: Alex Gaynor Signed-off-by: Alex Gaynor Co-developed-by: Wedson Almeida Filho Signed-off-by: Wedson Almeida Filho Co-developed-by: David Gow Signed-off-by: David Gow Signed-off-by: Miguel Ojeda List of files: /linux-6.15/scripts/.gitignore

340a0253 - certs: move scripts/extract-cert to certs/

Tue, 14 Dec 2021 02:53:54 +0000

certs: move scripts/extract-cert to certs/extract-cert is only used in certs/Makefile.Move it there and build extract-cert on demand.Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

9009b455 - .gitignore: prefix local generated files with a slash

Fri, 30 Apr 2021 02:03:08 +0000

.gitignore: prefix local generated files with a slashThe pattern prefixed with '/' matches files in the same directory,but not ones in sub-directories.Signed-off-by: Masahiro Yamada Acked-by: Miguel Ojeda Acked-by: Rob Herring Acked-by: Andra Paraschiv Acked-by: Greg Kroah-Hartman Acked-by: Gabriel Krisman Bertazi List of files: /linux-6.15/scripts/.gitignore

596b0474 - kbuild: preprocess module linker script

Tue, 08 Sep 2020 04:27:08 +0000

kbuild: preprocess module linker scriptThere was a request to preprocess the module linker script like wedo for the vmlinux one. (https://lkml.org/lkml/2020/8/21/512)The difference between vmlinux.lds and module.lds is that the latteris needed for external module builds, thus must be cleaned up by'make mrproper' instead of 'make clean'. Also, it must be createdby 'make modules_prepare'.You cannot put it in arch/$(SRCARCH)/kernel/, which is cleaned up by'make clean'. I moved arch/$(SRCARCH)/kernel/module.lds toarch/$(SRCARCH)/include/asm/module.lds.h, which is included fromscripts/module.lds.S.scripts/module.lds is fine because 'make clean' keeps all thebuild artifacts under scripts/.You can add arch-specific sections in .Signed-off-by: Masahiro Yamada Tested-by: Jessica Yu Acked-by: Will Deacon Acked-by: Geert Uytterhoeven Acked-by: Palmer Dabbelt Reviewed-by: Kees Cook Acked-by: Jessica Yu List of files: /linux-6.15/scripts/.gitignore

d198b34f - .gitignore: add SPDX License Identifier

Tue, 03 Mar 2020 13:35:59 +0000

.gitignore: add SPDX License IdentifierAdd SPDX License Identifier to all .gitignore files.Signed-off-by: Masahiro Yamada Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/scripts/.gitignore

2985bed6 - .gitignore: remove too obvious comments

Tue, 03 Mar 2020 13:35:58 +0000

.gitignore: remove too obvious commentsSome .gitignore files have comments like "Generated files","Ignore generated files" at the header part, but they aretoo obvious.Signed-off-by: Masahiro Yamada Signed-off-by: Greg Kroah-Hartman List of files: /linux-6.15/scripts/.gitignore

4484aa80 - tty: vt: move conmakehash to drivers/tty/vt/ from scripts/

Tue, 17 Dec 2019 11:06:33 +0000

tty: vt: move conmakehash to drivers/tty/vt/ from scripts/scripts/conmakehash is only used for generatingdrivers/tty/vt/consolemap_deftbl.cMove it to the related directory.Signed-off-by: Masahiro Yamada Link: https://lore.kernel.org/r/20191217110633.8796-1-masahiroy@kernel.orgSigned-off-by: Greg Kroah-Hartman List of files: /linux-6.15/scripts/.gitignore

10916706 - scripts/sorttable: Rename 'sortextable' to 'sorttable'

Wed, 04 Dec 2019 00:46:31 +0000

scripts/sorttable: Rename 'sortextable' to 'sorttable'Use a more generic name for additional table sorting usecases,such as the upcoming ORC table sorting feature. This tool isnot tied to exception table sorting anymore.No functional changes intended.[ mingo: Rewrote the changelog. ]Signed-off-by: Shile Zhang Acked-by: Peter Zijlstra (Intel) Cc: Josh Poimboeuf Cc: Masahiro Yamada Cc: Michal Marek Cc: linux-kbuild@vger.kernel.orgLink: https://lkml.kernel.org/r/20191204004633.88660-6-shile.zhang@linux.alibaba.comSigned-off-by: Ingo Molnar List of files: /linux-6.15/scripts/.gitignore

78a20a01 - video/logo: move pnmtologo tool to drivers/video/logo/ from scripts/

Wed, 21 Aug 2019 04:12:37 +0000

video/logo: move pnmtologo tool to drivers/video/logo/ from scripts/This tool is only used by drivers/video/logo/Makefile. No reason tokeep it in scripts/.Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

3c78c77b - scripts: remove unnecessary ihex2fw and check-lc_ctypes from .gitignore

Fri, 21 Dec 2018 03:12:39 +0000

scripts: remove unnecessary ihex2fw and check-lc_ctypes from .gitignoreCommit c512d2544c68 ("gitignore: ignore scripts/ihex2fw") was unneeded.ihex2fw was generated in firmware/ instead of scripts/ at that timealthough ihex2fw.c was pushed back and forth between those directoriesin the past.check-lc_ctype was removed by commit cb43fb5775df ("docs: removeDocBook from the building system").Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

c417fbce - kbuild: move bin2c back to scripts/ from scripts/basic/

Mon, 25 Jun 2018 16:40:23 +0000

kbuild: move bin2c back to scripts/ from scripts/basic/Commit 8370edea81e3 ("bin2c: move bin2c in scripts/basic") moved bin2cto the scripts/basic/ directory, incorrectly stating "Kexec wants touse bin2c and it wants to use it really early in the build process.See arch/x86/purgatory/ code in later patches."Commit bdab125c9301 ("Revert "kexec/purgatory: Add clean-up forpurgatory directory"") and commit d6605b6bbee8 ("x86/build: Removeunnecessary preparation for purgatory") removed the redundantpurgatory build magic entirely.That means that the move of bin2c was unnecessary in the first place.fixdep is the only host program that deserves to sit in thescripts/basic/ directory.Signed-off-by: Masahiro Yamada List of files: /linux-6.15/scripts/.gitignore

52b3f239 - Docs: clean up some DocBook loose ends

Fri, 23 Jun 2017 20:17:38 +0000

Docs: clean up some DocBook loose endsThere were a few bits and pieces left over from the now-disused DocBooktoolchain; git rid of them.Reported-by: Markus Heiser Signed-off-by: Jonathan Corbet List of files: /linux-6.15/scripts/.gitignore

c4c36105 - KEYS: Reserve an extra certificate symbol for inserting without recompiling

Tue, 24 Nov 2015 21:18:05 +0000

KEYS: Reserve an extra certificate symbol for inserting without recompilingPlace a system_extra_cert buffer of configurable size, right after thesystem_certificate_list, so that inserted keys can be readily processed bythe existing mechanism. Added script takes a key file and a kernel imageand inserts its contents to the reserved area. Thesystem_certificate_list_size is also adjusted accordingly.Call the script as: scripts/insert-sys-cert -b -c If vmlinux has no symbol table, supply System.map file with -s flag.Subsequent runs replace the previously inserted key, instead of appendingthe new one.Signed-off-by: Mehmet Kayaalp Signed-off-by: David Howells Acked-by: Mimi Zohar List of files: /linux-6.15/scripts/.gitignore

b479bfd0 - DocBook: Use a fixed encoding for output

Mon, 28 Sep 2015 00:09:52 +0000

DocBook: Use a fixed encoding for outputCurrently the encoding of documents generated by DocBook depends onthe current locale. Make the output reproducible independently ofthe locale, by setting the encoding to UTF-8 (LC_CTYPE=C.UTF-8) bypreference, or ASCII (LC_CTYPE=C) as a fallback.LC_CTYPE can normally be overridden by LC_ALL, but the top-levelMakefile unsets that.Signed-off-by: Ben Hutchings [jc: added check-lc_ctype to .gitignore]Signed-off-by: Jonathan Corbet List of files: /linux-6.15/scripts/.gitignore