File: uri_8h.html

package info (click to toggle)
pam-pkcs11 0.6.4-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 7,512 kB
  • ctags: 7,477
  • sloc: ansic: 12,651; sh: 10,824; xml: 2,756; makefile: 231; lex: 92
file content (200 lines) | stat: -rw-r--r-- 8,870 bytes parent folder | download 
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
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
 
<!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"/>
<title>pam_pkcs11: uri.h File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
</head>
<body>
<!-- Generated by Doxygen 1.6.3 -->
<div class="navigation" id="top">
  <div class="tabs">
    <ul>
      <li><a href="index.html"><span>Main&nbsp;Page</span></a></li>
      <li><a href="annotated.html"><span>Data&nbsp;Structures</span></a></li>
      <li class="current"><a href="files.html"><span>Files</span></a></li>
      <li><a href="dirs.html"><span>Directories</span></a></li>
    </ul>
  </div>
  <div class="tabs">
    <ul>
      <li><a href="files.html"><span>File&nbsp;List</span></a></li>
      <li><a href="globals.html"><span>Globals</span></a></li>
    </ul>
  </div>
  <div class="navpath"><a class="el" href="dir_55f9682142a78e45196901be32452b47.html">src</a>&nbsp;&raquo;&nbsp;<a class="el" href="dir_782c1fcd7529e1a05f3f2af490691324.html">common</a>
  </div>
</div>
<div class="contents">
<h1>uri.h File Reference</h1>
<p>This module contains several functions to retrieve data from an URL.  
<a href="#_details">More...</a></p>
<code>#include &lt;stdlib.h&gt;</code><br/>

<p><a href="uri_8h_source.html">Go to the source code of this file.</a></p>
<table border="0" cellpadding="0" cellspacing="0">
<tr><td colspan="2"><h2>Defines</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">#define&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#a80cf5712440b8fbd7422576c01f6f35b">URI_EXTERN</a>&nbsp;&nbsp;&nbsp;extern</td></tr>
<tr><td colspan="2"><h2>Functions</h2></td></tr>
<tr><td class="memItemLeft" align="right" valign="top">URI_EXTERN int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#aa951708e1500288b08b91c4db0e5404f">is_uri</a> (const char *path)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">URI_EXTERN int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#a6762521860b0ec7da48e290477330a58">is_file</a> (const char *path)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">URI_EXTERN int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#aa273722d8dec305e432f85539661bbd3">is_dir</a> (const char *path)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">URI_EXTERN int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#a2607a177d678fa4ec237f0b3b421d185">is_symlink</a> (const char *path)</td></tr>
<tr><td class="memItemLeft" align="right" valign="top">URI_EXTERN int&nbsp;</td><td class="memItemRight" valign="bottom"><a class="el" href="uri_8h.html#acae6bb80b0654971c3bbb94ef6d57e00">get_from_uri</a> (const char *uri_str, unsigned char **data, size_t *length)</td></tr>
<tr><td class="mdescLeft">&nbsp;</td><td class="mdescRight">Downloads data from a given URI.  <a href="#acae6bb80b0654971c3bbb94ef6d57e00"></a><br/></td></tr>
</table>
<hr/><a name="_details"></a><h2>Detailed Description</h2>
<p>This module contains several functions to retrieve data from an URL. </p>
<p>Some examples of valid URL's: </p>
<ul>
<li>
<a href="file:///home/mario/projects/pkcs11_login/tests/ca_crl_0.pem">file:///home/mario/projects/pkcs11_login/tests/ca_crl_0.pem</a> </li>
<li>
<a href="ftp://ftp.rediris.es/certs/rediris_cacert.pem">ftp://ftp.rediris.es/certs/rediris_cacert.pem</a> </li>
<li>
<a href="http://www-t.zhwin.ch/ca/root_ca.crl">http://www-t.zhwin.ch/ca/root_ca.crl</a> </li>
<li>
ldap://directory.verisign.com:389/CN=VeriSign IECA, OU=IECA-3, OU=Contractor, OU=PKI, OU=DOD, O=U.S. Government, C=US?certificateRevocationList;binary </li>
</ul>

