{"action":"created","comment":{"url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/comments/154937833","pull_request_review_id":81170005,"id":154937833,"diff_hunk":"@@ -0,0 +1,327 @@\n+Preface\n+ ===\n+ \n+ **The features described in this document are not\n+implemented yet or experimental. This document contains a preview of\n+how developers would use the notification feature**\n+ \n+ This document\n+explains how notifications are implemented in Elektra and how they\n+can be used by application developers.\n+ \n+ Notifications - Overview &\n+Concept\n+ ===\n+ \n+ Elektra's notification feature consists of several\n+components.\n+ While notification features are implemented by plugins,\n+applications use APIs provided by wrappers in order to use different\n+plugins.\n+ \n+ A wrapper for notifications provides the API for receiving\n+and handling notifications.\n+ A wrapper for I/O operations allows\n+asynchronous notification processing by compatible plugins.\n+ The\n+I/O-wrapper consists of an *interface* used by transport plugins\n+and a *binding* which implements the actual I/O management functions\n+for a specific I/O management library.\n+ \n+ Transport plugins exchange\n+notifications via different protocols like D-Bus, Redis and ZeroMQ.\n+ For\n+each type of transport there are two types of plugins: One for sending\n+and one for receiving notifications.\n+ Developers do not interact with\n+those plugins directly.\n+ The underlying transports are transparent\n+to them.\n+ An internal-notification plugin implements notification\n+handling functions and feeds back configuration changes from within\n+the application.\n+ \n+ ![Overview](../images/notifications.svg)\n+ \n+ When a\n+configuration key is changed Elektra can generate change notifications\n+that allow applications to process those changes.\n+ Developers can choose\n+whether and how they want to receive and handle those notifications\n+but not whether notifications are sent.\n+ How notifications are sent is\n+specified in the *notification configuration* by the system operator.\n+\n+ Notification configuration\n+ ===\n+ \n+ System operators can mount the\n+desired transport plugins and configure them (e.g. set channel, host,\n+port and credentials) either globally or when mounting a configuration\n+file.\n+ \n+ They need to mount both sending and receiving plugins in order\n+to use a transport.\n+ \n+```sh\n+kdb mount file.ini system/example ini dbussend dbusreceive","path":"doc/tutorials/notifications.md","position":67,"original_position":67,"commit_id":"c6e67f31dfb301c90c0b32ffaa442e06bd28cb50","original_commit_id":"c6e67f31dfb301c90c0b32ffaa442e06bd28cb50","user":{"login":"markus2330","id":7949075,"avatar_url":"https://avatars1.githubusercontent.com/u/7949075?v=4","gravatar_id":"","url":"https://api.github.com/users/markus2330","html_url":"https://github.com/markus2330","followers_url":"https://api.github.com/users/markus2330/followers","following_url":"https://api.github.com/users/markus2330/following{/other_user}","gists_url":"https://api.github.com/users/markus2330/gists{/gist_id}","starred_url":"https://api.github.com/users/markus2330/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/markus2330/subscriptions","organizations_url":"https://api.github.com/users/markus2330/orgs","repos_url":"https://api.github.com/users/markus2330/repos","events_url":"https://api.github.com/users/markus2330/events{/privacy}","received_events_url":"https://api.github.com/users/markus2330/received_events","type":"User","site_admin":false},"body":"dbussend currently called dbus (incompatible change?)","created_at":"2017-12-05T13:04:23Z","updated_at":"2017-12-05T13:45:48Z","html_url":"https://github.com/ElektraInitiative/libelektra/pull/1515#discussion_r154937833","pull_request_url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515","author_association":"CONTRIBUTOR","_links":{"self":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/comments/154937833"},"html":{"href":"https://github.com/ElektraInitiative/libelektra/pull/1515#discussion_r154937833"},"pull_request":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515"}}},"pull_request":{"url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515","id":126201311,"html_url":"https://github.com/ElektraInitiative/libelektra/pull/1515","diff_url":"https://github.com/ElektraInitiative/libelektra/pull/1515.diff","patch_url":"https://github.com/ElektraInitiative/libelektra/pull/1515.patch","issue_url":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/1515","number":1515,"state":"open","locked":false,"title":"iowrapper: add kdbiowrapper.h & libuv io-wrapper","user":{"login":"waht","id":2136968,"avatar_url":"https://avatars1.githubusercontent.com/u/2136968?v=4","gravatar_id":"","url":"https://api.github.com/users/waht","html_url":"https://github.com/waht","followers_url":"https://api.github.com/users/waht/followers","following_url":"https://api.github.com/users/waht/following{/other_user}","gists_url":"https://api.github.com/users/waht/gists{/gist_id}","starred_url":"https://api.github.com/users/waht/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/waht/subscriptions","organizations_url":"https://api.github.com/users/waht/orgs","repos_url":"https://api.github.com/users/waht/repos","events_url":"https://api.github.com/users/waht/events{/privacy}","received_events_url":"https://api.github.com/users/waht/received_events","type":"User","site_admin":false},"body":"# Purpose\r\n\r\nIncludes the io-wrapper interface and io-wrapper for libuv. These are preparations for io handling of the upcoming notification plugins. Developer documentation (usage in *elektrified* applications) and adapters for DBus, ZeroMQ and Redis are not yet included. Without adapters the code cannot be tried yet.\r\n\r\n**Building:**\r\nEnable the libuv-io-wrapper by setting the new ``IOWRAPPERS`` CMake-variable to \"libuv\" - default is \"\", so no io-wrappers are built by default. The libuv-io-wrapper requires libuv >= 1.9.\r\n\r\n# Checklist\r\n\r\n- [x] commit messages are fine (with references to issues)\r\n- [x] I ran all tests and everything went -fine- (some markdown tests failed for me with and without the io-wrapper - I didn't investigate this further)\r\n- [x] I added code comments, logging, and assertions\r\n\r\n@markus2330 please review my pull request\r\n","created_at":"2017-06-18T20:27:22Z","updated_at":"2017-12-05T13:45:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"b1dc6901241cb7f64d1062f7ea0a69d6e4fdead3","assignee":null,"assignees":[],"requested_reviewers":[],"milestone":null,"commits_url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515/commits","review_comments_url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515/comments","review_comment_url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/comments{/number}","comments_url":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/1515/comments","statuses_url":"https://api.github.com/repos/ElektraInitiative/libelektra/statuses/c6e67f31dfb301c90c0b32ffaa442e06bd28cb50","head":{"label":"waht:iowrapper","ref":"iowrapper","sha":"c6e67f31dfb301c90c0b32ffaa442e06bd28cb50","user":{"login":"waht","id":2136968,"avatar_url":"https://avatars1.githubusercontent.com/u/2136968?v=4","gravatar_id":"","url":"https://api.github.com/users/waht","html_url":"https://github.com/waht","followers_url":"https://api.github.com/users/waht/followers","following_url":"https://api.github.com/users/waht/following{/other_user}","gists_url":"https://api.github.com/users/waht/gists{/gist_id}","starred_url":"https://api.github.com/users/waht/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/waht/subscriptions","organizations_url":"https://api.github.com/users/waht/orgs","repos_url":"https://api.github.com/users/waht/repos","events_url":"https://api.github.com/users/waht/events{/privacy}","received_events_url":"https://api.github.com/users/waht/received_events","type":"User","site_admin":false},"repo":{"id":59359862,"name":"libelektra","full_name":"waht/libelektra","owner":{"login":"waht","id":2136968,"avatar_url":"https://avatars1.githubusercontent.com/u/2136968?v=4","gravatar_id":"","url":"https://api.github.com/users/waht","html_url":"https://github.com/waht","followers_url":"https://api.github.com/users/waht/followers","following_url":"https://api.github.com/users/waht/following{/other_user}","gists_url":"https://api.github.com/users/waht/gists{/gist_id}","starred_url":"https://api.github.com/users/waht/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/waht/subscriptions","organizations_url":"https://api.github.com/users/waht/orgs","repos_url":"https://api.github.com/users/waht/repos","events_url":"https://api.github.com/users/waht/events{/privacy}","received_events_url":"https://api.github.com/users/waht/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/waht/libelektra","description":"Elektra serves as a universal and secure framework to access configuration parameters in a global, hierarchical key database.","fork":true,"url":"https://api.github.com/repos/waht/libelektra","forks_url":"https://api.github.com/repos/waht/libelektra/forks","keys_url":"https://api.github.com/repos/waht/libelektra/keys{/key_id}","collaborators_url":"https://api.github.com/repos/waht/libelektra/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/waht/libelektra/teams","hooks_url":"https://api.github.com/repos/waht/libelektra/hooks","issue_events_url":"https://api.github.com/repos/waht/libelektra/issues/events{/number}","events_url":"https://api.github.com/repos/waht/libelektra/events","assignees_url":"https://api.github.com/repos/waht/libelektra/assignees{/user}","branches_url":"https://api.github.com/repos/waht/libelektra/branches{/branch}","tags_url":"https://api.github.com/repos/waht/libelektra/tags","blobs_url":"https://api.github.com/repos/waht/libelektra/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/waht/libelektra/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/waht/libelektra/git/refs{/sha}","trees_url":"https://api.github.com/repos/waht/libelektra/git/trees{/sha}","statuses_url":"https://api.github.com/repos/waht/libelektra/statuses/{sha}","languages_url":"https://api.github.com/repos/waht/libelektra/languages","stargazers_url":"https://api.github.com/repos/waht/libelektra/stargazers","contributors_url":"https://api.github.com/repos/waht/libelektra/contributors","subscribers_url":"https://api.github.com/repos/waht/libelektra/subscribers","subscription_url":"https://api.github.com/repos/waht/libelektra/subscription","commits_url":"https://api.github.com/repos/waht/libelektra/commits{/sha}","git_commits_url":"https://api.github.com/repos/waht/libelektra/git/commits{/sha}","comments_url":"https://api.github.com/repos/waht/libelektra/comments{/number}","issue_comment_url":"https://api.github.com/repos/waht/libelektra/issues/comments{/number}","contents_url":"https://api.github.com/repos/waht/libelektra/contents/{+path}","compare_url":"https://api.github.com/repos/waht/libelektra/compare/{base}...{head}","merges_url":"https://api.github.com/repos/waht/libelektra/merges","archive_url":"https://api.github.com/repos/waht/libelektra/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/waht/libelektra/downloads","issues_url":"https://api.github.com/repos/waht/libelektra/issues{/number}","pulls_url":"https://api.github.com/repos/waht/libelektra/pulls{/number}","milestones_url":"https://api.github.com/repos/waht/libelektra/milestones{/number}","notifications_url":"https://api.github.com/repos/waht/libelektra/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/waht/libelektra/labels{/name}","releases_url":"https://api.github.com/repos/waht/libelektra/releases{/id}","deployments_url":"https://api.github.com/repos/waht/libelektra/deployments","created_at":"2016-05-21T12:56:47Z","updated_at":"2016-05-21T12:56:52Z","pushed_at":"2017-11-30T20:20:46Z","git_url":"git://github.com/waht/libelektra.git","ssh_url":"git@github.com:waht/libelektra.git","clone_url":"https://github.com/waht/libelektra.git","svn_url":"https://github.com/waht/libelektra","homepage":"http://libelektra.org","size":43470,"stargazers_count":0,"watchers_count":0,"language":"C","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"other","name":"Other","spdx_id":null,"url":null},"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"ElektraInitiative:master","ref":"master","sha":"fd7fa37af2e8a212c8b665d1d1eb0c71776aa5f7","user":{"login":"ElektraInitiative","id":7949092,"avatar_url":"https://avatars1.githubusercontent.com/u/7949092?v=4","gravatar_id":"","url":"https://api.github.com/users/ElektraInitiative","html_url":"https://github.com/ElektraInitiative","followers_url":"https://api.github.com/users/ElektraInitiative/followers","following_url":"https://api.github.com/users/ElektraInitiative/following{/other_user}","gists_url":"https://api.github.com/users/ElektraInitiative/gists{/gist_id}","starred_url":"https://api.github.com/users/ElektraInitiative/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ElektraInitiative/subscriptions","organizations_url":"https://api.github.com/users/ElektraInitiative/orgs","repos_url":"https://api.github.com/users/ElektraInitiative/repos","events_url":"https://api.github.com/users/ElektraInitiative/events{/privacy}","received_events_url":"https://api.github.com/users/ElektraInitiative/received_events","type":"Organization","site_admin":false},"repo":{"id":21063580,"name":"libelektra","full_name":"ElektraInitiative/libelektra","owner":{"login":"ElektraInitiative","id":7949092,"avatar_url":"https://avatars1.githubusercontent.com/u/7949092?v=4","gravatar_id":"","url":"https://api.github.com/users/ElektraInitiative","html_url":"https://github.com/ElektraInitiative","followers_url":"https://api.github.com/users/ElektraInitiative/followers","following_url":"https://api.github.com/users/ElektraInitiative/following{/other_user}","gists_url":"https://api.github.com/users/ElektraInitiative/gists{/gist_id}","starred_url":"https://api.github.com/users/ElektraInitiative/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ElektraInitiative/subscriptions","organizations_url":"https://api.github.com/users/ElektraInitiative/orgs","repos_url":"https://api.github.com/users/ElektraInitiative/repos","events_url":"https://api.github.com/users/ElektraInitiative/events{/privacy}","received_events_url":"https://api.github.com/users/ElektraInitiative/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/ElektraInitiative/libelektra","description":"Elektra serves as a universal and secure framework to access configuration parameters in a global, hierarchical key database.","fork":false,"url":"https://api.github.com/repos/ElektraInitiative/libelektra","forks_url":"https://api.github.com/repos/ElektraInitiative/libelektra/forks","keys_url":"https://api.github.com/repos/ElektraInitiative/libelektra/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ElektraInitiative/libelektra/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ElektraInitiative/libelektra/teams","hooks_url":"https://api.github.com/repos/ElektraInitiative/libelektra/hooks","issue_events_url":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/events{/number}","events_url":"https://api.github.com/repos/ElektraInitiative/libelektra/events","assignees_url":"https://api.github.com/repos/ElektraInitiative/libelektra/assignees{/user}","branches_url":"https://api.github.com/repos/ElektraInitiative/libelektra/branches{/branch}","tags_url":"https://api.github.com/repos/ElektraInitiative/libelektra/tags","blobs_url":"https://api.github.com/repos/ElektraInitiative/libelektra/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ElektraInitiative/libelektra/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ElektraInitiative/libelektra/git/refs{/sha}","trees_url":"https://api.github.com/repos/ElektraInitiative/libelektra/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ElektraInitiative/libelektra/statuses/{sha}","languages_url":"https://api.github.com/repos/ElektraInitiative/libelektra/languages","stargazers_url":"https://api.github.com/repos/ElektraInitiative/libelektra/stargazers","contributors_url":"https://api.github.com/repos/ElektraInitiative/libelektra/contributors","subscribers_url":"https://api.github.com/repos/ElektraInitiative/libelektra/subscribers","subscription_url":"https://api.github.com/repos/ElektraInitiative/libelektra/subscription","commits_url":"https://api.github.com/repos/ElektraInitiative/libelektra/commits{/sha}","git_commits_url":"https://api.github.com/repos/ElektraInitiative/libelektra/git/commits{/sha}","comments_url":"https://api.github.com/repos/ElektraInitiative/libelektra/comments{/number}","issue_comment_url":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/comments{/number}","contents_url":"https://api.github.com/repos/ElektraInitiative/libelektra/contents/{+path}","compare_url":"https://api.github.com/repos/ElektraInitiative/libelektra/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ElektraInitiative/libelektra/merges","archive_url":"https://api.github.com/repos/ElektraInitiative/libelektra/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ElektraInitiative/libelektra/downloads","issues_url":"https://api.github.com/repos/ElektraInitiative/libelektra/issues{/number}","pulls_url":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls{/number}","milestones_url":"https://api.github.com/repos/ElektraInitiative/libelektra/milestones{/number}","notifications_url":"https://api.github.com/repos/ElektraInitiative/libelektra/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ElektraInitiative/libelektra/labels{/name}","releases_url":"https://api.github.com/repos/ElektraInitiative/libelektra/releases{/id}","deployments_url":"https://api.github.com/repos/ElektraInitiative/libelektra/deployments","created_at":"2014-06-21T08:01:04Z","updated_at":"2017-12-04T20:08:25Z","pushed_at":"2017-12-04T13:29:09Z","git_url":"git://github.com/ElektraInitiative/libelektra.git","ssh_url":"git@github.com:ElektraInitiative/libelektra.git","clone_url":"https://github.com/ElektraInitiative/libelektra.git","svn_url":"https://github.com/ElektraInitiative/libelektra","homepage":"https://www.libelektra.org","size":43847,"stargazers_count":68,"watchers_count":68,"language":"C","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":36,"mirror_url":null,"archived":false,"open_issues_count":271,"license":{"key":"other","name":"Other","spdx_id":null,"url":null},"forks":36,"open_issues":271,"watchers":68,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515"},"html":{"href":"https://github.com/ElektraInitiative/libelektra/pull/1515"},"issue":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/1515"},"comments":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/issues/1515/comments"},"review_comments":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515/comments"},"review_comment":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/pulls/1515/commits"},"statuses":{"href":"https://api.github.com/repos/ElektraInitiative/libelektra/statuses/c6e67f31dfb301c90c0b32ffaa442e06bd28cb50"}},"author_association":"CONTRIBUTOR"}}
{"actor":{"display_login":"markus2330"}}