Chromium Code Reviews| 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 |