lwres_getnameinfo.html revision ac299c4f5ca236370b9df2a91b18b149b1d344a7
b05585dcfe270c40e309ff7304cf6b69d7390bdaTatuya JINMEI 神明達哉 - Copyright (C) 2000, 2001 Internet Software Consortium.
1f030ca8a3df943d8016cac39bc3018f5952126aJeremy Reed - Permission to use, copy, modify, and distribute this software for any
1f030ca8a3df943d8016cac39bc3018f5952126aJeremy Reed - purpose with or without fee is hereby granted, provided that the above
698a4dcc8ae5c2a62a254ab2aff7b16d52598cc0Mark Andrews - copyright notice and this permission notice appear in all copies.
698a4dcc8ae5c2a62a254ab2aff7b16d52598cc0Mark Andrews - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM
88674be66567d3c7db91e717cd5972655e2e2488Mark Andrews - DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL
88674be66567d3c7db91e717cd5972655e2e2488Mark Andrews - IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL
88674be66567d3c7db91e717cd5972655e2e2488Mark Andrews - INTERNET SOFTWARE CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT,
d7896edb4e93c4785a9281ea86afba86b758e813Mark Andrews - INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING
d7896edb4e93c4785a9281ea86afba86b758e813Mark Andrews - FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
d7896edb4e93c4785a9281ea86afba86b758e813Mark Andrews - NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
d7896edb4e93c4785a9281ea86afba86b758e813Mark Andrews - WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
0db6bf459f7afa1f9dc0690a521df19955c89dbfJeremy Reed>lwres_getnameinfo</TITLE
99a522dad7623549cd5e32a4968e6de8eca46ff1Mark AndrewsNAME="GENERATOR"
99a522dad7623549cd5e32a4968e6de8eca46ff1Mark AndrewsCONTENT="Modular DocBook HTML Stylesheet Version 1.61
b90d59882c3b0bbe5dafe27c51c274f0b5912f65Mark AndrewsCLASS="REFENTRY"
b90d59882c3b0bbe5dafe27c51c274f0b5912f65Mark AndrewsBGCOLOR="#FFFFFF"
b90d59882c3b0bbe5dafe27c51c274f0b5912f65Mark AndrewsTEXT="#000000"
cd6555930b6829ebce8bbf2adc7ba05111edf595Mark AndrewsLINK="#0000FF"
cd6555930b6829ebce8bbf2adc7ba05111edf595Mark AndrewsVLINK="#840084"
369e148f307a322206a460f9fd470927bcc756d0Tatuya JINMEI 神明達哉ALINK="#0000FF"
2be6798f93e7ba1f4c4082e7b0837c7668a06dcaTatuya JINMEI 神明達哉>lwres_getnameinfo</A
b0bf1ad5b0b1d29b4cdf5de9789405aec5e0844cEvan HuntCLASS="REFNAMEDIV"
eab4a5c29ddda688d975ad59a55a965b16534432Mark Andrews>lwres_getnameinfo -- lightweight resolver socket address structure to hostname and service name</DIV
21d493fc392d472086ad3c7c4563b7cadcb06788Mark AndrewsCLASS="REFSYNOPSISDIV"
5737b74d34b1eab413f4a5734714bb176c5cc849Mark Andrews>Synopsis</H2
19e4588ed76d6832be4de0813b6108a292ef413aMark AndrewsCLASS="FUNCSYNOPSIS"
6098d364b690cb9dabf96e9664c4689c8559bd2eMark AndrewsCLASS="FUNCSYNOPSISINFO"
eeaa2277ead6df7253a8958ee2d786f73e05b8beTatuya JINMEI 神明達哉CLASS="FUNCDEF"
cfef3799266c3955a3e19df5794b7994d4dd7bdbMark Andrewslwres_getnameinfo</CODE
cfef3799266c3955a3e19df5794b7994d4dd7bdbMark Andrews>(const struct sockaddr *sa, size_t salen, char *host, size_t hostlen, char *serv, size_t servlen, int flags);</CODE
467e6fd1672fb35968f522e1ef11a7e2e0cb701eMichael GraffCLASS="REFSECT1"
896f88361ec8a15a20688eb533a65977ee698974Mark Andrews>DESCRIPTION</H2
5ce9206eb95c2b818a7f863dd26d9b7a2c3d9261Evan Hunt> This function is equivalent to the <SPAN
5ce9206eb95c2b818a7f863dd26d9b7a2c3d9261Evan HuntCLASS="CITEREFENTRY"
5ce9206eb95c2b818a7f863dd26d9b7a2c3d9261Evan HuntCLASS="REFENTRYTITLE"
5ce9206eb95c2b818a7f863dd26d9b7a2c3d9261Evan Hunt>getnameinfo</SPAN
5ce9206eb95c2b818a7f863dd26d9b7a2c3d9261Evan Hunt> function defined in RFC2133.
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark AndrewsCLASS="FUNCTION"
8760bb9e0c48dad3765571b6e1ce193548fc5e37Evan Hunt>lwres_getnameinfo()</TT
593bb6464621c50ceec0e5550045f4b405558548Evan Hunt> returns the hostname for the
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark Andrews>struct sockaddr</SPAN
aeadcd63196f164b219629a53c0e0925519288f3Evan HuntCLASS="PARAMETER"
f5662f41e73c27cc6e7fd29323c8dddf54dff982Mark AndrewsCLASS="PARAMETER"
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark Andrews> bytes long. The hostname is of length
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark AndrewsCLASS="PARAMETER"
470212919fb8a92cd7eb621e981905348eb73ccaMark Andrews> and is returned via
e72c1e7e465822fc9b5067b2dd3cf047f6132214Mark AndrewsCLASS="PARAMETER"
a8f6b2aa46f882c7c680b7bdab1dfb78a76787eaMark Andrews> The maximum length of the hostname is
a8f6b2aa46f882c7c680b7bdab1dfb78a76787eaMark Andrews1025 bytes: <TT
c6a1797aff73b707b4b7a71fdaa303136953d2a3Mark AndrewsCLASS="CONSTANT"
c6a1797aff73b707b4b7a71fdaa303136953d2a3Mark Andrews>NI_MAXHOST</TT
1e0209137159d4e16e4459cc8e804d657aad1af1Mark Andrews> The name of the service associated with the port number in
5e3f390f057801d245680b07dc2b2d64939183d4Mark AndrewsCLASS="PARAMETER"
ebacb7908afe3d62fe341f7ef9efed63d0c651a2Tatuya JINMEI 神明達哉> is returned in <TT
ebacb7908afe3d62fe341f7ef9efed63d0c651a2Tatuya JINMEI 神明達哉CLASS="PARAMETER"
3dfa202e4fea6b985bcf8761e2d11c176baa40d1Mark AndrewsCLASS="PARAMETER"
a45f57a2d5fa5a4cb50c4232c09dd7676a256599Evan Hunt> bytes long. The maximum length
a45f57a2d5fa5a4cb50c4232c09dd7676a256599Evan Huntof the service name is <TT
a45f57a2d5fa5a4cb50c4232c09dd7676a256599Evan HuntCLASS="CONSTANT"
a45f57a2d5fa5a4cb50c4232c09dd7676a256599Evan Hunt>NI_MAXSERV</TT
1bfe8851c0a2eb1d7e15556bfa21291cd62ee2bcMark Andrews> - 32 bytes.</P
13d9b8ce94aee267761cd297a583e280df262d60Tatuya JINMEI 神明達哉CLASS="PARAMETER"
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark Andrews> argument sets the following
691f1f7731d175c7b2e21fbcc8d16a0c323e209aMark AndrewsCLASS="VARIABLELIST"
2f420f33bbd5a84eee03b5f9b608e79acf06cb29Mark AndrewsCLASS="CONSTANT"
2f420f33bbd5a84eee03b5f9b608e79acf06cb29Mark Andrews>NI_NOFQDN</TT
e2fe1fda755f24f593406dc26fed87e8ea1bb502Tatuya JINMEI 神明達哉>A fully qualified domain name is not required for local hosts.
e2fe1fda755f24f593406dc26fed87e8ea1bb502Tatuya JINMEI 神明達哉The local part of the fully qualified domain name is returned instead.</P
cf225ed6cd51f9acc901a60520a9368e14224a4dTatuya JINMEI 神明達哉CLASS="CONSTANT"
cf225ed6cd51f9acc901a60520a9368e14224a4dTatuya JINMEI 神明達哉>NI_NUMERICHOST</TT
515ada69db06a727ca1197e2aa1f6a286d278228Tatuya JINMEI 神明達哉>Return the address in numeric form, as if calling inet_ntop(),
515ada69db06a727ca1197e2aa1f6a286d278228Tatuya JINMEI 神明達哉instead of a host name.</P
387bca7a55c0581dc36edb4a5071cb5e1d1c34f6Tatuya JINMEI 神明達哉CLASS="CONSTANT"
dc842cdcb946b3f89448f07a9f024497a50c216aMark Andrews>NI_NAMEREQD</TT
cd9bebfc4c225931391c7d9ce1cfd88394b23f20Tatuya JINMEI 神明達哉>A name is required. If the hostname cannot be found in the DNS and
cd9bebfc4c225931391c7d9ce1cfd88394b23f20Tatuya JINMEI 神明達哉this flag is set, a non-zero error code is returned.
04115a59c176759177545c72376e844e10dc557cMark AndrewsIf the hostname is not found and the flag is not set, the
04115a59c176759177545c72376e844e10dc557cMark Andrewsaddress is returned in numeric form.</P
a9579d3386009446d7527ef52fa28251ab8c3c2cTatuya JINMEI 神明達哉CLASS="CONSTANT"
a9579d3386009446d7527ef52fa28251ab8c3c2cTatuya JINMEI 神明達哉>NI_NUMERICSERV</TT
146484aced3e6c1b9cc88db5e75b8cbfd166f701Mark Andrews>The service name is returned as a digit string representing the port number.</P
e43b095921450c34288cadc3406f49c84a0e4d46Evan HuntCLASS="CONSTANT"
e43b095921450c34288cadc3406f49c84a0e4d46Evan Hunt>NI_DGRAM</TT
481e9b573b8233f8678c1dd4549c8c949312e81dMark Andrews>Specifies that the service being looked up is a datagram
481e9b573b8233f8678c1dd4549c8c949312e81dMark Andrewsservice, and causes getservbyport() to be called with a second
cbb8a1b7cbab933795ddee4f05f4eb5074a68e6cFrancis Dupontargument of "udp" instead of its default of "tcp". This is required
cbb8a1b7cbab933795ddee4f05f4eb5074a68e6cFrancis Dupontfor the few ports (512-514) that have different services for UDP and
05b8187cb3cf03fbd75af1afdacc4aefb373e37bTatuya JINMEI 神明達哉CLASS="REFSECT1"
0eeaaaf0ae1ae2856b94886fa80f94c21e6f1bfdMark Andrews>RETURN VALUES</H2
9de0f9b0aed432ee357dbba8d1d807525f4b6d4aMark AndrewsCLASS="FUNCTION"
9de0f9b0aed432ee357dbba8d1d807525f4b6d4aMark Andrews>lwres_getnameinfo()</TT
ee6c0ce79e83039c9f8692bfb6196e0bb591ff98Mark Andrewsreturns 0 on success or a non-zero error code if an error occurs.</P
07d0f86c8a1591c0ee785d6728af69cb40f1da61Francis DupontCLASS="REFSECT1"
7ed4399c6598276b76df95e6dc91ed7b2834abc6Evan HuntCLASS="CITEREFENTRY"
3d8b9b9956b64aba0d105f955ac0354fbcf5baa9Tatuya JINMEI 神明達哉CLASS="REFENTRYTITLE"
7ed4399c6598276b76df95e6dc91ed7b2834abc6Evan HuntCLASS="CITEREFENTRY"
efe34b8ddbecf45d1671efbcba30bdb75410c98aMark AndrewsCLASS="REFENTRYTITLE"
7c60401dbd4dce617dffc685c269fca224c589adTatuya JINMEI 神明達哉>getservbyport</SPAN
d923262186a3111a6ac7aae5dcd9996e01115a44Mark AndrewsCLASS="CITEREFENTRY"
f92c897cb69fbb8b7400a5df93271b0743fe9adeTatuya JINMEI 神明達哉CLASS="REFENTRYTITLE"
77514242b09538db8f3a8f96f7f3d368cff6ebbaTatuya JINMEI 神明達哉CLASS="CITEREFENTRY"
8aae2264818e1511fa30c3ef5c3dc7669e347d3cTatuya JINMEI 神明達哉CLASS="REFENTRYTITLE"
8aae2264818e1511fa30c3ef5c3dc7669e347d3cTatuya JINMEI 神明達哉>lwres_getnameinfo</SPAN
0f39ff74a85e16cbfd30354e24403b1ee50e1104Tatuya JINMEI 神明達哉CLASS="CITEREFENTRY"
7ecbfb6c0f566894fb7050e021cded6822771789Mark AndrewsCLASS="REFENTRYTITLE"
7ecbfb6c0f566894fb7050e021cded6822771789Mark Andrews>lwres_getnamebyaddr</SPAN
8ef7b7f3f68a26cb60f98da398562f8d1c616f96Mark AndrewsCLASS="CITEREFENTRY"
538a0a40a2c308a004ea40a9efd31c9aecb0f041Mark AndrewsCLASS="REFENTRYTITLE"
538a0a40a2c308a004ea40a9efd31c9aecb0f041Mark Andrews>lwres_net_ntop</SPAN
250dcb4cf5c356bb492c849edff5fe3c81f61f77Tatuya JINMEI 神明達哉CLASS="REFSECT1"
58253bddc4c33507ba28654b9c4a36ca1053730cMark Andrews>RFC2133 fails to define what the nonzero return values of
ae6942e3d1fc7327ba5df9d638e0af15a908f8fbMark AndrewsCLASS="CITEREFENTRY"
080a964a3f0622f2e343f114aa1cc066372c06caEvan HuntCLASS="REFENTRYTITLE"
080a964a3f0622f2e343f114aa1cc066372c06caEvan Hunt>getnameinfo</SPAN