<!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: XrdClient.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_a463079fa6e81dce85c7d5903b67b82e.html">XrdClient</a></li> </ul> </div> </div><!-- top --> <div class="header"> <div class="headertitle"> <div class="title">XrdClient.hh</div> </div> </div><!--header--> <div class="contents"> <a href="XrdClient_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 XRD_CLIENT_H</span></div> <div class="line"><a name="l00002"></a><span class="lineno"> 2</span> <span class="preprocessor"></span><span class="preprocessor">#define XRD_CLIENT_H</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 C l i e n t . 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">/* Author: Fabrizio Furano (INFN Padova, 2004) */</span></div> <div class="line"><a name="l00008"></a><span class="lineno"> 8</span> <span class="comment">/* Adapted from TXNetFile (root.cern.ch) originally done by */</span></div> <div class="line"><a name="l00009"></a><span class="lineno"> 9</span> <span class="comment">/* Alvise Dorigo, Fabrizio Furano */</span></div> <div class="line"><a name="l00010"></a><span class="lineno"> 10</span> <span class="comment">/* INFN Padova, 2003 */</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="l00034"></a><span class="lineno"> 34</span> <span class="comment">// //</span></div> <div class="line"><a name="l00035"></a><span class="lineno"> 35</span> <span class="comment">// A UNIX reference client for xrootd. //</span></div> <div class="line"><a name="l00036"></a><span class="lineno"> 36</span> <span class="comment">// //</span></div> <div class="line"><a name="l00038"></a><span class="lineno"> 38</span> <span class="comment"></span></div> <div class="line"><a name="l00040"></a><span class="lineno"> 40</span> <span class="comment">// //</span></div> <div class="line"><a name="l00041"></a><span class="lineno"> 41</span> <span class="comment">// //</span></div> <div class="line"><a name="l00042"></a><span class="lineno"> 42</span> <span class="comment">// Some features: //</span></div> <div class="line"><a name="l00043"></a><span class="lineno"> 43</span> <span class="comment">// - Automatic server kind recognition (xrootd load balancer, xrootd //</span></div> <div class="line"><a name="l00044"></a><span class="lineno"> 44</span> <span class="comment">// data server, old rootd) //</span></div> <div class="line"><a name="l00045"></a><span class="lineno"> 45</span> <span class="comment">// - Fault tolerance for read/write operations (read/write timeouts //</span></div> <div class="line"><a name="l00046"></a><span class="lineno"> 46</span> <span class="comment">// and retry) //</span></div> <div class="line"><a name="l00047"></a><span class="lineno"> 47</span> <span class="comment">// - Internal connection timeout (tunable indipendently from the OS //</span></div> <div class="line"><a name="l00048"></a><span class="lineno"> 48</span> <span class="comment">// one) //</span></div> <div class="line"><a name="l00049"></a><span class="lineno"> 49</span> <span class="comment">// - Full implementation of the xrootd protocol //</span></div> <div class="line"><a name="l00050"></a><span class="lineno"> 50</span> <span class="comment">// - handling of redirections from server //</span></div> <div class="line"><a name="l00051"></a><span class="lineno"> 51</span> <span class="comment">// - Connection multiplexing //</span></div> <div class="line"><a name="l00052"></a><span class="lineno"> 52</span> <span class="comment">// - Asynchronous operation mode //</span></div> <div class="line"><a name="l00053"></a><span class="lineno"> 53</span> <span class="comment">// - High performance read caching with read-ahead //</span></div> <div class="line"><a name="l00054"></a><span class="lineno"> 54</span> <span class="comment">// - Thread safe //</span></div> <div class="line"><a name="l00055"></a><span class="lineno"> 55</span> <span class="comment">// - Tunable log verbosity level (0 = nothing, 3 = dump read/write //</span></div> <div class="line"><a name="l00056"></a><span class="lineno"> 56</span> <span class="comment">// buffers too!) //</span></div> <div class="line"><a name="l00057"></a><span class="lineno"> 57</span> <span class="comment">// - Many parameters configurable. But the default are OK for nearly //</span></div> <div class="line"><a name="l00058"></a><span class="lineno"> 58</span> <span class="comment">// all the situations. //</span></div> <div class="line"><a name="l00059"></a><span class="lineno"> 59</span> <span class="comment">// //</span></div> <div class="line"><a name="l00061"></a><span class="lineno"> 61</span> <span class="comment"></span></div> <div class="line"><a name="l00062"></a><span class="lineno"> 62</span> <span class="preprocessor">#include "<a class="code" href="XProtocol_8hh.html">XProtocol/XProtocol.hh</a>"</span></div> <div class="line"><a name="l00063"></a><span class="lineno"> 63</span> </div> <div class="line"><a name="l00064"></a><span class="lineno"> 64</span> <span class="preprocessor">#include "<a class="code" href="XrdClientAbs_8hh.html">XrdClient/XrdClientAbs.hh</a>"</span></div> <div class="line"><a name="l00065"></a><span class="lineno"> 65</span> <span class="preprocessor">#include "<a class="code" href="XrdClientConst_8hh.html">XrdClient/XrdClientConst.hh</a>"</span></div> <div class="line"><a name="l00066"></a><span class="lineno"> 66</span> <span class="preprocessor">#include "<a class="code" href="XrdOucString_8hh.html">XrdOuc/XrdOucString.hh</a>"</span></div> <div class="line"><a name="l00067"></a><span class="lineno"> 67</span> <span class="preprocessor">#include "<a class="code" href="XrdSysSemWait_8hh.html">XrdSys/XrdSysSemWait.hh</a>"</span></div> <div class="line"><a name="l00068"></a><span class="lineno"> 68</span> <span class="preprocessor">#include "XrdVersion.hh"</span></div> <div class="line"><a name="l00069"></a><span class="lineno"> 69</span> <span class="preprocessor">#include <vector></span></div> <div class="line"><a name="l00070"></a><span class="lineno"> 70</span> <span class="preprocessor">#include <string></span></div> <div class="line"><a name="l00071"></a><span class="lineno"> 71</span> </div> <div class="line"><a name="l00072"></a><span class="lineno"> 72</span> <span class="keyword">class </span>XrdClientReadAheadMgr;</div> <div class="line"><a name="l00073"></a><span class="lineno"> 73</span> <span class="keyword">class </span>XrdClientThread;</div> <div class="line"><a name="l00074"></a><span class="lineno"> 74</span> </div> <div class="line"><a name="l00075"></a><span class="lineno"><a class="code" href="structXrdClientOpenInfo.html"> 75</a></span> <span class="keyword">struct </span><a class="code" href="structXrdClientOpenInfo.html">XrdClientOpenInfo</a> {</div> <div class="line"><a name="l00076"></a><span class="lineno"><a class="code" href="structXrdClientOpenInfo.html#ad240421fd9ea8bf136662cc031fae30b"> 76</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structXrdClientOpenInfo.html#ad240421fd9ea8bf136662cc031fae30b">inprogress</a>;</div> <div class="line"><a name="l00077"></a><span class="lineno"><a class="code" href="structXrdClientOpenInfo.html#abbfdd80a4c6d9e16b58d70732cac3c04"> 77</a></span>  <span class="keywordtype">bool</span> <a class="code" href="structXrdClientOpenInfo.html#abbfdd80a4c6d9e16b58d70732cac3c04">opened</a>;</div> <div class="line"><a name="l00078"></a><span class="lineno"><a class="code" href="structXrdClientOpenInfo.html#ac6ce616aecd9018342c7949e365d1cf5"> 78</a></span>  <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> <a class="code" href="structXrdClientOpenInfo.html#ac6ce616aecd9018342c7949e365d1cf5">mode</a>;</div> <div class="line"><a name="l00079"></a><span class="lineno"><a class="code" href="structXrdClientOpenInfo.html#ade914a4df5553928b0bc8797fa84e958"> 79</a></span>  <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> <a class="code" href="structXrdClientOpenInfo.html#ade914a4df5553928b0bc8797fa84e958">options</a>;</div> <div class="line"><a name="l00080"></a><span class="lineno"> 80</span> };</div> <div class="line"><a name="l00081"></a><span class="lineno"> 81</span> </div> <div class="line"><a name="l00082"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html"> 82</a></span> <span class="keyword">struct </span><a class="code" href="structXrdClientStatInfo.html">XrdClientStatInfo</a> {</div> <div class="line"><a name="l00083"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html#a74bceb2058c93c9f07d77848bcc57549"> 83</a></span>  <span class="keywordtype">int</span> <a class="code" href="structXrdClientStatInfo.html#a74bceb2058c93c9f07d77848bcc57549">stated</a>;</div> <div class="line"><a name="l00084"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html#a7290f13a23b11f1e13d5b125a46fdfb7"> 84</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientStatInfo.html#a7290f13a23b11f1e13d5b125a46fdfb7">size</a>;</div> <div class="line"><a name="l00085"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html#a261109d2672b0ba0a253df927da62e1d"> 85</a></span>  <span class="keywordtype">long</span> <a class="code" href="structXrdClientStatInfo.html#a261109d2672b0ba0a253df927da62e1d">id</a>;</div> <div class="line"><a name="l00086"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html#ad6c72c47b564326c9f80b671e11173cc"> 86</a></span>  <span class="keywordtype">long</span> <a class="code" href="structXrdClientStatInfo.html#ad6c72c47b564326c9f80b671e11173cc">flags</a>;</div> <div class="line"><a name="l00087"></a><span class="lineno"><a class="code" href="structXrdClientStatInfo.html#a7747820699c2170bfe7b1af5e62b3c1b"> 87</a></span>  <span class="keywordtype">long</span> <a class="code" href="structXrdClientStatInfo.html#a7747820699c2170bfe7b1af5e62b3c1b">modtime</a>;</div> <div class="line"><a name="l00088"></a><span class="lineno"> 88</span> };</div> <div class="line"><a name="l00089"></a><span class="lineno"> 89</span> </div> <div class="line"><a name="l00090"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html"> 90</a></span> <span class="keyword">struct </span><a class="code" href="structXrdClientCounters.html">XrdClientCounters</a> {</div> <div class="line"><a name="l00091"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a153e8cd2d6a0f57713c9ced02b670f0d"> 91</a></span>  <span class="keywordtype">int</span> <a class="code" href="structXrdClientCounters.html#a153e8cd2d6a0f57713c9ced02b670f0d">CacheSize</a>;</div> <div class="line"><a name="l00092"></a><span class="lineno"> 92</span> </div> <div class="line"><a name="l00093"></a><span class="lineno"> 93</span>  <span class="comment">// This does not take into account the 'suggestions'</span></div> <div class="line"><a name="l00094"></a><span class="lineno"> 94</span>  <span class="comment">// like async read or async readV</span></div> <div class="line"><a name="l00095"></a><span class="lineno"> 95</span>  <span class="comment">// We count only for functions which return data, eventually</span></div> <div class="line"><a name="l00096"></a><span class="lineno"> 96</span>  <span class="comment">// taken from the cache</span></div> <div class="line"><a name="l00097"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a61ec19750dbcbe71e9d2ef69d26f6358"> 97</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a61ec19750dbcbe71e9d2ef69d26f6358">ReadBytes</a>;</div> <div class="line"><a name="l00098"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#ab7cc32bc99156751ef9c83c5782ee627"> 98</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#ab7cc32bc99156751ef9c83c5782ee627">WrittenBytes</a>;</div> <div class="line"><a name="l00099"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#afaf088ff5089d17100974cc47f6f9633"> 99</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#afaf088ff5089d17100974cc47f6f9633">WriteRequests</a>;</div> <div class="line"><a name="l00100"></a><span class="lineno"> 100</span> </div> <div class="line"><a name="l00101"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#afc09ac5ff185e9d707d06bb145e20d93"> 101</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#afc09ac5ff185e9d707d06bb145e20d93">ReadRequests</a>;</div> <div class="line"><a name="l00102"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a4877b190d3dc402f9a3b630ec73915bc"> 102</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a4877b190d3dc402f9a3b630ec73915bc">ReadMisses</a>;</div> <div class="line"><a name="l00103"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a7294c2dc392acd3f1270ce336b3121ee"> 103</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a7294c2dc392acd3f1270ce336b3121ee">ReadHits</a>;</div> <div class="line"><a name="l00104"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a8ac66813b5c013ca162c8dec491187f3"> 104</a></span>  <span class="keywordtype">float</span> <a class="code" href="structXrdClientCounters.html#a8ac66813b5c013ca162c8dec491187f3">ReadMissRate</a>;</div> <div class="line"><a name="l00105"></a><span class="lineno"> 105</span> </div> <div class="line"><a name="l00106"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#ab384447129803a1780f81c060ad2c7a8"> 106</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#ab384447129803a1780f81c060ad2c7a8">ReadVRequests</a>; <span class="comment">// How many readVs (sync) were requested</span></div> <div class="line"><a name="l00107"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a19c5cdd55a928c7e53873033d1246767"> 107</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a19c5cdd55a928c7e53873033d1246767">ReadVSubRequests</a>; <span class="comment">// In how many sub-readVs they were split</span></div> <div class="line"><a name="l00108"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#ae7df566a93a0b72a2c80d0d99f543e17"> 108</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#ae7df566a93a0b72a2c80d0d99f543e17">ReadVSubChunks</a>; <span class="comment">// How many subchunks in total</span></div> <div class="line"><a name="l00109"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a06f238b6c51fd78f378cb27eddfef6da"> 109</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a06f238b6c51fd78f378cb27eddfef6da">ReadVBytes</a>; <span class="comment">// How many bytes were requested (sync)</span></div> <div class="line"><a name="l00110"></a><span class="lineno"> 110</span>  </div> <div class="line"><a name="l00111"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a4da9376915b69fa6c401c89eae3991ca"> 111</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a4da9376915b69fa6c401c89eae3991ca">ReadVAsyncRequests</a>; <span class="comment">// How many readVs (async) were requested</span></div> <div class="line"><a name="l00112"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a4bda647e623383f7133604711074b055"> 112</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a4bda647e623383f7133604711074b055">ReadVAsyncSubRequests</a>; <span class="comment">// In how many sub-readVs they were split</span></div> <div class="line"><a name="l00113"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a17a86f7224e5da6856b16140f26fd4e3"> 113</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a17a86f7224e5da6856b16140f26fd4e3">ReadVAsyncSubChunks</a>; <span class="comment">// How many subchunks in total</span></div> <div class="line"><a name="l00114"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#a341aebbd480d0067331260cdb69b85b7"> 114</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#a341aebbd480d0067331260cdb69b85b7">ReadVAsyncBytes</a>; <span class="comment">// How many bytes were requested (async)</span></div> <div class="line"><a name="l00115"></a><span class="lineno"> 115</span> </div> <div class="line"><a name="l00116"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#ada7b70ed38be68cd26f92e0e089b28ea"> 116</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#ada7b70ed38be68cd26f92e0e089b28ea">ReadAsyncRequests</a>;</div> <div class="line"><a name="l00117"></a><span class="lineno"><a class="code" href="structXrdClientCounters.html#aecc06beb4a02f832a0a445f25be9bf7a"> 117</a></span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> <a class="code" href="structXrdClientCounters.html#aecc06beb4a02f832a0a445f25be9bf7a">ReadAsyncBytes</a>;</div> <div class="line"><a name="l00118"></a><span class="lineno"> 118</span> };</div> <div class="line"><a name="l00119"></a><span class="lineno"> 119</span> </div> <div class="line"><a name="l00120"></a><span class="lineno"> 120</span> </div> <div class="line"><a name="l00121"></a><span class="lineno"><a class="code" href="classXrdClient.html"> 121</a></span> <span class="keyword">class </span><a class="code" href="classXrdClient.html">XrdClient</a> : <span class="keyword">public</span> <a class="code" href="classXrdClientAbs.html">XrdClientAbs</a> {</div> <div class="line"><a name="l00122"></a><span class="lineno"> 122</span>  <span class="keyword">friend</span> <span class="keywordtype">void</span> *<a class="code" href="classXrdClient.html#aaa23239446e394ff43f9dfb575c4edea">FileOpenerThread</a>(<span class="keywordtype">void</span>*, XrdClientThread*);</div> <div class="line"><a name="l00123"></a><span class="lineno"> 123</span>  </div> <div class="line"><a name="l00124"></a><span class="lineno"> 124</span> </div> <div class="line"><a name="l00125"></a><span class="lineno"> 125</span> <span class="keyword">private</span>:</div> <div class="line"><a name="l00126"></a><span class="lineno"> 126</span> </div> <div class="line"><a name="l00127"></a><span class="lineno"><a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee"> 127</a></span>  <span class="keyword">struct </span><a class="code" href="structXrdClientOpenInfo.html">XrdClientOpenInfo</a> <a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee">fOpenPars</a>; <span class="comment">// Just a container for the last parameters</span></div> <div class="line"><a name="l00128"></a><span class="lineno"> 128</span>  <span class="comment">// passed to a Open method</span></div> <div class="line"><a name="l00129"></a><span class="lineno"> 129</span> </div> <div class="line"><a name="l00130"></a><span class="lineno"> 130</span>  <span class="comment">// The open request can be in progress. Further requests must be delayed until</span></div> <div class="line"><a name="l00131"></a><span class="lineno"> 131</span>  <span class="comment">// finished.</span></div> <div class="line"><a name="l00132"></a><span class="lineno"><a class="code" href="classXrdClient.html#a84ad9cc66fc98bf80da1da6bfcd01ed4"> 132</a></span>  <a class="code" href="classXrdSysCondVar.html">XrdSysCondVar</a> *<a class="code" href="classXrdClient.html#a84ad9cc66fc98bf80da1da6bfcd01ed4">fOpenProgCnd</a>;</div> <div class="line"><a name="l00133"></a><span class="lineno"> 133</span> </div> <div class="line"><a name="l00134"></a><span class="lineno"> 134</span>  <span class="comment">// Used to open a file in parallel</span></div> <div class="line"><a name="l00135"></a><span class="lineno"><a class="code" href="classXrdClient.html#a515417e8434bb4a3f21534d60c2d54fd"> 135</a></span>  XrdClientThread *<a class="code" href="classXrdClient.html#a515417e8434bb4a3f21534d60c2d54fd">fOpenerTh</a>;</div> <div class="line"><a name="l00136"></a><span class="lineno"> 136</span> </div> <div class="line"><a name="l00137"></a><span class="lineno"> 137</span>  <span class="comment">// Used to limit the maximum number of concurrent opens</span></div> <div class="line"><a name="l00138"></a><span class="lineno"><a class="code" href="classXrdClient.html#a0e5f59366b90cde8a2daba44beef1a37"> 138</a></span>  <span class="keyword">static</span> <a class="code" href="classXrdSysSemWait.html">XrdSysSemWait</a> <a class="code" href="classXrdClient.html#a0e5f59366b90cde8a2daba44beef1a37">fConcOpenSem</a>;</div> <div class="line"><a name="l00139"></a><span class="lineno"> 139</span> </div> <div class="line"><a name="l00140"></a><span class="lineno"><a class="code" href="classXrdClient.html#ab86b36ad1943f2e05180e7fdde7c50ed"> 140</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ab86b36ad1943f2e05180e7fdde7c50ed">fOpenWithRefresh</a>;</div> <div class="line"><a name="l00141"></a><span class="lineno"> 141</span> </div> <div class="line"><a name="l00142"></a><span class="lineno"><a class="code" href="classXrdClient.html#a919001baf2ab59afccfd40921055d873"> 142</a></span>  <a class="code" href="classXrdSysCondVar.html">XrdSysCondVar</a> *<a class="code" href="classXrdClient.html#a919001baf2ab59afccfd40921055d873">fReadWaitData</a>; <span class="comment">// Used to wait for outstanding data </span></div> <div class="line"><a name="l00143"></a><span class="lineno"> 143</span> </div> <div class="line"><a name="l00144"></a><span class="lineno"><a class="code" href="classXrdClient.html#a96c4dfd3ebfe34c3e57ea688bfcd5e43"> 144</a></span>  <span class="keyword">struct </span><a class="code" href="structXrdClientStatInfo.html">XrdClientStatInfo</a> <a class="code" href="classXrdClient.html#a96c4dfd3ebfe34c3e57ea688bfcd5e43">fStatInfo</a>;</div> <div class="line"><a name="l00145"></a><span class="lineno"> 145</span> </div> <div class="line"><a name="l00146"></a><span class="lineno"><a class="code" href="classXrdClient.html#a5b9ec293f5b0c8188bb7641fe8042c55"> 146</a></span>  <span class="keywordtype">long</span> <a class="code" href="classXrdClient.html#a5b9ec293f5b0c8188bb7641fe8042c55">fReadTrimBlockSize</a>;</div> <div class="line"><a name="l00147"></a><span class="lineno"> 147</span> </div> <div class="line"><a name="l00148"></a><span class="lineno"><a class="code" href="classXrdClient.html#ad37cb8df77ec4979eeb89d591491b72a"> 148</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ad37cb8df77ec4979eeb89d591491b72a">fUseCache</a>;</div> <div class="line"><a name="l00149"></a><span class="lineno"> 149</span> </div> <div class="line"><a name="l00150"></a><span class="lineno"><a class="code" href="classXrdClient.html#a3b7ee64c220016ab0f4732063f723d98"> 150</a></span>  <a class="code" href="classXrdOucString.html">XrdOucString</a> <a class="code" href="classXrdClient.html#a3b7ee64c220016ab0f4732063f723d98">fInitialUrl</a>;</div> <div class="line"><a name="l00151"></a><span class="lineno"><a class="code" href="classXrdClient.html#ab495b34e065a343189cdea26d666c434"> 151</a></span>  <a class="code" href="classXrdClientUrlInfo.html">XrdClientUrlInfo</a> <a class="code" href="classXrdClient.html#ab495b34e065a343189cdea26d666c434">fUrl</a>;</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="keywordtype">bool</span> <a class="code" href="classXrdClient.html#af95958907736431ab821727441d4cd12">TryOpen</a>(<a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> mode,</div> <div class="line"><a name="l00154"></a><span class="lineno"> 154</span>  <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> options,</div> <div class="line"><a name="l00155"></a><span class="lineno"> 155</span>  <span class="keywordtype">bool</span> doitparallel);</div> <div class="line"><a name="l00156"></a><span class="lineno"> 156</span> </div> <div class="line"><a name="l00157"></a><span class="lineno"> 157</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a2e6d8c37736278d5b8ad50ceba49807d">LowOpen</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *file,</div> <div class="line"><a name="l00158"></a><span class="lineno"> 158</span>  <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> mode,</div> <div class="line"><a name="l00159"></a><span class="lineno"> 159</span>  <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> options,</div> <div class="line"><a name="l00160"></a><span class="lineno"> 160</span>  <span class="keywordtype">char</span> *additionalquery = 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="keywordtype">void</span> <a class="code" href="classXrdClient.html#a9d2f82ac4c610080e7ede6f1b2719298">TerminateOpenAttempt</a>();</div> <div class="line"><a name="l00163"></a><span class="lineno"> 163</span> </div> <div class="line"><a name="l00164"></a><span class="lineno"> 164</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#a19a4fb02a5caed7a1b017de0a492728a">WaitForNewAsyncData</a>();</div> <div class="line"><a name="l00165"></a><span class="lineno"> 165</span> </div> <div class="line"><a name="l00166"></a><span class="lineno"> 166</span>  <span class="comment">// Real implementation for ReadV </span></div> <div class="line"><a name="l00167"></a><span class="lineno"> 167</span>  <span class="comment">// To call it we need to be aware of the restrictions so the public</span></div> <div class="line"><a name="l00168"></a><span class="lineno"> 168</span>  <span class="comment">// interface should be ReadV()</span></div> <div class="line"><a name="l00169"></a><span class="lineno"> 169</span>  <a class="code" href="XPtypes_8hh.html#a689170b542c5f669b0e5659c54acf99f">kXR_int64</a> <a class="code" href="classXrdClient.html#a00d9ddf2d1584947776afa3e5b21dcfd">ReadVEach</a>(<span class="keywordtype">char</span> *buf, <a class="code" href="XPtypes_8hh.html#a689170b542c5f669b0e5659c54acf99f">kXR_int64</a> *offsets, <span class="keywordtype">int</span> *lens, <span class="keywordtype">int</span> &nbuf);</div> <div class="line"><a name="l00170"></a><span class="lineno"> 170</span> </div> <div class="line"><a name="l00171"></a><span class="lineno"><a class="code" href="classXrdClient.html#a297be9256eb2fad12c2d933eeaa2bc4b"> 171</a></span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a297be9256eb2fad12c2d933eeaa2bc4b">IsOpenedForWrite</a>() {</div> <div class="line"><a name="l00172"></a><span class="lineno"> 172</span>  <span class="comment">// This supposes that no options means read only</span></div> <div class="line"><a name="l00173"></a><span class="lineno"> 173</span>  <span class="keywordflow">if</span> (!<a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee">fOpenPars</a>.<a class="code" href="structXrdClientOpenInfo.html#ade914a4df5553928b0bc8797fa84e958">options</a>) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> <div class="line"><a name="l00174"></a><span class="lineno"> 174</span>  </div> <div class="line"><a name="l00175"></a><span class="lineno"> 175</span>  <span class="keywordflow">if</span> (<a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee">fOpenPars</a>.<a class="code" href="structXrdClientOpenInfo.html#ade914a4df5553928b0bc8797fa84e958">options</a> & <a class="code" href="XProtocol_8hh.html#a5730729b43c0e3a6393b594fa5385c1ea483cdb94e9ddf5433723c65cfa10f784">kXR_open_read</a>) <span class="keywordflow">return</span> <span class="keyword">false</span>;</div> <div class="line"><a name="l00176"></a><span class="lineno"> 176</span>  </div> <div class="line"><a name="l00177"></a><span class="lineno"> 177</span>  <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> <div class="line"><a name="l00178"></a><span class="lineno"> 178</span>  }</div> <div class="line"><a name="l00179"></a><span class="lineno"> 179</span> </div> <div class="line"><a name="l00180"></a><span class="lineno"><a class="code" href="classXrdClient.html#a998a474da93a87b3f527fd5bef4a326e"> 180</a></span>  XrdClientReadAheadMgr *<a class="code" href="classXrdClient.html#a998a474da93a87b3f527fd5bef4a326e">fReadAheadMgr</a>;</div> <div class="line"><a name="l00181"></a><span class="lineno"> 181</span> </div> <div class="line"><a name="l00182"></a><span class="lineno"> 182</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#ad0c34c8e80b3777045e53f324875ed1e">PrintCounters</a>();</div> <div class="line"><a name="l00183"></a><span class="lineno"> 183</span> <span class="keyword">protected</span>:</div> <div class="line"><a name="l00184"></a><span class="lineno"> 184</span> </div> <div class="line"><a name="l00185"></a><span class="lineno"><a class="code" href="classXrdClient.html#aed0cdc6ff262f772533a2e240b0c5dc4"> 185</a></span>  <a class="code" href="structXrdClientCounters.html">XrdClientCounters</a> <a class="code" href="classXrdClient.html#aed0cdc6ff262f772533a2e240b0c5dc4">fCounters</a>;</div> <div class="line"><a name="l00186"></a><span class="lineno"> 186</span> </div> <div class="line"><a name="l00187"></a><span class="lineno"> 187</span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a547812f3b3df3c845e2c3acdd0c6826c">OpenFileWhenRedirected</a>(<span class="keywordtype">char</span> *newfhandle,</div> <div class="line"><a name="l00188"></a><span class="lineno"> 188</span>  <span class="keywordtype">bool</span> &wasopen);</div> <div class="line"><a name="l00189"></a><span class="lineno"> 189</span> </div> <div class="line"><a name="l00190"></a><span class="lineno"><a class="code" href="classXrdClient.html#a3a27c49792fbb3825f099188942bcd17"> 190</a></span>  <span class="keyword">virtual</span> <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a3a27c49792fbb3825f099188942bcd17">CanRedirOnError</a>() {</div> <div class="line"><a name="l00191"></a><span class="lineno"> 191</span>  <span class="comment">// Can redir away on error if no file is opened</span></div> <div class="line"><a name="l00192"></a><span class="lineno"> 192</span>  <span class="comment">// or the file is opened in read mode</span></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="keywordflow">if</span> ( !<a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee">fOpenPars</a>.<a class="code" href="structXrdClientOpenInfo.html#abbfdd80a4c6d9e16b58d70732cac3c04">opened</a> ) <span class="keywordflow">return</span> <span class="keyword">true</span>;</div> <div class="line"><a name="l00195"></a><span class="lineno"> 195</span> </div> <div class="line"><a name="l00196"></a><span class="lineno"> 196</span>  <span class="keywordflow">return</span> !<a class="code" href="classXrdClient.html#a297be9256eb2fad12c2d933eeaa2bc4b">IsOpenedForWrite</a>();</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>  }</div> <div class="line"><a name="l00199"></a><span class="lineno"> 199</span> </div> <div class="line"><a name="l00200"></a><span class="lineno"> 200</span> </div> <div class="line"><a name="l00201"></a><span class="lineno"> 201</span> <span class="keyword">public</span>:</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>  <a class="code" href="classXrdClient.html#af451a4d6a4c894e6bbead338103d4a98">XrdClient</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *url, XrdClientCallback *XrdCcb = 0, <span class="keywordtype">void</span> *XrdCcbArg = 0);</div> <div class="line"><a name="l00204"></a><span class="lineno"> 204</span>  <span class="keyword">virtual</span> <a class="code" href="classXrdClient.html#a9b54533b5ba64c4b69848cc26ab6ae7c">~XrdClient</a>();</div> <div class="line"><a name="l00205"></a><span class="lineno"> 205</span> </div> <div class="line"><a name="l00206"></a><span class="lineno"> 206</span>  <a class="code" href="XrdClientUnsolMsg_8hh.html#ac8ef7fc6b74e2fda78f14bd74a171fa4">UnsolRespProcResult</a> <a class="code" href="classXrdClient.html#a09a924ec687afe79a55756a375e83f38">ProcessUnsolicitedMsg</a>(<a class="code" href="classXrdClientUnsolMsgSender.html">XrdClientUnsolMsgSender</a> *sender,</div> <div class="line"><a name="l00207"></a><span class="lineno"> 207</span>  XrdClientMessage *unsolmsg);</div> <div class="line"><a name="l00208"></a><span class="lineno"> 208</span> </div> <div class="line"><a name="l00209"></a><span class="lineno"> 209</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a8cc9b7641dec04d162781bfbc913edcb">Close</a>();</div> <div class="line"><a name="l00210"></a><span class="lineno"> 210</span> </div> <div class="line"><a name="l00211"></a><span class="lineno"> 211</span>  <span class="comment">// Ask the server to flush its cache</span></div> <div class="line"><a name="l00212"></a><span class="lineno"> 212</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#addb872c43afb72c12307a0a3f1ff87cd">Sync</a>();</div> <div class="line"><a name="l00213"></a><span class="lineno"> 213</span> </div> <div class="line"><a name="l00214"></a><span class="lineno"> 214</span>  <span class="comment">// Copy the whole file to the local filesystem. Not very efficient.</span></div> <div class="line"><a name="l00215"></a><span class="lineno"> 215</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a87637be99510ec398204ec61b298422a">Copy</a>(<span class="keyword">const</span> <span class="keywordtype">char</span> *localpath);</div> <div class="line"><a name="l00216"></a><span class="lineno"> 216</span> </div> <div class="line"><a name="l00217"></a><span class="lineno"> 217</span>  <span class="comment">// Returns low level information about the cache</span></div> <div class="line"><a name="l00218"></a><span class="lineno"> 218</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ab25b688fa55dada40d1c13cd4d1f17e5">GetCacheInfo</a>(</div> <div class="line"><a name="l00219"></a><span class="lineno"> 219</span>  <span class="comment">// The actual cache size</span></div> <div class="line"><a name="l00220"></a><span class="lineno"> 220</span>  <span class="keywordtype">int</span> &<a class="code" href="structXrdClientStatInfo.html#a7290f13a23b11f1e13d5b125a46fdfb7">size</a>,</div> <div class="line"><a name="l00221"></a><span class="lineno"> 221</span>  </div> <div class="line"><a name="l00222"></a><span class="lineno"> 222</span>  <span class="comment">// The number of bytes submitted since the beginning</span></div> <div class="line"><a name="l00223"></a><span class="lineno"> 223</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> &bytessubmitted,</div> <div class="line"><a name="l00224"></a><span class="lineno"> 224</span>  </div> <div class="line"><a name="l00225"></a><span class="lineno"> 225</span>  <span class="comment">// The number of bytes found in the cache (estimate)</span></div> <div class="line"><a name="l00226"></a><span class="lineno"> 226</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> &byteshit,</div> <div class="line"><a name="l00227"></a><span class="lineno"> 227</span>  </div> <div class="line"><a name="l00228"></a><span class="lineno"> 228</span>  <span class="comment">// The number of reads which did not find their data</span></div> <div class="line"><a name="l00229"></a><span class="lineno"> 229</span>  <span class="comment">// (estimate)</span></div> <div class="line"><a name="l00230"></a><span class="lineno"> 230</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> &misscount,</div> <div class="line"><a name="l00231"></a><span class="lineno"> 231</span>  </div> <div class="line"><a name="l00232"></a><span class="lineno"> 232</span>  <span class="comment">// miss/totalreads ratio (estimate)</span></div> <div class="line"><a name="l00233"></a><span class="lineno"> 233</span>  <span class="keywordtype">float</span> &missrate,</div> <div class="line"><a name="l00234"></a><span class="lineno"> 234</span>  </div> <div class="line"><a name="l00235"></a><span class="lineno"> 235</span>  <span class="comment">// number of read requests towards the cache</span></div> <div class="line"><a name="l00236"></a><span class="lineno"> 236</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> &readreqcnt,</div> <div class="line"><a name="l00237"></a><span class="lineno"> 237</span>  </div> <div class="line"><a name="l00238"></a><span class="lineno"> 238</span>  <span class="comment">// ratio between bytes found / bytes submitted</span></div> <div class="line"><a name="l00239"></a><span class="lineno"> 239</span>  <span class="keywordtype">float</span> &bytesusefulness</div> <div class="line"><a name="l00240"></a><span class="lineno"> 240</span>  );</div> <div class="line"><a name="l00241"></a><span class="lineno"> 241</span> </div> <div class="line"><a name="l00242"></a><span class="lineno"> 242</span> </div> <div class="line"><a name="l00243"></a><span class="lineno"> 243</span> </div> <div class="line"><a name="l00244"></a><span class="lineno"> 244</span>  <span class="comment">// Returns client-level information about the activity performed up to now</span></div> <div class="line"><a name="l00245"></a><span class="lineno"> 245</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ac1f603433e07eaf8a13d431ac89bbfbf">GetCounters</a>( <a class="code" href="structXrdClientCounters.html">XrdClientCounters</a> *cnt );</div> <div class="line"><a name="l00246"></a><span class="lineno"> 246</span> </div> <div class="line"><a name="l00247"></a><span class="lineno"> 247</span>  <span class="comment">// Quickly tells if the file is open</span></div> <div class="line"><a name="l00248"></a><span class="lineno"><a class="code" href="classXrdClient.html#aa98104eebaecc118e96d9f39388c30d3"> 248</a></span>  <span class="keyword">inline</span> <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#aa98104eebaecc118e96d9f39388c30d3">IsOpen</a>() { <span class="keywordflow">return</span> <a class="code" href="classXrdClient.html#ac5febb53cb6f7f4b6165d3dfc714c0ee">fOpenPars</a>.<a class="code" href="structXrdClientOpenInfo.html#abbfdd80a4c6d9e16b58d70732cac3c04">opened</a>; }</div> <div class="line"><a name="l00249"></a><span class="lineno"> 249</span> </div> <div class="line"><a name="l00250"></a><span class="lineno"> 250</span>  <span class="comment">// Tells if the file opening is in progress</span></div> <div class="line"><a name="l00251"></a><span class="lineno"> 251</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ac605432e7bbfc874f9e68ecf7d4d98bc">IsOpen_inprogress</a>();</div> <div class="line"><a name="l00252"></a><span class="lineno"> 252</span> </div> <div class="line"><a name="l00253"></a><span class="lineno"> 253</span>  <span class="comment">// Tells if the file is open, waiting for the completion of the parallel open</span></div> <div class="line"><a name="l00254"></a><span class="lineno"> 254</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#aee72665af3499c08ae990c1bcf008743">IsOpen_wait</a>();</div> <div class="line"><a name="l00255"></a><span class="lineno"> 255</span> </div> <div class="line"><a name="l00256"></a><span class="lineno"> 256</span>  <span class="comment">// Open the file. See the xrootd documentation for mode and options</span></div> <div class="line"><a name="l00257"></a><span class="lineno"> 257</span>  <span class="comment">// If parallel, then the open is done by a separate thread, and</span></div> <div class="line"><a name="l00258"></a><span class="lineno"> 258</span>  <span class="comment">// all the operations are delayed until the open has finished</span></div> <div class="line"><a name="l00259"></a><span class="lineno"> 259</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a53ef21d5a9cfdab2ce562bd0831c6f45">Open</a>(<a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> mode, <a class="code" href="XPtypes_8hh.html#ad69193718ce8710d74d5defe1de42cf8">kXR_unt16</a> options, <span class="keywordtype">bool</span> doitparallel=<span class="keyword">true</span>);</div> <div class="line"><a name="l00260"></a><span class="lineno"> 260</span> </div> <div class="line"><a name="l00261"></a><span class="lineno"> 261</span>  <span class="comment">// Read a block of data. If no error occurs, it returns all the requested bytes.</span></div> <div class="line"><a name="l00262"></a><span class="lineno"> 262</span>  <span class="keywordtype">int</span> <a class="code" href="classXrdClient.html#a43413155b2d243f6a94cf437d0c30825">Read</a>(<span class="keywordtype">void</span> *buf, <span class="keywordtype">long</span> <span class="keywordtype">long</span> offset, <span class="keywordtype">int</span> len);</div> <div class="line"><a name="l00263"></a><span class="lineno"> 263</span> </div> <div class="line"><a name="l00264"></a><span class="lineno"> 264</span>  <span class="comment">// Read multiple blocks of data compressed into a sinle one. It's up</span></div> <div class="line"><a name="l00265"></a><span class="lineno"> 265</span>  <span class="comment">// to the application to do the logistic (having the offset and len to find</span></div> <div class="line"><a name="l00266"></a><span class="lineno"> 266</span>  <span class="comment">// the position of the required buffer given the big one). If no error </span></div> <div class="line"><a name="l00267"></a><span class="lineno"> 267</span>  <span class="comment">// occurs, it returns all the requested bytes.</span></div> <div class="line"><a name="l00268"></a><span class="lineno"> 268</span>  <span class="comment">// NOTE: if buf == 0 then the req will be carried out asynchronously, i.e.</span></div> <div class="line"><a name="l00269"></a><span class="lineno"> 269</span>  <span class="comment">// the result of the request will only populate the internal cache. A subsequent read()</span></div> <div class="line"><a name="l00270"></a><span class="lineno"> 270</span>  <span class="comment">// of that chunk will get the data from the cache</span></div> <div class="line"><a name="l00271"></a><span class="lineno"> 271</span>  <a class="code" href="XPtypes_8hh.html#a689170b542c5f669b0e5659c54acf99f">kXR_int64</a> <a class="code" href="classXrdClient.html#ae9b195025db795d3eb05d233b3c40fdc">ReadV</a>(<span class="keywordtype">char</span> *buf, <span class="keywordtype">long</span> <span class="keywordtype">long</span> *offsets, <span class="keywordtype">int</span> *lens, <span class="keywordtype">int</span> nbuf);</div> <div class="line"><a name="l00272"></a><span class="lineno"> 272</span> </div> <div class="line"><a name="l00273"></a><span class="lineno"> 273</span>  <span class="comment">// Submit an asynchronous read request. Its result will only populate the cache</span></div> <div class="line"><a name="l00274"></a><span class="lineno"> 274</span>  <span class="comment">// (if any!!)</span></div> <div class="line"><a name="l00275"></a><span class="lineno"> 275</span>  <a class="code" href="XProtocol_8hh.html#a2373fa59f703ebf3836e1e157fe5152c">XReqErrorType</a> <a class="code" href="classXrdClient.html#a1c82506384b3b34aa3f97fdb47091487">Read_Async</a>(<span class="keywordtype">long</span> <span class="keywordtype">long</span> offset, <span class="keywordtype">int</span> len, <span class="keywordtype">bool</span> updatecounters=<span class="keyword">true</span>);</div> <div class="line"><a name="l00276"></a><span class="lineno"> 276</span> </div> <div class="line"><a name="l00277"></a><span class="lineno"> 277</span>  <span class="comment">// Get stat info about the file. Normally it tries to guess the file size variations</span></div> <div class="line"><a name="l00278"></a><span class="lineno"> 278</span>  <span class="comment">// unless force==true</span></div> <div class="line"><a name="l00279"></a><span class="lineno"> 279</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a45532eb59d10d2c363c708ad4382da68">Stat</a>(<span class="keyword">struct</span> <a class="code" href="structXrdClientStatInfo.html">XrdClientStatInfo</a> *stinfo, <span class="keywordtype">bool</span> force = <span class="keyword">false</span>);</div> <div class="line"><a name="l00280"></a><span class="lineno"> 280</span> </div> <div class="line"><a name="l00281"></a><span class="lineno"> 281</span>  <span class="comment">// On-the-fly enabling/disabling of the cache</span></div> <div class="line"><a name="l00282"></a><span class="lineno"> 282</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#a20a40f4c77b2adaed10e48fc80cb9d95">UseCache</a>(<span class="keywordtype">bool</span> u = <span class="keyword">true</span>);</div> <div class="line"><a name="l00283"></a><span class="lineno"> 283</span> </div> <div class="line"><a name="l00284"></a><span class="lineno"> 284</span>  <span class="comment">// To instantly remove all the chunks in the cache</span></div> <div class="line"><a name="l00285"></a><span class="lineno"> 285</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#a2a8656c94d0cc188acec43c41c2f6b9a">RemoveAllDataFromCache</a>();</div> <div class="line"><a name="l00286"></a><span class="lineno"> 286</span> </div> <div class="line"><a name="l00287"></a><span class="lineno"> 287</span>  <span class="comment">// To remove pieces of data from the cache</span></div> <div class="line"><a name="l00288"></a><span class="lineno"> 288</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#a2962b22b4a52d8ce6782d806bd6cdedb">RemoveDataFromCache</a>(<span class="keywordtype">long</span> <span class="keywordtype">long</span> begin_offs,</div> <div class="line"><a name="l00289"></a><span class="lineno"> 289</span>  <span class="keywordtype">long</span> <span class="keywordtype">long</span> end_offs,</div> <div class="line"><a name="l00290"></a><span class="lineno"> 290</span>  <span class="keywordtype">bool</span> remove_overlapped = <span class="keyword">false</span>);</div> <div class="line"><a name="l00291"></a><span class="lineno"> 291</span> </div> <div class="line"><a name="l00292"></a><span class="lineno"> 292</span>  <span class="comment">// To set at run time the cache/readahead parameters for this instance only</span></div> <div class="line"><a name="l00293"></a><span class="lineno"> 293</span>  <span class="comment">// If a parameter is < 0 then it's left untouched.</span></div> <div class="line"><a name="l00294"></a><span class="lineno"> 294</span>  <span class="comment">// To simply enable/disable the caching, just use UseCache(), not this function</span></div> <div class="line"><a name="l00295"></a><span class="lineno"> 295</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#acf0767ccca9bc61664c3b5f2de284e72">SetCacheParameters</a>(<span class="keywordtype">int</span> CacheSize, <span class="keywordtype">int</span> ReadAheadSize, <span class="keywordtype">int</span> RmPolicy);</div> <div class="line"><a name="l00296"></a><span class="lineno"> 296</span> </div> <div class="line"><a name="l00297"></a><span class="lineno"> 297</span>  <span class="comment">// To enable/disable different read ahead strategies. Defined in XrdClientReadAhead.hh</span></div> <div class="line"><a name="l00298"></a><span class="lineno"> 298</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#a19d1b861903c54407f5af3ce71c3cfe3">SetReadAheadStrategy</a>(<span class="keywordtype">int</span> strategy);</div> <div class="line"><a name="l00299"></a><span class="lineno"> 299</span>  </div> <div class="line"><a name="l00300"></a><span class="lineno"> 300</span>  <span class="comment">// To enable the trimming of the blocks to read. Blocksize will be rounded to a multiple of 512.</span></div> <div class="line"><a name="l00301"></a><span class="lineno"> 301</span>  <span class="comment">// Each read request will have the offset and length aligned with a multiple of blocksize</span></div> <div class="line"><a name="l00302"></a><span class="lineno"> 302</span>  <span class="comment">// This strategy is similar to a read ahead, but not quite. Here we see it as a transformation</span></div> <div class="line"><a name="l00303"></a><span class="lineno"> 303</span>  <span class="comment">// of the stream of the read accesses to request</span></div> <div class="line"><a name="l00304"></a><span class="lineno"> 304</span>  <span class="keywordtype">void</span> <a class="code" href="classXrdClient.html#a233c9dded9143c23528ea4f419506b7f">SetBlockReadTrimming</a>(<span class="keywordtype">int</span> blocksize);</div> <div class="line"><a name="l00305"></a><span class="lineno"> 305</span>  </div> <div class="line"><a name="l00306"></a><span class="lineno"> 306</span>  <span class="comment">// Truncates the open file at a specified length</span></div> <div class="line"><a name="l00307"></a><span class="lineno"> 307</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#adfb80b498fe7d38fd63b81d73c52e297">Truncate</a>(<span class="keywordtype">long</span> <span class="keywordtype">long</span> len);</div> <div class="line"><a name="l00308"></a><span class="lineno"> 308</span> </div> <div class="line"><a name="l00309"></a><span class="lineno"> 309</span>  <span class="comment">// Write data to the file</span></div> <div class="line"><a name="l00310"></a><span class="lineno"> 310</span>  <span class="keywordtype">bool</span> <a class="code" href="classXrdClient.html#ad673bf9cd7d22cbdf0c0d222a49b2f00">Write</a>(<span class="keyword">const</span> <span class="keywordtype">void</span> *buf, <span class="keywordtype">long</span> <span class="keywordtype">long</span> offset, <span class="keywordtype">int</span> len);</div> <div class="line"><a name="l00311"></a><span class="lineno"> 311</span> </div> <div class="line"><a name="l00312"></a><span class="lineno"><a class="code" href="classXrdClient.html#a8563cd80a184e571eb3dd9b3ed33ec14"> 312</a></span>  std::vector<std::string> <a class="code" href="classXrdClient.html#a8563cd80a184e571eb3dd9b3ed33ec14">fExcludedHosts</a>;</div> <div class="line"><a name="l00313"></a><span class="lineno"> 313</span> </div> <div class="line"><a name="l00314"></a><span class="lineno"> 314</span> };</div> <div class="line"><a name="l00315"></a><span class="lineno"> 315</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>