#1947 Document use_ipv6, use_ipv4

Reporter Zash
Owner Nobody
Created
Updated
Stars ★★ (3)
Tags
  • Component-Docs
  • Type-Defect
  • Priority-Medium
  • Status-Accepted
  • Patch
  1. Zash on

    Link to relevant page (if any): https://prosody.im/doc/ports What's wrong and how can it be improved? I find no mention of the options use_ipv6 and use_ipv4, which would probably make sense to have documented on this page. Should probably word it to recommend using those settings instead of changing `interfaces` to e.g. disable IPv4 in an IPv6-only environment or vice versa.

  2. eerielili on

    I've added this blurb at the end of the "Default interfaces" section: https://git.les-miquelots.net/prosody-patches/tree/doc_ports-document-useipv4-useipv6-option.patch

  3. Zash on

    Thanks for the patch. When I wrote this, I was intending to rewrite the whole section to make it clearer when the `use_ipv` settings are more appropriate to use than `interfaces`, as it can currently be read to imply that `interfaces` could be used to disable IPv6 or IPv4 entirely, but it would be incomplete.

    Changes
    • tags Patch
  4. eerielili on

    Re Zash, Thanks for the feedback. I've modified the patch, the use_ipv* are put first and marked as recommended.

  5. Zash on

    Sorry for the delay. I'm not sure the patched text is accurate and I am uncomfortable with the word "recommended" anywhere near instructions for disabling IPv6. Sorry I can't describe what is wrong, if I could I would not have filed this issue.

  6. eerielili on

    Re Zash, No problem, I was busy too. I've dropped the recommends and worded use of the settings better imo. Thanks for the feedback!

New comment

Not published. Used for spam prevention and optional update notifications.