mirrors/arti.git/crates/tor-netdoc/src/doc, branch arti-v1.1.4

netdoc: Document that particular bit values for flags are not part of our API.

2023-04-17T21:09:58Z

netstatus: re-number routerstatus flags to go in order.

2023-04-17T20:50:08Z

Otherwise there is too much risk of accidentally adding in another 1<<12 when we meant to add a 1<<13. (It would be neat to have an alternative to bitflags here that would auto-number our bitflags for us.)

netdir: more documentation on MIDDLE_ONLY flag.

2023-04-17T20:48:15Z

Clarify that it isn't anything that most users will need to check.

netdoc: Add MiddleOnly flag to RelayFlags

2023-04-17T09:53:04Z

Closes #833

Merge branch 'remove-hsdesc-todo' into 'main'

2023-04-12T16:52:59Z

Remove misleading TODO. See merge request tpo/core/arti!1130

Remove misleading TODO.

2023-04-11T18:44:50Z

The `superencrypted` blob is, in fact, followed by a newline. See [core/torspec!122]. [core/torspec!122]: https://gitlab.torproject.org/tpo/core/torspec/-/merge_requests/122 Signed-off-by: Gabriela Moldovan

tor-netdoc: Tidy up and fix some broken intra-doc links

2023-04-11T18:31:10Z

1. Abbreviate the link text, and don't have it contain `crate` which is not really great in docs. 2. Use `super::` for the link target, to find the right thing. (`crate` doesn't seem to work in rustdoc, perhaps deliberately, although the error messages are ridiculous and claim the nonexistence of intermediate modules.) 3. Wrap the lines a bit more.

tor-netdoc: Expose test data under new "testing" feature flag

2023-04-05T10:02:36Z

tor-netdoc: Fix feature builds

2023-04-05T10:02:33Z

Fixes cargo +stable test --locked --offline F -p tor-netdoc cargo +stable clippy -p tor-netdoc F --all-targets for values of F including --all-features --features=hs-client --features=hs-common --features=hs-service (nothing)

Generate a new KP_hss_desc_enc keypair for each new descriptor.

2023-03-31T14:04:30Z

Previously, to build descriptors for hidden services with client auth enabled, in addition to the list of authorized clients, users of `HsDescBuilder` were required to also provide a descriptor encryption keypair and a descriptor cookie. This was potentially dangerous and/or error-prone, because the ephemeral encryption key and the descriptor cookie are expected to be randomly generated and unique for each descriptor. This change makes `ClientAuth` private to the `hsdesc::build` module and updates `HsDescBuilder` to build `ClientAuth`s internally. Users now only need to provide the list of authorized client public keys. Signed-off-by: Gabriela Moldovan