~ubuntu-branches/ubuntu/hardy/curl/hardy

« back to all changes in this revision

Viewing changes to docs/libcurl/curl_easy_getinfo.html

  • Committer: Bazaar Package Importer
  • Author(s): Matthias Klose
  • Date: 2007-12-04 01:09:30 UTC
  • mfrom: (1.1.9 upstream)
  • Revision ID: james.westby@ubuntu.com-20071204010930-he4zlo7f3qdaz3qz
Tags: 7.17.1-1ubuntu1
* Merge with Debian; remaining changes:
  - Drop the stunnel build dependency.
* Drop the build-dependency on libdb4.5-dev, add build-dependency on
  openssh-server.

Show diffs side-by-side

added added

removed removed

Lines of Context:
96
96
<p class="level0"><a name="CURLINFOCONTENTTYPE"></a><span class="nroffip">CURLINFO_CONTENT_TYPE</span> 
97
97
<p class="level1">Pass a pointer to a 'char *' to receive the content-type of the downloaded object. This is the value read from the Content-Type: field. If you get NULL, it means that the server didn't send a valid Content-Type header or that the protocol used doesn't support this. 
98
98
<p class="level0"><a name="CURLINFOPRIVATE"></a><span class="nroffip">CURLINFO_PRIVATE</span> 
99
 
<p class="level1">Pass a pointer to a 'char *' to receive the pointer to the private data associated with the curl handle (set with the CURLOPT_PRIVATE option to <a class="emphasis" href="./curl_easy_setopt.html">curl_easy_setopt(3)</a>). (Added in 7.10.3) 
 
99
<p class="level1">Pass a pointer to a 'char *' to receive the pointer to the private data associated with the curl handle (set with the CURLOPT_PRIVATE option to <a class="emphasis" href="./curl_easy_setopt.html">curl_easy_setopt(3)</a>). Please note that for internal reasons, the value is returned as a 'char *', although effectively being a 'void *'. (Added in 7.10.3) 
100
100
<p class="level0"><a name="CURLINFOHTTPAUTHAVAIL"></a><span class="nroffip">CURLINFO_HTTPAUTH_AVAIL</span> 
101
101
<p class="level1">Pass a pointer to a long to receive a bitmask indicating the authentication method(s) available. The meaning of the bits is explained in the CURLOPT_HTTPAUTH option for <a class="emphasis" href="./curl_easy_setopt.html">curl_easy_setopt(3)</a>.  (Added in 7.10.8) 
102
102
<p class="level0"><a name="CURLINFOPROXYAUTHAVAIL"></a><span class="nroffip">CURLINFO_PROXYAUTH_AVAIL</span> 
121
121
 &nbsp;   |--|--|--|--ST
122
122
 &nbsp;   |--|--|--|--|--TT
123
123
 &nbsp;   |--|--|--|--|--RT
124
 
 <p class="level0"><a name="NT"></a><span class="nroffip">NT</span> <p class="level1"><a class="emphasis" href="#CURLINFONAMELOOKUPTIME">CURLINFO_NAMELOOKUP_TIME</a>. The time it took from the start until the name
125
 
 resolving was completed.
126
 
 <p class="level0"><a name="CT"></a><span class="nroffip">CT</span> <p class="level1"><a class="emphasis" href="#CURLINFOCONNECTTIME">CURLINFO_CONNECT_TIME</a>. The time it took from the start until the connect
127
 
 to the remote host (or proxy) was completed.
128
 
 <p class="level0"><a name="PT"></a><span class="nroffip">PT</span> <p class="level1"><a class="emphasis" href="#CURLINFOPRETRANSFERTIME">CURLINFO_PRETRANSFER_TIME</a>. The time it took from the start until the
129
 
 file transfer is just about to begin. This includes all pre-transfer commands
130
 
 and negotiations that are specific to the particular protocol(s) involved.
131
 
 <p class="level0"><a name="ST"></a><span class="nroffip">ST</span> <p class="level1"><a class="emphasis" href="#CURLINFOSTARTTRANSFERTIME">CURLINFO_STARTTRANSFER_TIME</a>. The time it took from the start until the
132
 
 first byte is just about to be transferred.
133
 
 <p class="level0"><a name="TT"></a><span class="nroffip">TT</span> <p class="level1"><a class="emphasis" href="#CURLINFOTOTALTIME">CURLINFO_TOTAL_TIME</a>. Total time of the previous request.
134
 
 <p class="level0"><a name="RT"></a><span class="nroffip">RT</span> <p class="level1"><a class="emphasis" href="#CURLINFOREDIRECTTIME">CURLINFO_REDIRECT_TIME</a>. The time it took for all redirection steps
135
 
 include name lookup, connect, pretransfer and transfer before final
136
 
 transaction was started. So, this is zero if no redirection took place.
137
124
 </pre>
138
 
<a name="RETURN"></a><h2 class="nroffsh">RETURN VALUE</h2>
 
125
 
 
126
<p class="level0">
 
127
<p class="level0"><a name="NT"></a><span class="nroffip">NT</span> 
 
128
<p class="level1"><a class="emphasis" href="#CURLINFONAMELOOKUPTIME">CURLINFO_NAMELOOKUP_TIME</a>. The time it took from the start until the name resolving was completed. 
 
129
<p class="level0"><a name="CT"></a><span class="nroffip">CT</span> 
 
130
<p class="level1"><a class="emphasis" href="#CURLINFOCONNECTTIME">CURLINFO_CONNECT_TIME</a>. The time it took from the start until the connect to the remote host (or proxy) was completed. 
 
131
<p class="level0"><a name="PT"></a><span class="nroffip">PT</span> 
 
132
<p class="level1"><a class="emphasis" href="#CURLINFOPRETRANSFERTIME">CURLINFO_PRETRANSFER_TIME</a>. The time it took from the start until the file transfer is just about to begin. This includes all pre-transfer commands and negotiations that are specific to the particular protocol(s) involved. 
 
133
<p class="level0"><a name="ST"></a><span class="nroffip">ST</span> 
 
134
<p class="level1"><a class="emphasis" href="#CURLINFOSTARTTRANSFERTIME">CURLINFO_STARTTRANSFER_TIME</a>. The time it took from the start until the first byte is just about to be transferred. 
 
135
<p class="level0"><a name="TT"></a><span class="nroffip">TT</span> 
 
136
<p class="level1"><a class="emphasis" href="#CURLINFOTOTALTIME">CURLINFO_TOTAL_TIME</a>. Total time of the previous request. 
 
137
<p class="level0"><a name="RT"></a><span class="nroffip">RT</span> 
 
138
<p class="level1"><a class="emphasis" href="#CURLINFOREDIRECTTIME">CURLINFO_REDIRECT_TIME</a>. The time it took for all redirection steps include name lookup, connect, pretransfer and transfer before final transaction was started. So, this is zero if no redirection took place. <a name="RETURN"></a><h2 class="nroffsh">RETURN VALUE</h2>
139
139
<p class="level0">If the operation was successful, CURLE_OK is returned. Otherwise an appropriate error code will be returned. <a name="SEE"></a><h2 class="nroffsh">SEE ALSO</h2>
140
140
<p class="level0"><a class="manpage" href="./curl_easy_setopt.html">curl_easy_setopt (3)</a> <p class="roffit">
141
141
 This HTML page was made with <a href="http://daniel.haxx.se/projects/roffit/">roffit</a>.