| Index: third_party/crashpad/crashpad/util/win/exception_handler_server.h
|
| diff --git a/third_party/crashpad/crashpad/util/win/exception_handler_server.h b/third_party/crashpad/crashpad/util/win/exception_handler_server.h
|
| new file mode 100644
|
| index 0000000000000000000000000000000000000000..46141414fd670234c3ecd98426d10cdc7c61a6ea
|
| --- /dev/null
|
| +++ b/third_party/crashpad/crashpad/util/win/exception_handler_server.h
|
| @@ -0,0 +1,123 @@
|
| +// Copyright 2015 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_UTIL_WIN_EXCEPTION_HANDLER_SERVER_H_
|
| +#define CRASHPAD_UTIL_WIN_EXCEPTION_HANDLER_SERVER_H_
|
| +
|
| +#include <set>
|
| +#include <string>
|
| +
|
| +#include "base/basictypes.h"
|
| +#include "base/synchronization/lock.h"
|
| +#include "util/file/file_io.h"
|
| +#include "util/win/address_types.h"
|
| +#include "util/win/scoped_handle.h"
|
| +
|
| +namespace crashpad {
|
| +
|
| +namespace internal {
|
| +class PipeServiceContext;
|
| +class ClientData;
|
| +} // namespace internal
|
| +
|
| +//! \brief Runs the main exception-handling server in Crashpad's handler
|
| +//! process.
|
| +class ExceptionHandlerServer {
|
| + public:
|
| + class Delegate {
|
| + public:
|
| + virtual ~Delegate();
|
| +
|
| + //! \brief Called when the server has created the named pipe connection
|
| + //! points and is ready to service requests.
|
| + virtual void ExceptionHandlerServerStarted() = 0;
|
| +
|
| + //! \brief Called when the client has signalled that it has encountered an
|
| + //! exception and so wants a crash dump to be taken.
|
| + //!
|
| + //! \param[in] process A handle to the client process. Ownership of the
|
| + //! lifetime of this handle is not passed to the delegate.
|
| + //! \param[in] exception_information_address The address in the client's
|
| + //! address space of an ExceptionInformation structure.
|
| + //! \param[in] debug_critical_section_address The address in the client's
|
| + //! address space of a `CRITICAL_SECTION` allocated with a valid
|
| + //! `.DebugInfo` field, or `0` if unavailable.
|
| + //! \return The exit code that should be used when terminating the client
|
| + //! process.
|
| + virtual unsigned int ExceptionHandlerServerException(
|
| + HANDLE process,
|
| + WinVMAddress exception_information_address,
|
| + WinVMAddress debug_critical_section_address) = 0;
|
| + };
|
| +
|
| + //! \brief Constructs the exception handling server.
|
| + //!
|
| + //! \param[in] persistent `true` if Run() should not return until Stop() is
|
| + //! called. If `false`, Run() will return when all clients have exited,
|
| + //! although Run() will always wait for the first client to connect.
|
| + explicit ExceptionHandlerServer(bool persistent);
|
| +
|
| + ~ExceptionHandlerServer();
|
| +
|
| + //! \brief Sets the pipe name to listen for client registrations on.
|
| + //!
|
| + //! Either this method or CreatePipe(), but not both, must be called before
|
| + //! Run().
|
| + //!
|
| + //! \param[in] pipe_name The name of the pipe to listen on. Must be of the
|
| + //! form "\\.\pipe\<some_name>".
|
| + void SetPipeName(const std::wstring& pipe_name);
|
| +
|
| + //! \brief Creates a randomized pipe name to listen for client registrations
|
| + //! on and returns its name.
|
| + //!
|
| + //! Either this method or CreatePipe(), but not both, must be called before
|
| + //! Run().
|
| + //!
|
| + //! \return The pipe name that will be listened on.
|
| + std::wstring CreatePipe();
|
| +
|
| + //! \brief Runs the exception-handling server.
|
| + //!
|
| + //! \param[in] delegate The interface to which the exceptions are delegated
|
| + //! when they are caught in Run(). Ownership is not transferred.
|
| + void Run(Delegate* delegate);
|
| +
|
| + //! \brief Stops the exception-handling server. Returns immediately. The
|
| + //! object must not be destroyed until Run() returns.
|
| + void Stop();
|
| +
|
| + private:
|
| + static bool ServiceClientConnection(
|
| + const internal::PipeServiceContext& service_context);
|
| + static DWORD __stdcall PipeServiceProc(void* ctx);
|
| + static void __stdcall OnCrashDumpEvent(void* ctx, BOOLEAN);
|
| + static void __stdcall OnNonCrashDumpEvent(void* ctx, BOOLEAN);
|
| + static void __stdcall OnProcessEnd(void* ctx, BOOLEAN);
|
| +
|
| + std::wstring pipe_name_;
|
| + ScopedKernelHANDLE port_;
|
| + ScopedFileHandle first_pipe_instance_;
|
| +
|
| + base::Lock clients_lock_;
|
| + std::set<internal::ClientData*> clients_;
|
| +
|
| + bool persistent_;
|
| +
|
| + DISALLOW_COPY_AND_ASSIGN(ExceptionHandlerServer);
|
| +};
|
| +
|
| +} // namespace crashpad
|
| +
|
| +#endif // CRASHPAD_UTIL_WIN_EXCEPTION_HANDLER_SERVER_H_
|
|
|