linux - usr/include/Makefile

171 lines · 5.3 KiB

1	# SPDX-License-Identifier: GPL-2.0-only
2
3	# Unlike the kernel space, exported headers are written in standard C.
4	# - Forbid C++ style comments
5	# - Use '__inline__', '__asm__' instead of 'inline', 'asm'
6	#
7	# -std=c90 (equivalent to -ansi) catches the violation of those.
8	# We cannot go as far as adding -Wpedantic since it emits too many warnings.
9	UAPI_CFLAGS := -std=c90 -Werror=implicit-function-declaration
10
11	override c_flags = $(KBUILD_USERCFLAGS) $(UAPI_CFLAGS) -Wp,-MMD,$(depfile) -I $(obj) -I $(srctree)/usr/dummy-include
12
13	# The following are excluded for now because they fail to build.
14	#
15	# Do not add a new header to the blacklist without legitimate reason.
16	# Please consider to fix the header first.
17	#
18	# Sorted alphabetically.
19	no-header-test += asm/ucontext.h
20	no-header-test += drm/vmwgfx_drm.h
21	no-header-test += linux/am437x-vpfe.h
22	no-header-test += linux/coda.h
23	no-header-test += linux/cyclades.h
24	no-header-test += linux/errqueue.h
25	no-header-test += linux/hdlc/ioctl.h
26	no-header-test += linux/ivtv.h
27	no-header-test += linux/matroxfb.h
28	no-header-test += linux/omap3isp.h
29	no-header-test += linux/omapfb.h
30	no-header-test += linux/patchkey.h
31	no-header-test += linux/phonet.h
32	no-header-test += linux/sctp.h
33	no-header-test += linux/sysctl.h
34	no-header-test += linux/usb/audio.h
35	no-header-test += linux/v4l2-mediabus.h
36	no-header-test += linux/v4l2-subdev.h
37	no-header-test += linux/videodev2.h
38	no-header-test += linux/vm_sockets.h
39	no-header-test += sound/asequencer.h
40	no-header-test += sound/asoc.h
41	no-header-test += sound/asound.h
42	no-header-test += sound/compress_offload.h
43	no-header-test += sound/emu10k1.h
44	no-header-test += sound/sfnt_info.h
45	no-header-test += xen/evtchn.h
46	no-header-test += xen/gntdev.h
47	no-header-test += xen/privcmd.h
48
49	# More headers are broken in some architectures
50
51	ifeq ($(SRCARCH),arc)
52	no-header-test += linux/bpf_perf_event.h
53	endif
54
55	ifeq ($(SRCARCH),openrisc)
56	no-header-test += linux/bpf_perf_event.h
57	endif
58
59	ifeq ($(SRCARCH),powerpc)
60	no-header-test += linux/bpf_perf_event.h
61	endif
62
63	ifeq ($(SRCARCH),sparc)
64	no-header-test += asm/uctx.h
65	no-header-test += asm/fbio.h
66	endif
67
68	ifeq ($(SRCARCH),xtensa)
69	no-header-test += linux/bpf_perf_event.h
70	endif
71
72	# asm-generic/.h is used by asm/.h, and should not be included directly
73	no-header-test += asm-generic/%
74
75	# The following are using libc header and types.
76	#
77	# Do not add a new header to the list without legitimate reason.
78	# Please consider to fix the header first.
79	#
80	# Sorted alphabetically.
81	uses-libc += linux/a.out.h
82	uses-libc += linux/atmbr2684.h
83	uses-libc += linux/auto_dev-ioctl.h
84	uses-libc += linux/auto_fs.h
85	uses-libc += linux/auto_fs4.h
86	uses-libc += linux/btrfs_tree.h
87	uses-libc += linux/cec-funcs.h
88	uses-libc += linux/cec.h
89	uses-libc += linux/dvb/dmx.h
90	uses-libc += linux/dvb/video.h
91	uses-libc += linux/ethtool.h
92	uses-libc += linux/ethtool_netlink.h
93	uses-libc += linux/fuse.h
94	uses-libc += linux/gsmmux.h
95	uses-libc += linux/icmp.h
96	uses-libc += linux/idxd.h
97	uses-libc += linux/if.h
98	uses-libc += linux/if_arp.h
99	uses-libc += linux/if_bonding.h
100	uses-libc += linux/if_pppox.h
101	uses-libc += linux/if_tunnel.h
102	uses-libc += linux/input.h
103	uses-libc += linux/ip6_tunnel.h
104	uses-libc += linux/joystick.h
105	uses-libc += linux/llc.h
106	uses-libc += linux/mctp.h
107	uses-libc += linux/mdio.h
108	uses-libc += linux/mii.h
109	uses-libc += linux/mptcp.h
110	uses-libc += linux/netdevice.h
111	uses-libc += linux/netfilter/xt_RATEEST.h
112	uses-libc += linux/netfilter/xt_hashlimit.h
113	uses-libc += linux/netfilter/xt_physdev.h
114	uses-libc += linux/netfilter/xt_rateest.h
115	uses-libc += linux/netfilter_arp/arp_tables.h
116	uses-libc += linux/netfilter_arp/arpt_mangle.h
117	uses-libc += linux/netfilter_bridge.h
118	uses-libc += linux/netfilter_bridge/ebtables.h
119	uses-libc += linux/netfilter_ipv4.h
120	uses-libc += linux/netfilter_ipv4/ip_tables.h
121	uses-libc += linux/netfilter_ipv6.h
122	uses-libc += linux/netfilter_ipv6/ip6_tables.h
123	uses-libc += linux/route.h
124	uses-libc += linux/shm.h
125	uses-libc += linux/soundcard.h
126	uses-libc += linux/string.h
127	uses-libc += linux/tipc_config.h
128	uses-libc += linux/uhid.h
129	uses-libc += linux/uinput.h
130	uses-libc += linux/vhost.h
131	uses-libc += linux/vhost_types.h
132	uses-libc += linux/virtio_ring.h
133	uses-libc += linux/wireless.h
134	uses-libc += regulator/regulator.h
135	uses-libc += scsi/fc/fc_els.h
136
137	ifeq ($(SRCARCH),hexagon)
138	uses-libc += asm/sigcontext.h
139	endif
140
141	ifeq ($(SRCARCH),nios2)
142	uses-libc += asm/ptrace.h
143	uses-libc += linux/bpf_perf_event.h
144	endif
145
146	ifeq ($(SRCARCH),s390)
147	uses-libc += asm/chpid.h
148	uses-libc += asm/chsc.h
149	endif
150
151	always-y := $(patsubst $(obj)/%.h,%.hdrtest, $(shell find $(obj) -name '*.h' 2>/dev/null))
152
153	target-no-libc = $(filter-out $(uses-libc), $*.h)
154	target-can-compile = $(and $(filter-out $(no-header-test), $*.h), \
155	$(or $(CONFIG_CC_CAN_LINK), $(target-no-libc)))
156
157	# Include the header twice to detect missing include guard.
158	quiet_cmd_hdrtest = HDRTEST $<
159	cmd_hdrtest = \
160	$(CC) $(c_flags) -fsyntax-only -Werror -x c /dev/null \
161	$(if $(target-no-libc), -nostdinc) \
162	$(if $(target-can-compile), -include $< -include $<); \
163	$(PERL) $(src)/headers_check.pl $(obj) $<; \
164	touch $@
165
166	$(obj)/%.hdrtest: $(obj)/%.h $(src)/headers_check.pl FORCE
167	$(call if_changed_dep,hdrtest)
168
169	# Since GNU Make 4.3, $(patsubst $(obj)/%/,%,$(wildcard $(obj)/*/)) works.
170	# To support older Make versions, use a somewhat tedious way.
171	clean-files += $(filter-out Makefile headers_check.pl, $(notdir $(wildcard $(obj)/*)))