<p>Definition in file <a class="el" href="uri_8h_source.html">uri.h</a>.</p>
<hr/><h2>Define Documentation</h2>
<a class="anchor" id="a80cf5712440b8fbd7422576c01f6f35b"></a><!-- doxytag: member="uri.h::URI_EXTERN" ref="a80cf5712440b8fbd7422576c01f6f35b" args="" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">#define URI_EXTERN&nbsp;&nbsp;&nbsp;extern</td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Definition at line <a class="el" href="uri_8h_source.html#l00039">39</a> of file <a class="el" href="uri_8h_source.html">uri.h</a>.</p>

</div>
</div>
<hr/><h2>Function Documentation</h2>
<a class="anchor" id="acae6bb80b0654971c3bbb94ef6d57e00"></a><!-- doxytag: member="uri.h::get_from_uri" ref="acae6bb80b0654971c3bbb94ef6d57e00" args="(const char *uri_str, unsigned char **data, size_t *length)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">URI_EXTERN int get_from_uri </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>uri_str</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">unsigned char **&nbsp;</td>
          <td class="paramname"> <em>data</em>, </td>
        </tr>
        <tr>
          <td class="paramkey"></td>
          <td></td>
          <td class="paramtype">size_t *&nbsp;</td>
          <td class="paramname"> <em>length</em></td><td>&nbsp;</td>
        </tr>
        <tr>
          <td></td>
          <td>)</td>
          <td></td><td></td><td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

<p>Downloads data from a given URI. </p>
<dl><dt><b>Parameters:</b></dt><dd>
  <table border="0" cellspacing="2" cellpadding="0">
    <tr><td valign="top"></td><td valign="top"><em>uri_str</em>&nbsp;</td><td>URL string where to retrieve data </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>data</em>&nbsp;</td><td>Pointer to a String buffer where data is retrieved </td></tr>
    <tr><td valign="top"></td><td valign="top"><em>length</em>&nbsp;</td><td>Length of retrieved data </td></tr>
  </table>
  </dd>
</dl>
<dl class="return"><dt><b>Returns:</b></dt><dd>-1 on error, 0 on sucess </dd></dl>

</div>
</div>
<a class="anchor" id="aa273722d8dec305e432f85539661bbd3"></a><!-- doxytag: member="uri.h::is_dir" ref="aa273722d8dec305e432f85539661bbd3" args="(const char *path)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">URI_EXTERN int is_dir </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>path</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="a6762521860b0ec7da48e290477330a58"></a><!-- doxytag: member="uri.h::is_file" ref="a6762521860b0ec7da48e290477330a58" args="(const char *path)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">URI_EXTERN int is_file </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>path</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="a2607a177d678fa4ec237f0b3b421d185"></a><!-- doxytag: member="uri.h::is_symlink" ref="a2607a177d678fa4ec237f0b3b421d185" args="(const char *path)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">URI_EXTERN int is_symlink </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>path</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
<a class="anchor" id="aa951708e1500288b08b91c4db0e5404f"></a><!-- doxytag: member="uri.h::is_uri" ref="aa951708e1500288b08b91c4db0e5404f" args="(const char *path)" -->
<div class="memitem">
<div class="memproto">
      <table class="memname">
        <tr>
          <td class="memname">URI_EXTERN int is_uri </td>
          <td>(</td>
          <td class="paramtype">const char *&nbsp;</td>
          <td class="paramname"> <em>path</em></td>
          <td>&nbsp;)&nbsp;</td>
          <td></td>
        </tr>
      </table>
</div>
<div class="memdoc">

</div>
</div>
</div>
<hr class="footer"/><address style="text-align: right;"><small>Generated on Sat Jun 12 17:28:16 2010 for pam_pkcs11 by&nbsp;
<a href="http://www.doxygen.org/index.html">
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.3 </small></address>
</body>
</html>