커널 기능 지원 상태 표 갱신 스크립트

Kconfig 존재 여부로 arch-support.txt를 제자리 재생성

`features-refresh.sh`는 `Documentation/features/*/*/arch-support.txt`의 아키텍처별 지원 상태 표를 현재 커널 소스의 Kconfig 내용과 대조해 제자리에서 다시 만드는 셸 스크립트입니다. 각 기능 파일의 `# Kconfig:` 헤더에서 표현식 `F`를 추출하고, 이를 연산자 `O`와 Kconfig 심볼 `K`의 쌍으로 해석합니다.

지원하는 연산자는 두 가지뿐입니다. 긍정형은 `O`가 빈 문자열이고 `K=F`이며, 표현식이 `!`로 시작하면 `O=not`으로 두고 선두 `!`를 제거한 나머지를 `K`로 사용합니다. 다른 논리 연산자는 지원하지 않습니다.

스크립트는 먼저 어느 아키텍처의 `Kconfig*` 파일에라도 `K`가 있는지 검사해 기능 표현식의 유효성을 판단합니다. 그 뒤 원래 파일의 주석 행만 임시 파일에 복사하고 새 표 머리글을 쓴 다음, 각 아키텍처를 다시 순회해 `ok`, 기존 상태 또는 `TODO` 행을 선택합니다. 마지막에 임시 파일을 원래 `arch-support.txt`로 이동합니다.

아래 코드는 Linux v6.18.37 원문 1-98줄 전체입니다. 표시 안정성을 위해 탭만 여덟 칸으로 정규화했으며 변수명, glob, grep·find·sed 표현식, 주석의 사례 번호, 표 문자와 파일 교체 순서를 변경하지 않았습니다.

#
# Small script that refreshes the kernel feature support status in place.
#

for F_FILE in Documentation/features/*/*/arch-support.txt; do
        F=$(grep "^#         Kconfig:" "$F_FILE" | cut -c26-)

        #
        # Each feature F is identified by a pair (O, K), where 'O' can
        # be either the empty string (for 'nop') or "not" (the logical
        # negation operator '!'); other operators are not supported.
        #
        O=""
        K=$F
        if [[ "$F" == !* ]]; then
                O="not"
                K=$(echo $F | sed -e 's/^!//g')
        fi

        #
        # F := (O, K) is 'valid' iff there is a Kconfig file (for some
        # arch) which contains K.
        #
        # Notice that this definition entails an 'asymmetry' between
        # the case 'O = ""' and the case 'O = "not"'. E.g., F may be
        # _invalid_ if:
        #
        # [case 'O = ""']
        #   1) no arch provides support for F,
        #   2) K does not exist (e.g., it was renamed/mis-typed);
        #
        # [case 'O = "not"']
        #   3) all archs provide support for F,
        #   4) as in (2).
        #
        # The rationale for adopting this definition (and, thus, for
        # keeping the asymmetry) is:
        #
        #       We want to be able to 'detect' (2) (or (4)).
        #
        # (1) and (3) may further warn the developers about the fact
        # that K can be removed.
        #
        F_VALID="false"
        for ARCH_DIR in arch/*/; do
                K_FILES=$(find $ARCH_DIR -name "Kconfig*")
                K_GREP=$(grep "$K" $K_FILES)
                if [ ! -z "$K_GREP" ]; then
                        F_VALID="true"
                        break
                fi
        done
        if [ "$F_VALID" = "false" ]; then
                printf "WARNING: '%s' is not a valid Kconfig\n" "$F"
        fi

        T_FILE="$F_FILE.tmp"
        grep "^#" $F_FILE > $T_FILE
        echo "    -----------------------" >> $T_FILE
        echo "    |         arch |status|" >> $T_FILE
        echo "    -----------------------" >> $T_FILE
        for ARCH_DIR in arch/*/; do
                ARCH=$(echo $ARCH_DIR | sed -e 's/^arch//g' | sed -e 's/\///g')
                K_FILES=$(find $ARCH_DIR -name "Kconfig*")
                K_GREP=$(grep "$K" $K_FILES)
                #
                # Arch support status values for (O, K) are updated according
                # to the following rules.
                #
                #   - ("", K) is 'supported by a given arch', if there is a
                #     Kconfig file for that arch which contains K;
                #
                #   - ("not", K) is 'supported by a given arch', if there is
                #     no Kconfig file for that arch which contains K;
                #
                #   - otherwise: preserve the previous status value (if any),
                #                default to 'not yet supported'.
                #
                # Notice that, according these rules, invalid features may be
                # updated/modified.
                #
                if [ "$O" = "" ] && [ ! -z "$K_GREP" ]; then
                        printf "    |%12s: |  ok  |\n" "$ARCH" >> $T_FILE
                elif [ "$O" = "not" ] && [ -z "$K_GREP" ]; then
                        printf "    |%12s: |  ok  |\n" "$ARCH" >> $T_FILE
                else
                        S=$(grep -v "^#" "$F_FILE" | grep " $ARCH:")
                        if [ ! -z "$S" ]; then
                                echo "$S" >> $T_FILE
                        else
                                printf "    |%12s: | TODO |\n" "$ARCH" \
                                        >> $T_FILE
                        fi
                fi
        done
        echo "    -----------------------" >> $T_FILE
        mv $T_FILE $F_FILE
done