tree 95f99e264c65c1d34cef39dce0b5795447c7a926
parent 0d9be316eddf2eb66d266d9e68aed7e39671fc91
author Alex Deymo <deymo@google.com> 1489716927 -0700
committer Alex Deymo <deymo@google.com> 1489772932 +0000

Update qtaguid tag/untag documentation.

The qtaguid_tagSocket() function tags a network socket by passing a
reference to the given socket to the qtaguid kernel module. The module
will keep the socket alive even if the process calls close() on said
socket. In this scenario, the socket object would not be destroyed
even if all the file descriptor.

While this is at least a memory leak, it plays bad with epoll(7)
if you also didn't remove the socket from the epoll fd before closing
since epoll will not notice that the socket was closed and there is no
way to remove the socket from epoll after it was closed.

This patch updates the documentation to explicitly mention that the
socket must be untag before closing or bad things happen.

Bug: 36264049
Test: None.
Change-Id: I564a9b6d11d22b43a6c12312524386c0338b42ed