시그널 프레임과 사용자 실행 상태 복원

저장된 태스크 상태에 SMSTOP SM의 효과를 적용하여 신호 처리기가 SME streaming 모드 밖에서 시작하게 합니다. streaming 모드였다면 벡터 상태 등을 규정된 값으로 바꾸고 SM 비트를 지웁니다.

저장된 SVCR에서 ZA 활성 비트를 지웁니다. 중단된 코드가 ZA를 사용했어도 신호 처리기는 ZA가 비활성인 상태로 시작해야 합니다.

TPIDR2_EL0를 0으로 만들어 신호 처리기가 중단된 코드의 SME 지연 저장 상태 포인터를 그대로 사용하지 않게 합니다. 앞에서 원래 상태를 신호 프레임에 보관한 뒤 처리기 진입 상태를 준비하는 부분입니다.

신호 처리기 진입용 레지스터와 CPU 기능 상태 준비를 성공했음을 반환합니다.

신호 번호 usig, 처리기 설정 ksig와 복원할 신호 마스크 set으로 AArch64 신호 프레임을 만듭니다.

중단된 사용자 레지스터를 regs로 받습니다. 원래 상태는 프레임에 저장하고 regs 자체는 처리기 진입용으로 바꿉니다.

기본 신호 프레임과 확장 문맥이 사용자 스택의 어느 위치에 놓일지 담는 배치 정보입니다.

사용자 스택의 기본 rt_sigframe을 가리킬 포인터입니다. __user 표식은 일반 커널 포인터처럼 직접 접근해서는 안 됨을 나타냅니다.

프레임을 쓰기 위해 임시로 바꾸는 사용자 접근 권한의 원래 값을 보관합니다. 빈 초기값에서 지원되는 POE 상태를 채웁니다.

여러 사용자 메모리 쓰기의 오류를 모을 변수입니다. 모두 성공하면 0이 유지되어 처리기 진입 준비를 계속합니다.

현재 태스크의 FP·SIMD 등 상태를 메모리에 저장하고 CPU에 남아 있는 상태와의 연결을 정리합니다. 이후 신호 프레임이 최신 값을 담을 수 있게 하는 작업이며, 일반 데이터 캐시를 비운다는 뜻은 아닙니다.

스택 위치와 확장 상태 크기를 반영한 프레임 배치를 구합니다. 실패하면 불완전한 주소로 프레임을 쓰기 전에 중단합니다.

신호 프레임 배치를 구하지 못했으므로 비영(1) 실패를 반환합니다. 호출자가 신호 설정 실패로 처리합니다.

POE를 지원하면 기존 POR_EL0 접근 권한을 ua_state에 저장하고 신호 프레임을 쓸 수 있도록 임시로 권한을 엽니다. 사용자 보호 키 설정이 프레임 작성 자체를 가로막지 않게 준비합니다.

계산한 배치 중 기본 신호 프레임 주소를 꺼냅니다. 다음 줄부터 이 주소에 ucontext와 siginfo를 기록합니다.

사용자 신호 프레임의 uc_flags를 0으로 초기화합니다. __put_user_error는 쓰기 오류를 err에 누적하므로, 이 필드를 쓰지 못했으면 뒤에서 정상 처리기 진입을 중단할 수 있습니다.

신호 프레임의 uc_link를 NULL로 기록해 연결된 다음 사용자 문맥이 없음을 나타냅니다. 사용자 메모리 쓰기 실패는 앞선 오류와 함께 err에 남깁니다.

중단 당시 SP를 기준으로 대체 신호 스택의 설정과 사용 상태를 uc_stack에 저장합니다. 신호 처리기가 끝난 뒤 sigreturn에서 원래 스택 상태를 복구할 자료입니다.

중단된 레지스터, 신호 마스크와 확장 상태를 계산해 둔 user 프레임 배치에 저장합니다. ua_state에는 임시 변경 전 사용자 접근 권한이 담겨 있으므로 그 상태도 복귀 때 되살릴 수 있게 전달합니다.

처리기가 세 인자 형식의 SA_SIGINFO를 요청했는지 검사합니다. 요청했을 때만 발생 원인 등의 siginfo를 프레임에 복사합니다.

