X-Git-Url: http://repo.macrolet.net/gitweb/?a=blobdiff_plain;f=contrib%2Fsb-bsd-sockets%2Fsb-bsd-sockets.texinfo;h=cad46a47087c7ed5f21aeceb38a742fc50c0fdc6;hb=2d68a49fe9d30f687da45cfe7a02b497cb91137c;hp=ad85a601724dcb468ac5b7ead05e50a56da8b05c;hpb=34f433eb2a61281c2cd274687d33b61f577f4ba4;p=sbcl.git diff --git a/contrib/sb-bsd-sockets/sb-bsd-sockets.texinfo b/contrib/sb-bsd-sockets/sb-bsd-sockets.texinfo index ad85a60..cad46a4 100644 --- a/contrib/sb-bsd-sockets/sb-bsd-sockets.texinfo +++ b/contrib/sb-bsd-sockets/sb-bsd-sockets.texinfo @@ -36,7 +36,7 @@ Where the C API would typically return -1 and set @code{errno}, of @code{sb-bsd-sockets:socket-condition} and generally correspond one for one with possible @code{errno} values. -@item +@item We use multiple return values in many places where the C API would use pass-by-reference values. @@ -75,6 +75,8 @@ than "network-endian integers". @include fun-sb-bsd-sockets-socket-close.texinfo +@include fun-sb-bsd-sockets-socket-shutdown.texinfo + @include fun-sb-bsd-sockets-socket-make-stream.texinfo @include fun-sb-bsd-sockets-socket-error.texinfo @@ -141,7 +143,7 @@ port, so for example, (socket-connect s #(192 168 1 1) 80). Local domain (@code{AF_LOCAL}) sockets are also known as Unix-domain sockets, but were renamed by POSIX presumably on the basis that they may be available on other systems too. - + A local socket address is a string, which is used to create a node in the local filesystem. This means of course that they cannot be used across a network. @@ -151,14 +153,16 @@ across a network. @node Name Service @section Name Service -Presently name service is implemented by calling whatever -@code{gethostbyname(2)} uses. This may be any or all of -@file{/etc/hosts}, NIS, DNS, or something completely different. -Typically it's controlled by @file{/etc/nsswitch.conf}. - -Direct links to the asynchronous @code{resolver(3)} routines would be -nice to have eventually, so that we can do DNS lookups in parallel -with other things +Presently name service is implemented by calling out to the +@code{getaddrinfo(3)} and @code{gethostinfo(3)}, or to +@code{gethostbyname(3)} @code{gethostbyaddr(3)} on platforms where +the preferred functions are not available. The exact details of +the name resolving process (for example the choice of whether +DNS or a hosts file is used for lookup) are platform dependent. + +@c Direct links to the asynchronous @code{resolver(3)} routines would be +@c nice to have eventually, so that we can do DNS lookups in parallel +@c with other things. @include class-sb-bsd-sockets-host-ent.texinfo @@ -167,5 +171,3 @@ with other things @include fun-sb-bsd-sockets-get-host-by-address.texinfo @include fun-sb-bsd-sockets-host-ent-address.texinfo - -@include fun-sb-bsd-sockets-name-service-error.texinfo