{"action":"created","issue":{"url":"https://api.github.com/repos/ansible/ansible/issues/35850","repository_url":"https://api.github.com/repos/ansible/ansible","labels_url":"https://api.github.com/repos/ansible/ansible/issues/35850/labels{/name}","comments_url":"https://api.github.com/repos/ansible/ansible/issues/35850/comments","events_url":"https://api.github.com/repos/ansible/ansible/issues/35850/events","html_url":"https://github.com/ansible/ansible/issues/35850","id":295239606,"number":35850,"title":"Error in documentation of \"mount\" module \"state\" parameter","user":{"login":"fthommen","id":279232,"avatar_url":"https://avatars3.githubusercontent.com/u/279232?v=4","gravatar_id":"","url":"https://api.github.com/users/fthommen","html_url":"https://github.com/fthommen","followers_url":"https://api.github.com/users/fthommen/followers","following_url":"https://api.github.com/users/fthommen/following{/other_user}","gists_url":"https://api.github.com/users/fthommen/gists{/gist_id}","starred_url":"https://api.github.com/users/fthommen/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/fthommen/subscriptions","organizations_url":"https://api.github.com/users/fthommen/orgs","repos_url":"https://api.github.com/users/fthommen/repos","events_url":"https://api.github.com/users/fthommen/events{/privacy}","received_events_url":"https://api.github.com/users/fthommen/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2018-02-07T18:12:17Z","updated_at":"2018-02-07T18:16:41Z","closed_at":null,"author_association":"NONE","body":"##### ISSUE TYPE\r\n - Documentation Report\r\n\r\n##### COMPONENT NAME\r\nmount\r\n\r\n##### ANSIBLE VERSION\r\n```\r\n-bash-4.2$ ansible --version\r\nansible 2.4.2.0\r\n  config file = /[...]/ansible.cfg\r\n  configured module search path = [u'/[...]/.ansible/plugins/modules', u'/usr/share/ansible/plugins/modules']\r\n  ansible python module location = /usr/lib/python2.7/site-packages/ansible\r\n  executable location = /usr/bin/ansible\r\n  python version = 2.7.5 (default, Aug  4 2017, 00:39:18) [GCC 4.8.5 20150623 (Red Hat 4.8.5-16)]\r\n-bash-4.2$ \r\n```\r\n\r\n##### CONFIGURATION\r\n```\r\nANSIBLE_NOCOLOR(env: ANSIBLE_NOCOLOR) = True\r\nDEFAULT_CALLBACK_PLUGIN_PATH(/[...]) = [u'[...]/lib/callback_plugins']\r\nDEFAULT_GATHERING([...]) = smart\r\nDEFAULT_GATHER_SUBSET([...]) = min\r\nDEFAULT_HOST_LIST([...]) = [u'/[...]/inventory']\r\nDEFAULT_LOG_PATH([...]) = /[...]/ansible.log\r\nHOST_KEY_CHECKING([...]) = False\r\n```\r\n\r\n##### OS / ENVIRONMENT\r\nCentOS 7.4, x86_64 fully updated\r\n\r\n##### SUMMARY\r\nThe documentation of the `state` parameter of the `mount` module on http://docs.ansible.com/ansible/latest/mount_module.html is not completely correct.  It says\r\n\r\nIf `mounted`, the device will be actively mounted and appropriately configured in fstab.\r\nIf `unmounted`, the device will be unmounted without changing fstab.\r\n**_`absent` and `present` only deal with fstab but will not affect current mounting._**\r\nIf specifying `mounted` and the mount point is not present, the mount point will be created.\r\nSimilarly, specifying `absent` will remove the mount point directory.\r\n\r\n\r\nIt is correct, that `present` only deals with fstab, but `absent` modifies fstab _and_ unmounts a filesystem _and_ removes the mount point directory\r\n"},"comment":{"url":"https://api.github.com/repos/ansible/ansible/issues/comments/363860628","html_url":"https://github.com/ansible/ansible/issues/35850#issuecomment-363860628","issue_url":"https://api.github.com/repos/ansible/ansible/issues/35850","id":363860628,"user":{"login":"ansibot","id":6585283,"avatar_url":"https://avatars0.githubusercontent.com/u/6585283?v=4","gravatar_id":"","url":"https://api.github.com/users/ansibot","html_url":"https://github.com/ansibot","followers_url":"https://api.github.com/users/ansibot/followers","following_url":"https://api.github.com/users/ansibot/following{/other_user}","gists_url":"https://api.github.com/users/ansibot/gists{/gist_id}","starred_url":"https://api.github.com/users/ansibot/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ansibot/subscriptions","organizations_url":"https://api.github.com/users/ansibot/orgs","repos_url":"https://api.github.com/users/ansibot/repos","events_url":"https://api.github.com/users/ansibot/events{/privacy}","received_events_url":"https://api.github.com/users/ansibot/received_events","type":"User","site_admin":false},"created_at":"2018-02-07T18:16:41Z","updated_at":"2018-02-07T18:16:41Z","author_association":"CONTRIBUTOR","body":"Files identified in the description:\n* [lib/ansible/modules/system/mount.py](https://github.com/ansible/ansible/blob/devel/lib/ansible/modules/system/mount.py)\n\nIf these files are inaccurate, please update the `component name` section of the description or use the `!component` bot command.\n\n[click here for bot help](https://github.com/ansible/ansibullbot/blob/master/ISSUE_HELP.md)\n<!--- boilerplate: components_banner --->"}}
{"actor":{"display_login":"ansibot"}}