Home | History | Annotate | Download | only in net
History log of /src/lib/libc/net/getaddrinfo.3
RevisionDateAuthorComments
 1.61  09-May-2024  wiz Document that freeaddrinfo(NULL) dumps core.

A source code comment already said this, but it's easier to
find in a man page.
 1.60  04-Jun-2020  nia branches: 1.60.6;
getaddrinfo.3: order of the struct members is wrong, correct it
 1.59  03-Jul-2017  wiz Remove workaround for ancient HTML generation code.
 1.58  13-Dec-2015  christos mention ip6addrctl
 1.57  03-May-2013  wiz New sentence, new line.
 1.56  03-May-2013  christos document AI_SRV
 1.55  17-Apr-2010  wiz branches: 1.55.6; 1.55.12;
Join URL.
 1.54  17-Apr-2010  jruoho Use the common template for the USENIX paper. Add URL.
 1.53  22-Mar-2010  joerg Use .In for header files instead of .Ar Pa and variations.
 1.52  14-Dec-2009  wiz Bump date for previous.
 1.51  14-Dec-2009  dholland getaddrinfo is defined to use the AF_* constants, even though perhaps its
interface ought to have been defined in terms of PF_*. Add a note about
how the distinction has been lost anyway. Fixes PR lib/42384.
 1.50  02-Oct-2009  wiz Revert a -> an changes: Adding an 'n' follows pronunciation, not writing.
 1.49  02-Oct-2009  wiz Bump date for new allocaddrinfo.
 1.48  02-Oct-2009  cegger fix grammar: a -> an
 1.47  02-Oct-2009  tsarna Introduce allocaddrinfo(3) to make writing getaddrinfo() nss plugins easier.
Discussed on tech-net.
 1.46  23-Dec-2006  wiz Add missing article.
 1.45  24-Nov-2006  reed Document AI_NUMERICSERV.

(When manpage was rewritten some docs were lost.)
 1.44  18-Jul-2006  christos Remove comments that do not reflect reality anymore.
 1.43  21-Mar-2005  kleink Only name <netdb.h> in the synopsis, like the old manual page used to.
 1.42  21-Mar-2005  kleink Add restrict qualifiers to getaddrinfo() and getnameinfo() arguments.
 1.41  28-Jan-2005  wiz branches: 1.41.2;
Use In instead of Fd; use \*[Am]\*[Lt]\*[Gt] for html output. Uppercase FREENIX.
 1.40  28-Jan-2005  itojun title was backwards. djm@openbsd
 1.39  11-Jan-2005  itojun replace with written-from-scratch manpage. (fixes ISOC copyright issue)
 1.38  20-Dec-2004  christos revert previous change while discussion is in progress.
 1.37  20-Dec-2004  itojun RFC cannot be used as manpage regarding to the ISOC copyright boilerplate.
remove it until someone writes it up from scratch/freely-redistributable
text is found.
 1.36  14-Apr-2004  wiz Add missing "-".
 1.35  14-Apr-2004  itojun remove unneeded refs to rfc2553. jmc
 1.34  14-Apr-2004  itojun document AI_NUMERICSERV
 1.33  01-Mar-2004  itojun use "%s" for err(), do not pass pointer directly. Pedro Martelletto
 1.32  07-Sep-2003  wiz Consistently use 'RFC 1234' instead of 'RFC1234' or 'RFC-1234'.
From jmc@openbsd.
 1.31  07-Aug-2003  agc Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22280, verified by myself.
 1.30  30-Apr-2003  itojun english grammer. by Jason McIntyre via kame
 1.29  16-Apr-2003  wiz Use
.In header.h
instead of
.Fd #include \*[Lt]header.h\*[Gt]
Much easier to read and write, and supported by groff for ages.
Okayed by ross.
 1.28  15-Jun-2002  itojun refer nsswitch.conf(5). From: Jim Bernard <jbernard@mines.edu>
 1.27  14-May-2002  kleink ai_addrlen: size_t -> socklen_t.
 1.26  10-May-2002  kleink Rip out <sys/types.h> and <sys/socket.h> inclusions: there are no
pre-requisites for <netdb.h>.
 1.25  10-May-2002  kleink In the examples, initialize struct addrinfo explicitly to either 0 or a
NULL pointer; from der Mouse in PR lib/16634.
 1.24  07-Feb-2002  ross generate & symbolically
 1.23  07-Feb-2002  ross Generate <>& symbolically.
 1.22  16-Sep-2001  wiz Sort sections, sort SEE ALSO, and misc. fixes.
 1.21  16-Sep-2001  wiz Boring whitespace fixes.
 1.20  05-Aug-2001  itojun there's no host.conf in netbsd. pointed out by smb
 1.19  12-Feb-2001  itojun branches: 1.19.2;