SA_SIGINFO 처리기에 전달할 신호 번호·발생 원인 등의 siginfo를 사용자 프레임에 복사합니다. 접근 오류가 있으면 err에 반영하여 불완전한 프레임으로 처리기를 실행하지 않게 합니다.

프레임의 모든 사용자 메모리 쓰기가 성공했는지 확인합니다. 실패가 누적됐다면 PC·SP를 처리기용으로 바꾸지 않습니다.

프레임 작성에 오류가 없을 때 PC·SP·인자·복귀 주소 등 regs를 신호 처리기 진입 상태로 바꿉니다. usig는 처리기에 전달할 신호 번호이며, 설정에 실패하면 err를 통해 알립니다.

프레임 작성과 처리기 진입 준비까지 성공했는지 확인합니다. 성공이면 처리기용 접근 권한을 적용하고, 실패면 원래 권한으로 복구합니다.

프레임과 처리기 진입 준비에 성공했으므로 POR_EL0를 신호 처리기용 기본 접근 권한으로 설정합니다. 이 시점 이후에는 임시 권한으로 사용자 메모리를 더 접근하지 않습니다.

신호 설정이 실패한 경로입니다. 임시로 완화했던 사용자 접근 권한을 원래 값으로 되돌립니다.

신호 프레임을 만들지 못한 경우 ua_state에 보관한 기존 사용자 접근 권한을 되돌립니다. 성공 경로와 달리 처리기용 권한으로 바꾸지 않고, 중단된 코드의 상태를 유지합니다.

신호 프레임 준비의 성공 0 또는 누적된 실패값을 반환합니다. 이 결과로 상위 신호 코드가 실제 전달 가능 여부를 판단합니다.

재시작이 필요한 시스템 콜을 restart_syscall로 다시 호출하도록 번호 레지스터를 준비합니다. 사용자 ABI에 따라 번호를 놓는 위치가 다릅니다.

현재 태스크가 32비트 호환 ABI인지 검사합니다. AArch32이면 호환 번호와 레지스터 규약을 사용합니다.

32비트 호환 태스크에 맞는 레지스터에 restart_syscall 번호를 준비합니다. 다시 시작해야 하는 시스템 콜이 AArch64의 x8 규약이 아니라 호환 ABI의 시스템 콜 규약을 따르도록 합니다.

64비트 AArch64 태스크의 경로입니다. 시스템 콜 번호를 x8에 넣는 규약을 따릅니다.

복귀 후 재실행할 시스템 콜 번호를 x8의 저장값에 넣습니다. 원래 번호 대신 restart_syscall이 재시작용 상태를 처리하게 합니다.

선택된 신호를 사용자 처리기에 전달할 준비를 합니다. rseq 처리, ABI별 프레임 작성, 레지스터 유효성 확인과 단일 단계 상태 반영을 연결합니다.

신호 복귀 때 복원할 차단 신호 집합을 고릅니다. 보통 current->blocked를 쓰지만 임시 신호 마스크를 되돌려야 하는 상황이면 saved_sigmask를 선택하므로, 처리 시점의 마스크와 항상 같지는 않습니다.

전달할 Linux 신호 번호를 usig에 보관합니다. ABI별 프레임 작성과 처리기 첫 인자에 같은 번호를 사용합니다.

사용자 시그널 프레임 구성의 성공·실패를 담을 ret를 선언합니다. 뒤에서 프레임 생성 결과와 사용자 레지스터 유효성 검사 결과를 합쳐 signal_setup_done에 전달합니다.

등록된 rseq 실행 구간이 신호로 중단됐음을 처리합니다. 필요한 경우 복귀 PC를 해당 구간의 중단 처리 지점으로 옮긴 뒤 그 레지스터 상태로 신호 프레임을 구성하게 합니다.

AArch32 호환 태스크이면 32비트 형식으로 프레임을 만듭니다. 그렇지 않으면 아래 AArch64 rt 프레임 경로를 사용합니다.

호환 태스크의 처리기가 SA_SIGINFO를 요구하는지 검사합니다. 요구하면 확장 rt 프레임을, 아니면 전통적인 호환 프레임을 선택합니다.

