From f838f51c238f8dcc4568eb68a16a7a86024eea5d Mon Sep 17 00:00:00 2001 From: Luke Shumaker Date: Fri, 12 May 2017 23:58:59 -0400 Subject: ./tools/notsd-move --- man/sd_event_source_set_enabled.xml | 179 ------------------------------------ 1 file changed, 179 deletions(-) delete mode 100644 man/sd_event_source_set_enabled.xml (limited to 'man/sd_event_source_set_enabled.xml') diff --git a/man/sd_event_source_set_enabled.xml b/man/sd_event_source_set_enabled.xml deleted file mode 100644 index 6844f29a49..0000000000 --- a/man/sd_event_source_set_enabled.xml +++ /dev/null @@ -1,179 +0,0 @@ - - - - - - - - - sd_event_source_set_enabled - systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - - - - - sd_event_source_set_enabled - 3 - - - - sd_event_source_set_enabled - sd_event_source_get_enabled - SD_EVENT_ON - SD_EVENT_OFF - SD_EVENT_ONESHOT - - Enable or disable event sources - - - - - #include <systemd/sd-event.h> - - enum { - SD_EVENT_OFF = 0, - SD_EVENT_ON = 1, - SD_EVENT_ONESHOT = -1, -}; - - - int sd_event_source_set_enabled - sd_event_source *source - int enabled - - - - int sd_event_source_get_enabled - sd_event_source *source - int *enabled - - - - - - - Description - - sd_event_source_set_enabled() may be - used to enable or disable the event source object specified as - source. The enabled - parameter takes one of SD_EVENT_ON (to - enable), SD_EVENT_OFF (to disable) or - SD_EVENT_ONESHOT. If invoked with - SD_EVENT_ONESHOT the event source will be - enabled but automatically reset to - SD_EVENT_OFF after the event source was - dispatched once. - - Event sources that are disabled will not result in event - loop wakeups and will not be dispatched, until they are enabled - again. - - sd_event_source_get_enabled() may be - used to query whether the event source object - source is currently enabled or not. It - returns the enablement state in - enabled. - - Event source objects are enabled when they are first created - with calls such as - sd_event_add_io3, - sd_event_add_time3. However, - depending on the event source type they are enabled continuously - (SD_EVENT_ON) or only for a single invocation - of the event source handler - (SD_EVENT_ONESHOT). For details see the - respective manual pages. - - As event source objects stay active and may be dispatched as - long as there is at least one reference to them, in many cases it - is a good idea to combine a call to - sd_event_source_unref3 - with a prior call to - sd_event_source_set_enabled() with - SD_EVENT_OFF, to ensure the event source is - not dispatched again until all other remaining references are dropped. - - - - Return Value - - On success, sd_event_source_set_enabled() and - sd_event_source_get_enabled() return a - non-negative integer. On failure, they return a negative - errno-style error code. - - - - Errors - - Returned errors may indicate the following problems: - - - - -EINVAL - - source is not a valid - pointer to an sd_event_source - object. - - - - -ENOMEM - - Not enough memory. - - - - -ECHILD - - The event loop has been created in a different process. - - - - - - - - - - See Also - - - sd-event3, - sd_event_add_io3, - sd_event_add_time3, - sd_event_add_child3, - sd_event_add_signal3, - sd_event_add_defer3, - sd_event_source_unref3 - - - - -- cgit v1.2.3-54-g00ecf