/usr/share/doc/python-pycurl-doc/html/curlshareobject.html is in python-pycurl-doc 7.19.5-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 | <!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/html; charset=utf-8" />
<title>CurlShare Object — PycURL 7.19.5 documentation</title>
<link rel="stylesheet" href="_static/default.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript">
var DOCUMENTATION_OPTIONS = {
URL_ROOT: './',
VERSION: '7.19.5',
COLLAPSE_INDEX: false,
FILE_SUFFIX: '.html',
HAS_SOURCE: true
};
</script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<link rel="shortcut icon" href="_static/favicon.ico"/>
<link rel="top" title="PycURL 7.19.5 documentation" href="index.html" />
<link rel="next" title="Callbacks" href="callbacks.html" />
<link rel="prev" title="CurlMulti Object" href="curlmultiobject.html" />
</head>
<body>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
accesskey="I">index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="callbacks.html" title="Callbacks"
accesskey="N">next</a> |</li>
<li class="right" >
<a href="curlmultiobject.html" title="CurlMulti Object"
accesskey="P">previous</a> |</li>
<li><a href="index.html">PycURL 7.19.5 documentation</a> »</li>
</ul>
</div>
<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">
<div class="body">
<div class="section" id="curlshare-object">
<span id="curlshareobject"></span><h1>CurlShare Object<a class="headerlink" href="#curlshare-object" title="Permalink to this headline">¶</a></h1>
<dl class="class">
<dt id="pycurl.CurlShare">
<em class="property">class </em><tt class="descclassname">pycurl.</tt><tt class="descname">CurlShare</tt><a class="headerlink" href="#pycurl.CurlShare" title="Permalink to this definition">¶</a></dt>
<dd><p>CurlShare() -> New CurlShare object</p>
<p>Creates a new <a class="reference internal" href="#curlshareobject"><em>CurlShare Object</em></a> which corresponds to a
<tt class="docutils literal"><span class="pre">CURLSH</span></tt> handle in libcurl. CurlShare objects is what you pass as an
argument to the SHARE option on <a class="reference internal" href="curlobject.html#curlobject"><em>Curl objects</em></a>.</p>
<p>CurlShare objects have the following methods:</p>
<dl class="method">
<dt id="pycurl.CurlShare.close">
<tt class="descname">close</tt><big>(</big><big>)</big> → None<a class="headerlink" href="#pycurl.CurlShare.close" title="Permalink to this definition">¶</a></dt>
<dd><p>Close shared handle.</p>
<p>Corresponds to <a class="reference external" href="http://curl.haxx.se/libcurl/c/curl_share_cleanup.html">curl_share_cleanup</a> in libcurl. This method is
automatically called by pycurl when a CurlShare object no longer has
any references to it, but can also be called explicitly.</p>
</dd></dl>
<dl class="method">
<dt id="pycurl.CurlShare.setopt">
<tt class="descname">setopt</tt><big>(</big><em>option</em>, <em>value</em><big>)</big> → None<a class="headerlink" href="#pycurl.CurlShare.setopt" title="Permalink to this definition">¶</a></dt>
<dd><p>Set curl share option.</p>
<p>Corresponds to <a class="reference external" href="http://curl.haxx.se/libcurl/c/curl_share_setopt.html">curl_share_setopt</a> in libcurl, where <em>option</em> is
specified with the <tt class="docutils literal"><span class="pre">CURLSHOPT_*</span></tt> constants in libcurl, except that the
<tt class="docutils literal"><span class="pre">CURLSHOPT_</span></tt> prefix has been changed to <tt class="docutils literal"><span class="pre">SH_</span></tt>. Currently, <em>value</em> must be
either <tt class="docutils literal"><span class="pre">LOCK_DATA_COOKIE</span></tt> or <tt class="docutils literal"><span class="pre">LOCK_DATA_DNS</span></tt>.</p>
<p>Example usage:</p>
<div class="highlight-python"><div class="highlight"><pre><span class="kn">import</span> <span class="nn">pycurl</span>
<span class="n">curl</span> <span class="o">=</span> <span class="n">pycurl</span><span class="o">.</span><span class="n">Curl</span><span class="p">()</span>
<span class="n">s</span> <span class="o">=</span> <span class="n">pycurl</span><span class="o">.</span><span class="n">CurlShare</span><span class="p">()</span>
<span class="n">s</span><span class="o">.</span><span class="n">setopt</span><span class="p">(</span><span class="n">pycurl</span><span class="o">.</span><span class="n">SH_SHARE</span><span class="p">,</span> <span class="n">pycurl</span><span class="o">.</span><span class="n">LOCK_DATA_COOKIE</span><span class="p">)</span>
<span class="n">s</span><span class="o">.</span><span class="n">setopt</span><span class="p">(</span><span class="n">pycurl</span><span class="o">.</span><span class="n">SH_SHARE</span><span class="p">,</span> <span class="n">pycurl</span><span class="o">.</span><span class="n">LOCK_DATA_DNS</span><span class="p">)</span>
<span class="n">curl</span><span class="o">.</span><span class="n">setopt</span><span class="p">(</span><span class="n">pycurl</span><span class="o">.</span><span class="n">URL</span><span class="p">,</span> <span class="s">'http://curl.haxx.se'</span><span class="p">)</span>
<span class="n">curl</span><span class="o">.</span><span class="n">setopt</span><span class="p">(</span><span class="n">pycurl</span><span class="o">.</span><span class="n">SHARE</span><span class="p">,</span> <span class="n">s</span><span class="p">)</span>
<span class="n">curl</span><span class="o">.</span><span class="n">perform</span><span class="p">()</span>
<span class="n">curl</span><span class="o">.</span><span class="n">close</span><span class="p">()</span>
</pre></div>
</div>
<p>Raises pycurl.error exception upon failure.</p>
</dd></dl>
</dd></dl>
</div>
</div>
</div>
</div>
<div class="sphinxsidebar">
<div class="sphinxsidebarwrapper">
<h4>Previous topic</h4>
<p class="topless"><a href="curlmultiobject.html"
title="previous chapter">CurlMulti Object</a></p>
<h4>Next topic</h4>
<p class="topless"><a href="callbacks.html"
title="next chapter">Callbacks</a></p>
<h3>This Page</h3>
<ul class="this-page-menu">
<li><a href="_sources/curlshareobject.txt"
rel="nofollow">Show Source</a></li>
</ul>
<div id="searchbox" style="display: none">
<h3>Quick search</h3>
<form class="search" action="search.html" method="get">
<input type="text" name="q" />
<input type="submit" value="Go" />
<input type="hidden" name="check_keywords" value="yes" />
<input type="hidden" name="area" value="default" />
</form>
<p class="searchtip" style="font-size: 90%">
Enter search terms or a module, class or function name.
</p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
</div>
</div>
<div class="clearer"></div>
</div>
<div class="related">
<h3>Navigation</h3>
<ul>
<li class="right" style="margin-right: 10px">
<a href="genindex.html" title="General Index"
>index</a></li>
<li class="right" >
<a href="py-modindex.html" title="Python Module Index"
>modules</a> |</li>
<li class="right" >
<a href="callbacks.html" title="Callbacks"
>next</a> |</li>
<li class="right" >
<a href="curlmultiobject.html" title="CurlMulti Object"
>previous</a> |</li>
<li><a href="index.html">PycURL 7.19.5 documentation</a> »</li>
</ul>
</div>
<div class="footer">
© Copyright 2001-2014 Kjetil Jacobsen, Markus F.X.J. Oberhumer, Oleg Pudeyev.
Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2.3.
</div>
</body>
</html>
|