1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
content / public / browser / browser_child_process_observer.h [blame]
// Copyright 2013 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef CONTENT_PUBLIC_BROWSER_BROWSER_CHILD_PROCESS_OBSERVER_H_
#define CONTENT_PUBLIC_BROWSER_BROWSER_CHILD_PROCESS_OBSERVER_H_
#include "content/common/content_export.h"
namespace content {
struct ChildProcessData;
struct ChildProcessTerminationInfo;
// An observer API implemented by classes which are interested in browser child
// process events. Note that render processes cannot be observed through this
// interface; use RenderProcessHostObserver instead.
class CONTENT_EXPORT BrowserChildProcessObserver {
public:
// Called when a child process has successfully launched and has connected to
// it child process host. `data.GetProcess()` is guaranteed to be valid.
virtual void BrowserChildProcessLaunchedAndConnected(
const ChildProcessData& data) {}
// Called after a ChildProcessHost is disconnected from the child process.
virtual void BrowserChildProcessHostDisconnected(
const ChildProcessData& data) {}
// Called when a child process disappears unexpectedly as a result of a crash.
virtual void BrowserChildProcessCrashed(
const ChildProcessData& data,
const ChildProcessTerminationInfo& info) {}
// Called when a child process disappears unexpectedly as a result of being
// killed.
virtual void BrowserChildProcessKilled(
const ChildProcessData& data,
const ChildProcessTerminationInfo& info) {}
// Called when a child process never launches successfully. In this case,
// info.status will be TERMINATION_STATUS_LAUNCH_FAILED and info.exit_code
// will contain a platform specific launch failure error code.
virtual void BrowserChildProcessLaunchFailed(
const ChildProcessData& data,
const ChildProcessTerminationInfo& info) {}
// Called when a child process exits without crashing or being killed.
virtual void BrowserChildProcessExitedNormally(
const ChildProcessData& data,
const ChildProcessTerminationInfo& info) {}
// Note for Android. There is no way to reliably distinguish between Crash
// and Kill. Arbitrarily choose all abnormal terminations on Android to call
// BrowserChildProcessKilled, which means BrowserChildProcessCrashed will
// never be called on Android.
protected:
// The observer can be destroyed on any thread.
virtual ~BrowserChildProcessObserver() {}
static void Add(BrowserChildProcessObserver* observer);
static void Remove(BrowserChildProcessObserver* observer);
};
} // namespace content
#endif // CONTENT_PUBLIC_BROWSER_BROWSER_CHILD_PROCESS_OBSERVER_H_