{"action":"created","issue":{"url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/6187","repository_url":"https://api.github.com/repos/zephyrproject-rtos/zephyr","labels_url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/6187/labels{/name}","comments_url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/6187/comments","events_url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/6187/events","html_url":"https://github.com/zephyrproject-rtos/zephyr/issues/6187","id":296847976,"number":6187,"title":"entropy: Clarify API contract","user":{"login":"pfalcon","id":500451,"avatar_url":"https://avatars3.githubusercontent.com/u/500451?v=4","gravatar_id":"","url":"https://api.github.com/users/pfalcon","html_url":"https://github.com/pfalcon","followers_url":"https://api.github.com/users/pfalcon/followers","following_url":"https://api.github.com/users/pfalcon/following{/other_user}","gists_url":"https://api.github.com/users/pfalcon/gists{/gist_id}","starred_url":"https://api.github.com/users/pfalcon/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/pfalcon/subscriptions","organizations_url":"https://api.github.com/users/pfalcon/orgs","repos_url":"https://api.github.com/users/pfalcon/repos","events_url":"https://api.github.com/users/pfalcon/events{/privacy}","received_events_url":"https://api.github.com/users/pfalcon/received_events","type":"User","site_admin":false},"labels":[{"id":700751208,"url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/labels/area:%20Drivers","name":"area: Drivers","color":"ededed","default":false},{"id":383053982,"url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/labels/enhancement","name":"enhancement","color":"e99695","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":5,"created_at":"2018-02-13T18:56:32Z","updated_at":"2018-02-23T20:24:13Z","closed_at":null,"author_association":"MEMBER","body":"Currently, entropy subsystem interface description is pretty bare: https://github.com/zephyrproject-rtos/zephyr/blob/master/include/entropy.h#L45\r\n\r\nFollowing issues are worth being specified explicitly:\r\n\r\n1. Many hardware \"true RNG\" generators have limited bandwidth, so it should be explicitly specified that calling entropy_get_entropy() may block, in the sense that calling thread may be put inti sleep, and another thread rescheduled instead.\r\n2. It's worth to clarify re-entrancy of this API, specifically whether it's safe to call entropy_get_entropy() from multiple threads as is, or not, i.e. only one thread can call it, and multiple threads should use external mutex for synchronization.\r\n\r\nNote that to guarantee how-quality entropy generation, we probably need to require thread-safety support, because otherwise it would be too easy to get low-quality entropy, which is a security issue.\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/comments/368128680","html_url":"https://github.com/zephyrproject-rtos/zephyr/issues/6187#issuecomment-368128680","issue_url":"https://api.github.com/repos/zephyrproject-rtos/zephyr/issues/6187","id":368128680,"user":{"login":"carlescufi","id":12450381,"avatar_url":"https://avatars3.githubusercontent.com/u/12450381?v=4","gravatar_id":"","url":"https://api.github.com/users/carlescufi","html_url":"https://github.com/carlescufi","followers_url":"https://api.github.com/users/carlescufi/followers","following_url":"https://api.github.com/users/carlescufi/following{/other_user}","gists_url":"https://api.github.com/users/carlescufi/gists{/gist_id}","starred_url":"https://api.github.com/users/carlescufi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/carlescufi/subscriptions","organizations_url":"https://api.github.com/users/carlescufi/orgs","repos_url":"https://api.github.com/users/carlescufi/repos","events_url":"https://api.github.com/users/carlescufi/events{/privacy}","received_events_url":"https://api.github.com/users/carlescufi/received_events","type":"User","site_admin":false},"created_at":"2018-02-23T20:24:12Z","updated_at":"2018-02-23T20:24:12Z","author_association":"COLLABORATOR","body":"CC @lpereira @tbursztyka @anangl "}}
{"actor":{"display_login":"carlescufi"}}