32비트 호환 태스크가 SA_SIGINFO를 요청했으므로 siginfo와 ucontext가 포함된 실시간 시그널 프레임을 구성합니다. 기존 시그널 마스크·레지스터를 저장하고 핸들러 인자를 준비한 결과를 ret에 받습니다.

호환 태스크가 SA_SIGINFO를 요청하지 않은 경우입니다. 옛 arm32 처리기가 기대하는 기본 신호 프레임을 만듭니다.

SA_SIGINFO를 쓰지 않는 32비트 호환 태스크에 기존 형식의 시그널 프레임을 만듭니다. 저장 문맥과 복귀 코드를 준비하고 핸들러로 들어갈 레지스터를 설정한 성공·실패를 기록합니다.

native AArch64 태스크의 경로입니다. SA_SIGINFO 여부와 무관하게 AArch64 rt 프레임 형식을 사용합니다.

64비트 태스크의 사용자 스택에 실시간 시그널 프레임을 구성합니다. 원래 문맥과 시그널 마스크를 저장하고 핸들러로 진입할 사용자 레지스터를 설정하며, 오류 여부를 ret에 기록합니다.

XSAVE 확장 상태를 제공하지 않는 경우에도 SS 레지스터 문맥이 포함됨을 UC_SIGCONTEXT_SS로 표시합니다.

신호가 실제 64비트 사용자 코드 실행 중에 발생했는지 검사합니다. 그 경우 복귀 때 SS를 엄격하게 복원하도록 추가 표시합니다.

64비트 문맥에서 저장한 SS의 엄격한 복원을 요구합니다. 오래된 32·16비트 문맥과의 호환 복원 규칙을 적용하지 않게 합니다.

확장 FP 상태와 SS 복원 규칙을 나타내는 비트들을 반환합니다. 이 값이 사용자 ucontext의 uc_flags에 기록됩니다.

x86-64 신호 처리기용 rt 프레임과 진입 레지스터를 준비합니다. 원래 사용자 상태를 저장하고 처리기에서 sigreturn으로 돌아올 수 있게 합니다.

신호 처리기에서 복귀한 뒤 적용할 신호 마스크를 선택합니다. 임시로 변경한 마스크의 복원이 예약되어 있으면 saved_sigmask를, 아니면 현재 blocked 집합을 프레임에 저장합니다.

사용자 스택에 만들 rt_sigframe의 주소를 담습니다. get_sigframe이 정한 위치를 이후 접근 검사와 쓰기에 사용합니다.

프레임에 연계되는 사용자 FP 상태 저장 영역의 주소입니다. 처음 NULL로 두고 get_sigframe이 저장 위치를 정하면 갱신합니다.

프레임이 담는 확장 상태와 SS 복원 규칙을 표시할 비트 묶음입니다. frame_uc_flags가 계산하여 uc_flags 필드에 기록합니다.

처리기가 복귀용 sa_restorer를 제공했는지 검사합니다. x86-64 신호 ABI는 이 사용자 복귀 코드가 있어야 rt_sigreturn을 요청할 수 있습니다.

필수 복귀 코드가 없으므로 신호 프레임 설정을 -EFAULT로 실패 처리합니다.

red-zone, altstack, fpstate 크기를 반영해 새 user RSP를 계산한다.

이 프레임에 확장 FP 상태와 SS 복구 정보를 어떻게 해석할지 나타내는 uc_flags를 만듭니다. XSAVE 지원 여부와 중단된 코드가 64비트 모드인지에 따라 UC_FP_XSTATE·UC_STRICT_RESTORE_SS 등을 정합니다.

프레임 전체가 허용된 사용자 주소 범위인지 검사하고 쓰기 구간을 엽니다. 실제 페이지 쓰기 오류는 이어지는 unsafe 접근의 Efault 경로에서도 처리합니다.

프레임 주소 범위로 사용자 접근을 시작할 수 없으므로 -EFAULT를 반환합니다.

계산한 uc_flags를 사용자 프레임에 기록합니다. 앞의 user_access_begin으로 연 접근 구간에서 수행하며, 오류가 나면 Efault로 이동해 프레임 작성 실패를 처리합니다.

