1
2/*--------------------------------------------------------------------*/
3/*--- Create/destroy signal delivery frames.                       ---*/
4/*---                                          pub_core_sigframe.h ---*/
5/*--------------------------------------------------------------------*/
6
7/*
8   This file is part of Valgrind, a dynamic binary instrumentation
9   framework.
10
11   Copyright (C) 2000-2013 Julian Seward
12      jseward@acm.org
13
14   This program is free software; you can redistribute it and/or
15   modify it under the terms of the GNU General Public License as
16   published by the Free Software Foundation; either version 2 of the
17   License, or (at your option) any later version.
18
19   This program is distributed in the hope that it will be useful, but
20   WITHOUT ANY WARRANTY; without even the implied warranty of
21   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
22   General Public License for more details.
23
24   You should have received a copy of the GNU General Public License
25   along with this program; if not, write to the Free Software
26   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
27   02111-1307, USA.
28
29   The GNU General Public License is contained in the file COPYING.
30*/
31
32#ifndef __PUB_CORE_SIGFRAME_H
33#define __PUB_CORE_SIGFRAME_H
34
35#include "pub_core_basics.h"     // VG_ macro
36#include "pub_core_vki.h"        // vki_sigset_t et al.
37
38//--------------------------------------------------------------------
39// PURPOSE: This module creates and destroys signal delivery frames
40// for client threads, saving/restoring the thread CPU state in the
41// frame appropriately.
42//--------------------------------------------------------------------
43
44/* Create a signal frame for thread 'tid'. */
45extern
46void VG_(sigframe_create) ( ThreadId tid,
47                            Addr sp_top_of_frame,
48                            const vki_siginfo_t *siginfo,
49                            const struct vki_ucontext *uc,
50                            void *handler,
51                            UInt flags,
52                            const vki_sigset_t *mask,
53                            void *restorer );
54
55/* Remove a signal frame from thread 'tid's stack, and
56   restore the CPU state from it. */
57extern
58void VG_(sigframe_destroy)( ThreadId tid, Bool isRT );
59
60#endif   // __PUB_CORE_SIGFRAME_H
61
62/*--------------------------------------------------------------------*/
63/*--- end                                      pub_core_sigframe.h ---*/
64/*--------------------------------------------------------------------*/
65