mirror of
https://github.com/chromium/crashpad.git
synced 2025-03-10 06:36:02 +00:00
a0f5dc62a4
Some annotations will exist at a broader scope than per-module, which is the only place that annotations can currently be stored. The product name and version are not under the control of any module, but are established when the first Crashpad client establishes a handler. These annotations will be stored in a minidump’s MinidumpCrashpadInfo structure, which applies to the entire minidump. Within the snapshot interface, this data is carried within the “process” snapshot because it is the top-level structure in that family. Note that the data may not correspond directly with a process, however. TEST=minidump_test MinidumpCrashpadInfoWriter.* R=rsesek@chromium.org Review URL: https://codereview.chromium.org/924673003
124 lines
4.6 KiB
C++
124 lines
4.6 KiB
C++
// Copyright 2014 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_SNAPSHOT_MAC_PROCESS_SNAPSHOT_MAC_H_
|
||
#define CRASHPAD_SNAPSHOT_MAC_PROCESS_SNAPSHOT_MAC_H_
|
||
|
||
#include <mach/mach.h>
|
||
#include <sys/time.h>
|
||
#include <unistd.h>
|
||
|
||
#include <map>
|
||
#include <string>
|
||
#include <vector>
|
||
|
||
#include "base/basictypes.h"
|
||
#include "base/memory/scoped_ptr.h"
|
||
#include "snapshot/exception_snapshot.h"
|
||
#include "snapshot/mac/exception_snapshot_mac.h"
|
||
#include "snapshot/mac/module_snapshot_mac.h"
|
||
#include "snapshot/mac/process_reader.h"
|
||
#include "snapshot/mac/system_snapshot_mac.h"
|
||
#include "snapshot/mac/thread_snapshot_mac.h"
|
||
#include "snapshot/module_snapshot.h"
|
||
#include "snapshot/process_snapshot.h"
|
||
#include "snapshot/system_snapshot.h"
|
||
#include "snapshot/thread_snapshot.h"
|
||
#include "util/misc/initialization_state_dcheck.h"
|
||
#include "util/stdlib/pointer_container.h"
|
||
|
||
namespace crashpad {
|
||
|
||
//! \brief A ProcessSnapshot of a running (or crashed) process running on a Mac
|
||
//! OS X system.
|
||
class ProcessSnapshotMac final : public ProcessSnapshot {
|
||
public:
|
||
ProcessSnapshotMac();
|
||
~ProcessSnapshotMac() override;
|
||
|
||
//! \brief Initializes the object.
|
||
//!
|
||
//! \param[in] task The task to create a snapshot from.
|
||
//!
|
||
//! \return `true` if the snapshot could be created, `false` otherwise with
|
||
//! an appropriate message logged.
|
||
bool Initialize(task_t task);
|
||
|
||
//! \brief Initializes the object’s exception.
|
||
//!
|
||
//! This populates the data to be returned by Exception(). The parameters may
|
||
//! be passed directly through from a Mach exception handler.
|
||
//!
|
||
//! This method must not be called until after a successful call to
|
||
//! Initialize().
|
||
//!
|
||
//! \return `true` if the exception information could be initialized, `false`
|
||
//! otherwise with an appropriate message logged. When this method returns
|
||
//! `false`, the ProcessSnapshotMac object’s validity remains unchanged.
|
||
bool InitializeException(thread_t exception_thread,
|
||
exception_type_t exception,
|
||
const mach_exception_data_type_t* code,
|
||
mach_msg_type_number_t code_count,
|
||
thread_state_flavor_t flavor,
|
||
const natural_t* state,
|
||
mach_msg_type_number_t state_count);
|
||
|
||
//! \brief Sets the value to be returned by AnnotationsSimpleMap().
|
||
//!
|
||
//! On Mac OS X, all process annotations are under the control of the snapshot
|
||
//! producer, which may call this method to establish these annotations.
|
||
//! Contrast this with module annotations, which are under the control of the
|
||
//! process being snapshotted.
|
||
void SetAnnotationsSimpleMap(
|
||
const std::map<std::string, std::string>& annotations_simple_map) {
|
||
annotations_simple_map_ = annotations_simple_map;
|
||
}
|
||
|
||
// ProcessSnapshot:
|
||
|
||
pid_t ProcessID() const override;
|
||
pid_t ParentProcessID() const override;
|
||
void SnapshotTime(timeval* snapshot_time) const override;
|
||
void ProcessStartTime(timeval* start_time) const override;
|
||
void ProcessCPUTimes(timeval* user_time, timeval* system_time) const override;
|
||
const std::map<std::string, std::string>& AnnotationsSimpleMap()
|
||
const override;
|
||
const SystemSnapshot* System() const override;
|
||
std::vector<const ThreadSnapshot*> Threads() const override;
|
||
std::vector<const ModuleSnapshot*> Modules() const override;
|
||
const ExceptionSnapshot* Exception() const override;
|
||
|
||
private:
|
||
// Initializes threads_ on behalf of Initialize().
|
||
void InitializeThreads();
|
||
|
||
// Initializes modules_ on behalf of Initialize().
|
||
void InitializeModules();
|
||
|
||
internal::SystemSnapshotMac system_;
|
||
PointerVector<internal::ThreadSnapshotMac> threads_;
|
||
PointerVector<internal::ModuleSnapshotMac> modules_;
|
||
scoped_ptr<internal::ExceptionSnapshotMac> exception_;
|
||
ProcessReader process_reader_;
|
||
std::map<std::string, std::string> annotations_simple_map_;
|
||
timeval snapshot_time_;
|
||
InitializationStateDcheck initialized_;
|
||
|
||
DISALLOW_COPY_AND_ASSIGN(ProcessSnapshotMac);
|
||
};
|
||
|
||
} // namespace crashpad
|
||
|
||
#endif // CRASHPAD_SNAPSHOT_MAC_PROCESS_SNAPSHOT_MAC_H_
|