uc_link에 0을 써 연결된 다음 사용자 문맥이 없음을 표시합니다. 쓰기 도중 사용자 페이지 접근이 실패하면 Efault 경로로 빠집니다.

중단 당시 SP를 바탕으로 대체 신호 스택의 설정과 상태를 uc_stack에 기록합니다. sigreturn이 원래 신호 스택 상태를 복구할 수 있도록 하며, 기록 실패는 Efault로 처리합니다.

사용자 공간에 이미 있는 복귀용 stub을 사용한다는 앞줄 주석의 끝입니다. 다음 줄에서 sa_restorer를 프레임의 반환 주소로 기록합니다.

사용자가 등록한 sa_restorer 주소를 프레임의 복귀 주소에 넣습니다. 신호 처리기가 반환하면 이 사용자 코드가 rt_sigreturn을 요청하게 하며, 커널이 여기서 restorer를 직접 호출하는 것은 아닙니다.

현재 integer register와 trap metadata를 user-visible sigcontext로 복사한다.

복귀 때 되살릴 신호 차단 집합 set을 프레임의 uc_sigmask에 기록합니다. 64비트 신호 집합을 사용자 메모리에 쓰다가 오류가 나면 Efault로 이동합니다.

신호 프레임 필드들을 쓰기 위해 열었던 사용자 메모리 접근 구간을 닫습니다. 이후의 siginfo 복사와 shadow stack 준비가 이 unsafe 접근 구간 밖에서 진행되도록 경계를 정합니다.

SA_SIGINFO 처리기일 때만 siginfo 내용을 복사합니다. 번호 하나만 받는 처리기에는 이 추가 자료의 전달을 요구하지 않습니다.

사용자 프레임에 신호 발생 정보를 복사하고 실패 여부를 검사합니다. 쓰기 실패면 처리기로 진입하지 않습니다.

siginfo 복사를 완료하지 못했으므로 -EFAULT로 신호 설정 실패를 반환합니다.

사용 중인 사용자 shadow stack에도 신호 호출과 복귀에 필요한 상태를 준비합니다. 실패하면 일반 스택만 준비된 채 처리기를 실행하지 않습니다.

shadow stack 준비가 실패했으므로 신호 전달 설정을 -EFAULT로 중단합니다.

신호 번호를 저장된 RDI에 넣습니다. x86-64 함수 호출 규약의 첫 정수 인자로 처리기에 전달됩니다.

프로토타입 없는 처리기 호출과의 호환성을 위해 RAX를 0으로 둡니다. 이 호출에서 인자로 전달하는 벡터 레지스터가 없다는 상태도 맞춥니다.

SA_SIGINFO를 쓰지 않는 처리기와도 이 인자 준비가 호환된다는 주석의 끝입니다. 아래 RSI·RDX에는 추가 정보 주소를 두지만 한 인자 처리기는 사용하지 않습니다.

두 번째 인자 RSI에 사용자 프레임의 siginfo 주소를 넣습니다. SA_SIGINFO 처리기가 신호 발생 원인을 읽는 포인터입니다.

세 번째 인자 RDX에 ucontext 주소를 넣습니다. 처리기는 중단된 레지스터와 신호 마스크 등의 문맥을 이 자료에서 볼 수 있습니다.

IRET/SYSRET 이후 signal handler를 실행하도록 saved instruction pointer를 바꾼다.

사용자 SP를 새 신호 프레임 시작으로 바꿉니다. 사용자 모드 복귀 후 처리기가 이 스택과 저장된 restorer 주소로 실행됩니다.

SA_ONSTACK 등에 따라 일반 또는 대체 스택의 기준 SP를 선택한 뒤 프레임 크기를 뺍니다. 낮은 주소 방향으로 자라는 스택에서 프레임 공간을 확보합니다.

SP의 하위 4비트를 지워 주소를 16바이트 경계로 내립니다. 처리기 진입이 RISC-V ABI의 스택 정렬을 지키게 합니다.

계산한 스택 위치를 사용자 프레임 포인터로 반환합니다. 여기서는 위치만 정하며 실제 자료 쓰기는 호출자에서 수행합니다.

