<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.3.1"/> <title>xrootd: XrdSysDNS.hh Source File</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">xrootd </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.3.1 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li class="current"><a href="files.html"><span>Files</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="files.html"><span>File List</span></a></li> <li><a href="globals.html"><span>File Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="dir_68267d1309a1af8e8297ef4c3efbcdba.html">src</a></li><li class="navelem"><a class="el" href="dir_d751caa81ddb88473173cbaf15e76961.html">XrdSys</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">XrdSysDNS.hh</div> </div> </div><!--header--> <div class="contents"> <a href="XrdSysDNS_8hh.html">Go to the documentation of this file.</a><div class="fragment"><div class="line"><a name="l00001"></a><span class="lineno"> 1</span> <span class="preprocessor">#ifndef __XRDSYSDNS__</span></div> <div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="preprocessor"></span><span class="preprocessor">#define __XRDSYSDNS__</span></div> <div class="line"><a name="l00003"></a><span class="lineno"> 3</span> <span class="preprocessor"></span><span class="comment">/******************************************************************************/</span></div> <div class="line"><a name="l00004"></a><span class="lineno"> 4</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00005"></a><span class="lineno"> 5</span> <span class="comment">/* X r d S y s D N S . h h */</span></div> <div class="line"><a name="l00006"></a><span class="lineno"> 6</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00007"></a><span class="lineno"> 7</span> <span class="comment">/* (c) 2004 by the Board of Trustees of the Leland Stanford, Jr., University */</span></div> <div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">/* All Rights Reserved */</span></div> <div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">/* Produced by Andrew Hanushevsky for Stanford University under contract */</span></div> <div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">/* DE-AC02-76-SFO0515 with the Department of Energy */</span></div> <div class="line"><a name="l00011"></a><span class="lineno"> 11</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00012"></a><span class="lineno"> 12</span> <span class="comment">/* This file is part of the XRootD software suite. */</span></div> <div class="line"><a name="l00013"></a><span class="lineno"> 13</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00014"></a><span class="lineno"> 14</span> <span class="comment">/* XRootD is free software: you can redistribute it and/or modify it under */</span></div> <div class="line"><a name="l00015"></a><span class="lineno"> 15</span> <span class="comment">/* the terms of the GNU Lesser General Public License as published by the */</span></div> <div class="line"><a name="l00016"></a><span class="lineno"> 16</span> <span class="comment">/* Free Software Foundation, either version 3 of the License, or (at your */</span></div> <div class="line"><a name="l00017"></a><span class="lineno"> 17</span> <span class="comment">/* option) any later version. */</span></div> <div class="line"><a name="l00018"></a><span class="lineno"> 18</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00019"></a><span class="lineno"> 19</span> <span class="comment">/* XRootD is distributed in the hope that it will be useful, but WITHOUT */</span></div> <div class="line"><a name="l00020"></a><span class="lineno"> 20</span> <span class="comment">/* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or */</span></div> <div class="line"><a name="l00021"></a><span class="lineno"> 21</span> <span class="comment">/* FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public */</span></div> <div class="line"><a name="l00022"></a><span class="lineno"> 22</span> <span class="comment">/* License for more details. */</span></div> <div class="line"><a name="l00023"></a><span class="lineno"> 23</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00024"></a><span class="lineno"> 24</span> <span class="comment">/* You should have received a copy of the GNU Lesser General Public License */</span></div> <div class="line"><a name="l00025"></a><span class="lineno"> 25</span> <span class="comment">/* along with XRootD in a file called COPYING.LESSER (LGPL license) and file */</span></div> <div class="line"><a name="l00026"></a><span class="lineno"> 26</span> <span class="comment">/* COPYING (GPL license). If not, see <http://www.gnu.org/licenses/>. */</span></div> <div class="line"><a name="l00027"></a><span class="lineno"> 27</span> <span class="comment">/* */</span></div> <div class="line"><a name="l00028"></a><span class="lineno"> 28</span> <span class="comment">/* The copyright holder's institutional names and contributor's names may not */</span></div> <div class="line"><a name="l00029"></a><span class="lineno"> 29</span> <span class="comment">/* be used to endorse or promote products derived from this software without */</span></div> <div class="line"><a name="l00030"></a><span class="lineno"> 30</span> <span class="comment">/* specific prior written permission of the institution or contributor. */</span></div> <div class="line"><a name="l00031"></a><span class="lineno"> 31</span> <span class="comment">/******************************************************************************/</span></div> <div class="line"><a name="l00032"></a><span class="lineno"> 32</span> </div> <div class="line"><a name="l00033"></a><span class="lineno"> 33</span> <span class="preprocessor">#include <sys/types.h></span></div> <div class="line"><a name="l00034"></a><span class="lineno"> 34</span> <span class="preprocessor">#ifndef WIN32</span></div> <div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="preprocessor"></span><span class="preprocessor">#include <sys/socket.h></span></div> <div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="preprocessor">#else</span></div> <div class="line"><a name="l00037"></a><span class="lineno"> 37</span> <span class="preprocessor"></span><span class="preprocessor">#include <Winsock2.h></span></div> <div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="preprocessor">#endif</span></div> <div class="line"><a name="l00039"></a><span class="lineno"> 39</span> <span class="preprocessor"></span></div> <div class="line"><a name="l00040"></a><span class="lineno"><a class="code" href="classXrdSysDNS.html"> 40</a></span> <span class="keyword">class </span><a class="code" href="classXrdSysDNS.html">XrdSysDNS</a></div> <div class="line"><a name="l00041"></a><span class="lineno"> 41</span> {</div> <div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="keyword">public</span>:</div> <div class="line"><a name="l00043"></a><span class="lineno"> 43</span> </div> <div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// Note: Most methods allow the reason for failure to be returned via an errtxt</span></div> <div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// argument. The string returned in errtxt is static and must neither be</span></div> <div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// modified not freed.</span></div> <div class="line"><a name="l00047"></a><span class="lineno"> 47</span> </div> <div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// getHostAddr() translates an host name or an ascii host ip address to the</span></div> <div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// binary address suitable for use in network system calls. The</span></div> <div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// host name or address must be registered in the DNS for the</span></div> <div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// translation to be successful. Upon success the either the</span></div> <div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// primary address (1st form) or a list of addresses (2nd form)</span></div> <div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// up to maxipa is returned. The return values are:</span></div> <div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// 0 -> Host name could not be translated, the error text</span></div> <div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// is placed in errtxt, if an address is supplied.</span></div> <div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// > 0 -> The number of addresses returned.</span></div> <div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">//</span></div> <div class="line"><a name="l00058"></a><span class="lineno"><a class="code" href="classXrdSysDNS.html#a2d13e5375cce1f2b0b459ceaa7a6c9a4"> 58</a></span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a2d13e5375cce1f2b0b459ceaa7a6c9a4">getHostAddr</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName,</div> <div class="line"><a name="l00059"></a><span class="lineno"> 59</span>  <span class="keyword">struct</span> sockaddr &InetAddr,</div> <div class="line"><a name="l00060"></a><span class="lineno"> 60</span>  <span class="keywordtype">char</span> **errtxt=0)</div> <div class="line"><a name="l00061"></a><span class="lineno"> 61</span>  {<span class="keywordflow">return</span> <a class="code" href="classXrdSysDNS.html#a2d13e5375cce1f2b0b459ceaa7a6c9a4">getHostAddr</a>(InetName, &InetAddr, 1, errtxt);}</div> <div class="line"><a name="l00062"></a><span class="lineno"> 62</span> </div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a2d13e5375cce1f2b0b459ceaa7a6c9a4">getHostAddr</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName,</div> <div class="line"><a name="l00064"></a><span class="lineno"> 64</span>  <span class="keyword">struct</span> sockaddr InetAddr[],</div> <div class="line"><a name="l00065"></a><span class="lineno"> 65</span>  <span class="keywordtype">int</span> maxipa=1,</div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span> </div> <div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="comment">// getHostID() returns the ASCII string corresponding to the IP address</span></div> <div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="comment">// InetAddr. If a translation is successful, the address</span></div> <div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="comment">// of an strdup'd null terminated name is returned (it must be</span></div> <div class="line"><a name="l00071"></a><span class="lineno"> 71</span> <span class="comment">// released using free()). Otherwise, an strdup of '0.0.0.0' is</span></div> <div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="comment">// returned (which must also be freed).</span></div> <div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="comment">//</span></div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span> <span class="keyword">static</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdSysDNS.html#ad0dcbc6d2355d87f49dc0de2cb9215a8">getHostID</a>(<span class="keyword">struct</span> sockaddr &InetAddr);</div> <div class="line"><a name="l00075"></a><span class="lineno"> 75</span> </div> <div class="line"><a name="l00076"></a><span class="lineno"> 76</span> <span class="comment">// getAddrName() finds addresses and names associated with an host name or</span></div> <div class="line"><a name="l00077"></a><span class="lineno"> 77</span> <span class="comment">// an ascii host ip address. The host name or address must be</span></div> <div class="line"><a name="l00078"></a><span class="lineno"> 78</span> <span class="comment">// registered in the DNS for the translation to be successful.</span></div> <div class="line"><a name="l00079"></a><span class="lineno"> 79</span> <span class="comment">// Upon success a list of addresses and names up to maxipa is</span></div> <div class="line"><a name="l00080"></a><span class="lineno"> 80</span> <span class="comment">// returned in the arrays haddr and hname. The arrays must be</span></div> <div class="line"><a name="l00081"></a><span class="lineno"> 81</span> <span class="comment">// previously allocated by the caller for at least maxipa</span></div> <div class="line"><a name="l00082"></a><span class="lineno"> 82</span> <span class="comment">// 'char *'. The returned char arrays are allocated inside and</span></div> <div class="line"><a name="l00083"></a><span class="lineno"> 83</span> <span class="comment">// must be freed by the caller. The return values are:</span></div> <div class="line"><a name="l00084"></a><span class="lineno"> 84</span> <span class="comment">// 0 -> Host name could not be translated, the error text</span></div> <div class="line"><a name="l00085"></a><span class="lineno"> 85</span> <span class="comment">// is placed in errtxt, if an address is supplied.</span></div> <div class="line"><a name="l00086"></a><span class="lineno"> 86</span> <span class="comment">// > 0 -> The number of addresses returned.</span></div> <div class="line"><a name="l00087"></a><span class="lineno"> 87</span> <span class="comment">//</span></div> <div class="line"><a name="l00088"></a><span class="lineno"> 88</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a755727e390a157beda18744b56cd3010">getAddrName</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName,</div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span>  <span class="keywordtype">int</span> maxipa,</div> <div class="line"><a name="l00090"></a><span class="lineno"> 90</span>  <span class="keywordtype">char</span> **haddr,</div> <div class="line"><a name="l00091"></a><span class="lineno"> 91</span>  <span class="keywordtype">char</span> **hname,</div> <div class="line"><a name="l00092"></a><span class="lineno"> 92</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00093"></a><span class="lineno"> 93</span> </div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span> <span class="comment">// getHostName() returns the fully qualified name of a host. If no partial</span></div> <div class="line"><a name="l00095"></a><span class="lineno"> 95</span> <span class="comment">// host name is specified (or specifiied as 0), the fully</span></div> <div class="line"><a name="l00096"></a><span class="lineno"> 96</span> <span class="comment">// qualified name of this host is returned. The name is returned</span></div> <div class="line"><a name="l00097"></a><span class="lineno"> 97</span> <span class="comment">// as an strdup'd string which must be released using free().</span></div> <div class="line"><a name="l00098"></a><span class="lineno"> 98</span> <span class="comment">// If errtxt is supplied, it is set to zero.</span></div> <div class="line"><a name="l00099"></a><span class="lineno"> 99</span> <span class="comment">// Upon failure, strdup("0.0.0.0") is returned and the error</span></div> <div class="line"><a name="l00100"></a><span class="lineno"> 100</span> <span class="comment">// text is placed in errtxt if an address is supplied.</span></div> <div class="line"><a name="l00101"></a><span class="lineno"> 101</span> <span class="comment">//</span></div> <div class="line"><a name="l00102"></a><span class="lineno"> 102</span> <span class="keyword">static</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdSysDNS.html#a9be29ef29cb8618c2d7f6dbba38e4bb1">getHostName</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName=0,</div> <div class="line"><a name="l00103"></a><span class="lineno"> 103</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00104"></a><span class="lineno"> 104</span> </div> <div class="line"><a name="l00105"></a><span class="lineno"> 105</span> <span class="comment">// getHostName() returns the primary name of the host associated with the IP</span></div> <div class="line"><a name="l00106"></a><span class="lineno"> 106</span> <span class="comment">// address InetAddr. If a translation is successful, the address</span></div> <div class="line"><a name="l00107"></a><span class="lineno"> 107</span> <span class="comment">// of an strdup'd null terminated name is returned (it must be</span></div> <div class="line"><a name="l00108"></a><span class="lineno"> 108</span> <span class="comment">// released using free()) and errtxt, of supplied, is set to 0.</span></div> <div class="line"><a name="l00109"></a><span class="lineno"> 109</span> <span class="comment">// Upon failure, the ascii text version of the address is</span></div> <div class="line"><a name="l00110"></a><span class="lineno"> 110</span> <span class="comment">// returned and the error text is placed in errtxt if an </span></div> <div class="line"><a name="l00111"></a><span class="lineno"> 111</span> <span class="comment">// address is supplied.</span></div> <div class="line"><a name="l00112"></a><span class="lineno"> 112</span> <span class="comment">//</span></div> <div class="line"><a name="l00113"></a><span class="lineno"> 113</span> <span class="keyword">static</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdSysDNS.html#a9be29ef29cb8618c2d7f6dbba38e4bb1">getHostName</a>(<span class="keyword">struct</span> sockaddr &InetAddr,</div> <div class="line"><a name="l00114"></a><span class="lineno"> 114</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div> <div class="line"><a name="l00116"></a><span class="lineno"> 116</span> <span class="comment">// getHostName() returns the names of the host associated with the IP address</span></div> <div class="line"><a name="l00117"></a><span class="lineno"> 117</span> <span class="comment">// InetAddr. The first name is the primary name of the host.</span></div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span> <span class="comment">// Upon success, the address of each null terminated name is</span></div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span> <span class="comment">// placed in InetName[i]. Up to maxipn names are returned. The</span></div> <div class="line"><a name="l00120"></a><span class="lineno"> 120</span> <span class="comment">// array must be large enough to hold maxipn entries, Each</span></div> <div class="line"><a name="l00121"></a><span class="lineno"> 121</span> <span class="comment">// name is returned as an strdup'd string, which must be </span></div> <div class="line"><a name="l00122"></a><span class="lineno"> 122</span> <span class="comment">// released using free(). Return values are:</span></div> <div class="line"><a name="l00123"></a><span class="lineno"> 123</span> <span class="comment">// 0 -> No names could be returned; the error text is placed</span></div> <div class="line"><a name="l00124"></a><span class="lineno"> 124</span> <span class="comment">// in errtxt if an address is supplied.</span></div> <div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="comment">// >0 -> Number of names returned.</span></div> <div class="line"><a name="l00126"></a><span class="lineno"> 126</span> <span class="comment">//</span></div> <div class="line"><a name="l00127"></a><span class="lineno"> 127</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a9be29ef29cb8618c2d7f6dbba38e4bb1">getHostName</a>(<span class="keyword">struct</span> sockaddr &InetAddr, </div> <div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="keywordtype">char</span> *InetName[],</div> <div class="line"><a name="l00129"></a><span class="lineno"> 129</span>  <span class="keywordtype">int</span> maxipn,</div> <div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00131"></a><span class="lineno"> 131</span> </div> <div class="line"><a name="l00132"></a><span class="lineno"> 132</span> <span class="comment">// getPort() returns the port number of the service corresponding to the</span></div> <div class="line"><a name="l00133"></a><span class="lineno"> 133</span> <span class="comment">// supplied name and service type (i.e., "tcp" or "udp"). If the port</span></div> <div class="line"><a name="l00134"></a><span class="lineno"> 134</span> <span class="comment">// cannot be found, zero is returned and the error text is placed</span></div> <div class="line"><a name="l00135"></a><span class="lineno"> 135</span> <span class="comment">// in errtxt if an address is supplied.</span></div> <div class="line"><a name="l00136"></a><span class="lineno"> 136</span> <span class="comment">//</span></div> <div class="line"><a name="l00137"></a><span class="lineno"> 137</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#ac456249c3c4f5c652c97368037cad016">getPort</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *servname,</div> <div class="line"><a name="l00138"></a><span class="lineno"> 138</span>  <span class="keyword">const</span> <span class="keywordtype">char</span> *servtype,</div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00140"></a><span class="lineno"> 140</span> </div> <div class="line"><a name="l00141"></a><span class="lineno"> 141</span> <span class="comment">// getPort() variant returns the port number associated with the specified</span></div> <div class="line"><a name="l00142"></a><span class="lineno"> 142</span> <span class="comment">// file descriptor. If an error occurs, a negative errno is returned,</span></div> <div class="line"><a name="l00143"></a><span class="lineno"> 143</span> <span class="comment">// and errtxt is set if supplied.</span></div> <div class="line"><a name="l00144"></a><span class="lineno"> 144</span> <span class="comment">//</span></div> <div class="line"><a name="l00145"></a><span class="lineno"> 145</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#ac456249c3c4f5c652c97368037cad016">getPort</a>(<span class="keywordtype">int</span> fd, <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00146"></a><span class="lineno"> 146</span> </div> <div class="line"><a name="l00147"></a><span class="lineno"> 147</span> <span class="comment">// getProtoID() returns the protocol number associated with the protocol name</span></div> <div class="line"><a name="l00148"></a><span class="lineno"> 148</span> <span class="comment">// passed as a parameter. No failures can occur since TCP is</span></div> <div class="line"><a name="l00149"></a><span class="lineno"> 149</span> <span class="comment">// returned if the protocol cannot be found.</span></div> <div class="line"><a name="l00150"></a><span class="lineno"> 150</span> <span class="comment">//</span></div> <div class="line"><a name="l00151"></a><span class="lineno"> 151</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a322594522425ef9b4df353631ed16af9">getProtoID</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *pname);</div> <div class="line"><a name="l00152"></a><span class="lineno"> 152</span> </div> <div class="line"><a name="l00153"></a><span class="lineno"> 153</span> <span class="comment">// Host2Dest() returns a sockaddr structure suitable for socket operations</span></div> <div class="line"><a name="l00154"></a><span class="lineno"> 154</span> <span class="comment">// built from the "host:port" specified in InetName. It returns</span></div> <div class="line"><a name="l00155"></a><span class="lineno"> 155</span> <span class="comment">// 1 upon success and 0 upon failure with the reason placed in</span></div> <div class="line"><a name="l00156"></a><span class="lineno"> 156</span> <span class="comment">// errtxt, if as address is supplied.</span></div> <div class="line"><a name="l00157"></a><span class="lineno"> 157</span> <span class="comment">//</span></div> <div class="line"><a name="l00158"></a><span class="lineno"> 158</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a7012a7870f0f51d3d91cf27a8198547b">Host2Dest</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName,</div> <div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <span class="keyword">struct</span> sockaddr &DestAddr,</div> <div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00161"></a><span class="lineno"> 161</span> </div> <div class="line"><a name="l00162"></a><span class="lineno"> 162</span> <span class="comment">// Host2IP() converts a host name passed in InetName to an IPV4 address,</span></div> <div class="line"><a name="l00163"></a><span class="lineno"> 163</span> <span class="comment">// returned in ipaddr (unless it is zero, in which only a conversion</span></div> <div class="line"><a name="l00164"></a><span class="lineno"> 164</span> <span class="comment">// check is performed). 1 is returned upon success, 0 upon failure.</span></div> <div class="line"><a name="l00165"></a><span class="lineno"> 165</span> <span class="comment">//</span></div> <div class="line"><a name="l00166"></a><span class="lineno"> 166</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a3293d16a4ad6ee7669e2727126a316dd">Host2IP</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *InetName,</div> <div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> *ipaddr=0);</div> <div class="line"><a name="l00168"></a><span class="lineno"> 168</span> </div> <div class="line"><a name="l00169"></a><span class="lineno"> 169</span> <span class="comment">// IPFormat() converts an IP address/port (V4 or V6) into the standard V6 RFC</span></div> <div class="line"><a name="l00170"></a><span class="lineno"> 170</span> <span class="comment">// ASCII representation: "[address]:port".</span></div> <div class="line"><a name="l00171"></a><span class="lineno"> 171</span> </div> <div class="line"><a name="l00172"></a><span class="lineno"> 172</span> <span class="comment">// Input: sAddr - Address to convert. This is either sockaddr_in or</span></div> <div class="line"><a name="l00173"></a><span class="lineno"> 173</span> <span class="comment">// sockaddr_in6 cast to struct sockaddr.</span></div> <div class="line"><a name="l00174"></a><span class="lineno"> 174</span> <span class="comment">// bP - points to a buffer large enough to hold the result.</span></div> <div class="line"><a name="l00175"></a><span class="lineno"> 175</span> <span class="comment">// A buffer 64 characters long will always be big enough.</span></div> <div class="line"><a name="l00176"></a><span class="lineno"> 176</span> <span class="comment">// bL - the actual size of the buffer.</span></div> <div class="line"><a name="l00177"></a><span class="lineno"> 177</span> <span class="comment">// fP - When true (the default) will format sAddr->sin_port</span></div> <div class="line"><a name="l00178"></a><span class="lineno"> 178</span> <span class="comment">// (or sin6_port) as ":port" at the end of the address.</span></div> <div class="line"><a name="l00179"></a><span class="lineno"> 179</span> <span class="comment">// When false the colon and port number is omitted.</span></div> <div class="line"><a name="l00180"></a><span class="lineno"> 180</span> <span class="comment">//</span></div> <div class="line"><a name="l00181"></a><span class="lineno"> 181</span> <span class="comment">// Output: Upon success the length of the formatted address is returned.</span></div> <div class="line"><a name="l00182"></a><span class="lineno"> 182</span> <span class="comment">// Upon failure zero is returned and the buffer state is undefined.</span></div> <div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="comment">// Failure occurs when the buffer is too small or the address family</span></div> <div class="line"><a name="l00184"></a><span class="lineno"> 184</span> <span class="comment">// (sAddr->sa_family) is neither AF_INET nor AF_INET6.</span></div> <div class="line"><a name="l00185"></a><span class="lineno"> 185</span> <span class="comment">//</span></div> <div class="line"><a name="l00186"></a><span class="lineno"> 186</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#afca98c643e1156239b08a4b828993cf7">IPFormat</a>(<span class="keyword">const</span> <span class="keyword">struct</span> sockaddr *sAddr, <span class="keywordtype">char</span> *bP, <span class="keywordtype">int</span> bL, <span class="keywordtype">int</span> fP=1);</div> <div class="line"><a name="l00187"></a><span class="lineno"> 187</span> </div> <div class="line"><a name="l00188"></a><span class="lineno"> 188</span> <span class="comment">// IP2String() converts an IPV4 version of the address to ascii dot notation</span></div> <div class="line"><a name="l00189"></a><span class="lineno"> 189</span> <span class="comment">// If port > 0 then the results is <ipaddr>:<port>. The return</span></div> <div class="line"><a name="l00190"></a><span class="lineno"> 190</span> <span class="comment">// value is the number of characters placed in the buffer.</span></div> <div class="line"><a name="l00191"></a><span class="lineno"> 191</span> <span class="comment">//</span></div> <div class="line"><a name="l00192"></a><span class="lineno"> 192</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a01a8c3fa1d2ecb5fa50dec9bde20f7e2">IP2String</a>(<span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> ipaddr, <span class="keywordtype">int</span> port, <span class="keywordtype">char</span> *buff, <span class="keywordtype">int</span> blen);</div> <div class="line"><a name="l00193"></a><span class="lineno"> 193</span> </div> <div class="line"><a name="l00194"></a><span class="lineno"> 194</span> <span class="comment">// IPAddr() returns the IPV4 version of the address in the address argument</span></div> <div class="line"><a name="l00195"></a><span class="lineno"> 195</span> <span class="comment">//</span></div> <div class="line"><a name="l00196"></a><span class="lineno"> 196</span> <span class="keyword">static</span> <span class="keywordtype">unsigned</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#ad667e83c0eb312b95d51d47732e6ef4c">IPAddr</a>(<span class="keyword">struct</span> sockaddr *InetAddr);</div> <div class="line"><a name="l00197"></a><span class="lineno"> 197</span> </div> <div class="line"><a name="l00198"></a><span class="lineno"> 198</span> <span class="comment">// isDomain() returns true if the domain portion of the hostname matches</span></div> <div class="line"><a name="l00199"></a><span class="lineno"> 199</span> <span class="comment">// the specified domain name.</span></div> <div class="line"><a name="l00200"></a><span class="lineno"> 200</span> <span class="comment">//</span></div> <div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a66ba4cb14c1733a34205f17054bc2c96">isDomain</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *Hostname, <span class="keyword">const</span> <span class="keywordtype">char</span> *Domname, <span class="keywordtype">int</span> Domlen);</div> <div class="line"><a name="l00202"></a><span class="lineno"> 202</span> </div> <div class="line"><a name="l00203"></a><span class="lineno"> 203</span> <span class="comment">// isLoopback() returns true if the address in InetAddr is the loopback address.</span></div> <div class="line"><a name="l00204"></a><span class="lineno"> 204</span> <span class="comment">// This test is used to discover IP address spoofing in UDP packets.</span></div> <div class="line"><a name="l00205"></a><span class="lineno"> 205</span> <span class="comment">//</span></div> <div class="line"><a name="l00206"></a><span class="lineno"> 206</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a4c81fbc5c1365bb460f73efaf631b901">isLoopback</a>(<span class="keyword">struct</span> sockaddr &InetAddr);</div> <div class="line"><a name="l00207"></a><span class="lineno"> 207</span> </div> <div class="line"><a name="l00208"></a><span class="lineno"> 208</span> <span class="comment">// isMatch() returns true if the HostName matches the host pattern HostPat.</span></div> <div class="line"><a name="l00209"></a><span class="lineno"> 209</span> <span class="comment">// Patterns are formed as {[<pfx>][*][<sfx>] | <name>+}</span></div> <div class="line"><a name="l00210"></a><span class="lineno"> 210</span> <span class="comment">//</span></div> <div class="line"><a name="l00211"></a><span class="lineno"> 211</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#ae9dd2ea85afc93e7910b4b4575e0a942">isMatch</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *HostNme, <span class="keywordtype">char</span> *HostPat);</div> <div class="line"><a name="l00212"></a><span class="lineno"> 212</span> </div> <div class="line"><a name="l00213"></a><span class="lineno"> 213</span> <span class="comment">// Peername() returns the strdupp'd string name (and optionally the address) of </span></div> <div class="line"><a name="l00214"></a><span class="lineno"> 214</span> <span class="comment">// the host associated with the socket passed as the first parameter. </span></div> <div class="line"><a name="l00215"></a><span class="lineno"> 215</span> <span class="comment">// The string must be released using free(). If the host cannot be</span></div> <div class="line"><a name="l00216"></a><span class="lineno"> 216</span> <span class="comment">// determined, 0 is returned and the error text is placed in errtxt</span></div> <div class="line"><a name="l00217"></a><span class="lineno"> 217</span> <span class="comment">// if an address is supplied.</span></div> <div class="line"><a name="l00218"></a><span class="lineno"> 218</span> <span class="comment">//</span></div> <div class="line"><a name="l00219"></a><span class="lineno"> 219</span> <span class="keyword">static</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdSysDNS.html#a206112c52bf03708e833ca1a6b493617">Peername</a>( <span class="keywordtype">int</span> snum,</div> <div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keyword">struct</span> sockaddr *sap=0,</div> <div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  <span class="keywordtype">char</span> **errtxt=0);</div> <div class="line"><a name="l00222"></a><span class="lineno"> 222</span> </div> <div class="line"><a name="l00223"></a><span class="lineno"> 223</span> <span class="comment">// setPort() sets the port number InetAddr. If anyaddr is true,, InetAddr is</span></div> <div class="line"><a name="l00224"></a><span class="lineno"> 224</span> <span class="comment">// initialized to the network defined "any" IP address.</span></div> <div class="line"><a name="l00225"></a><span class="lineno"> 225</span> <span class="comment">//</span></div> <div class="line"><a name="l00226"></a><span class="lineno"> 226</span> <span class="keyword">static</span> <span class="keywordtype">void</span> <a class="code" href="classXrdSysDNS.html#a1882a76754ac3bf7372fe06f8b6d5ab9">setPort</a>(<span class="keyword">struct</span> sockaddr &InetAddr, <span class="keywordtype">int</span> port, <span class="keywordtype">int</span> anyaddr=0);</div> <div class="line"><a name="l00227"></a><span class="lineno"> 227</span> </div> <div class="line"><a name="l00228"></a><span class="lineno"><a class="code" href="classXrdSysDNS.html#aa9da70c6ad1725fc6c689c15eb84c412"> 228</a></span>  <a class="code" href="classXrdSysDNS.html#aa9da70c6ad1725fc6c689c15eb84c412">XrdSysDNS</a>() {}</div> <div class="line"><a name="l00229"></a><span class="lineno"><a class="code" href="classXrdSysDNS.html#a8377c1ab55678b2903a58fd5c45203cf"> 229</a></span>  <a class="code" href="classXrdSysDNS.html#a8377c1ab55678b2903a58fd5c45203cf">~XrdSysDNS</a>() {}</div> <div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  </div> <div class="line"><a name="l00231"></a><span class="lineno"> 231</span> <span class="keyword">private</span>:</div> <div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  </div> <div class="line"><a name="l00233"></a><span class="lineno"> 233</span> <span class="keyword">static</span> <span class="keywordtype">char</span> *<a class="code" href="classXrdSysDNS.html#ab750ade7d4fceb881d13d06b0092f324">LowCase</a>(<span class="keywordtype">char</span> *str);</div> <div class="line"><a name="l00234"></a><span class="lineno"> 234</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#ad005c8ecbcfb326e2414f9d4ccbdabae">setET</a>(<span class="keywordtype">char</span> **errtxt, <span class="keywordtype">int</span> rc);</div> <div class="line"><a name="l00235"></a><span class="lineno"> 235</span> <span class="keyword">static</span> <span class="keywordtype">int</span> <a class="code" href="classXrdSysDNS.html#a4fcc1e0c85d10e402eede678a963e0a4">setETni</a>(<span class="keywordtype">char</span> **errtxt, <span class="keywordtype">int</span> rc);</div> <div class="line"><a name="l00236"></a><span class="lineno"> 236</span> };</div> <div class="line"><a name="l00237"></a><span class="lineno"> 237</span> <span class="preprocessor">#endif</span></div> </div><!-- fragment --></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.3.1 </small></address> </body> </html>