Replace stale link

[sevan]

Summary

We point to broken CGI script which redirects to Amazon if working.
Replace link with the target Amazon URL visitor would be redirected to normally.
Bug 218071

head/en_US.ISO8859-1/books/developers-handbook/x86/chapter.xml

 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\"     From: @(#)gethostbyname.3  8.4 (Berkeley) 5/25/95
 .\" $FreeBSD$
 .\"
-.Dd October 4, 2017
+.Dd June 20, 2022
 .Dt GETHOSTBYNAME 3
 .Os
 .Sh NAME
 .Nm gethostbyname ,
 .Nm gethostbyname2 ,
 .Nm gethostbyaddr ,
 .Nm gethostent ,
 .Nm sethostent ,
 .Nm endhostent ,
 .Nm herror ,
-.Nm hstrerror
+.Nm hstrerror ,
+.Nm gethostbyname_r ,
+.Nm gethostbyname2_r ,
+.Nm gethostbyaddr_r
 .Nd get network host entry
 .Sh LIBRARY
 .Lb libc
 .Sh SYNOPSIS
 .In netdb.h
 .Vt int h_errno ;
 .Ft struct hostent *
 .Fn gethostbyname "const char *name"
 .Ft struct hostent *
 .Fn gethostbyname2 "const char *name" "int af"
 .Ft struct hostent *
 .Fn gethostbyaddr "const void *addr" "socklen_t len" "int af"
 .Ft struct hostent *
 .Fn gethostent void
 .Ft void
 .Fn sethostent "int stayopen"
 .Ft void
 .Fn endhostent void
 .Ft void
 .Fn herror "const char *string"
 .Ft const char *
 .Fn hstrerror "int err"
+.Ft int
+.Fn gethostbyname_r "const char *name" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyname2_r "const char *name" "int af" "struct hostent *he" "char *buffer" "size_t buflen" "struct hostent **result" "int *h_errnop"
+.Ft int
+.Fn gethostbyaddr_r "const void *addr" "socklen_t len" "int af" "struct hostent *hp" "char *buf" "size_t buflen" "struct hostent **result" "int *h_errno"p
 .Sh DESCRIPTION
 .Bf -symbolic
 The
 .Xr getaddrinfo 3
 and
 .Xr getnameinfo 3
 functions are preferred over the
 .Fn gethostbyname ,

 .Va h_errno .
 .Pp
 The
 .Fn hstrerror
 function returns a string which is the message text corresponding to the
 value of the
 .Fa err
 argument.
+.Pp
+Functions with the
+.Em _r
+suffix provide reentrant versions of their respective counterparts.
+The caller must supply five additional parameters: a
+.Vt struct hostent
+variable to be filled on success, a
+.Va buffer
+of
+.Va buflen
+bytes in size, a
+.Vt struct hostent
+.Va result
+variable that will point to the result on success or be set to
+.Dv NULL
+on failure or if the name is not found.
+The
+.Va h_errnop
+variable will be filled with the error code if any.
+All these functions return 0 on success.
 .Sh FILES
 .Bl -tag -width /etc/nsswitch.conf -compact
 .It Pa /etc/hosts
 .It Pa /etc/nsswitch.conf
 .It Pa /etc/resolv.conf
 .El
 .Sh EXAMPLES
 Print out the hostname associated with a specific IP address: