* [PATCH] man/man5/gai.conf: Labels have a label not a precedence
@ 2026-01-04 22:04 dg
2026-01-04 22:23 ` Alejandro Colomar
0 siblings, 1 reply; 6+ messages in thread
From: dg @ 2026-01-04 22:04 UTC (permalink / raw)
To: alx, linux-man; +Cc: Dr. David Alan Gilbert
From: "Dr. David Alan Gilbert" <dave@treblig.org>
The numeric value on a label entry is a label which is separate
from the precedences. Labels are compared with other labels, not
precedences.
Rename the field.
Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
---
man/man5/gai.conf.5 | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
index 4aff0b0b9..ef330995d 100644
--- a/man/man5/gai.conf.5
+++ b/man/man5/gai.conf.5
@@ -26,7 +26,7 @@ .SH DESCRIPTION
.P
The keywords currently recognized are:
.TP
-.BI label\~ netmask\~precedence
+.BI label\~ netmask\~label
The value is added to the label table used in the RFC\ 3484 sorting.
If any
.B label
@@ -35,7 +35,7 @@ .SH DESCRIPTION
All the label definitions
of the default table which are to be maintained have to be duplicated.
Following the keyword,
-the line has to contain a network mask and a precedence value.
+the line has to contain a network mask and a label value.
.TP
.BI precedence\~ netmask\~precedence
This keyword is similar to
--
2.52.0
^ permalink raw reply related [flat|nested] 6+ messages in thread
* Re: [PATCH] man/man5/gai.conf: Labels have a label not a precedence
2026-01-04 22:04 [PATCH] man/man5/gai.conf: Labels have a label not a precedence dg
@ 2026-01-04 22:23 ` Alejandro Colomar
2026-01-04 22:52 ` Dr. David Alan Gilbert
0 siblings, 1 reply; 6+ messages in thread
From: Alejandro Colomar @ 2026-01-04 22:23 UTC (permalink / raw)
To: dg; +Cc: linux-man, Dr. David Alan Gilbert
[-- Attachment #1: Type: text/plain, Size: 1386 bytes --]
Hi David,
On Sun, Jan 04, 2026 at 10:04:38PM +0000, dg@treblig.org wrote:
> From: "Dr. David Alan Gilbert" <dave@treblig.org>
>
> The numeric value on a label entry is a label which is separate
> from the precedences. Labels are compared with other labels, not
> precedences.
Is there any source to verify this?
Cheers,
Alex
>
> Rename the field.
>
> Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> ---
> man/man5/gai.conf.5 | 4 ++--
> 1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> index 4aff0b0b9..ef330995d 100644
> --- a/man/man5/gai.conf.5
> +++ b/man/man5/gai.conf.5
> @@ -26,7 +26,7 @@ .SH DESCRIPTION
> .P
> The keywords currently recognized are:
> .TP
> -.BI label\~ netmask\~precedence
> +.BI label\~ netmask\~label
> The value is added to the label table used in the RFC\ 3484 sorting.
> If any
> .B label
> @@ -35,7 +35,7 @@ .SH DESCRIPTION
> All the label definitions
> of the default table which are to be maintained have to be duplicated.
> Following the keyword,
> -the line has to contain a network mask and a precedence value.
> +the line has to contain a network mask and a label value.
> .TP
> .BI precedence\~ netmask\~precedence
> This keyword is similar to
> --
> 2.52.0
>
--
<https://www.alejandro-colomar.es>
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] man/man5/gai.conf: Labels have a label not a precedence
2026-01-04 22:23 ` Alejandro Colomar
@ 2026-01-04 22:52 ` Dr. David Alan Gilbert
2026-01-14 14:26 ` Dr. David Alan Gilbert
0 siblings, 1 reply; 6+ messages in thread
From: Dr. David Alan Gilbert @ 2026-01-04 22:52 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
* Alejandro Colomar (alx@kernel.org) wrote:
> Hi David,
Hi Alex,
> On Sun, Jan 04, 2026 at 10:04:38PM +0000, dg@treblig.org wrote:
> > From: "Dr. David Alan Gilbert" <dave@treblig.org>
> >
> > The numeric value on a label entry is a label which is separate
> > from the precedences. Labels are compared with other labels, not
> > precedences.
>
> Is there any source to verify this?
The two I checked are:
https://datatracker.ietf.org/doc/html/rfc3484#section-2.1
is the RFC itself, and it talks about the Precedence and labels
as separate values. Note how it's talking in terms of:
If Precedence(A) > Precedence(B), we say that...
and
The algorithms prefer to use a source address S with a destination
address D if Label(S) = Label(D).
So it's label compared to label and precedence compared to precedence.
The corresponding bits of glibc are:
https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1525
where the label values are compared in Rule 5, and the precedence values
are compared in Rule 6.
Dave
>
> Cheers,
> Alex
>
> >
> > Rename the field.
> >
> > Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> > ---
> > man/man5/gai.conf.5 | 4 ++--
> > 1 file changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> > index 4aff0b0b9..ef330995d 100644
> > --- a/man/man5/gai.conf.5
> > +++ b/man/man5/gai.conf.5
> > @@ -26,7 +26,7 @@ .SH DESCRIPTION
> > .P
> > The keywords currently recognized are:
> > .TP
> > -.BI label\~ netmask\~precedence
> > +.BI label\~ netmask\~label
> > The value is added to the label table used in the RFC\ 3484 sorting.
> > If any
> > .B label
> > @@ -35,7 +35,7 @@ .SH DESCRIPTION
> > All the label definitions
> > of the default table which are to be maintained have to be duplicated.
> > Following the keyword,
> > -the line has to contain a network mask and a precedence value.
> > +the line has to contain a network mask and a label value.
> > .TP
> > .BI precedence\~ netmask\~precedence
> > This keyword is similar to
> > --
> > 2.52.0
> >
>
> --
> <https://www.alejandro-colomar.es>
--
-----Open up your eyes, open up your mind, open up your code -------
/ Dr. David Alan Gilbert | Running GNU/Linux | Happy \
\ dave @ treblig.org | | In Hex /
\ _________________________|_____ http://www.treblig.org |_______/
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] man/man5/gai.conf: Labels have a label not a precedence
2026-01-04 22:52 ` Dr. David Alan Gilbert
@ 2026-01-14 14:26 ` Dr. David Alan Gilbert
2026-01-14 20:17 ` Alejandro Colomar
0 siblings, 1 reply; 6+ messages in thread
From: Dr. David Alan Gilbert @ 2026-01-14 14:26 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
* Dr. David Alan Gilbert (dave@treblig.org) wrote:
> * Alejandro Colomar (alx@kernel.org) wrote:
> > Hi David,
>
> Hi Alex,
Hi Alex,
> > On Sun, Jan 04, 2026 at 10:04:38PM +0000, dg@treblig.org wrote:
> > > From: "Dr. David Alan Gilbert" <dave@treblig.org>
> > >
> > > The numeric value on a label entry is a label which is separate
> > > from the precedences. Labels are compared with other labels, not
> > > precedences.
> >
> > Is there any source to verify this?
>
> The two I checked are:
> https://datatracker.ietf.org/doc/html/rfc3484#section-2.1
> is the RFC itself, and it talks about the Precedence and labels
> as separate values. Note how it's talking in terms of:
>
> If Precedence(A) > Precedence(B), we say that...
> and
> The algorithms prefer to use a source address S with a destination
> address D if Label(S) = Label(D).
>
> So it's label compared to label and precedence compared to precedence.
>
> The corresponding bits of glibc are:
> https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1525
>
> where the label values are compared in Rule 5, and the precedence values
> are compared in Rule 6.
Does that explanation I sent make sense?
Dave
> Dave
>
> >
> > Cheers,
> > Alex
> >
> > >
> > > Rename the field.
> > >
> > > Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> > > ---
> > > man/man5/gai.conf.5 | 4 ++--
> > > 1 file changed, 2 insertions(+), 2 deletions(-)
> > >
> > > diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> > > index 4aff0b0b9..ef330995d 100644
> > > --- a/man/man5/gai.conf.5
> > > +++ b/man/man5/gai.conf.5
> > > @@ -26,7 +26,7 @@ .SH DESCRIPTION
> > > .P
> > > The keywords currently recognized are:
> > > .TP
> > > -.BI label\~ netmask\~precedence
> > > +.BI label\~ netmask\~label
> > > The value is added to the label table used in the RFC\ 3484 sorting.
> > > If any
> > > .B label
> > > @@ -35,7 +35,7 @@ .SH DESCRIPTION
> > > All the label definitions
> > > of the default table which are to be maintained have to be duplicated.
> > > Following the keyword,
> > > -the line has to contain a network mask and a precedence value.
> > > +the line has to contain a network mask and a label value.
> > > .TP
> > > .BI precedence\~ netmask\~precedence
> > > This keyword is similar to
> > > --
> > > 2.52.0
> > >
> >
> > --
> > <https://www.alejandro-colomar.es>
>
>
> --
> -----Open up your eyes, open up your mind, open up your code -------
> / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> \ dave @ treblig.org | | In Hex /
> \ _________________________|_____ http://www.treblig.org |_______/
--
-----Open up your eyes, open up your mind, open up your code -------
/ Dr. David Alan Gilbert | Running GNU/Linux | Happy \
\ dave @ treblig.org | | In Hex /
\ _________________________|_____ http://www.treblig.org |_______/
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] man/man5/gai.conf: Labels have a label not a precedence
2026-01-14 14:26 ` Dr. David Alan Gilbert
@ 2026-01-14 20:17 ` Alejandro Colomar
2026-01-14 21:16 ` Dr. David Alan Gilbert
0 siblings, 1 reply; 6+ messages in thread
From: Alejandro Colomar @ 2026-01-14 20:17 UTC (permalink / raw)
To: Dr. David Alan Gilbert; +Cc: linux-man
[-- Attachment #1: Type: text/plain, Size: 3649 bytes --]
Hi Dave,
On Wed, Jan 14, 2026 at 02:26:11PM +0000, Dr. David Alan Gilbert wrote:
> * Dr. David Alan Gilbert (dave@treblig.org) wrote:
> > * Alejandro Colomar (alx@kernel.org) wrote:
> > > Hi David,
> >
> > Hi Alex,
>
> Hi Alex,
> > > On Sun, Jan 04, 2026 at 10:04:38PM +0000, dg@treblig.org wrote:
> > > > From: "Dr. David Alan Gilbert" <dave@treblig.org>
> > > >
> > > > The numeric value on a label entry is a label which is separate
> > > > from the precedences. Labels are compared with other labels, not
> > > > precedences.
> > >
> > > Is there any source to verify this?
> >
> > The two I checked are:
> > https://datatracker.ietf.org/doc/html/rfc3484#section-2.1
> > is the RFC itself, and it talks about the Precedence and labels
> > as separate values. Note how it's talking in terms of:
> >
> > If Precedence(A) > Precedence(B), we say that...
> > and
> > The algorithms prefer to use a source address S with a destination
> > address D if Label(S) = Label(D).
> >
> > So it's label compared to label and precedence compared to precedence.
> >
> > The corresponding bits of glibc are:
> > https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1525
> >
> > where the label values are compared in Rule 5, and the precedence values
> > are compared in Rule 6.
>
> Does that explanation I sent make sense?
Thanks for the ping, and sorry for being slow!
I've verified now, and have applied the patch. Thanks for the patch and
for the follow-up links and details!
Have a lovely night!
Alex
>
> Dave
>
> > Dave
> >
> > >
> > > Cheers,
> > > Alex
> > >
> > > >
> > > > Rename the field.
> > > >
> > > > Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> > > > ---
> > > > man/man5/gai.conf.5 | 4 ++--
> > > > 1 file changed, 2 insertions(+), 2 deletions(-)
> > > >
> > > > diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> > > > index 4aff0b0b9..ef330995d 100644
> > > > --- a/man/man5/gai.conf.5
> > > > +++ b/man/man5/gai.conf.5
> > > > @@ -26,7 +26,7 @@ .SH DESCRIPTION
> > > > .P
> > > > The keywords currently recognized are:
> > > > .TP
> > > > -.BI label\~ netmask\~precedence
> > > > +.BI label\~ netmask\~label
> > > > The value is added to the label table used in the RFC\ 3484 sorting.
> > > > If any
> > > > .B label
> > > > @@ -35,7 +35,7 @@ .SH DESCRIPTION
> > > > All the label definitions
> > > > of the default table which are to be maintained have to be duplicated.
> > > > Following the keyword,
> > > > -the line has to contain a network mask and a precedence value.
> > > > +the line has to contain a network mask and a label value.
> > > > .TP
> > > > .BI precedence\~ netmask\~precedence
> > > > This keyword is similar to
> > > > --
> > > > 2.52.0
> > > >
> > >
> > > --
> > > <https://www.alejandro-colomar.es>
> >
> >
> > --
> > -----Open up your eyes, open up your mind, open up your code -------
> > / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> > \ dave @ treblig.org | | In Hex /
> > \ _________________________|_____ http://www.treblig.org |_______/
> --
> -----Open up your eyes, open up your mind, open up your code -------
> / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> \ dave @ treblig.org | | In Hex /
> \ _________________________|_____ http://www.treblig.org |_______/
--
<https://www.alejandro-colomar.es>
[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 833 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: [PATCH] man/man5/gai.conf: Labels have a label not a precedence
2026-01-14 20:17 ` Alejandro Colomar
@ 2026-01-14 21:16 ` Dr. David Alan Gilbert
0 siblings, 0 replies; 6+ messages in thread
From: Dr. David Alan Gilbert @ 2026-01-14 21:16 UTC (permalink / raw)
To: Alejandro Colomar; +Cc: linux-man
* Alejandro Colomar (alx@kernel.org) wrote:
> Hi Dave,
>
> On Wed, Jan 14, 2026 at 02:26:11PM +0000, Dr. David Alan Gilbert wrote:
> > * Dr. David Alan Gilbert (dave@treblig.org) wrote:
> > > * Alejandro Colomar (alx@kernel.org) wrote:
> > > > Hi David,
> > >
> > > Hi Alex,
> >
> > Hi Alex,
> > > > On Sun, Jan 04, 2026 at 10:04:38PM +0000, dg@treblig.org wrote:
> > > > > From: "Dr. David Alan Gilbert" <dave@treblig.org>
> > > > >
> > > > > The numeric value on a label entry is a label which is separate
> > > > > from the precedences. Labels are compared with other labels, not
> > > > > precedences.
> > > >
> > > > Is there any source to verify this?
> > >
> > > The two I checked are:
> > > https://datatracker.ietf.org/doc/html/rfc3484#section-2.1
> > > is the RFC itself, and it talks about the Precedence and labels
> > > as separate values. Note how it's talking in terms of:
> > >
> > > If Precedence(A) > Precedence(B), we say that...
> > > and
> > > The algorithms prefer to use a source address S with a destination
> > > address D if Label(S) = Label(D).
> > >
> > > So it's label compared to label and precedence compared to precedence.
> > >
> > > The corresponding bits of glibc are:
> > > https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1525
> > >
> > > where the label values are compared in Rule 5, and the precedence values
> > > are compared in Rule 6.
> >
> > Does that explanation I sent make sense?
>
> Thanks for the ping, and sorry for being slow!
>
> I've verified now, and have applied the patch. Thanks for the patch and
> for the follow-up links and details!
Thanks!
(I think that's all my gai.conf changes for now; the fallout of me turning on IPv6
at home!)
Dave
>
> Have a lovely night!
> Alex
>
> >
> > Dave
> >
> > > Dave
> > >
> > > >
> > > > Cheers,
> > > > Alex
> > > >
> > > > >
> > > > > Rename the field.
> > > > >
> > > > > Signed-off-by: Dr. David Alan Gilbert <dave@treblig.org>
> > > > > ---
> > > > > man/man5/gai.conf.5 | 4 ++--
> > > > > 1 file changed, 2 insertions(+), 2 deletions(-)
> > > > >
> > > > > diff --git a/man/man5/gai.conf.5 b/man/man5/gai.conf.5
> > > > > index 4aff0b0b9..ef330995d 100644
> > > > > --- a/man/man5/gai.conf.5
> > > > > +++ b/man/man5/gai.conf.5
> > > > > @@ -26,7 +26,7 @@ .SH DESCRIPTION
> > > > > .P
> > > > > The keywords currently recognized are:
> > > > > .TP
> > > > > -.BI label\~ netmask\~precedence
> > > > > +.BI label\~ netmask\~label
> > > > > The value is added to the label table used in the RFC\ 3484 sorting.
> > > > > If any
> > > > > .B label
> > > > > @@ -35,7 +35,7 @@ .SH DESCRIPTION
> > > > > All the label definitions
> > > > > of the default table which are to be maintained have to be duplicated.
> > > > > Following the keyword,
> > > > > -the line has to contain a network mask and a precedence value.
> > > > > +the line has to contain a network mask and a label value.
> > > > > .TP
> > > > > .BI precedence\~ netmask\~precedence
> > > > > This keyword is similar to
> > > > > --
> > > > > 2.52.0
> > > > >
> > > >
> > > > --
> > > > <https://www.alejandro-colomar.es>
> > >
> > >
> > > --
> > > -----Open up your eyes, open up your mind, open up your code -------
> > > / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> > > \ dave @ treblig.org | | In Hex /
> > > \ _________________________|_____ http://www.treblig.org |_______/
> > --
> > -----Open up your eyes, open up your mind, open up your code -------
> > / Dr. David Alan Gilbert | Running GNU/Linux | Happy \
> > \ dave @ treblig.org | | In Hex /
> > \ _________________________|_____ http://www.treblig.org |_______/
>
> --
> <https://www.alejandro-colomar.es>
--
-----Open up your eyes, open up your mind, open up your code -------
/ Dr. David Alan Gilbert | Running GNU/Linux | Happy \
\ dave @ treblig.org | | In Hex /
\ _________________________|_____ http://www.treblig.org |_______/
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2026-01-14 21:16 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-01-04 22:04 [PATCH] man/man5/gai.conf: Labels have a label not a precedence dg
2026-01-04 22:23 ` Alejandro Colomar
2026-01-04 22:52 ` Dr. David Alan Gilbert
2026-01-14 14:26 ` Dr. David Alan Gilbert
2026-01-14 20:17 ` Alejandro Colomar
2026-01-14 21:16 ` Dr. David Alan Gilbert
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox