crashpad::ExceptionHandlerServer Class Reference

Runs the main exception-handling server in Crashpad’s handler process. More...

#include "util/win/exception_handler_server.h"

Classes
class	Delegate

Public Member Functions
	ExceptionHandlerServer (base::mac::ScopedMachReceiveRight receive_port)
	Constructs an ExceptionHandlerServer object. More...
void	Run (UniversalMachExcServer::Interface *exception_interface)
	Runs the exception-handling server. More...
	ExceptionHandlerServer (const std::string &pipe_name, bool persistent)
	Constructs the exception handling server. More...
void	Run (Delegate *delegate)
	Runs the exception-handling server. More...
void	Stop ()
	Stops the exception-handling server. Returns immediately. The object must not be destroyed until Run() returns.

Detailed Description

Runs the main exception-handling server in Crashpad’s handler process.

Runs the main exception-handling server in Crashpad's handler process.

Constructor & Destructor Documentation

crashpad::ExceptionHandlerServer::ExceptionHandlerServer ( base::mac::ScopedMachReceiveRight  receive_port )

explicit

Constructs an ExceptionHandlerServer object.

Parameters

[in]

receive_port

The port that exception messages and no-senders notifications will be received on.

crashpad::ExceptionHandlerServer::ExceptionHandlerServer	(	const std::string &	pipe_name,
		bool	persistent
	)

Constructs the exception handling server.

Parameters

[in]	pipe_name	The name of the pipe to listen on. Must be of the form "\\.\pipe\<some_name>".
[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.

Member Function Documentation

void crashpad::ExceptionHandlerServer::Run

(

UniversalMachExcServer::Interface *

exception_interface

)

Runs the exception-handling server.

Parameters

[in]

exception_interface

An object to send exception messages to.

This method monitors the receive port for exception messages and no-senders notifications. It continues running until it has no more clients, indicated by the receipt of a no-senders notification. It is important to assure that a send right exists in a client (or has been queued by mach_msg() to be sent to a client) prior to calling this method, or it will detect that it is sender-less and return immediately.

All exception messages will be passed to exception_interface.

This method must only be called once on an ExceptionHandlerServer object.

If an unexpected condition that prevents this method from functioning is encountered, it will log a message and terminate execution. Receipt of an invalid message on the receive port will cause a message to be logged, but this method will continue running normally.

void crashpad::ExceptionHandlerServer::Run

(

Delegate *

delegate

)

Runs the exception-handling server.

Parameters

[in]

delegate

The interface to which the exceptions are delegated when they are caught in Run(). Ownership is not transferred.

---

The documentation for this class was generated from the following files:

• handler/mac/exception_handler_server.h
• handler/mac/exception_handler_server.cc