신호 설정과 복귀용 마스크를 받아 RISC-V 사용자 스택에 rt 신호 프레임을 구성합니다.

중단된 레지스터 상태를 받습니다. 프레임에 기존 값을 저장한 뒤 이 regs의 PC·SP·인자를 처리기 진입 상태로 바꿉니다.

사용자 신호 프레임의 위치를 담습니다. get_sigframe으로 주소를 구한 뒤 접근 가능 범위를 검사합니다.

프레임 구성 중 생기는 복사 오류를 누적합니다. 모든 쓰기가 성공했을 때만 0이 유지됩니다.

MMU가 없는 구성에서 스택에 만든 sigreturn 명령의 주소를 보관합니다. MMU 구성에서는 쓰지 않아도 되므로 __maybe_unused를 붙입니다.

현재 태스크에 필요한 신호 프레임 크기를 구합니다. false를 넘겨 가능한 모든 확장 상태의 최대 크기 대신 현재 활성화된 벡터 상태 등을 반영하고, ABI가 요구하는 16바이트 정렬에 맞춥니다.

기존 사용자 SP와 SA_ONSTACK 설정에 따라 프레임을 놓을 사용자 스택 위치를 정합니다. 힙 메모리를 할당하는 함수가 아니며, 대체 스택 경계를 넘는 등의 문제는 뒤의 접근 검사에서 실패하도록 반환합니다.

계산한 프레임 전체가 허용된 사용자 주소 범위인지 검사합니다. 실제 페이지가 쓰기 가능한지는 이어지는 복사에서도 확인됩니다.

프레임 주소 범위가 잘못되었으므로 -EFAULT를 반환하고 사용자 메모리에 기록하지 않습니다.

신호의 번호와 원인 등의 siginfo를 사용자 프레임에 복사합니다. 실패를 err에 누적하여 필요한 정보가 빠진 채 신호 처리기를 실행하지 않게 합니다.

신호 프레임의 uc_flags를 0으로 초기화합니다. __put_user의 오류 반환값을 err에 합쳐 이후 프레임 작성 실패 여부를 판단합니다.

uc_link를 NULL로 설정해 연결된 다음 문맥이 없음을 나타냅니다. 사용자 페이지 쓰기가 실패하면 그 오류도 err에 남습니다.

중단 당시 SP를 기준으로 대체 신호 스택의 설정과 현재 사용 상태를 uc_stack에 보관합니다. 신호 처리 후 원래 스택 상태로 복귀할 때 사용하는 정보입니다.

중단된 일반 레지스터와 지원·활성 상태에 따른 FP·벡터 문맥을 신호 프레임에 저장합니다. 신호 처리기가 끝난 뒤 sigreturn이 이 자료로 사용자 실행 상태를 복원합니다.

복귀 때 되살릴 신호 차단 집합 set을 프레임의 uc_sigmask로 복사합니다. __copy_to_user는 복사하지 못한 바이트 수를 반환하므로, 0이 아니면 err가 실패를 나타냅니다.

siginfo·ucontext·레지스터·신호 마스크 저장 중 하나라도 실패했는지 검사합니다. 실패한 프레임으로 복귀 레지스터를 준비하지 않습니다.

프레임 저장을 완료하지 못했으므로 사용자 메모리 오류 -EFAULT를 반환합니다.

MMU가 있는 커널은 시그널 handler의 복귀 주소를 사용자 vDSO의 rt_sigreturn으로 정합니다. MMU가 없으면 vDSO가 없으므로 아래 분기에서 복귀 시스템 호출 명령 두 개를 사용자 스택에 직접 넣습니다. 이 조건은 빌드 전처리 단계에서 포함할 코드를 선택하며 런타임 조건 분기가 아닙니다.

신호 처리기의 복귀 주소 RA를 vDSO의 rt_sigreturn 진입점으로 설정합니다. 처리기가 반환하면 이 사용자 코드가 커널에 문맥 복원을 요청합니다.

현재 mm에 매핑된 vDSO 기준주소와 rt_sigreturn 심볼 오프셋을 합쳐 실제 사용자 복귀 주소를 구합니다.

