blob: e37dbaffb716c496cce5aeae89d34a3f49d696d1 [file] [log] [blame]
// Copyright 2015 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#include "base/callback.h"
#include "base/files/file_path.h"
#include "base/macros.h"
#include "base/time/time.h"
#include "chromecast/crash/linux/minidump_params.h"
#include "chromecast/crash/linux/synchronized_minidump_manager.h"
namespace chromecast {
class MinidumpGenerator;
// Class for writing a minidump with synchronized access to the minidumps
// directory.
class MinidumpWriter : public SynchronizedMinidumpManager {
typedef base::Callback<int(const std::string&)> DumpStateCallback;
// Constructs a writer for a minidump. If |minidump_filename| is absolute, it
// must be a path to a file in the |dump_path_| directory. Otherwise, it
// should be a filename only, in which case, |minidump_generator| creates
// a minidump at $HOME/minidumps/|minidump_filename|. |params| describes the
// minidump metadata. |dump_state_cb| is Run() to generate a log dump. Please
// see the comments on |dump_state_cb_| below for details about this
// parameter.
// This does not take ownership of |minidump_generator|.
MinidumpWriter(MinidumpGenerator* minidump_generator,
const std::string& minidump_filename,
const MinidumpParams& params,
const base::Callback<int(const std::string&)>& dump_state_cb);
// Like the constructor above, but the default implementation of
// |dump_state_cb_| is used inside DoWork().
MinidumpWriter(MinidumpGenerator* minidump_generator,
const std::string& minidump_filename,
const MinidumpParams& params);
~MinidumpWriter() override;
// Acquires exclusive access to the minidumps directory and generates a
// minidump and a log to be uploaded later. Returns 0 if successful, -1
// otherwise.
int Write() { return AcquireLockAndDoWork(); }
// MinidumpManager implementation:
int DoWork() override;
MinidumpGenerator* const minidump_generator_;
base::FilePath minidump_path_;
const MinidumpParams params_;
// This callback is Run() to dump a log to |minidump_path_|.txt.gz, taking
// |minidump_path_| as a parameter. It returns 0 on success, and a negative
// integer otherwise. If a callback is not passed in the constructor, the
// default implemementaion is used.
DumpStateCallback dump_state_cb_;
} // namespace chromecast