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 45 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
56 //! started with this path as its `--database` argument. | 56 //! started with this path as its `--database` argument. |
57 //! \param[in] url The URL of an upload server. The handler will be started | 57 //! \param[in] url The URL of an upload server. The handler will be started |
58 //! with this URL as its `--url` argument. | 58 //! with this URL as its `--url` argument. |
59 //! \param[in] annotations Process annotations to set in each crash report. | 59 //! \param[in] annotations Process annotations to set in each crash report. |
60 //! The handler will be started with an `--annotation` argument for each | 60 //! The handler will be started with an `--annotation` argument for each |
61 //! element in this map. | 61 //! element in this map. |
62 //! \param[in] arguments Additional arguments to pass to the Crashpad handler. | 62 //! \param[in] arguments Additional arguments to pass to the Crashpad handler. |
63 //! Arguments passed in other parameters and arguments required to perform | 63 //! Arguments passed in other parameters and arguments required to perform |
64 //! the handshake are the responsibility of this method, and must not be | 64 //! the handshake are the responsibility of this method, and must not be |
65 //! specified in this parameter. | 65 //! specified in this parameter. |
| 66 //! \param[in] restartable If `true`, the handler will be restarted if it |
| 67 //! dies, if this behavior is supported. This option is not available on |
| 68 //! all platforms, and does not function on all OS versions. If it is |
| 69 //! not supported, it will be ignored. |
66 //! | 70 //! |
67 //! \return `true` on success, `false` on failure with a message logged. | 71 //! \return `true` on success, `false` on failure with a message logged. |
68 bool StartHandler(const base::FilePath& handler, | 72 bool StartHandler(const base::FilePath& handler, |
69 const base::FilePath& database, | 73 const base::FilePath& database, |
70 const std::string& url, | 74 const std::string& url, |
71 const std::map<std::string, std::string>& annotations, | 75 const std::map<std::string, std::string>& annotations, |
72 const std::vector<std::string>& arguments); | 76 const std::vector<std::string>& arguments, |
| 77 bool restartable); |
73 | 78 |
74 #if defined(OS_WIN) || DOXYGEN | 79 #if defined(OS_WIN) || DOXYGEN |
75 //! \brief Sets the IPC pipe of a presumably-running Crashpad handler process | 80 //! \brief Sets the IPC pipe of a presumably-running Crashpad handler process |
76 //! which was started with StartHandler() or by other compatible means | 81 //! which was started with StartHandler() or by other compatible means |
77 //! and does an IPC message exchange to register this process with the | 82 //! and does an IPC message exchange to register this process with the |
78 //! handler. However, just like StartHandler(), crashes are not serviced | 83 //! handler. However, just like StartHandler(), crashes are not serviced |
79 //! until UseHandler() is called. | 84 //! until UseHandler() is called. |
80 //! | 85 //! |
81 //! \param[in] ipc_pipe The full name of the crash handler IPC pipe. This is | 86 //! \param[in] ipc_pipe The full name of the crash handler IPC pipe. This is |
82 //! a string of the form `"\\.\pipe\NAME"`. | 87 //! a string of the form `"\\.\pipe\NAME"`. |
(...skipping 75 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
158 #elif defined(OS_WIN) | 163 #elif defined(OS_WIN) |
159 std::wstring ipc_pipe_; | 164 std::wstring ipc_pipe_; |
160 #endif | 165 #endif |
161 | 166 |
162 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); | 167 DISALLOW_COPY_AND_ASSIGN(CrashpadClient); |
163 }; | 168 }; |
164 | 169 |
165 } // namespace crashpad | 170 } // namespace crashpad |
166 | 171 |
167 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ | 172 #endif // CRASHPAD_CLIENT_CRASHPAD_CLIENT_H_ |
OLD | NEW |