/* Copyright (C) 2006-2024 Free Software Foundation, Inc.
This file is part of the GNU C Library.
The GNU C Library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public License as
published by the Free Software Foundation; either version 2.1 of the
License, or (at your option) any later version.
The GNU C Library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with the GNU C Library. If not, see
. */
#define JB_X19 0
#define JB_X20 1
#define JB_X21 2
#define JB_X22 3
#define JB_X23 4
#define JB_X24 5
#define JB_X25 6
#define JB_X26 7
#define JB_X27 8
#define JB_X28 9
#define JB_X29 10
#define JB_LR 11
#define JB_SP 13
#define JB_D8 14
#define JB_D9 15
#define JB_D10 16
#define JB_D11 17
#define JB_D12 18
#define JB_D13 19
#define JB_D14 20
#define JB_D15 21
/* The target specific part of jmp_buf has no space for expansion but
the public jmp_buf ABI type has. Unfortunately there is another type
that is used with setjmp APIs and exposed by thread cancellation (in
binaries built with -fno-exceptions) which complicates the situation.
// Internal layout of the public jmp_buf type on AArch64.
// This is passed to setjmp, longjmp, sigsetjmp, siglongjmp.
struct
{
uint64_t jmpbuf[22]; // Target specific part.
uint32_t mask_was_saved; // savemask bool used by sigsetjmp/siglongjmp.
uint32_t pad;
uint64_t saved_mask; // sigset_t bits used on linux.
uint64_t unused[15]; // sigset_t bits not used on linux.
};
// Internal layout of the public __pthread_unwind_buf_t type.
// This is passed to sigsetjmp with !savemask and to the internal
// __libc_longjmp (currently alias of longjmp on AArch64).
struct
{
uint64_t jmpbuf[22]; // Must match jmp_buf.
uint32_t mask_was_saved; // Must match jmp_buf, always 0.
uint32_t pad;
void *prev; // List for unwinding.
void *cleanup; // Cleanup handlers.
uint32_t canceltype; // 1 bit cancellation type.
uint32_t pad2;
void *pad3;
};
Ideally only the target specific part of jmp_buf (A) is accessed by
__setjmp and __longjmp. But that is always embedded into one of the
two types above so the bits that are unused in those types (B) may be
reused for target specific purposes. Setjmp can't distinguish between
jmp_buf and __pthread_unwind_buf_t, but longjmp can: only an internal
longjmp call uses the latter, so state that is not needed for cancel
cleanups can go to fields (C). If generic code is refactored then the
usage of additional fields can be optimized (D). And some fields are
only accessible in the savedmask case (E). Reusability of jmp_buf
fields on AArch64 for target purposes:
struct
{
uint64_t A[22]; // 0 .. 176
uint32_t D; // 176 .. 180
uint32_t B; // 180 .. 184
uint64_t D; // 184 .. 192
uint64_t C; // 192 .. 200
uint32_t C; // 200 .. 204
uint32_t B; // 204 .. 208
uint64_t B; // 208 .. 216
uint64_t E[12]; // 216 .. 312
}
The B fields can be used with minimal glibc code changes. We need a
64 bit field for the Guarded Control Stack pointer (GCSPR_EL0) which
can use a C field too as cancellation cleanup does not execute RET
for a previous BL of the cancelled thread, but that would require a
custom __libc_longjmp. This layout can change in the future.
*/
#define JB_GCSPR 208
#ifndef __ASSEMBLER__
#include
#include
#include
#include
static inline uintptr_t __attribute__ ((unused))
_jmpbuf_sp (__jmp_buf jmpbuf)
{
uintptr_t sp = jmpbuf[JB_SP];
PTR_DEMANGLE (sp);
return sp;
}
#endif
/* Helper for generic ____longjmp_chk(). */
#define JB_FRAME_ADDRESS(buf) \
((void *) _jmpbuf_sp (buf))