| 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 |