* [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