fix listener side example. from deraadt, sync with kame
 1.18  26-Jan-2001  itojun - scope separater is percentage, not atmark.
- typo in example. s/err1/errx/.
- some wording improvements.
sync with kame.
 1.17  16-Nov-2000  lukem english fixup
 1.16  09-Aug-2000  itojun mention that current get{addr,name}info implementation are not thread-safe.
(sync with kame)
From: Greg Thompson
 1.15  25-Jul-2000  itojun typo. s/Fa getaddrinfo/Fn getaddrinfo/. sync with kame.
 1.14  25-Jul-2000  itojun move pitfall example to downwards. wording fixes. sync with kame.
 1.13  25-Jul-2000  itojun give pitfall examples.
in response to couple of PRs including 10666. sync with kame.
 1.12  30-Jun-2000  itojun typo in RFC number. KAME PR 263
 1.11  22-Jun-2000  itojun add cmetz paper, correct example
 1.10  11-May-2000  itojun branches: 1.10.4;
$NetBSD$
 1.9  11-May-2000  itojun update internet draft #. correct samples.
sync getnameinfo function prototype with /usr/include/netdb.h (not
standard conformant yet, needs update - will do soon)
 1.8  20-Feb-2000  itojun getaddrinfo(3) now obeys nsswitch.conf correctly.
 1.7  14-Feb-2000  itojun in BUGS section, document that it can behave differently from nsswitch.conf(5)
suggests.
NetBSD PR: 9413
 1.6  19-Jan-2000  itojun cosmetic (last dot in SEE ALSO section)
 1.5  17-Jan-2000  itojun sync with latest KAME tree.
add example section to get{addr,name}info.
s/\.Os KAME/.Os/.
 1.4  07-Jan-2000  itojun need sys/types.h before sys/socket.h
 1.3  13-Dec-1999  itojun bring in latest KAME get{addr,name}info(3).
getnameinfo(3) globs ai_socktype and ai_protocol correctly.
KAME scopeid extension is implemented.
(draft-ietf-ipngwg-scopedaddr-format-00.txt)

bump up shlib minor
(may not be necessary, but rather big difference in behavior - especially
ai_flags)
 1.2  03-Jul-1999  kleink branches: 1.2.4;
Add missing LIBRARY sections.
 1.1  01-Jul-1999  itojun add IPv6 support functions.

get{addr,name} info are implemented to have as little impact to existing
resolver code as possible, so they are NOT the optimal implementation.
They are at this moment not very thread safe (as they call
gethostby{name,addr}).

(shlib minor version)++, as new interfaces are added.

TODO: getipnodeby{name,addr} - which needs total reimplementation of
gethostby{name,addr}.
upgrade rcmd.c for multiple af support (needed for IPv6-ready rsh/rlogin)
 1.2.4.1  27-Dec-1999  wrstuden Pull up to last week's -current.
 1.10.4.4  10-Aug-2000  itojun pullup (approved by releng-1-5)
mention that current implementation is not thread-safe. (sync with kame)
From: Greg Thompson

getaddrinfo.3 1.15 -> 1.16
getnameinfo.3 1.10 -> 1.11
 1.10.4.3  28-Jul-2000  itojun pullup 1.12 -> 1.15 (approved by releng-1-5)
give pitfall examples.
in response to couple of PRs including 10666. sync with kame.
 1.10.4.2  03-Jul-2000  thorpej Pull up rev. 1.12:
typo in RFC number. KAME PR 263
 1.10.4.1  27-Jun-2000  thorpej Pull up rev. 1.11:
add cmetz paper, correct example
 1.19.2.4  21-Jun-2002  nathanw Catch up to -current.
 1.19.2.3  22-Mar-2002  nathanw Catch up to -current.
 1.19.2.2  08-Mar-2002  nathanw Catch up to -current.
 1.19.2.1  08-Oct-2001  nathanw Catch up to -current.
 1.41.2.2  21-Mar-2005  tron Pull up revision 1.43 (requested by kleink in ticket #41):
Only name <netdb.h> in the synopsis, like the old manual page used to.
 1.41.2.1  21-Mar-2005  tron Pull up revision 1.42 (requested by kleink in ticket #40):
Add restrict qualifiers to getaddrinfo() and getnameinfo() arguments.
 1.55.12.1  23-Jun-2013  tls resync from head
 1.55.6.1  22-May-2014  yamt sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs. ("Protocol error: too many arguments")
 1.60.6.1  20-Jul-2024  martin Pull up following revision(s) (requested by rin in ticket #753):

lib/libc/net/getaddrinfo.3: revision 1.61

Document that freeaddrinfo(NULL) dumps core.

A source code comment already said this, but it's easier to
find in a man page.

RSS XML Feed