103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// Copyright (c) 2014, Google Inc. 203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// All rights reserved. 303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// 403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// Redistribution and use in source and binary forms, with or without 503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// modification, are permitted provided that the following conditions are 603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// met: 703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// 803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// * Redistributions of source code must retain the above copyright 903d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// notice, this list of conditions and the following disclaimer. 1003d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// * Redistributions in binary form must reproduce the above 1103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// copyright notice, this list of conditions and the following disclaimer 1203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// in the documentation and/or other materials provided with the 1303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// distribution. 1403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// * Neither the name of Google Inc. nor the names of its 1503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// contributors may be used to endorse or promote products derived from 1603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// this software without specific prior written permission. 1703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// 1803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1903d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 2003d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 2103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 2203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 2303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 2403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 2503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 2603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 2703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 2803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 2903d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 3003d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#ifndef CLIENT_LINUX_MINIDUMP_WRITER_MICRODUMP_WRITER_H_ 3103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#define CLIENT_LINUX_MINIDUMP_WRITER_MICRODUMP_WRITER_H_ 3203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 3303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#include <stdint.h> 3403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#include <sys/types.h> 3503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 3603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#include "client/linux/dump_writer_common/mapping_info.h" 3703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 3803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.orgnamespace google_breakpad { 3903d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 4003d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// Writes a microdump (a reduced dump containing only the state of the crashing 4103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// thread) on the console (logcat on Android). These functions do not malloc nor 4203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// use libc functions which may. Thus, it can be used in contexts where the 4303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// state of the heap may be corrupt. 4403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// Args: 4503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// crashing_process: the pid of the crashing process. This must be trusted. 4603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// blob: a blob of data from the crashing process. See exception_handler.h 4703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// blob_size: the length of |blob| in bytes. 4803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// mappings: a list of additional mappings provided by the application. 4903d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// 5003d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org// Returns true iff successful. 5103d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.orgbool WriteMicrodump(pid_t crashing_process, 5203d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org const void* blob, 5303d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org size_t blob_size, 5403d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org const MappingList& mappings); 5503d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 5603d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org} // namespace google_breakpad 5703d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org 5803d36567efefa6d833cb4b15f2ea6f97b040ea85primiano@chromium.org#endif // CLIENT_LINUX_MINIDUMP_WRITER_MICRODUMP_WRITER_H_ 59