Skip to content

Ipv6Addr::is_documentation should be expanded to include RFC 9637's 3ffff::/20 #137821

Closed

Description

@jrose-signal

The unstable Ipv6Addr::is_documentation (#27709) is documented, matching the implementation, as

Returns true if this is an address reserved for documentation (2001:db8::/32).

This property is defined in IETF RFC 3849.

However, RFC 9637 from Aug 2024 added 3fff::/20 as a documentation space as well, and thus this API should be updated.

This does mean two programs may disagree on whether an address is_documentation based on which version of the stdlib they use…but I think that's inevitable with anything based on IETF standards. (In some cases it might make sense to explicitly pin the library to an earlier version of the standard, but I don't think that's necessary here.)

Activity

  1. added
    needs-triageThis issue may need triage. Remove when done. See docs forge.rust-lang.org/release/issue-triaging
    on Feb 28, 2025
  2. removed
    needs-triageThis issue may need triage. Remove when done. See docs forge.rust-lang.org/release/issue-triaging
    on Mar 1, 2025
  3. the8472 commented on Mar 1, 2025

    @the8472
    Member

    This does mean two programs may disagree on whether an address is_documentation based on which version of the stdlib they use

    Even if that were a concern (I don't think it is), the feature is unstable so we're free to change it anyway.

  4. fgsch commented on Jun 3, 2025

    @fgsch

    I was just looking at this myself and it seems this was implemented in #135741.

  5. jrose-signal commented on Jun 3, 2025

    @jrose-signal
    Author

    That's what I get for only looking at the stable source in the rustdocs…hooray!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    C-bugCategory: This is a bug.T-libs-api[DEPRECATED; DO NOT USE]

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions