1ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 2ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/ 3ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--- Create initial process image on for the client ---*/ 4ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--- pub_core_initimg.h ---*/ 5ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/ 6ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 7ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* 8ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown This file is part of Valgrind, a dynamic binary instrumentation 9ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown framework. 10ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 11b32f58018498ea2225959b0ba11c18f0c433deefEvgeniy Stepanov Copyright (C) 2006-2011 OpenWorks LLP 12ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown info@open-works.co.uk 13ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 14ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown This program is free software; you can redistribute it and/or 15ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown modify it under the terms of the GNU General Public License as 16ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown published by the Free Software Foundation; either version 2 of the 17ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown License, or (at your option) any later version. 18ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 19ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown This program is distributed in the hope that it will be useful, but 20ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown WITHOUT ANY WARRANTY; without even the implied warranty of 21ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 22ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown General Public License for more details. 23ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 24ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown You should have received a copy of the GNU General Public License 25ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown along with this program; if not, write to the Free Software 26ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 27ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 02111-1307, USA. 28ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 29ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown The GNU General Public License is contained in the file COPYING. 30ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown*/ 31ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 32ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#ifndef __PUB_CORE_INITIMG_H 33ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#define __PUB_CORE_INITIMG_H 34ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 35ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 36ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown//-------------------------------------------------------------------- 37ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// PURPOSE: Map the client executable into memory, then set up its 38ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown// stack, environment and data section, ready for execution. Quite a 39b32f58018498ea2225959b0ba11c18f0c433deefEvgeniy Stepanov// lot of work on Linux (ELF). 40ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown//-------------------------------------------------------------------- 41ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 42ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* These are OS-specific and defined below. */ 43ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Browntypedef struct _IICreateImageInfo IICreateImageInfo; 44ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Browntypedef struct _IIFinaliseImageInfo IIFinaliseImageInfo; 45ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 46ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* This is a two stage process. The first stage, which is most of the 47ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown work, creates the initial image in memory to the extent possible. 48ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown To do this it takes a bundle of information in an IICreateImageInfo 49ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown structure, which is gathered in an OS-specific way at startup. 50ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown This returns an IIFinaliseImageInfo structure: */ 51ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern 52ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff BrownIIFinaliseImageInfo VG_(ii_create_image)( IICreateImageInfo ); 53ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 54ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* Just before starting the client, we may need to make final 55ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown adjustments to its initial image. Also we need to set up the VEX 56ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown guest state for thread 1 (the root thread) and copy in essential 57ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown starting values. This is handed the IIFinaliseImageInfo created by 58ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown VG_(ii_create_image). */ 59ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownextern 60ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownvoid VG_(ii_finalise_image)( IIFinaliseImageInfo ); 61ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 62ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* Note that both IICreateImageInfo and IIFinaliseImageInfo are 63ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown OS-specific. We now go on to give instantiations of them 64ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown for supported OSes. */ 65ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 66ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* ------------------------- Linux ------------------------- */ 67ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 68ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#if defined(VGO_linux) 69ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 70ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownstruct _IICreateImageInfo { 71ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Mandatory fields ------ */ 72ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar* toolname; 73ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr sp_at_startup; 74ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr clstack_top; 75ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Per-OS fields ------ */ 76ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar** argv; 77ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar** envp; 78ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown}; 79ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 80ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownstruct _IIFinaliseImageInfo { 81ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Mandatory fields ------ */ 82ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown SizeT clstack_max_size; 83ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr initial_client_SP; 84ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Per-OS fields ------ */ 85ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr initial_client_IP; 86ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr initial_client_TOC; 87ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown UInt* client_auxv; 88ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown}; 89ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 90ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/* ------------------------- Darwin ------------------------- */ 91ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 92ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#elif defined(VGO_darwin) 93ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 94ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownstruct _IICreateImageInfo { 95ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Mandatory fields ------ */ 96ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar* toolname; 97ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr sp_at_startup; 98ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr clstack_top; 99ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Per-OS fields ------ */ 100ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar** argv; 101ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar** envp; 102ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr entry; /* &_start */ 103ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr init_ip; /* &__dyld_start, or copy of entry */ 104ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr stack_start; /* stack segment hot */ 105ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr stack_end; /* stack segment cold */ 106ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr text; /* executable's Mach header */ 107ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Bool dynamic; /* False iff executable is static */ 108ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown HChar* executable_path; /* path passed to execve() */ 109ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown}; 110ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 111ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brownstruct _IIFinaliseImageInfo { 112ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Mandatory fields ------ */ 113ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown SizeT clstack_max_size; 114ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr initial_client_SP; 115ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown /* ------ Per-OS fields ------ */ 116ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown Addr initial_client_IP; 117ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown}; 118ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 119ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 120ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#else 121ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown# error "Unknown OS" 122ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#endif 123ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 124ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 125ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown#endif // __PUB_CORE_INITIMG_H 126ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown 127ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/ 128ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--- end ---*/ 129ed07e00d438c74b7a23c01bfffde77e3968305e4Jeff Brown/*--------------------------------------------------------------------*/ 130