| 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 23 matching lines...) Expand all Loading... |
| 34 bool ServiceManagementSubmitJob(CFDictionaryRef job_cf); | 34 bool ServiceManagementSubmitJob(CFDictionaryRef job_cf); |
| 35 | 35 |
| 36 //! \brief Removes a job from the user launchd domain as in `SMJobRemove()`. | 36 //! \brief Removes a job from the user launchd domain as in `SMJobRemove()`. |
| 37 //! | 37 //! |
| 38 //! \param[in] label The label for the job to remove. | 38 //! \param[in] label The label for the job to remove. |
| 39 //! \param[in] wait `true` if this function should block, waiting for the job to | 39 //! \param[in] wait `true` if this function should block, waiting for the job to |
| 40 //! be removed. `false` if the job may be removed asynchronously. | 40 //! be removed. `false` if the job may be removed asynchronously. |
| 41 //! | 41 //! |
| 42 //! \return `true` if the job was removed successfully or if an asynchronous | 42 //! \return `true` if the job was removed successfully or if an asynchronous |
| 43 //! attempt to remove the job was started successfully, otherwise `false`. | 43 //! attempt to remove the job was started successfully, otherwise `false`. |
| 44 //! Unlike previous systems, on Mac OS X 10.10, this function returns `true` | |
| 45 //! even if \a label names a job that does not exist. This is filed as radar | |
| 46 //! 18268941. | |
| 47 //! | 44 //! |
| 48 //! \note This function is provided because `SMJobRemove()` is deprecated in Mac | 45 //! \note This function is provided because `SMJobRemove()` is deprecated in Mac |
| 49 //! OS X 10.10. It may or may not be implemented using `SMJobRemove()` from | 46 //! OS X 10.10. On Mac OS X 10.10, observed in DP8 14A361c, it also blocks |
| 50 //! `ServiceManagement.framework`. | 47 //! for far too long (`_block_until_job_exits()` contains a one-second |
| 48 //! `sleep()`, filed as radar 18398683) and does not signal failure via its |
| 49 //! return value when asked to remove a nonexistent job (filed as radar |
| 50 //! 18268941). |
| 51 bool ServiceManagementRemoveJob(const std::string& label, bool wait); | 51 bool ServiceManagementRemoveJob(const std::string& label, bool wait); |
| 52 | 52 |
| 53 //! \brief Determines whether a specified job is loaded in the user launchd | 53 //! \brief Determines whether a specified job is loaded in the user launchd |
| 54 //! domain. | 54 //! domain. |
| 55 //! | 55 //! |
| 56 //! \param[in] label The label for the job to look up. | 56 //! \param[in] label The label for the job to look up. |
| 57 //! | 57 //! |
| 58 //! \return `true` if the job is loaded, otherwise `false`. | 58 //! \return `true` if the job is loaded, otherwise `false`. |
| 59 //! | 59 //! |
| 60 //! \note A loaded job is not necessarily presently running, nor has it | 60 //! \note A loaded job is not necessarily presently running, nor has it |
| (...skipping 11 matching lines...) Expand all Loading... |
| 72 //! \return The job’s process ID if running, otherwise `0`. | 72 //! \return The job’s process ID if running, otherwise `0`. |
| 73 //! | 73 //! |
| 74 //! \note This function is provided because `SMJobCopyDictionary()` is | 74 //! \note This function is provided because `SMJobCopyDictionary()` is |
| 75 //! deprecated in Mac OS X 10.10. It may or may not be implemented using | 75 //! deprecated in Mac OS X 10.10. It may or may not be implemented using |
| 76 //! `SMJobCopyDictionary()` from `ServiceManagement.framework`. | 76 //! `SMJobCopyDictionary()` from `ServiceManagement.framework`. |
| 77 pid_t ServiceManagementIsJobRunning(const std::string& label); | 77 pid_t ServiceManagementIsJobRunning(const std::string& label); |
| 78 | 78 |
| 79 } // namespace crashpad | 79 } // namespace crashpad |
| 80 | 80 |
| 81 #endif // CRASHPAD_UTIL_MAC_SERVICE_MANAGEMENT | 81 #endif // CRASHPAD_UTIL_MAC_SERVICE_MANAGEMENT |
| OLD | NEW |