OLD | NEW |
---|---|
1 // Copyright 2014 The Crashpad Authors. All rights reserved. | 1 // Copyright 2014 The Crashpad Authors. All rights reserved. |
2 // | 2 // |
3 // Licensed under the Apache License, Version 2.0 (the "License"); | 3 // Licensed under the Apache License, Version 2.0 (the "License"); |
4 // you may not use this file except in compliance with the License. | 4 // you may not use this file except in compliance with the License. |
5 // You may obtain a copy of the License at | 5 // You may obtain a copy of the License at |
6 // | 6 // |
7 // http://www.apache.org/licenses/LICENSE-2.0 | 7 // http://www.apache.org/licenses/LICENSE-2.0 |
8 // | 8 // |
9 // Unless required by applicable law or agreed to in writing, software | 9 // Unless required by applicable law or agreed to in writing, software |
10 // distributed under the License is distributed on an "AS IS" BASIS, | 10 // distributed under the License is distributed on an "AS IS" BASIS, |
(...skipping 48 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
59 //! started with this path as its `--database` argument. | 59 //! started with this path as its `--database` argument. |
60 //! \param[in] url The URL of an upload server. The handler will be started | 60 //! \param[in] url The URL of an upload server. The handler will be started |
61 //! with this URL as its `--url` argument. | 61 //! with this URL as its `--url` argument. |
62 //! \param[in] annotations Process annotations to set in each crash report. | 62 //! \param[in] annotations Process annotations to set in each crash report. |
63 //! The handler will be started with an `--annotation` argument for each | 63 //! The handler will be started with an `--annotation` argument for each |
64 //! element in this map. | 64 //! element in this map. |
65 //! \param[in] arguments Additional arguments to pass to the Crashpad handler. | 65 //! \param[in] arguments Additional arguments to pass to the Crashpad handler. |
66 //! Arguments passed in other parameters and arguments required to perform | 66 //! Arguments passed in other parameters and arguments required to perform |
67 //! the handshake are the responsibility of this method, and must not be | 67 //! the handshake are the responsibility of this method, and must not be |
68 //! specified in this parameter. | 68 //! specified in this parameter. |
69 //! \param[in] restartable If `true`, the handler will be restarted if it | |
70 //! dies, if this behavior is supported. This option is not available on | |
Robert Sesek
2015/11/03 15:50:27
What happens if this is `true` and the platform do
| |
71 //! all platforms, and does not function on all OS versions. | |
69 //! | 72 //! |
70 //! \return `true` on success, `false` on failure with a message logged. | 73 //! \return `true` on success, `false` on failure with a message logged. |
71 bool StartHandler(const base::FilePath& handler, | 74 bool StartHandler(const base::FilePath& handler, |
72 const base::FilePath& database, | 75 const base::FilePath& database, |
73 const std::string& url, | 76 const std::string& url, |
74 const std::map<std::string, std::string>& annotations, | 77 const std::map<std::string, std::string>& annotations, |
75 const std::vector<std::string>& arguments); | 78 const std::vector<std::string>& arguments, |
79 bool restartable); | |
76 | 80 |
77 #if defined(OS_WIN) || DOXYGEN | 81 #if defined(OS_WIN) || DOXYGEN |
78 //! \brief Sets the IPC port of a presumably-running Crashpad handler process | 82 //! \brief Sets the IPC port of a presumably-running Crashpad handler process |
79 //! which was started with StartHandler() or by other compatible means | 83 //! which was started with StartHandler() or by other compatible means |
80 //! and does an IPC message exchange to register this process with the | 84 //! and does an IPC message exchange to register this process with the |
81 //! handler. However, just like StartHandler(), crashes are not serviced | 85 //! handler. However, just like StartHandler(), crashes are not serviced |
82 //! until UseHandler() is called. | 86 //! until UseHandler() is called. |
83 //! | 87 //! |
84 //! The IPC port name (somehow) encodes enough information so that | 88 //! The IPC port name (somehow) encodes enough information so that |
85 //! registration is done with a crash handler using the appropriate database | 89 //! registration is done with a crash handler using the appropriate database |
(...skipping 61 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
147 #if defined(OS_MACOSX) | 151 #if defined(OS_MACOSX) |
148 base::mac::ScopedMachSendRight exception_port_; | 152 base::mac::ScopedMachSendRight exception_port_; |
149 #endif | 153 #endif |
150 | 154 |
151 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); | 155 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); |
152 }; | 156 }; |
153 | 157 |
154 } // namespace crashpad | 158 } // namespace crashpad |
155 | 159 |
156 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ | 160 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ |
OLD | NEW |