2 * \file trc_mem_acc_file.cpp
5 * \copyright Copyright (c) 2015, ARM Limited. All Rights Reserved.
8 * Redistribution and use in source and binary forms, with or without modification,
9 * are permitted provided that the following conditions are met:
11 * 1. Redistributions of source code must retain the above copyright notice,
12 * this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright notice,
15 * this list of conditions and the following disclaimer in the documentation
16 * and/or other materials provided with the distribution.
18 * 3. Neither the name of the copyright holder nor the names of its contributors
19 * may be used to endorse or promote products derived from this software without
20 * specific prior written permission.
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' AND
23 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
24 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
25 * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
26 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
27 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
28 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
29 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
31 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
34 #include "mem_acc/trc_mem_acc_file.h"
39 /***************************************************/
40 /* protected construction and reference counting */
41 /***************************************************/
43 TrcMemAccessorFile::TrcMemAccessorFile() : TrcMemAccessorBase(MEMACC_FILE)
46 m_base_range_set = false;
47 m_has_access_regions = false;
51 TrcMemAccessorFile::~TrcMemAccessorFile()
53 if(m_mem_file.is_open())
55 if(m_access_regions.size())
57 std::list<FileRegionMemAccessor *>::iterator it;
58 it = m_access_regions.begin();
59 while(it != m_access_regions.end())
64 m_access_regions.clear();
68 ocsd_err_t TrcMemAccessorFile::initAccessor(const std::string &pathToFile, ocsd_vaddr_t startAddr, size_t offset, size_t size)
70 ocsd_err_t err = OCSD_OK;
73 m_mem_file.open(pathToFile.c_str(), std::ifstream::binary | std::ifstream::ate);
74 if(m_mem_file.is_open())
76 m_file_size = (ocsd_vaddr_t)m_mem_file.tellg() & ((ocsd_vaddr_t)~0x1);
77 m_mem_file.seekg(0, m_mem_file.beg);
78 // adding an offset of 0, sets the base range.
79 if((offset == 0) && (size == 0))
81 init = AddOffsetRange(startAddr, ((size_t)m_file_size)-offset, offset);
83 else if((offset + size) <= m_file_size)
85 // if offset != 0, size must by != 0
86 init = AddOffsetRange(startAddr, size, offset);
88 m_file_path = pathToFile;
91 err = OCSD_ERR_MEM_ACC_FILE_NOT_FOUND;
93 err = OCSD_ERR_NOT_INIT;
98 FileRegionMemAccessor *TrcMemAccessorFile::getRegionForAddress(const ocsd_vaddr_t startAddr) const
100 FileRegionMemAccessor *p_region = 0;
101 if(m_has_access_regions)
103 std::list<FileRegionMemAccessor *>::const_iterator it;
104 it = m_access_regions.begin();
105 while((it != m_access_regions.end()) && (p_region == 0))
107 if((*it)->addrInRange(startAddr))
116 /***************************************************/
117 /* static object creation */
118 /***************************************************/
120 std::map<std::string, TrcMemAccessorFile *> TrcMemAccessorFile::s_FileAccessorMap;
122 // return existing or create new accessor
123 ocsd_err_t TrcMemAccessorFile::createFileAccessor(TrcMemAccessorFile **p_acc, const std::string &pathToFile, ocsd_vaddr_t startAddr, size_t offset /*= 0*/, size_t size /*= 0*/)
125 ocsd_err_t err = OCSD_OK;
126 TrcMemAccessorFile * acc = 0;
127 std::map<std::string, TrcMemAccessorFile *>::iterator it = s_FileAccessorMap.find(pathToFile);
128 if(it != s_FileAccessorMap.end())
131 if(acc->addrStartOfRange(startAddr))
135 err = OCSD_ERR_MEM_ACC_FILE_DIFF_RANGE;
141 acc = new (std::nothrow) TrcMemAccessorFile();
144 if((err = acc->initAccessor(pathToFile,startAddr, offset,size)) == OCSD_OK)
147 s_FileAccessorMap.insert(std::pair<std::string, TrcMemAccessorFile *>(pathToFile,acc));
162 void TrcMemAccessorFile::destroyFileAccessor(TrcMemAccessorFile *p_accessor)
166 p_accessor->DecRefCount();
167 if(p_accessor->getRefCount() == 0)
169 std::map<std::string, TrcMemAccessorFile *>::iterator it = s_FileAccessorMap.find(p_accessor->getFilePath());
170 if(it != s_FileAccessorMap.end())
172 s_FileAccessorMap.erase(it);
179 const bool TrcMemAccessorFile::isExistingFileAccessor(const std::string &pathToFile)
181 bool bExists = false;
182 std::map<std::string, TrcMemAccessorFile *>::const_iterator it = s_FileAccessorMap.find(pathToFile);
183 if(it != s_FileAccessorMap.end())
188 TrcMemAccessorFile * TrcMemAccessorFile::getExistingFileAccessor(const std::string &pathToFile)
190 TrcMemAccessorFile * p_acc = 0;
191 std::map<std::string, TrcMemAccessorFile *>::iterator it = s_FileAccessorMap.find(pathToFile);
192 if(it != s_FileAccessorMap.end())
199 /***************************************************/
200 /* accessor instance functions */
201 /***************************************************/
202 const uint32_t TrcMemAccessorFile::readBytes(const ocsd_vaddr_t address, const ocsd_mem_space_acc_t mem_space, const uint8_t trcID, const uint32_t reqBytes, uint8_t *byteBuffer)
204 if(!m_mem_file.is_open())
206 uint32_t bytesRead = 0;
210 bytesRead = TrcMemAccessorBase::bytesInRange(address,reqBytes); // get avialable bytes in range.
213 ocsd_vaddr_t addr_pos = (ocsd_vaddr_t)m_mem_file.tellg();
214 if((address - m_startAddress) != addr_pos)
215 m_mem_file.seekg(address - m_startAddress);
216 m_mem_file.read((char *)byteBuffer,bytesRead);
220 if((bytesRead == 0) && m_has_access_regions)
222 bytesRead = bytesInRange(address,reqBytes);
225 FileRegionMemAccessor *p_region = getRegionForAddress(address);
226 ocsd_vaddr_t addr_pos = (ocsd_vaddr_t)m_mem_file.tellg();
227 if((address - p_region->regionStartAddress() + p_region->getOffset()) != addr_pos)
228 m_mem_file.seekg(address - p_region->regionStartAddress() + p_region->getOffset());
229 m_mem_file.read((char *)byteBuffer,bytesRead);
235 bool TrcMemAccessorFile::AddOffsetRange(const ocsd_vaddr_t startAddr, const size_t size, const size_t offset)
238 if(m_file_size == 0) // must have set the file size
240 if(addrInRange(startAddr) || addrInRange(startAddr+size-1)) // cannot be overlapping
243 // now either set the base range or an offset range
246 if(!m_base_range_set)
248 setRange(startAddr, startAddr+size-1);
249 m_base_range_set = true;
255 if((offset + size) <= m_file_size)
257 FileRegionMemAccessor *frmacc = new (std::nothrow) FileRegionMemAccessor();
260 frmacc->setOffset(offset);
261 frmacc->setRange(startAddr,startAddr+size-1);
262 m_access_regions.push_back(frmacc);
263 m_access_regions.sort();
264 // may need to trim the 0 offset base range...
267 std::list<FileRegionMemAccessor *>::iterator it;
268 it = m_access_regions.begin();
269 size_t first_range_offset = (*it)->getOffset();
270 if((m_startAddress + first_range_offset - 1) > m_endAddress)
271 m_endAddress = m_startAddress + first_range_offset - 1;
274 m_has_access_regions = true;
281 const bool TrcMemAccessorFile::addrInRange(const ocsd_vaddr_t s_address) const
283 bool bInRange = false;
285 bInRange = TrcMemAccessorBase::addrInRange(s_address);
287 if(!bInRange && m_has_access_regions)
289 if(getRegionForAddress(s_address) != 0)
295 const bool TrcMemAccessorFile::addrStartOfRange(const ocsd_vaddr_t s_address) const
297 bool bInRange = false;
299 bInRange = TrcMemAccessorBase::addrStartOfRange(s_address);
300 if(!bInRange && m_has_access_regions)
302 FileRegionMemAccessor *pRegion = getRegionForAddress(s_address);
304 bInRange = (pRegion->regionStartAddress() == s_address);
310 /* validate ranges */
311 const bool TrcMemAccessorFile::validateRange()
313 bool bRangeValid = true;
315 bRangeValid = TrcMemAccessorBase::validateRange();
317 if(m_has_access_regions && bRangeValid)
319 std::list<FileRegionMemAccessor *>::const_iterator it;
320 it = m_access_regions.begin();
321 while((it != m_access_regions.end()) && bRangeValid)
323 bRangeValid = (*it)->validateRange();
330 const uint32_t TrcMemAccessorFile::bytesInRange(const ocsd_vaddr_t s_address, const uint32_t reqBytes) const
332 uint32_t bytesInRange = 0;
334 bytesInRange = TrcMemAccessorBase::bytesInRange(s_address,reqBytes);
336 if((bytesInRange == 0) && (m_has_access_regions))
338 FileRegionMemAccessor *p_region = getRegionForAddress(s_address);
339 bytesInRange = p_region->bytesInRange(s_address,reqBytes);
345 const bool TrcMemAccessorFile::overLapRange(const TrcMemAccessorBase *p_test_acc) const
347 bool bOverLapRange = false;
349 bOverLapRange = TrcMemAccessorBase::overLapRange(p_test_acc);
351 if(!bOverLapRange && (m_has_access_regions))
353 std::list<FileRegionMemAccessor *>::const_iterator it;
354 it = m_access_regions.begin();
355 while((it != m_access_regions.end()) && !bOverLapRange)
357 bOverLapRange = (*it)->overLapRange(p_test_acc);
361 return bOverLapRange;
364 /*! Override to handle ranges and offset accessors plus add in file name. */
365 void TrcMemAccessorFile::getMemAccString(std::string &accStr) const
367 std::ostringstream oss;
371 TrcMemAccessorBase::getMemAccString(accStr);
374 if(m_has_access_regions)
377 std::list<FileRegionMemAccessor *>::const_iterator it;
378 it = m_access_regions.begin();
379 while(it != m_access_regions.end())
381 (*it)->getMemAccString(addStr);
388 accStr += (std::string)"\nFilename=" + m_file_path;
391 /* End of File trc_mem_acc_file.cpp */