MMU가 없는 구성에는 vDSO가 없어 사용자 스택의 시그널 프레임에 rt_sigreturn 요청 명령 두 개를 복사합니다. handler의 복귀 주소는 그 코드가 되며, 커널은 복귀 시스템 호출로 원래 문맥을 복원합니다.

vDSO가 없는 MMU 미사용 구성에서는 rt_sigreturn을 요청하는 짧은 명령열을 사용자 스택의 sigreturn_code에 복사합니다.

복사 길이를 프레임에 마련된 sigreturn_code 크기로 지정합니다. 복사되지 않은 바이트가 남으면 조건이 참이 되어 오류를 반환합니다.

스택의 sigreturn 코드를 완전히 쓰지 못했으므로 프레임 준비를 -EFAULT로 실패 처리합니다.

사용자 스택에 쓴 sigreturn 코드의 시작 주소를 addr에 보관합니다. 명령 캐시 동기화와 처리기의 RA 설정에 같은 주소를 사용합니다.

MMU가 없는 구성에서 스택에 방금 써 넣은 sigreturn 코드 구간의 명령 캐시를 동기화합니다. 처리기의 복귀 주소가 이 코드이므로 CPU가 이전 명령 바이트가 아닌 새 두 명령을 실행할 수 있어야 합니다.

처리기의 복귀 주소를 스택에 준비한 sigreturn 코드로 바꿉니다. MMU 미사용 환경에서 vDSO를 대신하는 반환 경로입니다.

339행에서 시작한 선택 구간을 마칩니다. MMU가 있는 커널은 시그널 handler의 복귀 주소를 사용자 vDSO의 rt_sigreturn으로 정합니다. MMU가 없으면 vDSO가 없으므로 아래 분기에서 복귀 시스템 호출 명령 두 개를 사용자 스택에 직접 넣습니다.

sret 뒤 signal handler에서 시작하도록 saved EPC를 교체한다.

저장된 SP를 새 신호 프레임 위치로 바꿉니다. 처리기는 원래 문맥을 보관한 프레임 아래쪽 스택을 사용하여 실행됩니다.

RISC-V 함수 호출 규약의 첫 인자 a0에 신호 번호를 넣습니다.

두 번째 인자 a1에 사용자 프레임의 siginfo 주소를 넣습니다. 이 구현은 SA_SIGINFO 여부와 무관하게 해당 포인터를 준비합니다.

세 번째 인자 a2에 ucontext 주소를 넣습니다. 신호 처리기는 이 자료로 중단된 실행 문맥을 살펴볼 수 있습니다.

DEBUG_SIG는 시그널 전달 상황을 출력할 때 쓰는 이 파일의 디버깅 조건입니다. 켜면 task·시그널 번호·PC·복귀 주소·스택을 기록하고, 꺼지면 로그만 빠지며 시그널 프레임 구성은 그대로 수행합니다. 이 조건은 빌드 전처리 단계에서 포함할 코드를 선택하며 런타임 조건 분기가 아닙니다.

DEBUG_SIG가 켜진 빌드에서 신호 전달 상태를 로그로 남깁니다. 태스크와 신호 번호, 처리기 PC·복귀 주소·스택을 함께 출력합니다.

진단 로그에 현재 태스크 이름·PID와 전달 신호 번호를 넘깁니다. 같은 신호가 어떤 태스크로 갔는지 구분할 자료입니다.

진단 로그에 설정을 마친 PC·RA와 프레임 주소를 넘깁니다. 포인터 출력용 형변환이며 레지스터를 변경하지 않습니다.

371행에서 시작한 선택 구간을 마칩니다. DEBUG_SIG는 시그널 전달 상황을 출력할 때 쓰는 이 파일의 디버깅 조건입니다. 켜면 task·시그널 번호·PC·복귀 주소·스택을 기록하고, 꺼지면 로그만 빠지며 시그널 프레임 구성은 그대로 수행합니다.

신호 프레임과 처리기 진입 레지스터를 성공적으로 준비했음을 0으로 반환합니다.

선택된 신호의 rseq 상태를 처리한 뒤 사용자 ABI에 맞는 신호 프레임을 만듭니다. 끝에서는 준비 결과와 단일 단계 추적 상태를 공통 신호 코드에 알립니다.