mirrors/arti.git/doc/hsc.md, branch arti-v2.5.1mirror of https://gitlab.torproject.org/tpo/core/arti
http://git.dilluti0n.com/mirrors/arti.git/atom?h=arti-v2.5.12025-11-24T18:35:58Zdoc/hsc.md: Add clarification about KeystoreIds2025-11-24T18:35:58ZIan Jacksoniwj@torproject.org2025-11-24T18:30:26Zurn:sha1:ea2581e3ccd78e05a08885bfaf23c1e04e87c0c7
Applies @Dizet's suggestion from
https://gitlab.torproject.org/tpo/core/arti/-/merge_requests/3485#note_3291709
doc/hsc.md: Use toml block for config example2025-11-24T12:33:41ZGabriela Moldovangabi@torproject.org2025-11-24T12:33:17Zurn:sha1:a32aeaed578408fb14eb81d14e9c99ea0658868bdoc/hsc.md: Remove note about invalid keystores2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:33:54Zurn:sha1:c6d6f24a8fe5885ded11694948ad38ea68c498a8
I don't think we need to tell users a C Tor keystore cannot have more
than one client entry for the same onion service, because they already
know that: C Tor doesn't allow it, so if they are migrating an existing
C Tor configuration, it will likely be valid. And if not, the error
message will inform them what went wrong.
So I am removing this section in the interest in keeping this guide
short and sweet and straight to the point.
doc/hsc.md: Warn against running tor/arti during the migration2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:33:06Zurn:sha1:9ac7a6f1593177554157d8961229f2144b4705a0
This is analogous to the warning from `doc/hss.md`.
doc/hsc.md: s/ctor-keystore-id/ctor-client2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:22:35Zurn:sha1:5bd1d7817dcca3c51a3bbe0faf21b32d26e1e6bb
Otherwise users might think it's idiomatic/necessary to add the `-id`
suffix to their keystore identifiers.
doc/hsc.md: Rephrase section about --batch2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:18:30Zurn:sha1:9d24c0ac53a9e8cb4f390a537057d15818dff2bd
This makes the language more consistent with the `hss ctor-migrate`
docs.
doc/hsc.md: Add missing text before example invocation2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:16:44Zurn:sha1:9eb1ad60f88d13f84da125e127e4221565486453doc/hsc.md: Say keystore identifiers must be unique2025-11-24T12:30:22ZGabriela Moldovangabi@torproject.org2025-11-24T11:16:10Zurn:sha1:c3af8fbfb35c4462a5ebe34862d96a86cbfa5cc8doc/hsc.md: Add comments to the config example2025-11-24T12:30:21ZGabriela Moldovangabi@torproject.org2025-11-24T11:14:04Zurn:sha1:d3cc6402751fa51ca9c53ffb9a6c1fe7b401f660
This should help clarify what each of those options means.
It's also consistent with the analogous example from `doc/hss.md`.
doc/hsc.md: Remove config from usage example2025-11-24T12:30:21ZGabriela Moldovangabi@torproject.org2025-11-24T11:04:58Zurn:sha1:027b33e679f6bc55e12754e2a493224f3a9c6832
There's no need to pass a config file when using `-o`.