Lines Matching refs:UAPI

4 UAPI Checker
7 The UAPI checker (``scripts/check-uapi.sh``) is a shell script which
8 checks UAPI header files for userspace backwards-compatibility across
24                    will use any dirty changes in tree to UAPI files. If there are no
31     -i             Ignore ambiguous changes that may or may not break UAPI compatibility.
53 First, let's try making a change to a UAPI header file that obviously
76     Installing user-facing UAPI headers from dirty tree... OK
77     Installing user-facing UAPI headers from HEAD... OK
78     Checking changes to UAPI headers between HEAD and dirty tree...
79     All 912 UAPI headers compatible with x86 appear to be backwards compatible
100     Installing user-facing UAPI headers from dirty tree... OK
101     Installing user-facing UAPI headers from HEAD... OK
102     Checking changes to UAPI headers between HEAD and dirty tree...
114     error - 1/912 UAPI headers compatible with x86 appear _not_ to be backwards compatible
124     Installing user-facing UAPI headers from dirty tree... OK
125     Installing user-facing UAPI headers from HEAD... OK
126     Checking changes to UAPI headers between HEAD and dirty tree...
127     All 912 UAPI headers compatible with x86 appear to be backwards compatible
150     Installing user-facing UAPI headers from dirty tree... OK
151     Installing user-facing UAPI headers from HEAD... OK
152     Checking changes to UAPI headers between HEAD and dirty tree...
161     error - 1/912 UAPI headers compatible with x86 appear _not_ to be backwards compatible
165     % git commit -m 'Breaking UAPI change' include/uapi/linux/bpf.h
166     [detached HEAD f758e574663a] Breaking UAPI change
168     % git commit -m 'Innocuous UAPI change' include/uapi/linux/acct.h
169     [detached HEAD 2e87df769081] Innocuous UAPI change
175     Installing user-facing UAPI headers from HEAD... OK
176     Installing user-facing UAPI headers from HEAD^1... OK
177     Checking changes to UAPI headers between HEAD^1 and HEAD...
178     All 912 UAPI headers compatible with x86 appear to be backwards compatible
184 let's pass ``-p HEAD~2`` to the script so it checks UAPI changes between
188     Installing user-facing UAPI headers from HEAD... OK
189     Installing user-facing UAPI headers from HEAD~2... OK
190     Checking changes to UAPI headers between HEAD~2 and HEAD...
199     error - 1/912 UAPI headers compatible with x86 appear _not_ to be backwards compatible
222 This is a change to an arm64-specific UAPI header file. In this example, I'm
224 the script only checks x86-compatible UAPI header files::
227     Installing user-facing UAPI headers from dirty tree... OK
228     Installing user-facing UAPI headers from HEAD... OK
229     No changes to UAPI headers were applied between HEAD and dirty tree
238     Installing user-facing UAPI headers from dirty tree... OK
239     Installing user-facing UAPI headers from HEAD... OK
240     Checking changes to UAPI headers between HEAD and dirty tree...
254     error - 1/884 UAPI headers compatible with arm64 appear _not_ to be backwards compatible
257 change is reported properly. Also notice that the total number of UAPI
281 a UAPI in ``types.h``, but other UAPIs in the tree may break due to
285     Installing user-facing UAPI headers from dirty tree... OK
286     Installing user-facing UAPI headers from HEAD... OK
287     Checking changes to UAPI headers between HEAD and dirty tree...
307 UAPI Header Removals
327 This script removes a UAPI header file from the install list. Let's run
331     Installing user-facing UAPI headers from dirty tree... OK
332     Installing user-facing UAPI headers from HEAD... OK
333     Checking changes to UAPI headers between HEAD and dirty tree...
334     ==== UAPI header include/asm/termios.h was removed between HEAD and dirty tree ====
336     error - 1/912 UAPI headers compatible with x86 appear _not_ to be backwards compatible
338 Removing a UAPI header is considered a breaking change, and the script
341 Checking Historic UAPI Compatibility
345 git tree. For example, to check all changed UAPI header files between tags
349     Installing user-facing UAPI headers from v6.1... OK
350     Installing user-facing UAPI headers from v6.0... OK
351     Checking changes to UAPI headers between v6.0 and v6.1...
354     error - 37/907 UAPI headers compatible with x86 appear _not_ to be backwards compatible
359 You'll notice that the script detected many UAPI changes that are not
367 The UAPI checker makes no assumptions about the author's intention, so some
368 types of changes may be flagged even though they intentionally break UAPI.
376     Installing user-facing UAPI headers from ba47652ba655... OK
377     Installing user-facing UAPI headers from ba47652ba655^1... OK
378     Checking changes to UAPI headers between ba47652ba655^1 and ba47652ba655...
379     ==== UAPI header include/linux/meye.h was removed between ba47652ba655^1 and ba47652ba655 ====
381     error - 1/910 UAPI headers compatible with x86 appear _not_ to be backwards compatible
468 which does not break UAPI. It's also possible a change which *does*
476 (and ideally a unit test in userspace) to make sure your UAPI changes