toolkit/crashreporter/google-breakpad/src/processor/static_range_map.h

changeset 0
6474c204b198
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/toolkit/crashreporter/google-breakpad/src/processor/static_range_map.h	Wed Dec 31 06:09:35 2014 +0100
     1.3 @@ -0,0 +1,106 @@
     1.4 +// Copyright (c) 2010, Google Inc.
     1.5 +// All rights reserved.
     1.6 +//
     1.7 +// Redistribution and use in source and binary forms, with or without
     1.8 +// modification, are permitted provided that the following conditions are
     1.9 +// met:
    1.10 +//
    1.11 +//     * Redistributions of source code must retain the above copyright
    1.12 +// notice, this list of conditions and the following disclaimer.
    1.13 +//     * Redistributions in binary form must reproduce the above
    1.14 +// copyright notice, this list of conditions and the following disclaimer
    1.15 +// in the documentation and/or other materials provided with the
    1.16 +// distribution.
    1.17 +//     * Neither the name of Google Inc. nor the names of its
    1.18 +// contributors may be used to endorse or promote products derived from
    1.19 +// this software without specific prior written permission.
    1.20 +//
    1.21 +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
    1.22 +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
    1.23 +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
    1.24 +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
    1.25 +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
    1.26 +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
    1.27 +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
    1.28 +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
    1.29 +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
    1.30 +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
    1.31 +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
    1.32 +//
    1.33 +// static_range_map.h: StaticRangeMap.
    1.34 +//
    1.35 +// StaticRangeMap is similar as RangeMap.  However, StaticRangeMap wraps a
    1.36 +// StaticMap instead of std::map, and does not support dynamic operations like
    1.37 +// StoreRange(...).  StaticRangeMap provides same Retrieve*() interfaces as
    1.38 +// RangeMap.  Please see range_map.h for more documentation.
    1.39 +//
    1.40 +// Author: Siyang Xie (lambxsy@google.com)
    1.41 +
    1.42 +#ifndef PROCESSOR_STATIC_RANGE_MAP_H__
    1.43 +#define PROCESSOR_STATIC_RANGE_MAP_H__
    1.44 +
    1.45 +
    1.46 +#include "processor/static_map-inl.h"
    1.47 +
    1.48 +namespace google_breakpad {
    1.49 +
    1.50 +// AddressType is basic type, e.g.: integer types, pointers etc
    1.51 +// EntryType could be a complex type, so we retrieve its pointer instead.
    1.52 +template<typename AddressType, typename EntryType>
    1.53 +class StaticRangeMap {
    1.54 + public:
    1.55 +  StaticRangeMap(): map_() { }
    1.56 +  explicit StaticRangeMap(const char *memory): map_(memory) { }
    1.57 +
    1.58 +  // Locates the range encompassing the supplied address.  If there is
    1.59 +  // no such range, returns false.  entry_base and entry_size, if non-NULL,
    1.60 +  // are set to the base and size of the entry's range.
    1.61 +  bool RetrieveRange(const AddressType &address, const EntryType *&entry,
    1.62 +                     AddressType *entry_base, AddressType *entry_size) const;
    1.63 +
    1.64 +  // Locates the range encompassing the supplied address, if one exists.
    1.65 +  // If no range encompasses the supplied address, locates the nearest range
    1.66 +  // to the supplied address that is lower than the address.  Returns false
    1.67 +  // if no range meets these criteria.  entry_base and entry_size, if
    1.68 +  // non-NULL, are set to the base and size of the entry's range.
    1.69 +  bool RetrieveNearestRange(const AddressType &address, const EntryType *&entry,
    1.70 +                            AddressType *entry_base, AddressType *entry_size)
    1.71 +                            const;
    1.72 +
    1.73 +  // Treating all ranges as a list ordered by the address spaces that they
    1.74 +  // occupy, locates the range at the index specified by index.  Returns
    1.75 +  // false if index is larger than the number of ranges stored.  entry_base
    1.76 +  // and entry_size, if non-NULL, are set to the base and size of the entry's
    1.77 +  // range.
    1.78 +  //
    1.79 +  // RetrieveRangeAtIndex is not optimized for speedy operation.
    1.80 +  bool RetrieveRangeAtIndex(int index, const EntryType *&entry,
    1.81 +                            AddressType *entry_base, AddressType *entry_size)
    1.82 +                            const;
    1.83 +
    1.84 +  // Returns the number of ranges stored in the RangeMap.
    1.85 +  inline int GetCount() const { return map_.size(); }
    1.86 +
    1.87 + private:
    1.88 +  friend class ModuleComparer;
    1.89 +  class Range {
    1.90 +   public:
    1.91 +    AddressType base() const {
    1.92 +      return *(reinterpret_cast<const AddressType*>(this));
    1.93 +    }
    1.94 +    const EntryType* entryptr() const {
    1.95 +      return reinterpret_cast<const EntryType*>(this + sizeof(AddressType));
    1.96 +    }
    1.97 +  };
    1.98 +
    1.99 +  // Convenience types.
   1.100 +  typedef StaticRangeMap* SelfPtr;
   1.101 +  typedef StaticMap<AddressType, Range> AddressToRangeMap;
   1.102 +  typedef typename AddressToRangeMap::const_iterator MapConstIterator;
   1.103 +
   1.104 +  AddressToRangeMap map_;
   1.105 +};
   1.106 +
   1.107 +}  // namespace google_breakpad
   1.108 +
   1.109 +#endif  // PROCESSOR_STATIC_RANGE_MAP_H__

mercurial