Files
ftmemsim-valgrind/coregrind/vgdb.h
Philippe Waroquiers b8ed3a5b65 Fix 326462 Refactor vgdb to isolate invoker stuff into separate module
vgdb.c contained (conditionally compiled) "invoker" code to have ptrace syscalls
used to allow gdb/vgdb to connect to a valgrind process blocked in a syscall.
This "invoker" code is ptrace based.
Not all platforms are using ptrace.
=> refactor vgdb so as allow invoker code to be added more cleanly
for non ptrace based platforms (e.g. Darwin, Solaris).

* add file vgdb.h for:
   - definition of the vgdb-invoker interface
   - common declarations between vgdb.c and vgdb-invoker implementations
* move ptrace related code from vgdb.c to new file vgdb-invoker-ptrace.c
* new file vgdb-invoker-none.c containing an empty invoker implementation
  used on platforms that do not (yet) have a invoker implementation
  (e.g. android and darwin).
* modified Makefile.am to use one of the vgdb-invoker-*.c file depending
  on the platform.
* small changes related to changing ptraceinvoker to invoker in various files:
  gdbserver_tests/make_local_links, gdbserver_tests/nlcontrolc.vgtest,
  gdbserver_tests/mcinvokeRU.vgtest, gdbserver_tests/nlsigvgdb.vgtest  
  gdbserver_tests/mcinvokeWS.vgtest, coregrind/m_gdbserver/README_DEVELOPERS

Patch from Ivo Raisr, slightly modified



git-svn-id: svn://svn.valgrind.org/valgrind/trunk@13743
2013-12-01 14:56:28 +00:00

104 lines
4.2 KiB
C

/*--------------------------------------------------------------------*/
/*--- Declarations common for vgdb and implementations ---*/
/*--- of vgdb-invoker. vgdb.h ---*/
/*--------------------------------------------------------------------*/
/*
This file is part of Valgrind, a dynamic binary instrumentation
framework.
Copyright (C) 2011-2013 Philippe Waroquiers
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation; either version 2 of the
License, or (at your option) any later version.
This program 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
General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
02111-1307, USA.
The GNU General Public License is contained in the file COPYING.
*/
#ifndef __VGDB_H
#define __VGDB_H
#include "pub_core_basics.h"
#include "pub_core_vki.h"
#include "pub_core_gdbserver.h"
#include <sys/types.h>
extern int debuglevel;
extern struct timeval dbgtv;
/* if level <= debuglevel, print timestamp, then print provided by debug info */
#define DEBUG(level, ...) (level <= debuglevel ? \
gettimeofday(&dbgtv, NULL), \
fprintf(stderr, "%ld.%6.6ld ", \
(long int)dbgtv.tv_sec, \
(long int)dbgtv.tv_usec), \
fprintf(stderr, __VA_ARGS__),fflush(stderr) \
: 0)
/* same as DEBUG but does not print time stamp info */
#define PDEBUG(level, ...) (level <= debuglevel ? \
fprintf(stderr, __VA_ARGS__),fflush(stderr) \
: 0)
/* if errno != 0,
report the errno and fprintf the ... varargs on stderr. */
#define ERROR(errno, ...) ((errno == 0 ? 0 : perror("syscall failed")), \
fprintf(stderr, __VA_ARGS__), \
fflush(stderr))
/* same as ERROR, but also exits with status 1 */
#define XERROR(errno, ...) ((errno == 0 ? 0 : perror("syscall failed")), \
fprintf(stderr, __VA_ARGS__), \
fflush(stderr), \
exit(1))
/* Will be set to True when any condition indicating we have to shutdown
is encountered. */
extern Bool shutting_down;
extern VgdbShared32 *shared32;
extern VgdbShared64 *shared64;
/*--------------------------------------------------------------------*/
/*--- Below is vgdb-invoker interface which must be implemented by ---*/
/*--- all vgdb-invoker implementations. ---*/
/*--------------------------------------------------------------------*/
/* Possibly produces additional usage information documenting the
invoker restrictions. */
void invoker_restrictions_msg(void);
/* Restore the registers to the saved value, then detaches from all threads.
Used as a cleanup handler for thread cancellation. */
void invoker_cleanup_restore_and_detach(void *v_pid);
/* Ensures that the gdbserver code is invoked by pid.
If an error occurs, resets the valgrind process
to the state it had before being invoked.
Returns True if invoke successful, False otherwise. */
Bool invoker_invoke_gdbserver(pid_t pid);
/* Called when connection with valgrind is lost. In case we
have lost the connection, it means that Valgrind has closed the
connection and is busy exiting. We can't and don't have to stop it in
this case. */
void invoker_valgrind_dying(void);
#endif // __VGDB_H
/*--------------------------------------------------------------------*/
/*--- end ---*/
/*--------------------------------------------------------------------*/