process.hh revision 1762
15124Sgblack@eecs.umich.edu/* 27087Snate@binkert.org * Copyright (c) 2001-2005 The Regents of The University of Michigan 37087Snate@binkert.org * All rights reserved. 47087Snate@binkert.org * 57087Snate@binkert.org * Redistribution and use in source and binary forms, with or without 67087Snate@binkert.org * modification, are permitted provided that the following conditions are 77087Snate@binkert.org * met: redistributions of source code must retain the above copyright 87087Snate@binkert.org * notice, this list of conditions and the following disclaimer; 97087Snate@binkert.org * redistributions in binary form must reproduce the above copyright 107087Snate@binkert.org * notice, this list of conditions and the following disclaimer in the 117087Snate@binkert.org * documentation and/or other materials provided with the distribution; 127087Snate@binkert.org * neither the name of the copyright holders nor the names of its 137087Snate@binkert.org * contributors may be used to endorse or promote products derived from 145124Sgblack@eecs.umich.edu * this software without specific prior written permission. 155124Sgblack@eecs.umich.edu * 165124Sgblack@eecs.umich.edu * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 175124Sgblack@eecs.umich.edu * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 185124Sgblack@eecs.umich.edu * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 195124Sgblack@eecs.umich.edu * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 205124Sgblack@eecs.umich.edu * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 215124Sgblack@eecs.umich.edu * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 225124Sgblack@eecs.umich.edu * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 235124Sgblack@eecs.umich.edu * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 245124Sgblack@eecs.umich.edu * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 255124Sgblack@eecs.umich.edu * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 265124Sgblack@eecs.umich.edu * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 275124Sgblack@eecs.umich.edu */ 285124Sgblack@eecs.umich.edu 295124Sgblack@eecs.umich.edu#ifndef __PROCESS_HH__ 305124Sgblack@eecs.umich.edu#define __PROCESS_HH__ 315124Sgblack@eecs.umich.edu 325124Sgblack@eecs.umich.edu// 335124Sgblack@eecs.umich.edu// The purpose of this code is to fake the loader & syscall mechanism 345124Sgblack@eecs.umich.edu// when there's no OS: thus there's no reason to use it in FULL_SYSTEM 355124Sgblack@eecs.umich.edu// mode when we do have an OS. 365124Sgblack@eecs.umich.edu// 375124Sgblack@eecs.umich.edu#ifndef FULL_SYSTEM 385124Sgblack@eecs.umich.edu 395124Sgblack@eecs.umich.edu#include <vector> 405124Sgblack@eecs.umich.edu 415124Sgblack@eecs.umich.edu#include "targetarch/isa_traits.hh" 425124Sgblack@eecs.umich.edu#include "sim/sim_object.hh" 435681Sgblack@eecs.umich.edu#include "sim/stats.hh" 445124Sgblack@eecs.umich.edu#include "base/statistics.hh" 458740Sgblack@eecs.umich.edu#include "base/trace.hh" 465124Sgblack@eecs.umich.edu 475124Sgblack@eecs.umich.educlass ExecContext; 488232Snate@binkert.orgclass FunctionalMemory; 498740Sgblack@eecs.umich.educlass Process : public SimObject 505124Sgblack@eecs.umich.edu{ 515124Sgblack@eecs.umich.edu public: 525124Sgblack@eecs.umich.edu 537678Sgblack@eecs.umich.edu // have we initialized an execution context from this process? If 545124Sgblack@eecs.umich.edu // yes, subsequent contexts are assumed to be for dynamically 558806Sgblack@eecs.umich.edu // created threads and are not initialized. 568806Sgblack@eecs.umich.edu bool initialContextLoaded; 578806Sgblack@eecs.umich.edu 588806Sgblack@eecs.umich.edu // execution contexts associated with this process 598806Sgblack@eecs.umich.edu std::vector<ExecContext *> execContexts; 608806Sgblack@eecs.umich.edu 618806Sgblack@eecs.umich.edu // number of CPUs (esxec contexts, really) assigned to this process. 628806Sgblack@eecs.umich.edu unsigned int numCpus() { return execContexts.size(); } 638806Sgblack@eecs.umich.edu 648806Sgblack@eecs.umich.edu // record of blocked context 658806Sgblack@eecs.umich.edu struct WaitRec 668806Sgblack@eecs.umich.edu { 678806Sgblack@eecs.umich.edu Addr waitChan; 688806Sgblack@eecs.umich.edu ExecContext *waitingContext; 698806Sgblack@eecs.umich.edu 708806Sgblack@eecs.umich.edu WaitRec(Addr chan, ExecContext *ctx) 718806Sgblack@eecs.umich.edu : waitChan(chan), waitingContext(ctx) 728806Sgblack@eecs.umich.edu { 738806Sgblack@eecs.umich.edu } 748806Sgblack@eecs.umich.edu }; 758806Sgblack@eecs.umich.edu 768806Sgblack@eecs.umich.edu // list of all blocked contexts 778806Sgblack@eecs.umich.edu std::list<WaitRec> waitList; 788806Sgblack@eecs.umich.edu 798740Sgblack@eecs.umich.edu RegFile *init_regs; // initial register contents 808806Sgblack@eecs.umich.edu 815858Sgblack@eecs.umich.edu Addr text_base; // text (code) segment base 828806Sgblack@eecs.umich.edu unsigned text_size; // text (code) size in bytes 838806Sgblack@eecs.umich.edu 845858Sgblack@eecs.umich.edu Addr data_base; // initialized data segment base 858806Sgblack@eecs.umich.edu unsigned data_size; // initialized data + bss size in bytes 868806Sgblack@eecs.umich.edu 878806Sgblack@eecs.umich.edu Addr brk_point; // top of the data segment 888806Sgblack@eecs.umich.edu 895681Sgblack@eecs.umich.edu Addr stack_base; // stack segment base (highest address) 908806Sgblack@eecs.umich.edu unsigned stack_size; // initial stack size 918806Sgblack@eecs.umich.edu Addr stack_min; // lowest address accessed on the stack 928806Sgblack@eecs.umich.edu 935124Sgblack@eecs.umich.edu // addr to use for next stack region (for multithreaded apps) 945909Sgblack@eecs.umich.edu Addr next_thread_stack_base; 955909Sgblack@eecs.umich.edu 965909Sgblack@eecs.umich.edu // Base of region for mmaps (when user doesn't specify an address). 975909Sgblack@eecs.umich.edu Addr mmap_start; 985909Sgblack@eecs.umich.edu Addr mmap_end; 995909Sgblack@eecs.umich.edu 1005909Sgblack@eecs.umich.edu // Base of region for nxm data 1015909Sgblack@eecs.umich.edu Addr nxm_start; 1025909Sgblack@eecs.umich.edu Addr nxm_end; 1035909Sgblack@eecs.umich.edu 1045909Sgblack@eecs.umich.edu std::string prog_fname; // file name 1055909Sgblack@eecs.umich.edu Addr prog_entry; // entry point (initial PC) 1065858Sgblack@eecs.umich.edu 1077678Sgblack@eecs.umich.edu Stats::Scalar<> num_syscalls; // number of syscalls executed 1085858Sgblack@eecs.umich.edu 1095858Sgblack@eecs.umich.edu 1108806Sgblack@eecs.umich.edu protected: 1118806Sgblack@eecs.umich.edu // constructor 1128806Sgblack@eecs.umich.edu Process(const std::string &nm, 1138806Sgblack@eecs.umich.edu int stdin_fd, // initial I/O descriptors 1148806Sgblack@eecs.umich.edu int stdout_fd, 1158806Sgblack@eecs.umich.edu int stderr_fd); 1168806Sgblack@eecs.umich.edu 1175858Sgblack@eecs.umich.edu // post initialization startup 1185858Sgblack@eecs.umich.edu virtual void startup(); 1197678Sgblack@eecs.umich.edu 1205858Sgblack@eecs.umich.edu protected: 1215858Sgblack@eecs.umich.edu FunctionalMemory *memory; 1225858Sgblack@eecs.umich.edu 1235858Sgblack@eecs.umich.edu private: 1248740Sgblack@eecs.umich.edu // file descriptor remapping support 1258740Sgblack@eecs.umich.edu static const int MAX_FD = 100; // max legal fd value 1268740Sgblack@eecs.umich.edu int fd_map[MAX_FD+1]; 1278740Sgblack@eecs.umich.edu 1288740Sgblack@eecs.umich.edu public: 1298740Sgblack@eecs.umich.edu // static helper functions to generate file descriptors for constructor 1308740Sgblack@eecs.umich.edu static int openInputFile(const std::string &filename); 1318740Sgblack@eecs.umich.edu static int openOutputFile(const std::string &filename); 1328740Sgblack@eecs.umich.edu 1338740Sgblack@eecs.umich.edu // override of virtual SimObject method: register statistics 1348740Sgblack@eecs.umich.edu virtual void regStats(); 1357678Sgblack@eecs.umich.edu 1365858Sgblack@eecs.umich.edu // register an execution context for this process. 1378740Sgblack@eecs.umich.edu // returns xc's cpu number (index into execContexts[]) 1388740Sgblack@eecs.umich.edu int registerExecContext(ExecContext *xc); 1398740Sgblack@eecs.umich.edu 1408740Sgblack@eecs.umich.edu 1418740Sgblack@eecs.umich.edu void replaceExecContext(ExecContext *xc, int xcIndex); 1428740Sgblack@eecs.umich.edu 1438740Sgblack@eecs.umich.edu // map simulator fd sim_fd to target fd tgt_fd 1448740Sgblack@eecs.umich.edu void dup_fd(int sim_fd, int tgt_fd); 1458740Sgblack@eecs.umich.edu 1468740Sgblack@eecs.umich.edu // generate new target fd for sim_fd 1478740Sgblack@eecs.umich.edu int open_fd(int sim_fd); 1488740Sgblack@eecs.umich.edu 1498740Sgblack@eecs.umich.edu // look up simulator fd for given target fd 1508740Sgblack@eecs.umich.edu int sim_fd(int tgt_fd); 1515858Sgblack@eecs.umich.edu 1528740Sgblack@eecs.umich.edu // is this a valid instruction fetch address? 1538740Sgblack@eecs.umich.edu bool validInstAddr(Addr addr) 1548740Sgblack@eecs.umich.edu { 1558740Sgblack@eecs.umich.edu return (text_base <= addr && 1568740Sgblack@eecs.umich.edu addr < text_base + text_size && 1578740Sgblack@eecs.umich.edu !(addr & (sizeof(MachInst)-1))); 1588740Sgblack@eecs.umich.edu } 1598740Sgblack@eecs.umich.edu 1608740Sgblack@eecs.umich.edu // is this a valid address? (used to filter data fetches) 1615858Sgblack@eecs.umich.edu // note that we just assume stack size <= 16MB 1625858Sgblack@eecs.umich.edu // this may be alpha-specific 1635237Sgblack@eecs.umich.edu bool validDataAddr(Addr addr) 1645909Sgblack@eecs.umich.edu { 1655909Sgblack@eecs.umich.edu return ((data_base <= addr && addr < brk_point) || 1665909Sgblack@eecs.umich.edu (next_thread_stack_base <= addr && addr < stack_base) || 1675909Sgblack@eecs.umich.edu (text_base <= addr && addr < (text_base + text_size)) || 1685909Sgblack@eecs.umich.edu (mmap_start <= addr && addr < mmap_end) || 1695909Sgblack@eecs.umich.edu (nxm_start <= addr && addr < nxm_end)); 1705909Sgblack@eecs.umich.edu } 1715909Sgblack@eecs.umich.edu 1726048Sgblack@eecs.umich.edu virtual void syscall(ExecContext *xc) = 0; 1737678Sgblack@eecs.umich.edu 1746048Sgblack@eecs.umich.edu virtual FunctionalMemory *getMemory() { return memory; } 1756048Sgblack@eecs.umich.edu}; 1766048Sgblack@eecs.umich.edu 1776048Sgblack@eecs.umich.edu// 1786048Sgblack@eecs.umich.edu// "Live" process with system calls redirected to host system 1796048Sgblack@eecs.umich.edu// 1806048Sgblack@eecs.umich.educlass ObjectFile; 1816048Sgblack@eecs.umich.educlass LiveProcess : public Process 1826048Sgblack@eecs.umich.edu{ 1836048Sgblack@eecs.umich.edu protected: 1846048Sgblack@eecs.umich.edu LiveProcess(const std::string &nm, ObjectFile *objFile, 1856048Sgblack@eecs.umich.edu int stdin_fd, int stdout_fd, int stderr_fd, 1866048Sgblack@eecs.umich.edu std::vector<std::string> &argv, 1876048Sgblack@eecs.umich.edu std::vector<std::string> &envp); 1886048Sgblack@eecs.umich.edu 1896048Sgblack@eecs.umich.edu public: 1906048Sgblack@eecs.umich.edu // this function is used to create the LiveProcess object, since 1916048Sgblack@eecs.umich.edu // we can't tell which subclass of LiveProcess to use until we 1926048Sgblack@eecs.umich.edu // open and look at the object file. 1936048Sgblack@eecs.umich.edu static LiveProcess *create(const std::string &nm, 1946048Sgblack@eecs.umich.edu int stdin_fd, int stdout_fd, int stderr_fd, 1956222Sgblack@eecs.umich.edu std::vector<std::string> &argv, 1966222Sgblack@eecs.umich.edu std::vector<std::string> &envp); 1976222Sgblack@eecs.umich.edu}; 1986222Sgblack@eecs.umich.edu 1996222Sgblack@eecs.umich.edu 2006222Sgblack@eecs.umich.edu#endif // !FULL_SYSTEM 2016222Sgblack@eecs.umich.edu 2026222Sgblack@eecs.umich.edu#endif // __PROCESS_HH__ 2036048Sgblack@eecs.umich.edu