aboutsummaryrefslogtreecommitdiff
path: root/sysdeps/generic/uw-sigframe.h
blob: b357f8aa76b35d010474f1b7fb4ac05d563b70d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
/* Internal header file for handling signal frames.  Generic version.
   Copyright (C) 2025 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
   <https://www.gnu.org/licenses/>.  */

/* Each architecture that supports SFrame may need to define several
   macros to handle exceptional cases during stack backtracing.

   MD_DECODE_SIGNAL_FRAME(frame) should recover frame information when
   a signal-related exception occurs.  The input frame must contain a
   valid program counter (PC) field.  On success, the macro should
   return _URC_NO_REASON.

   MD_DETECT_OUTERMOST_FRAME(frame) is used to detect the outermost
   stack frame.  It returns _URC_NO_REASON upon successful
   detection.

   The FRAME structure is defined in sysdeps/generic/sframe.h  */