xref: /linux/Documentation/features/scripts/features-refresh.sh (revision 7ae9fb1b7ecbb5d85d07857943f677fd1a559b18)
1#
2# Small script that refreshes the kernel feature support status in place.
3#
4
5for F_FILE in Documentation/features/*/*/arch-support.txt; do
6	F=$(grep "^#         Kconfig:" "$F_FILE" | cut -c26-)
7
8	#
9	# Each feature F is identified by a pair (O, K), where 'O' can
10	# be either the empty string (for 'nop') or "not" (the logical
11	# negation operator '!'); other operators are not supported.
12	#
13	O=""
14	K=$F
15	if [[ "$F" == !* ]]; then
16		O="not"
17		K=$(echo $F | sed -e 's/^!//g')
18	fi
19
20	#
21	# F := (O, K) is 'valid' iff there is a Kconfig file (for some
22	# arch) which contains K.
23	#
24	# Notice that this definition entails an 'asymmetry' between
25	# the case 'O = ""' and the case 'O = "not"'. E.g., F may be
26	# _invalid_ if:
27	#
28	# [case 'O = ""']
29	#   1) no arch provides support for F,
30	#   2) K does not exist (e.g., it was renamed/mis-typed);
31	#
32	# [case 'O = "not"']
33	#   3) all archs provide support for F,
34	#   4) as in (2).
35	#
36	# The rationale for adopting this definition (and, thus, for
37	# keeping the asymmetry) is:
38	#
39	#       We want to be able to 'detect' (2) (or (4)).
40	#
41	# (1) and (3) may further warn the developers about the fact
42	# that K can be removed.
43	#
44	F_VALID="false"
45	for ARCH_DIR in arch/*/; do
46		K_FILES=$(find $ARCH_DIR -name "Kconfig*")
47		K_GREP=$(grep "$K" $K_FILES)
48		if [ ! -z "$K_GREP" ]; then
49			F_VALID="true"
50			break
51		fi
52	done
53	if [ "$F_VALID" = "false" ]; then
54		printf "WARNING: '%s' is not a valid Kconfig\n" "$F"
55	fi
56
57	T_FILE="$F_FILE.tmp"
58	grep "^#" $F_FILE > $T_FILE
59	echo "    -----------------------" >> $T_FILE
60	echo "    |         arch |status|" >> $T_FILE
61	echo "    -----------------------" >> $T_FILE
62	for ARCH_DIR in arch/*/; do
63		ARCH=$(echo $ARCH_DIR | sed -e 's/^arch//g' | sed -e 's/\///g')
64		K_FILES=$(find $ARCH_DIR -name "Kconfig*")
65		K_GREP=$(grep "$K" $K_FILES)
66		#
67		# Arch support status values for (O, K) are updated according
68		# to the following rules.
69		#
70		#   - ("", K) is 'supported by a given arch', if there is a
71		#     Kconfig file for that arch which contains K;
72		#
73		#   - ("not", K) is 'supported by a given arch', if there is
74		#     no Kconfig file for that arch which contains K;
75		#
76		#   - otherwise: preserve the previous status value (if any),
77		#                default to 'not yet supported'.
78		#
79		# Notice that, according these rules, invalid features may be
80		# updated/modified.
81		#
82		if [ "$O" = "" ] && [ ! -z "$K_GREP" ]; then
83			printf "    |%12s: |  ok  |\n" "$ARCH" >> $T_FILE
84		elif [ "$O" = "not" ] && [ -z "$K_GREP" ]; then
85			printf "    |%12s: |  ok  |\n" "$ARCH" >> $T_FILE
86		else
87			S=$(grep -v "^#" "$F_FILE" | grep " $ARCH:")
88			if [ ! -z "$S" ]; then
89				echo "$S" >> $T_FILE
90			else
91				printf "    |%12s: | TODO |\n" "$ARCH" \
92					>> $T_FILE
93			fi
94		fi
95	done
96	echo "    -----------------------" >> $T_FILE
97	mv $T_FILE $F_FILE
98done
99