mirror of
https://github.com/chromium/crashpad.git
synced 2024-12-28 07:48:14 +08:00
0a4ea0b52d
All minidump objects now own their all of their children, rather than having them maintain weak pointers and requiring callers to maintain ownership. The only weak object in the entire tree now is the “extra memory” added to a MinidumpMemoryListWriter by its AddExtraMemory() method. Extra memory aliases objects owned elsewhere in the tree, typically by a MinidumpThreadWriter as stack memory. Non-“extra” memory added to a MinidumpMemoryListWriter by its AddMemory() method is strongly owned. Many objects are now deleted through base pointers, and in those cases, the base classes now have public virtual destructors. The ultimate base, MinidumpWritable, is still protected to guard against direct instantiation and deletion, and thus its destructor does not need to be virtual. This updates mini_chromium to eeb3b6a4f020 specifically for that revision, which includes necessary updates to scoped_ptr. It also picks up: eeb3b6a4f020 Update base/move.h and base/memory/scoped_ptr.h to match 67ad2efafaba More porting to Windows be27a006421e AUTHORS: Fix link post-git migration flag day. 05f5b1503230 Add codereview.settings to mini_chromium. a32c2b199811 Beginnings of Windows support in mini_chromium TEST=minidump_test R=rsesek@chromium.org Review URL: https://codereview.chromium.org/674153002
93 lines
3.1 KiB
C++
93 lines
3.1 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_MINIDUMP_MINIDUMP_FILE_WRITER_H_
|
|
#define CRASHPAD_MINIDUMP_MINIDUMP_FILE_WRITER_H_
|
|
|
|
#include <dbghelp.h>
|
|
#include <sys/types.h>
|
|
|
|
#include <set>
|
|
#include <vector>
|
|
|
|
#include "base/basictypes.h"
|
|
#include "base/memory/scoped_ptr.h"
|
|
#include "minidump/minidump_extensions.h"
|
|
#include "minidump/minidump_stream_writer.h"
|
|
#include "minidump/minidump_writable.h"
|
|
#include "util/stdlib/pointer_container.h"
|
|
|
|
namespace crashpad {
|
|
|
|
//! \brief The root-level object in a minidump file.
|
|
//!
|
|
//! This object writes a MINIDUMP_HEADER and list of MINIDUMP_DIRECTORY entries
|
|
//! to a minidump file.
|
|
class MinidumpFileWriter final : public internal::MinidumpWritable {
|
|
public:
|
|
MinidumpFileWriter();
|
|
~MinidumpFileWriter() override;
|
|
|
|
//! \brief Sets MINIDUMP_HEADER::Timestamp.
|
|
//!
|
|
//! \note Valid in #kStateMutable.
|
|
void SetTimestamp(time_t timestamp);
|
|
|
|
//! \brief Adds a stream to the minidump file and arranges for a
|
|
//! MINIDUMP_DIRECTORY entry to point to it.
|
|
//!
|
|
//! This object takes ownership of \a stream and becomes its parent in the
|
|
//! overall tree of internal::MinidumpWritable objects.
|
|
//!
|
|
//! At most one object of each stream type (as obtained from
|
|
//! internal::MinidumpStreamWriter::StreamType()) may be added to a
|
|
//! MinidumpFileWriter object. It is an error to attempt to add multiple
|
|
//! streams with the same stream type.
|
|
//!
|
|
//! \note Valid in #kStateMutable.
|
|
void AddStream(scoped_ptr<internal::MinidumpStreamWriter> stream);
|
|
|
|
// MinidumpWritable:
|
|
|
|
//! \copydoc internal::MinidumpWritable::WriteEverything()
|
|
//!
|
|
//! This method does not initially write the final value for
|
|
//! MINIDUMP_HEADER::Signature. After all child objects have been written, it
|
|
//! rewinds to the beginning of the file and writes the correct value for this
|
|
//! field. This prevents incompletely-written minidump files from being
|
|
//! mistaken for valid ones.
|
|
bool WriteEverything(FileWriterInterface* file_writer) override;
|
|
|
|
protected:
|
|
// MinidumpWritable:
|
|
bool Freeze() override;
|
|
size_t SizeOfObject() override;
|
|
std::vector<MinidumpWritable*> Children() override;
|
|
bool WillWriteAtOffsetImpl(off_t offset) override;
|
|
bool WriteObject(FileWriterInterface* file_writer) override;
|
|
|
|
private:
|
|
MINIDUMP_HEADER header_;
|
|
PointerVector<internal::MinidumpStreamWriter> streams_;
|
|
|
|
// Protects against multiple streams with the same ID being added.
|
|
std::set<MinidumpStreamType> stream_types_;
|
|
|
|
DISALLOW_COPY_AND_ASSIGN(MinidumpFileWriter);
|
|
};
|
|
|
|
} // namespace crashpad
|
|
|
|
#endif // CRASHPAD_MINIDUMP_MINIDUMP_WRITER_H_
|