[roll] Roll fuchsia [docs][handle] Improve header comments for zx_handle_t

Make it more clear in the comments around the definition of the
fundamental handle type that the last two bits of a valid handle will
always be set to 1, and that users can take advantage of this fact to
encode information in their handle state, as long as bits are restored
to 1 if the handle value is to be passed to a syscall.

Also, leave a link to the public `zx_handle_t` docs which also
describes this behavior to make it a bit easier for users to find if
they are simply skimming source code.

Original-Reviewed-on: https://fuchsia-review.googlesource.com/c/fuchsia/+/715731
Original-Revision: 16b3f8ee0cc716057bce58e43cd4d5f260c47cf1
GitOrigin-RevId: 6a8141cbb77b5d126cef1f8cdf34005ee016c9b0
Change-Id: Ib7078ae13c27c8607d1126b2781d703b6b2f820a
1 file changed
tree: 77d9379b0efa7f7adc225b7253bc8aaccd406e72
  1. git-hooks/
  2. infra/
  3. third_party/
  4. cts
  5. firmware
  6. flower
  7. jiri.lock
  8. minimal
  9. prebuilts
  10. README.md
  11. stem
  12. test_durations
  13. toolchain
README.md

Integration

This repository contains Fuchsia's Global Integration manifest files.

Making changes

All changes should be made to the internal version of this repository. Our infrastructure automatically updates this version when the internal one changes.

Currently all changes must be made by a Google employee. Non-Google employees wishing to make a change can ask for assistance via the IRC channel #fuchsia on Freenode.

Obtaining the source

First install Jiri.

Next run:

$ jiri init
$ jiri import minimal https://fuchsia.googlesource.com/integration
$ jiri update

Third party

Third party projects should have their own subdirectory in ./third_party.