mirror of
https://github.com/chromium/crashpad.git
synced 2024-12-28 07:48:14 +08:00
1aa478d161
This change was partially scripted and partially done manually with vim regex + manually placing the deleted constructors. The script change looked for destructors in the public: section of a class, if that existed the deleted constructors would go before the destructor. For manual placement I looked for any constructor in the public: section of the corresponding class. If there wasn't one, then it would ideally have gone as the first entry except below enums, classes and typedefs. This may not have been perfect, but is hopefully good enough. Fingers crossed. #include "base/macros.h" is removed from files that don't use ignore_result, which is the only other thing defined in base/macros.h. Bug: chromium:1010217 Change-Id: I099526255a40b1ac1264904b4ece2f3f503c9418 Reviewed-on: https://chromium-review.googlesource.com/c/crashpad/crashpad/+/3171034 Reviewed-by: Mark Mentovai <mark@chromium.org> Commit-Queue: Peter Boström <pbos@chromium.org>
113 lines
3.7 KiB
C++
113 lines
3.7 KiB
C++
// Copyright 2017 The Crashpad Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef CRASHPAD_CLIENT_ANNOTATION_LIST_H_
|
|
#define CRASHPAD_CLIENT_ANNOTATION_LIST_H_
|
|
|
|
#include "build/build_config.h"
|
|
#include "client/annotation.h"
|
|
|
|
namespace crashpad {
|
|
#if defined(OS_IOS)
|
|
namespace internal {
|
|
class InProcessIntermediateDumpHandler;
|
|
} // namespace internal
|
|
#endif
|
|
|
|
//! \brief A list that contains all the currently set annotations.
|
|
//!
|
|
//! An instance of this class must be registered on the \a CrashpadInfo
|
|
//! structure in order to use the annotations system. Once a list object has
|
|
//! been registered on the CrashpadInfo, a different instance should not
|
|
//! be used instead.
|
|
class AnnotationList {
|
|
public:
|
|
AnnotationList();
|
|
|
|
AnnotationList(const AnnotationList&) = delete;
|
|
AnnotationList& operator=(const AnnotationList&) = delete;
|
|
|
|
~AnnotationList();
|
|
|
|
//! \brief Returns the instance of the list that has been registered on the
|
|
//! CrashapdInfo structure.
|
|
static AnnotationList* Get();
|
|
|
|
//! \brief Returns the instace of the list, creating and registering
|
|
//! it if one is not already set on the CrashapdInfo structure.
|
|
static AnnotationList* Register();
|
|
|
|
//! \brief Adds \a annotation to the global list. This method does not need
|
|
//! to be called by clients directly. The Annotation object will do so
|
|
//! automatically.
|
|
//!
|
|
//! Once an annotation is added to the list, it is not removed. This is
|
|
//! because the AnnotationList avoids the use of locks/mutexes, in case it is
|
|
//! being manipulated in a compromised context. Instead, an Annotation keeps
|
|
//! track of when it has been cleared, which excludes it from a crash report.
|
|
//! This design also avoids linear scans of the list when repeatedly setting
|
|
//! and/or clearing the value.
|
|
void Add(Annotation* annotation);
|
|
|
|
//! \brief An InputIterator for the AnnotationList.
|
|
class Iterator {
|
|
public:
|
|
~Iterator();
|
|
|
|
Annotation* operator*() const;
|
|
Iterator& operator++();
|
|
bool operator==(const Iterator& other) const;
|
|
bool operator!=(const Iterator& other) const { return !(*this == other); }
|
|
|
|
private:
|
|
friend class AnnotationList;
|
|
Iterator(Annotation* head, const Annotation* tail);
|
|
|
|
Annotation* curr_;
|
|
const Annotation* const tail_;
|
|
|
|
// Copy and assign are required.
|
|
};
|
|
|
|
//! \brief Returns an iterator to the first element of the annotation list.
|
|
Iterator begin();
|
|
|
|
//! \brief Returns an iterator past the last element of the annotation list.
|
|
Iterator end();
|
|
|
|
protected:
|
|
#if defined(OS_IOS)
|
|
friend class internal::InProcessIntermediateDumpHandler;
|
|
#endif
|
|
|
|
//! \brief Returns a pointer to the tail node.
|
|
const Annotation* tail_pointer() const { return tail_pointer_; }
|
|
|
|
//! \brief Returns a pointer to the head element.
|
|
const Annotation* head() const { return &head_; }
|
|
|
|
private:
|
|
// To make it easier for the handler to locate the dummy tail node, store the
|
|
// pointer. Placed first for packing.
|
|
const Annotation* const tail_pointer_;
|
|
|
|
// Dummy linked-list head and tail elements of \a Annotation::Type::kInvalid.
|
|
Annotation head_;
|
|
Annotation tail_;
|
|
};
|
|
|
|
} // namespace crashpad
|
|
|
|
#endif // CRASHPAD_CLIENT_ANNOTATION_LIST_H_
|