gai.conf(5): Example table

gai.conf(5): Example table

[Dr. David Alan Gilbert]

Hi,
  The 'EXAMPLES' section in gai.conf(5) has a table that matches
RFC 3484; however that's not what glibc's default label table is;
it's table has three extra entries:

https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1341

and partially in the more readable:
https://sourceware.org/git/?p=glibc.git;a=blob;f=posix/gai.conf;h=4616ed005b2e064175c88609b6d6022a6da4d5d8;hb=HEAD#l31

I wonder if it makes sense to document glibc's default rather than the
RFC default?

Dave
-- 
 -----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   |_______/

Re: gai.conf(5): Example table

[Alejandro Colomar]

[-- Attachment #1: Type: text/plain, Size: 1199 bytes --]

Hi Dave,

On Mon, Jan 05, 2026 at 12:04:09AM +0000, Dr. David Alan Gilbert wrote:
> Hi,
>   The 'EXAMPLES' section in gai.conf(5) has a table that matches
> RFC 3484; however that's not what glibc's default label table is;
> it's table has three extra entries:
> 
> https://sourceware.org/git/?p=glibc.git;a=blob;f=nss/getaddrinfo.c;h=c0f496f96c752220e68bf0257d9ff1ffc624ebe6;hb=HEAD#l1341
> 
> and partially in the more readable:
> https://sourceware.org/git/?p=glibc.git;a=blob;f=posix/gai.conf;h=4616ed005b2e064175c88609b6d6022a6da4d5d8;hb=HEAD#l31
> 
> I wonder if it makes sense to document glibc's default rather than the
> RFC default?

Yup; feel free to send patches documenting the glibc behavior.  It would
also be good to note that those differences are specific to glibc.


Have a lovely New Year!
Alex

> 
> Dave
> -- 
>  -----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 --]