You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@apr.apache.org by bo...@apache.org on 2008/08/16 13:44:00 UTC
svn commit: r686480 [22/30] - in /apr/site/trunk/docs/docs: apr-util/1.3/
apr-util/trunk/ apr/1.3/ apr/trunk/
Modified: apr/site/trunk/docs/docs/apr/trunk/apr__file__io_8h-source.html
URL: http://svn.apache.org/viewvc/apr/site/trunk/docs/docs/apr/trunk/apr__file__io_8h-source.html?rev=686480&r1=686479&r2=686480&view=diff
==============================================================================
--- apr/site/trunk/docs/docs/apr/trunk/apr__file__io_8h-source.html (original)
+++ apr/site/trunk/docs/docs/apr/trunk/apr__file__io_8h-source.html Sat Aug 16 04:43:44 2008
@@ -4,7 +4,7 @@
<link href="doxygen.css" rel="stylesheet" type="text/css">
<link href="tabs.css" rel="stylesheet" type="text/css">
</head><body>
-<!-- Generated by Doxygen 1.5.5 -->
+<!-- Generated by Doxygen 1.5.6 -->
<div class="navigation" id="top">
<div class="tabs">
<ul>
@@ -283,667 +283,676 @@
<a name="l00265"></a>00265 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
<a name="l00266"></a>00266 <span class="comment"></span>
<a name="l00267"></a>00267 <span class="comment">/**</span>
-<a name="l00268"></a>00268 <span class="comment"> * Copy the specified file to another file.</span>
+<a name="l00268"></a>00268 <span class="comment"> * Create a hard link to the specified file.</span>
<a name="l00269"></a>00269 <span class="comment"> * @param from_path The full path to the original file (using / on all systems)</span>
<a name="l00270"></a>00270 <span class="comment"> * @param to_path The full path to the new file (using / on all systems)</span>
-<a name="l00271"></a>00271 <span class="comment"> * @param perms Access permissions for the new file if it is created.</span>
-<a name="l00272"></a>00272 <span class="comment"> * In place of the usual or'd combination of file permissions, the</span>
-<a name="l00273"></a>00273 <span class="comment"> * value APR_FILE_SOURCE_PERMS may be given, in which case the source</span>
-<a name="l00274"></a>00274 <span class="comment"> * file's permissions are copied.</span>
-<a name="l00275"></a>00275 <span class="comment"> * @param pool The pool to use.</span>
-<a name="l00276"></a>00276 <span class="comment"> * @remark The new file does not need to exist, it will be created if required.</span>
-<a name="l00277"></a>00277 <span class="comment"> * @warning If the new file already exists, its contents will be overwritten.</span>
-<a name="l00278"></a>00278 <span class="comment"> */</span>
-<a name="l00279"></a>00279 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g2b82c441246cc4596795420b0a94a9a2">apr_file_copy</a>(const <span class="keywordtype">char</span> *from_path,
-<a name="l00280"></a>00280 const <span class="keywordtype">char</span> *to_path,
-<a name="l00281"></a>00281 <a class="code" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perms,
-<a name="l00282"></a>00282 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00283"></a>00283 <span class="comment"></span>
-<a name="l00284"></a>00284 <span class="comment">/**</span>
-<a name="l00285"></a>00285 <span class="comment"> * Append the specified file to another file.</span>
-<a name="l00286"></a>00286 <span class="comment"> * @param from_path The full path to the source file (use / on all systems)</span>
-<a name="l00287"></a>00287 <span class="comment"> * @param to_path The full path to the destination file (use / on all systems)</span>
-<a name="l00288"></a>00288 <span class="comment"> * @param perms Access permissions for the destination file if it is created.</span>
-<a name="l00289"></a>00289 <span class="comment"> * In place of the usual or'd combination of file permissions, the</span>
-<a name="l00290"></a>00290 <span class="comment"> * value APR_FILE_SOURCE_PERMS may be given, in which case the source</span>
-<a name="l00291"></a>00291 <span class="comment"> * file's permissions are copied.</span>
-<a name="l00292"></a>00292 <span class="comment"> * @param pool The pool to use.</span>
-<a name="l00293"></a>00293 <span class="comment"> * @remark The new file does not need to exist, it will be created if required.</span>
-<a name="l00294"></a>00294 <span class="comment"> */</span>
-<a name="l00295"></a>00295 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g0b9bc41ffa4ac43cbea46b44eace939e">apr_file_append</a>(const <span class="keywordtype">char</span> *from_path,
-<a name="l00296"></a>00296 const <span class="keywordtype">char</span> *to_path,
-<a name="l00297"></a>00297 <a class="code" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perms,
-<a name="l00298"></a>00298 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00299"></a>00299 <span class="comment"></span>
-<a name="l00300"></a>00300 <span class="comment">/**</span>
-<a name="l00301"></a>00301 <span class="comment"> * Are we at the end of the file</span>
-<a name="l00302"></a>00302 <span class="comment"> * @param fptr The apr file we are testing.</span>
-<a name="l00303"></a>00303 <span class="comment"> * @remark Returns APR_EOF if we are at the end of file, APR_SUCCESS otherwise.</span>
-<a name="l00304"></a>00304 <span class="comment"> */</span>
-<a name="l00305"></a>00305 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g8efaff2f556b250fee1021541b782ea8">apr_file_eof</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *fptr);
-<a name="l00306"></a>00306 <span class="comment"></span>
-<a name="l00307"></a>00307 <span class="comment">/**</span>
-<a name="l00308"></a>00308 <span class="comment"> * Open standard error as an apr file pointer.</span>
-<a name="l00309"></a>00309 <span class="comment"> * @param thefile The apr file to use as stderr.</span>
-<a name="l00310"></a>00310 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00311"></a>00311 <span class="comment"> * </span>
-<a name="l00312"></a>00312 <span class="comment"> * @remark The only reason that the apr_file_open_std* functions exist</span>
-<a name="l00313"></a>00313 <span class="comment"> * is that you may not always have a stderr/out/in on Windows. This</span>
-<a name="l00314"></a>00314 <span class="comment"> * is generally a problem with newer versions of Windows and services.</span>
-<a name="l00315"></a>00315 <span class="comment"> * </span>
-<a name="l00316"></a>00316 <span class="comment"> * @remark The other problem is that the C library functions generally work</span>
-<a name="l00317"></a>00317 <span class="comment"> * differently on Windows and Unix. So, by using apr_file_open_std*</span>
-<a name="l00318"></a>00318 <span class="comment"> * functions, you can get a handle to an APR struct that works with</span>
-<a name="l00319"></a>00319 <span class="comment"> * the APR functions which are supposed to work identically on all</span>
-<a name="l00320"></a>00320 <span class="comment"> * platforms.</span>
-<a name="l00321"></a>00321 <span class="comment"> */</span>
-<a name="l00322"></a>00322 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf426d98943319acced2c9b52757f377f">apr_file_open_stderr</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00323"></a>00323 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00324"></a>00324 <span class="comment"></span>
-<a name="l00325"></a>00325 <span class="comment">/**</span>
-<a name="l00326"></a>00326 <span class="comment"> * open standard output as an apr file pointer.</span>
-<a name="l00327"></a>00327 <span class="comment"> * @param thefile The apr file to use as stdout.</span>
-<a name="l00328"></a>00328 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00329"></a>00329 <span class="comment"> * </span>
-<a name="l00330"></a>00330 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
-<a name="l00331"></a>00331 <span class="comment"> */</span>
-<a name="l00332"></a>00332 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g0d36922c0944ff9675cc820e68d56199">apr_file_open_stdout</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00333"></a>00333 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00334"></a>00334 <span class="comment"></span>
-<a name="l00335"></a>00335 <span class="comment">/**</span>
-<a name="l00336"></a>00336 <span class="comment"> * open standard input as an apr file pointer.</span>
-<a name="l00337"></a>00337 <span class="comment"> * @param thefile The apr file to use as stdin.</span>
-<a name="l00338"></a>00338 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00339"></a>00339 <span class="comment"> * </span>
-<a name="l00340"></a>00340 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
-<a name="l00341"></a>00341 <span class="comment"> */</span>
-<a name="l00342"></a>00342 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g539454470148f9b22a31f85936a5f8b4">apr_file_open_stdin</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00343"></a>00343 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00344"></a>00344 <span class="comment"></span>
-<a name="l00345"></a>00345 <span class="comment">/**</span>
-<a name="l00346"></a>00346 <span class="comment"> * open standard error as an apr file pointer, with flags.</span>
-<a name="l00347"></a>00347 <span class="comment"> * @param thefile The apr file to use as stderr.</span>
-<a name="l00348"></a>00348 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
-<a name="l00349"></a>00349 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
-<a name="l00350"></a>00350 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
-<a name="l00351"></a>00351 <span class="comment"> * be used. The APR_WRITE flag will be set unconditionally.</span>
-<a name="l00352"></a>00352 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00353"></a>00353 <span class="comment"> * </span>
-<a name="l00354"></a>00354 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
-<a name="l00355"></a>00355 <span class="comment"> */</span>
-<a name="l00356"></a>00356 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g6e87d695994e236dae3d428ed68886bf">apr_file_open_flags_stderr</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00357"></a>00357 apr_int32_t flags,
-<a name="l00358"></a>00358 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00359"></a>00359 <span class="comment"></span>
-<a name="l00360"></a>00360 <span class="comment">/**</span>
-<a name="l00361"></a>00361 <span class="comment"> * open standard output as an apr file pointer, with flags.</span>
-<a name="l00362"></a>00362 <span class="comment"> * @param thefile The apr file to use as stdout.</span>
-<a name="l00363"></a>00363 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
-<a name="l00364"></a>00364 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
-<a name="l00365"></a>00365 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
-<a name="l00366"></a>00366 <span class="comment"> * be used. The APR_WRITE flag will be set unconditionally.</span>
-<a name="l00367"></a>00367 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00368"></a>00368 <span class="comment"> * </span>
-<a name="l00369"></a>00369 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
-<a name="l00370"></a>00370 <span class="comment"> */</span>
-<a name="l00371"></a>00371 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#geda353505bc1dc46db93b0a80d0b1c4c">apr_file_open_flags_stdout</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00372"></a>00372 apr_int32_t flags,
-<a name="l00373"></a>00373 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00374"></a>00374 <span class="comment"></span>
-<a name="l00375"></a>00375 <span class="comment">/**</span>
-<a name="l00376"></a>00376 <span class="comment"> * open standard input as an apr file pointer, with flags.</span>
-<a name="l00377"></a>00377 <span class="comment"> * @param thefile The apr file to use as stdin.</span>
-<a name="l00378"></a>00378 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
-<a name="l00379"></a>00379 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
-<a name="l00380"></a>00380 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
-<a name="l00381"></a>00381 <span class="comment"> * be used. The APR_READ flag will be set unconditionally.</span>
-<a name="l00382"></a>00382 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
-<a name="l00383"></a>00383 <span class="comment"> * </span>
-<a name="l00384"></a>00384 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
-<a name="l00385"></a>00385 <span class="comment"> */</span>
-<a name="l00386"></a>00386 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g3bde3e61454b5604077f297b1d1671c0">apr_file_open_flags_stdin</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
-<a name="l00387"></a>00387 apr_int32_t flags,
-<a name="l00388"></a>00388 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00389"></a>00389 <span class="comment"></span>
-<a name="l00390"></a>00390 <span class="comment">/**</span>
-<a name="l00391"></a>00391 <span class="comment"> * Read data from the specified file.</span>
-<a name="l00392"></a>00392 <span class="comment"> * @param thefile The file descriptor to read from.</span>
-<a name="l00393"></a>00393 <span class="comment"> * @param buf The buffer to store the data to.</span>
-<a name="l00394"></a>00394 <span class="comment"> * @param nbytes On entry, the number of bytes to read; on exit, the number</span>
-<a name="l00395"></a>00395 <span class="comment"> * of bytes read.</span>
-<a name="l00396"></a>00396 <span class="comment"> *</span>
-<a name="l00397"></a>00397 <span class="comment"> * @remark apr_file_read will read up to the specified number of</span>
-<a name="l00398"></a>00398 <span class="comment"> * bytes, but never more. If there isn't enough data to fill that</span>
-<a name="l00399"></a>00399 <span class="comment"> * number of bytes, all of the available data is read. The third</span>
-<a name="l00400"></a>00400 <span class="comment"> * argument is modified to reflect the number of bytes read. If a</span>
-<a name="l00401"></a>00401 <span class="comment"> * char was put back into the stream via ungetc, it will be the first</span>
-<a name="l00402"></a>00402 <span class="comment"> * character returned.</span>
-<a name="l00403"></a>00403 <span class="comment"> *</span>
-<a name="l00404"></a>00404 <span class="comment"> * @remark It is not possible for both bytes to be read and an APR_EOF</span>
-<a name="l00405"></a>00405 <span class="comment"> * or other error to be returned. APR_EINTR is never returned.</span>
-<a name="l00406"></a>00406 <span class="comment"> */</span>
-<a name="l00407"></a>00407 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gdd067ee0050dff0c03a9420c9d424466">apr_file_read</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, <span class="keywordtype">void</span> *buf,
-<a name="l00408"></a>00408 apr_size_t *nbytes);
-<a name="l00409"></a>00409 <span class="comment"></span>
-<a name="l00410"></a>00410 <span class="comment">/**</span>
-<a name="l00411"></a>00411 <span class="comment"> * Write data to the specified file.</span>
-<a name="l00412"></a>00412 <span class="comment"> * @param thefile The file descriptor to write to.</span>
-<a name="l00413"></a>00413 <span class="comment"> * @param buf The buffer which contains the data.</span>
-<a name="l00414"></a>00414 <span class="comment"> * @param nbytes On entry, the number of bytes to write; on exit, the number </span>
-<a name="l00415"></a>00415 <span class="comment"> * of bytes written.</span>
-<a name="l00416"></a>00416 <span class="comment"> *</span>
-<a name="l00417"></a>00417 <span class="comment"> * @remark apr_file_write will write up to the specified number of</span>
-<a name="l00418"></a>00418 <span class="comment"> * bytes, but never more. If the OS cannot write that many bytes, it</span>
-<a name="l00419"></a>00419 <span class="comment"> * will write as many as it can. The third argument is modified to</span>
-<a name="l00420"></a>00420 <span class="comment"> * reflect the * number of bytes written.</span>
-<a name="l00421"></a>00421 <span class="comment"> *</span>
-<a name="l00422"></a>00422 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
-<a name="l00423"></a>00423 <span class="comment"> * be returned. APR_EINTR is never returned.</span>
-<a name="l00424"></a>00424 <span class="comment"> */</span>
-<a name="l00425"></a>00425 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g2e4baa94102c363fdca3c850375d3584">apr_file_write</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, const <span class="keywordtype">void</span> *buf,
-<a name="l00426"></a>00426 apr_size_t *nbytes);
-<a name="l00427"></a>00427 <span class="comment"></span>
-<a name="l00428"></a>00428 <span class="comment">/**</span>
-<a name="l00429"></a>00429 <span class="comment"> * Write data from iovec array to the specified file.</span>
-<a name="l00430"></a>00430 <span class="comment"> * @param thefile The file descriptor to write to.</span>
-<a name="l00431"></a>00431 <span class="comment"> * @param vec The array from which to get the data to write to the file.</span>
-<a name="l00432"></a>00432 <span class="comment"> * @param nvec The number of elements in the struct iovec array. This must </span>
-<a name="l00433"></a>00433 <span class="comment"> * be smaller than APR_MAX_IOVEC_SIZE. If it isn't, the function </span>
-<a name="l00434"></a>00434 <span class="comment"> * will fail with APR_EINVAL.</span>
-<a name="l00435"></a>00435 <span class="comment"> * @param nbytes The number of bytes written.</span>
-<a name="l00436"></a>00436 <span class="comment"> *</span>
-<a name="l00437"></a>00437 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
-<a name="l00438"></a>00438 <span class="comment"> * be returned. APR_EINTR is never returned.</span>
-<a name="l00439"></a>00439 <span class="comment"> *</span>
-<a name="l00440"></a>00440 <span class="comment"> * @remark apr_file_writev is available even if the underlying</span>
-<a name="l00441"></a>00441 <span class="comment"> * operating system doesn't provide writev().</span>
-<a name="l00442"></a>00442 <span class="comment"> */</span>
-<a name="l00443"></a>00443 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gcc7924dd7af1c2948b5b2ea6e5f77984">apr_file_writev</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
-<a name="l00444"></a>00444 const struct iovec *vec,
-<a name="l00445"></a>00445 apr_size_t nvec, apr_size_t *nbytes);
-<a name="l00446"></a>00446 <span class="comment"></span>
-<a name="l00447"></a>00447 <span class="comment">/**</span>
-<a name="l00448"></a>00448 <span class="comment"> * Read data from the specified file, ensuring that the buffer is filled</span>
-<a name="l00449"></a>00449 <span class="comment"> * before returning.</span>
-<a name="l00450"></a>00450 <span class="comment"> * @param thefile The file descriptor to read from.</span>
-<a name="l00451"></a>00451 <span class="comment"> * @param buf The buffer to store the data to.</span>
-<a name="l00452"></a>00452 <span class="comment"> * @param nbytes The number of bytes to read.</span>
-<a name="l00453"></a>00453 <span class="comment"> * @param bytes_read If non-NULL, this will contain the number of bytes read.</span>
-<a name="l00454"></a>00454 <span class="comment"> *</span>
-<a name="l00455"></a>00455 <span class="comment"> * @remark apr_file_read will read up to the specified number of</span>
-<a name="l00456"></a>00456 <span class="comment"> * bytes, but never more. If there isn't enough data to fill that</span>
-<a name="l00457"></a>00457 <span class="comment"> * number of bytes, then the process/thread will block until it is</span>
-<a name="l00458"></a>00458 <span class="comment"> * available or EOF is reached. If a char was put back into the</span>
-<a name="l00459"></a>00459 <span class="comment"> * stream via ungetc, it will be the first character returned.</span>
-<a name="l00460"></a>00460 <span class="comment"> *</span>
-<a name="l00461"></a>00461 <span class="comment"> * @remark It is possible for both bytes to be read and an error to be</span>
-<a name="l00462"></a>00462 <span class="comment"> * returned. And if *bytes_read is less than nbytes, an accompanying</span>
-<a name="l00463"></a>00463 <span class="comment"> * error is _always_ returned.</span>
-<a name="l00464"></a>00464 <span class="comment"> *</span>
-<a name="l00465"></a>00465 <span class="comment"> * @remark APR_EINTR is never returned.</span>
-<a name="l00466"></a>00466 <span class="comment"> */</span>
-<a name="l00467"></a>00467 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf39a17404e868808aff8e2e7ecaa87e0">apr_file_read_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, <span class="keywordtype">void</span> *buf,
-<a name="l00468"></a>00468 apr_size_t nbytes,
-<a name="l00469"></a>00469 apr_size_t *bytes_read);
-<a name="l00470"></a>00470 <span class="comment"></span>
-<a name="l00471"></a>00471 <span class="comment">/**</span>
-<a name="l00472"></a>00472 <span class="comment"> * Write data to the specified file, ensuring that all of the data is</span>
-<a name="l00473"></a>00473 <span class="comment"> * written before returning.</span>
-<a name="l00474"></a>00474 <span class="comment"> * @param thefile The file descriptor to write to.</span>
-<a name="l00475"></a>00475 <span class="comment"> * @param buf The buffer which contains the data.</span>
-<a name="l00476"></a>00476 <span class="comment"> * @param nbytes The number of bytes to write.</span>
-<a name="l00477"></a>00477 <span class="comment"> * @param bytes_written If non-NULL, set to the number of bytes written.</span>
-<a name="l00478"></a>00478 <span class="comment"> * </span>
-<a name="l00479"></a>00479 <span class="comment"> * @remark apr_file_write will write up to the specified number of</span>
-<a name="l00480"></a>00480 <span class="comment"> * bytes, but never more. If the OS cannot write that many bytes, the</span>
-<a name="l00481"></a>00481 <span class="comment"> * process/thread will block until they can be written. Exceptional</span>
-<a name="l00482"></a>00482 <span class="comment"> * error such as "out of space" or "pipe closed" will terminate with</span>
-<a name="l00483"></a>00483 <span class="comment"> * an error.</span>
-<a name="l00484"></a>00484 <span class="comment"> *</span>
-<a name="l00485"></a>00485 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
-<a name="l00486"></a>00486 <span class="comment"> * be returned. And if *bytes_written is less than nbytes, an</span>
-<a name="l00487"></a>00487 <span class="comment"> * accompanying error is _always_ returned.</span>
-<a name="l00488"></a>00488 <span class="comment"> *</span>
-<a name="l00489"></a>00489 <span class="comment"> * @remark APR_EINTR is never returned.</span>
-<a name="l00490"></a>00490 <span class="comment"> */</span>
-<a name="l00491"></a>00491 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g560d5c062d65e64c07d906d1207337d4">apr_file_write_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
-<a name="l00492"></a>00492 const <span class="keywordtype">void</span> *buf,
-<a name="l00493"></a>00493 apr_size_t nbytes,
-<a name="l00494"></a>00494 apr_size_t *bytes_written);
-<a name="l00495"></a>00495
-<a name="l00496"></a>00496 <span class="comment"></span>
-<a name="l00497"></a>00497 <span class="comment">/**</span>
-<a name="l00498"></a>00498 <span class="comment"> * Write data from iovec array to the specified file, ensuring that all of the</span>
-<a name="l00499"></a>00499 <span class="comment"> * data is written before returning.</span>
-<a name="l00500"></a>00500 <span class="comment"> * @param thefile The file descriptor to write to.</span>
-<a name="l00501"></a>00501 <span class="comment"> * @param vec The array from which to get the data to write to the file.</span>
-<a name="l00502"></a>00502 <span class="comment"> * @param nvec The number of elements in the struct iovec array. This must </span>
-<a name="l00503"></a>00503 <span class="comment"> * be smaller than APR_MAX_IOVEC_SIZE. If it isn't, the function </span>
-<a name="l00504"></a>00504 <span class="comment"> * will fail with APR_EINVAL.</span>
-<a name="l00505"></a>00505 <span class="comment"> * @param nbytes The number of bytes written.</span>
-<a name="l00506"></a>00506 <span class="comment"> *</span>
-<a name="l00507"></a>00507 <span class="comment"> * @remark apr_file_writev_full is available even if the underlying</span>
-<a name="l00508"></a>00508 <span class="comment"> * operating system doesn't provide writev().</span>
-<a name="l00509"></a>00509 <span class="comment"> */</span>
-<a name="l00510"></a>00510 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g24457e11f0db908b21b7e1742db4ed7b">apr_file_writev_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
-<a name="l00511"></a>00511 const struct iovec *vec,
-<a name="l00512"></a>00512 apr_size_t nvec,
-<a name="l00513"></a>00513 apr_size_t *nbytes);<span class="comment"></span>
-<a name="l00514"></a>00514 <span class="comment">/**</span>
-<a name="l00515"></a>00515 <span class="comment"> * Write a character into the specified file.</span>
-<a name="l00516"></a>00516 <span class="comment"> * @param ch The character to write.</span>
-<a name="l00517"></a>00517 <span class="comment"> * @param thefile The file descriptor to write to</span>
+<a name="l00271"></a>00271 <span class="comment"> * @remark Both files must reside on the same device.</span>
+<a name="l00272"></a>00272 <span class="comment"> */</span>
+<a name="l00273"></a>00273 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#ga7911275c0e97edc064b8167be658f9e">apr_file_link</a>(const <span class="keywordtype">char</span> *from_path,
+<a name="l00274"></a>00274 const <span class="keywordtype">char</span> *to_path);
+<a name="l00275"></a>00275 <span class="comment"></span>
+<a name="l00276"></a>00276 <span class="comment">/**</span>
+<a name="l00277"></a>00277 <span class="comment"> * Copy the specified file to another file.</span>
+<a name="l00278"></a>00278 <span class="comment"> * @param from_path The full path to the original file (using / on all systems)</span>
+<a name="l00279"></a>00279 <span class="comment"> * @param to_path The full path to the new file (using / on all systems)</span>
+<a name="l00280"></a>00280 <span class="comment"> * @param perms Access permissions for the new file if it is created.</span>
+<a name="l00281"></a>00281 <span class="comment"> * In place of the usual or'd combination of file permissions, the</span>
+<a name="l00282"></a>00282 <span class="comment"> * value APR_FILE_SOURCE_PERMS may be given, in which case the source</span>
+<a name="l00283"></a>00283 <span class="comment"> * file's permissions are copied.</span>
+<a name="l00284"></a>00284 <span class="comment"> * @param pool The pool to use.</span>
+<a name="l00285"></a>00285 <span class="comment"> * @remark The new file does not need to exist, it will be created if required.</span>
+<a name="l00286"></a>00286 <span class="comment"> * @warning If the new file already exists, its contents will be overwritten.</span>
+<a name="l00287"></a>00287 <span class="comment"> */</span>
+<a name="l00288"></a>00288 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g2b82c441246cc4596795420b0a94a9a2">apr_file_copy</a>(const <span class="keywordtype">char</span> *from_path,
+<a name="l00289"></a>00289 const <span class="keywordtype">char</span> *to_path,
+<a name="l00290"></a>00290 <a class="code" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perms,
+<a name="l00291"></a>00291 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00292"></a>00292 <span class="comment"></span>
+<a name="l00293"></a>00293 <span class="comment">/**</span>
+<a name="l00294"></a>00294 <span class="comment"> * Append the specified file to another file.</span>
+<a name="l00295"></a>00295 <span class="comment"> * @param from_path The full path to the source file (use / on all systems)</span>
+<a name="l00296"></a>00296 <span class="comment"> * @param to_path The full path to the destination file (use / on all systems)</span>
+<a name="l00297"></a>00297 <span class="comment"> * @param perms Access permissions for the destination file if it is created.</span>
+<a name="l00298"></a>00298 <span class="comment"> * In place of the usual or'd combination of file permissions, the</span>
+<a name="l00299"></a>00299 <span class="comment"> * value APR_FILE_SOURCE_PERMS may be given, in which case the source</span>
+<a name="l00300"></a>00300 <span class="comment"> * file's permissions are copied.</span>
+<a name="l00301"></a>00301 <span class="comment"> * @param pool The pool to use.</span>
+<a name="l00302"></a>00302 <span class="comment"> * @remark The new file does not need to exist, it will be created if required.</span>
+<a name="l00303"></a>00303 <span class="comment"> */</span>
+<a name="l00304"></a>00304 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g0b9bc41ffa4ac43cbea46b44eace939e">apr_file_append</a>(const <span class="keywordtype">char</span> *from_path,
+<a name="l00305"></a>00305 const <span class="keywordtype">char</span> *to_path,
+<a name="l00306"></a>00306 <a class="code" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perms,
+<a name="l00307"></a>00307 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00308"></a>00308 <span class="comment"></span>
+<a name="l00309"></a>00309 <span class="comment">/**</span>
+<a name="l00310"></a>00310 <span class="comment"> * Are we at the end of the file</span>
+<a name="l00311"></a>00311 <span class="comment"> * @param fptr The apr file we are testing.</span>
+<a name="l00312"></a>00312 <span class="comment"> * @remark Returns APR_EOF if we are at the end of file, APR_SUCCESS otherwise.</span>
+<a name="l00313"></a>00313 <span class="comment"> */</span>
+<a name="l00314"></a>00314 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g8efaff2f556b250fee1021541b782ea8">apr_file_eof</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *fptr);
+<a name="l00315"></a>00315 <span class="comment"></span>
+<a name="l00316"></a>00316 <span class="comment">/**</span>
+<a name="l00317"></a>00317 <span class="comment"> * Open standard error as an apr file pointer.</span>
+<a name="l00318"></a>00318 <span class="comment"> * @param thefile The apr file to use as stderr.</span>
+<a name="l00319"></a>00319 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00320"></a>00320 <span class="comment"> * </span>
+<a name="l00321"></a>00321 <span class="comment"> * @remark The only reason that the apr_file_open_std* functions exist</span>
+<a name="l00322"></a>00322 <span class="comment"> * is that you may not always have a stderr/out/in on Windows. This</span>
+<a name="l00323"></a>00323 <span class="comment"> * is generally a problem with newer versions of Windows and services.</span>
+<a name="l00324"></a>00324 <span class="comment"> * </span>
+<a name="l00325"></a>00325 <span class="comment"> * @remark The other problem is that the C library functions generally work</span>
+<a name="l00326"></a>00326 <span class="comment"> * differently on Windows and Unix. So, by using apr_file_open_std*</span>
+<a name="l00327"></a>00327 <span class="comment"> * functions, you can get a handle to an APR struct that works with</span>
+<a name="l00328"></a>00328 <span class="comment"> * the APR functions which are supposed to work identically on all</span>
+<a name="l00329"></a>00329 <span class="comment"> * platforms.</span>
+<a name="l00330"></a>00330 <span class="comment"> */</span>
+<a name="l00331"></a>00331 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf426d98943319acced2c9b52757f377f">apr_file_open_stderr</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00332"></a>00332 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00333"></a>00333 <span class="comment"></span>
+<a name="l00334"></a>00334 <span class="comment">/**</span>
+<a name="l00335"></a>00335 <span class="comment"> * open standard output as an apr file pointer.</span>
+<a name="l00336"></a>00336 <span class="comment"> * @param thefile The apr file to use as stdout.</span>
+<a name="l00337"></a>00337 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00338"></a>00338 <span class="comment"> * </span>
+<a name="l00339"></a>00339 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
+<a name="l00340"></a>00340 <span class="comment"> */</span>
+<a name="l00341"></a>00341 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g0d36922c0944ff9675cc820e68d56199">apr_file_open_stdout</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00342"></a>00342 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00343"></a>00343 <span class="comment"></span>
+<a name="l00344"></a>00344 <span class="comment">/**</span>
+<a name="l00345"></a>00345 <span class="comment"> * open standard input as an apr file pointer.</span>
+<a name="l00346"></a>00346 <span class="comment"> * @param thefile The apr file to use as stdin.</span>
+<a name="l00347"></a>00347 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00348"></a>00348 <span class="comment"> * </span>
+<a name="l00349"></a>00349 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
+<a name="l00350"></a>00350 <span class="comment"> */</span>
+<a name="l00351"></a>00351 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g539454470148f9b22a31f85936a5f8b4">apr_file_open_stdin</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00352"></a>00352 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00353"></a>00353 <span class="comment"></span>
+<a name="l00354"></a>00354 <span class="comment">/**</span>
+<a name="l00355"></a>00355 <span class="comment"> * open standard error as an apr file pointer, with flags.</span>
+<a name="l00356"></a>00356 <span class="comment"> * @param thefile The apr file to use as stderr.</span>
+<a name="l00357"></a>00357 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
+<a name="l00358"></a>00358 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
+<a name="l00359"></a>00359 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
+<a name="l00360"></a>00360 <span class="comment"> * be used. The APR_WRITE flag will be set unconditionally.</span>
+<a name="l00361"></a>00361 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00362"></a>00362 <span class="comment"> * </span>
+<a name="l00363"></a>00363 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
+<a name="l00364"></a>00364 <span class="comment"> */</span>
+<a name="l00365"></a>00365 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g6e87d695994e236dae3d428ed68886bf">apr_file_open_flags_stderr</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00366"></a>00366 apr_int32_t flags,
+<a name="l00367"></a>00367 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00368"></a>00368 <span class="comment"></span>
+<a name="l00369"></a>00369 <span class="comment">/**</span>
+<a name="l00370"></a>00370 <span class="comment"> * open standard output as an apr file pointer, with flags.</span>
+<a name="l00371"></a>00371 <span class="comment"> * @param thefile The apr file to use as stdout.</span>
+<a name="l00372"></a>00372 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
+<a name="l00373"></a>00373 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
+<a name="l00374"></a>00374 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
+<a name="l00375"></a>00375 <span class="comment"> * be used. The APR_WRITE flag will be set unconditionally.</span>
+<a name="l00376"></a>00376 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00377"></a>00377 <span class="comment"> * </span>
+<a name="l00378"></a>00378 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
+<a name="l00379"></a>00379 <span class="comment"> */</span>
+<a name="l00380"></a>00380 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#geda353505bc1dc46db93b0a80d0b1c4c">apr_file_open_flags_stdout</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00381"></a>00381 apr_int32_t flags,
+<a name="l00382"></a>00382 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00383"></a>00383 <span class="comment"></span>
+<a name="l00384"></a>00384 <span class="comment">/**</span>
+<a name="l00385"></a>00385 <span class="comment"> * open standard input as an apr file pointer, with flags.</span>
+<a name="l00386"></a>00386 <span class="comment"> * @param thefile The apr file to use as stdin.</span>
+<a name="l00387"></a>00387 <span class="comment"> * @param flags The flags to open the file with. Only the APR_EXCL,</span>
+<a name="l00388"></a>00388 <span class="comment"> * APR_BUFFERED, APR_XTHREAD, APR_SHARELOCK, </span>
+<a name="l00389"></a>00389 <span class="comment"> * APR_SENDFILE_ENABLED and APR_LARGEFILE flags should</span>
+<a name="l00390"></a>00390 <span class="comment"> * be used. The APR_READ flag will be set unconditionally.</span>
+<a name="l00391"></a>00391 <span class="comment"> * @param pool The pool to allocate the file out of.</span>
+<a name="l00392"></a>00392 <span class="comment"> * </span>
+<a name="l00393"></a>00393 <span class="comment"> * @remark See remarks for apr_file_open_stderr.</span>
+<a name="l00394"></a>00394 <span class="comment"> */</span>
+<a name="l00395"></a>00395 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g3bde3e61454b5604077f297b1d1671c0">apr_file_open_flags_stdin</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **thefile,
+<a name="l00396"></a>00396 apr_int32_t flags,
+<a name="l00397"></a>00397 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
+<a name="l00398"></a>00398 <span class="comment"></span>
+<a name="l00399"></a>00399 <span class="comment">/**</span>
+<a name="l00400"></a>00400 <span class="comment"> * Read data from the specified file.</span>
+<a name="l00401"></a>00401 <span class="comment"> * @param thefile The file descriptor to read from.</span>
+<a name="l00402"></a>00402 <span class="comment"> * @param buf The buffer to store the data to.</span>
+<a name="l00403"></a>00403 <span class="comment"> * @param nbytes On entry, the number of bytes to read; on exit, the number</span>
+<a name="l00404"></a>00404 <span class="comment"> * of bytes read.</span>
+<a name="l00405"></a>00405 <span class="comment"> *</span>
+<a name="l00406"></a>00406 <span class="comment"> * @remark apr_file_read will read up to the specified number of</span>
+<a name="l00407"></a>00407 <span class="comment"> * bytes, but never more. If there isn't enough data to fill that</span>
+<a name="l00408"></a>00408 <span class="comment"> * number of bytes, all of the available data is read. The third</span>
+<a name="l00409"></a>00409 <span class="comment"> * argument is modified to reflect the number of bytes read. If a</span>
+<a name="l00410"></a>00410 <span class="comment"> * char was put back into the stream via ungetc, it will be the first</span>
+<a name="l00411"></a>00411 <span class="comment"> * character returned.</span>
+<a name="l00412"></a>00412 <span class="comment"> *</span>
+<a name="l00413"></a>00413 <span class="comment"> * @remark It is not possible for both bytes to be read and an APR_EOF</span>
+<a name="l00414"></a>00414 <span class="comment"> * or other error to be returned. APR_EINTR is never returned.</span>
+<a name="l00415"></a>00415 <span class="comment"> */</span>
+<a name="l00416"></a>00416 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gdd067ee0050dff0c03a9420c9d424466">apr_file_read</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, <span class="keywordtype">void</span> *buf,
+<a name="l00417"></a>00417 apr_size_t *nbytes);
+<a name="l00418"></a>00418 <span class="comment"></span>
+<a name="l00419"></a>00419 <span class="comment">/**</span>
+<a name="l00420"></a>00420 <span class="comment"> * Write data to the specified file.</span>
+<a name="l00421"></a>00421 <span class="comment"> * @param thefile The file descriptor to write to.</span>
+<a name="l00422"></a>00422 <span class="comment"> * @param buf The buffer which contains the data.</span>
+<a name="l00423"></a>00423 <span class="comment"> * @param nbytes On entry, the number of bytes to write; on exit, the number </span>
+<a name="l00424"></a>00424 <span class="comment"> * of bytes written.</span>
+<a name="l00425"></a>00425 <span class="comment"> *</span>
+<a name="l00426"></a>00426 <span class="comment"> * @remark apr_file_write will write up to the specified number of</span>
+<a name="l00427"></a>00427 <span class="comment"> * bytes, but never more. If the OS cannot write that many bytes, it</span>
+<a name="l00428"></a>00428 <span class="comment"> * will write as many as it can. The third argument is modified to</span>
+<a name="l00429"></a>00429 <span class="comment"> * reflect the * number of bytes written.</span>
+<a name="l00430"></a>00430 <span class="comment"> *</span>
+<a name="l00431"></a>00431 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
+<a name="l00432"></a>00432 <span class="comment"> * be returned. APR_EINTR is never returned.</span>
+<a name="l00433"></a>00433 <span class="comment"> */</span>
+<a name="l00434"></a>00434 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g2e4baa94102c363fdca3c850375d3584">apr_file_write</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, const <span class="keywordtype">void</span> *buf,
+<a name="l00435"></a>00435 apr_size_t *nbytes);
+<a name="l00436"></a>00436 <span class="comment"></span>
+<a name="l00437"></a>00437 <span class="comment">/**</span>
+<a name="l00438"></a>00438 <span class="comment"> * Write data from iovec array to the specified file.</span>
+<a name="l00439"></a>00439 <span class="comment"> * @param thefile The file descriptor to write to.</span>
+<a name="l00440"></a>00440 <span class="comment"> * @param vec The array from which to get the data to write to the file.</span>
+<a name="l00441"></a>00441 <span class="comment"> * @param nvec The number of elements in the struct iovec array. This must </span>
+<a name="l00442"></a>00442 <span class="comment"> * be smaller than APR_MAX_IOVEC_SIZE. If it isn't, the function </span>
+<a name="l00443"></a>00443 <span class="comment"> * will fail with APR_EINVAL.</span>
+<a name="l00444"></a>00444 <span class="comment"> * @param nbytes The number of bytes written.</span>
+<a name="l00445"></a>00445 <span class="comment"> *</span>
+<a name="l00446"></a>00446 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
+<a name="l00447"></a>00447 <span class="comment"> * be returned. APR_EINTR is never returned.</span>
+<a name="l00448"></a>00448 <span class="comment"> *</span>
+<a name="l00449"></a>00449 <span class="comment"> * @remark apr_file_writev is available even if the underlying</span>
+<a name="l00450"></a>00450 <span class="comment"> * operating system doesn't provide writev().</span>
+<a name="l00451"></a>00451 <span class="comment"> */</span>
+<a name="l00452"></a>00452 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gcc7924dd7af1c2948b5b2ea6e5f77984">apr_file_writev</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
+<a name="l00453"></a>00453 const struct iovec *vec,
+<a name="l00454"></a>00454 apr_size_t nvec, apr_size_t *nbytes);
+<a name="l00455"></a>00455 <span class="comment"></span>
+<a name="l00456"></a>00456 <span class="comment">/**</span>
+<a name="l00457"></a>00457 <span class="comment"> * Read data from the specified file, ensuring that the buffer is filled</span>
+<a name="l00458"></a>00458 <span class="comment"> * before returning.</span>
+<a name="l00459"></a>00459 <span class="comment"> * @param thefile The file descriptor to read from.</span>
+<a name="l00460"></a>00460 <span class="comment"> * @param buf The buffer to store the data to.</span>
+<a name="l00461"></a>00461 <span class="comment"> * @param nbytes The number of bytes to read.</span>
+<a name="l00462"></a>00462 <span class="comment"> * @param bytes_read If non-NULL, this will contain the number of bytes read.</span>
+<a name="l00463"></a>00463 <span class="comment"> *</span>
+<a name="l00464"></a>00464 <span class="comment"> * @remark apr_file_read will read up to the specified number of</span>
+<a name="l00465"></a>00465 <span class="comment"> * bytes, but never more. If there isn't enough data to fill that</span>
+<a name="l00466"></a>00466 <span class="comment"> * number of bytes, then the process/thread will block until it is</span>
+<a name="l00467"></a>00467 <span class="comment"> * available or EOF is reached. If a char was put back into the</span>
+<a name="l00468"></a>00468 <span class="comment"> * stream via ungetc, it will be the first character returned.</span>
+<a name="l00469"></a>00469 <span class="comment"> *</span>
+<a name="l00470"></a>00470 <span class="comment"> * @remark It is possible for both bytes to be read and an error to be</span>
+<a name="l00471"></a>00471 <span class="comment"> * returned. And if *bytes_read is less than nbytes, an accompanying</span>
+<a name="l00472"></a>00472 <span class="comment"> * error is _always_ returned.</span>
+<a name="l00473"></a>00473 <span class="comment"> *</span>
+<a name="l00474"></a>00474 <span class="comment"> * @remark APR_EINTR is never returned.</span>
+<a name="l00475"></a>00475 <span class="comment"> */</span>
+<a name="l00476"></a>00476 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf39a17404e868808aff8e2e7ecaa87e0">apr_file_read_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile, <span class="keywordtype">void</span> *buf,
+<a name="l00477"></a>00477 apr_size_t nbytes,
+<a name="l00478"></a>00478 apr_size_t *bytes_read);
+<a name="l00479"></a>00479 <span class="comment"></span>
+<a name="l00480"></a>00480 <span class="comment">/**</span>
+<a name="l00481"></a>00481 <span class="comment"> * Write data to the specified file, ensuring that all of the data is</span>
+<a name="l00482"></a>00482 <span class="comment"> * written before returning.</span>
+<a name="l00483"></a>00483 <span class="comment"> * @param thefile The file descriptor to write to.</span>
+<a name="l00484"></a>00484 <span class="comment"> * @param buf The buffer which contains the data.</span>
+<a name="l00485"></a>00485 <span class="comment"> * @param nbytes The number of bytes to write.</span>
+<a name="l00486"></a>00486 <span class="comment"> * @param bytes_written If non-NULL, set to the number of bytes written.</span>
+<a name="l00487"></a>00487 <span class="comment"> * </span>
+<a name="l00488"></a>00488 <span class="comment"> * @remark apr_file_write will write up to the specified number of</span>
+<a name="l00489"></a>00489 <span class="comment"> * bytes, but never more. If the OS cannot write that many bytes, the</span>
+<a name="l00490"></a>00490 <span class="comment"> * process/thread will block until they can be written. Exceptional</span>
+<a name="l00491"></a>00491 <span class="comment"> * error such as "out of space" or "pipe closed" will terminate with</span>
+<a name="l00492"></a>00492 <span class="comment"> * an error.</span>
+<a name="l00493"></a>00493 <span class="comment"> *</span>
+<a name="l00494"></a>00494 <span class="comment"> * @remark It is possible for both bytes to be written and an error to</span>
+<a name="l00495"></a>00495 <span class="comment"> * be returned. And if *bytes_written is less than nbytes, an</span>
+<a name="l00496"></a>00496 <span class="comment"> * accompanying error is _always_ returned.</span>
+<a name="l00497"></a>00497 <span class="comment"> *</span>
+<a name="l00498"></a>00498 <span class="comment"> * @remark APR_EINTR is never returned.</span>
+<a name="l00499"></a>00499 <span class="comment"> */</span>
+<a name="l00500"></a>00500 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g560d5c062d65e64c07d906d1207337d4">apr_file_write_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
+<a name="l00501"></a>00501 const <span class="keywordtype">void</span> *buf,
+<a name="l00502"></a>00502 apr_size_t nbytes,
+<a name="l00503"></a>00503 apr_size_t *bytes_written);
+<a name="l00504"></a>00504
+<a name="l00505"></a>00505 <span class="comment"></span>
+<a name="l00506"></a>00506 <span class="comment">/**</span>
+<a name="l00507"></a>00507 <span class="comment"> * Write data from iovec array to the specified file, ensuring that all of the</span>
+<a name="l00508"></a>00508 <span class="comment"> * data is written before returning.</span>
+<a name="l00509"></a>00509 <span class="comment"> * @param thefile The file descriptor to write to.</span>
+<a name="l00510"></a>00510 <span class="comment"> * @param vec The array from which to get the data to write to the file.</span>
+<a name="l00511"></a>00511 <span class="comment"> * @param nvec The number of elements in the struct iovec array. This must </span>
+<a name="l00512"></a>00512 <span class="comment"> * be smaller than APR_MAX_IOVEC_SIZE. If it isn't, the function </span>
+<a name="l00513"></a>00513 <span class="comment"> * will fail with APR_EINVAL.</span>
+<a name="l00514"></a>00514 <span class="comment"> * @param nbytes The number of bytes written.</span>
+<a name="l00515"></a>00515 <span class="comment"> *</span>
+<a name="l00516"></a>00516 <span class="comment"> * @remark apr_file_writev_full is available even if the underlying</span>
+<a name="l00517"></a>00517 <span class="comment"> * operating system doesn't provide writev().</span>
<a name="l00518"></a>00518 <span class="comment"> */</span>
-<a name="l00519"></a>00519 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g33e51b53194e7c0dac513ca27ca18e63">apr_file_putc</a>(<span class="keywordtype">char</span> ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00520"></a>00520 <span class="comment"></span>
-<a name="l00521"></a>00521 <span class="comment">/**</span>
-<a name="l00522"></a>00522 <span class="comment"> * Read a character from the specified file.</span>
-<a name="l00523"></a>00523 <span class="comment"> * @param ch The character to read into</span>
-<a name="l00524"></a>00524 <span class="comment"> * @param thefile The file descriptor to read from</span>
-<a name="l00525"></a>00525 <span class="comment"> */</span>
-<a name="l00526"></a>00526 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g852b9c77d4223af15d8d3674a0e2714d">apr_file_getc</a>(<span class="keywordtype">char</span> *ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00527"></a>00527 <span class="comment"></span>
-<a name="l00528"></a>00528 <span class="comment">/**</span>
-<a name="l00529"></a>00529 <span class="comment"> * Put a character back onto a specified stream.</span>
-<a name="l00530"></a>00530 <span class="comment"> * @param ch The character to write.</span>
-<a name="l00531"></a>00531 <span class="comment"> * @param thefile The file descriptor to write to</span>
-<a name="l00532"></a>00532 <span class="comment"> */</span>
-<a name="l00533"></a>00533 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g9d06778e719d596ab96bca812b01cb3a">apr_file_ungetc</a>(<span class="keywordtype">char</span> ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00534"></a>00534 <span class="comment"></span>
-<a name="l00535"></a>00535 <span class="comment">/**</span>
-<a name="l00536"></a>00536 <span class="comment"> * Read a string from the specified file.</span>
-<a name="l00537"></a>00537 <span class="comment"> * @param str The buffer to store the string in. </span>
-<a name="l00538"></a>00538 <span class="comment"> * @param len The length of the string</span>
-<a name="l00539"></a>00539 <span class="comment"> * @param thefile The file descriptor to read from</span>
-<a name="l00540"></a>00540 <span class="comment"> * @remark The buffer will be NUL-terminated if any characters are stored.</span>
+<a name="l00519"></a>00519 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g24457e11f0db908b21b7e1742db4ed7b">apr_file_writev_full</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
+<a name="l00520"></a>00520 const struct iovec *vec,
+<a name="l00521"></a>00521 apr_size_t nvec,
+<a name="l00522"></a>00522 apr_size_t *nbytes);<span class="comment"></span>
+<a name="l00523"></a>00523 <span class="comment">/**</span>
+<a name="l00524"></a>00524 <span class="comment"> * Write a character into the specified file.</span>
+<a name="l00525"></a>00525 <span class="comment"> * @param ch The character to write.</span>
+<a name="l00526"></a>00526 <span class="comment"> * @param thefile The file descriptor to write to</span>
+<a name="l00527"></a>00527 <span class="comment"> */</span>
+<a name="l00528"></a>00528 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g33e51b53194e7c0dac513ca27ca18e63">apr_file_putc</a>(<span class="keywordtype">char</span> ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
+<a name="l00529"></a>00529 <span class="comment"></span>
+<a name="l00530"></a>00530 <span class="comment">/**</span>
+<a name="l00531"></a>00531 <span class="comment"> * Read a character from the specified file.</span>
+<a name="l00532"></a>00532 <span class="comment"> * @param ch The character to read into</span>
+<a name="l00533"></a>00533 <span class="comment"> * @param thefile The file descriptor to read from</span>
+<a name="l00534"></a>00534 <span class="comment"> */</span>
+<a name="l00535"></a>00535 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g852b9c77d4223af15d8d3674a0e2714d">apr_file_getc</a>(<span class="keywordtype">char</span> *ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
+<a name="l00536"></a>00536 <span class="comment"></span>
+<a name="l00537"></a>00537 <span class="comment">/**</span>
+<a name="l00538"></a>00538 <span class="comment"> * Put a character back onto a specified stream.</span>
+<a name="l00539"></a>00539 <span class="comment"> * @param ch The character to write.</span>
+<a name="l00540"></a>00540 <span class="comment"> * @param thefile The file descriptor to write to</span>
<a name="l00541"></a>00541 <span class="comment"> */</span>
-<a name="l00542"></a>00542 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf9513b769c10b09e5f37d6d0b86bdce9">apr_file_gets</a>(<span class="keywordtype">char</span> *str, <span class="keywordtype">int</span> len,
-<a name="l00543"></a>00543 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00544"></a>00544 <span class="comment"></span>
-<a name="l00545"></a>00545 <span class="comment">/**</span>
-<a name="l00546"></a>00546 <span class="comment"> * Write the string into the specified file.</span>
-<a name="l00547"></a>00547 <span class="comment"> * @param str The string to write. </span>
-<a name="l00548"></a>00548 <span class="comment"> * @param thefile The file descriptor to write to</span>
-<a name="l00549"></a>00549 <span class="comment"> */</span>
-<a name="l00550"></a>00550 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gcde81145cc38660a1512d469886ddb16">apr_file_puts</a>(const <span class="keywordtype">char</span> *str, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00551"></a>00551 <span class="comment"></span>
-<a name="l00552"></a>00552 <span class="comment">/**</span>
-<a name="l00553"></a>00553 <span class="comment"> * Flush the file's buffer.</span>
-<a name="l00554"></a>00554 <span class="comment"> * @param thefile The file descriptor to flush</span>
-<a name="l00555"></a>00555 <span class="comment"> */</span>
-<a name="l00556"></a>00556 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g68aba780b7fc53e47404bfd8def949bc">apr_file_flush</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00557"></a>00557 <span class="comment"></span>
-<a name="l00558"></a>00558 <span class="comment">/**</span>
-<a name="l00559"></a>00559 <span class="comment"> * Duplicate the specified file descriptor.</span>
-<a name="l00560"></a>00560 <span class="comment"> * @param new_file The structure to duplicate into. </span>
-<a name="l00561"></a>00561 <span class="comment"> * @param old_file The file to duplicate.</span>
-<a name="l00562"></a>00562 <span class="comment"> * @param p The pool to use for the new file.</span>
-<a name="l00563"></a>00563 <span class="comment"> * @remark *new_file must point to a valid apr_file_t, or point to NULL.</span>
-<a name="l00564"></a>00564 <span class="comment"> */</span>
-<a name="l00565"></a>00565 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g6e849af1b0fd31669c58a803fcb13837">apr_file_dup</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **new_file,
-<a name="l00566"></a>00566 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *old_file,
-<a name="l00567"></a>00567 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);
-<a name="l00568"></a>00568 <span class="comment"></span>
-<a name="l00569"></a>00569 <span class="comment">/**</span>
-<a name="l00570"></a>00570 <span class="comment"> * Duplicate the specified file descriptor and close the original</span>
-<a name="l00571"></a>00571 <span class="comment"> * @param new_file The old file that is to be closed and reused</span>
-<a name="l00572"></a>00572 <span class="comment"> * @param old_file The file to duplicate</span>
-<a name="l00573"></a>00573 <span class="comment"> * @param p The pool to use for the new file</span>
-<a name="l00574"></a>00574 <span class="comment"> *</span>
-<a name="l00575"></a>00575 <span class="comment"> * @remark new_file MUST point at a valid apr_file_t. It cannot be NULL.</span>
-<a name="l00576"></a>00576 <span class="comment"> */</span>
-<a name="l00577"></a>00577 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g602926aad867088297e8f59490ff939c">apr_file_dup2</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *new_file,
-<a name="l00578"></a>00578 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *old_file,
-<a name="l00579"></a>00579 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);
-<a name="l00580"></a>00580 <span class="comment"></span>
-<a name="l00581"></a>00581 <span class="comment">/**</span>
-<a name="l00582"></a>00582 <span class="comment"> * Move the specified file descriptor to a new pool</span>
-<a name="l00583"></a>00583 <span class="comment"> * @param new_file Pointer in which to return the new apr_file_t</span>
-<a name="l00584"></a>00584 <span class="comment"> * @param old_file The file to move</span>
-<a name="l00585"></a>00585 <span class="comment"> * @param p The pool to which the descriptor is to be moved</span>
-<a name="l00586"></a>00586 <span class="comment"> * @remark Unlike apr_file_dup2(), this function doesn't do an</span>
-<a name="l00587"></a>00587 <span class="comment"> * OS dup() operation on the underlying descriptor; it just</span>
-<a name="l00588"></a>00588 <span class="comment"> * moves the descriptor's apr_file_t wrapper to a new pool.</span>
-<a name="l00589"></a>00589 <span class="comment"> * @remark The new pool need not be an ancestor of old_file's pool.</span>
-<a name="l00590"></a>00590 <span class="comment"> * @remark After calling this function, old_file may not be used</span>
-<a name="l00591"></a>00591 <span class="comment"> */</span>
-<a name="l00592"></a>00592 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gdaf046ce39aa118dab921a407446355b">apr_file_setaside</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **new_file,
-<a name="l00593"></a>00593 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *old_file,
-<a name="l00594"></a>00594 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);
-<a name="l00595"></a>00595 <span class="comment"></span>
-<a name="l00596"></a>00596 <span class="comment">/**</span>
-<a name="l00597"></a>00597 <span class="comment"> * Give the specified apr file handle a new buffer </span>
-<a name="l00598"></a>00598 <span class="comment"> * @param thefile The file handle that is to be modified</span>
-<a name="l00599"></a>00599 <span class="comment"> * @param buffer The buffer</span>
-<a name="l00600"></a>00600 <span class="comment"> * @param bufsize The size of the buffer</span>
-<a name="l00601"></a>00601 <span class="comment"> * @remark It is possible to add a buffer to previously unbuffered</span>
-<a name="l00602"></a>00602 <span class="comment"> * file handles, the APR_BUFFERED flag will be added to</span>
-<a name="l00603"></a>00603 <span class="comment"> * the file handle's flags. Likewise, with buffer=NULL and</span>
-<a name="l00604"></a>00604 <span class="comment"> * bufsize=0 arguments it is possible to make a previously</span>
-<a name="l00605"></a>00605 <span class="comment"> * buffered file handle unbuffered.</span>
-<a name="l00606"></a>00606 <span class="comment"> */</span>
-<a name="l00607"></a>00607 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gfe4be8c3b62c42535b84d4237bf6e421">apr_file_buffer_set</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
-<a name="l00608"></a>00608 <span class="keywordtype">char</span> * buffer,
-<a name="l00609"></a>00609 apr_size_t bufsize);
-<a name="l00610"></a>00610 <span class="comment"></span>
-<a name="l00611"></a>00611 <span class="comment">/**</span>
-<a name="l00612"></a>00612 <span class="comment"> * Get the size of any buffer for the specified apr file handle </span>
-<a name="l00613"></a>00613 <span class="comment"> * @param thefile The file handle </span>
-<a name="l00614"></a>00614 <span class="comment"> */</span>
-<a name="l00615"></a>00615 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(apr_size_t) <a class="code" href="group__apr__file__io.html#g42bbb9227095686ea15eb79f99d248a2">apr_file_buffer_size_get</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
-<a name="l00616"></a>00616 <span class="comment"></span>
-<a name="l00617"></a>00617 <span class="comment">/**</span>
-<a name="l00618"></a>00618 <span class="comment"> * Move the read/write file offset to a specified byte within a file.</span>
-<a name="l00619"></a>00619 <span class="comment"> * @param thefile The file descriptor</span>
-<a name="l00620"></a>00620 <span class="comment"> * @param where How to move the pointer, one of:</span>
-<a name="l00621"></a>00621 <span class="comment"> * <PRE></span>
-<a name="l00622"></a>00622 <span class="comment"> * APR_SET -- set the offset to offset</span>
-<a name="l00623"></a>00623 <span class="comment"> * APR_CUR -- add the offset to the current position </span>
-<a name="l00624"></a>00624 <span class="comment"> * APR_END -- add the offset to the current file size </span>
-<a name="l00625"></a>00625 <span class="comment"> * </PRE></span>
-<a name="l00626"></a>00626 <span class="comment"> * @param offset The offset to move the pointer to.</span>
-<a name="l00627"></a>00627 <span class="comment"> * @remark The third argument is modified to be the offset the pointer</span>
-<a name="l00628"></a>00628 <span class="comment"> was actually moved to.</span>
-<a name="l00629"></a>00629 <span class="comment"> */</span>
-<a name="l00630"></a>00630 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g9db84bec24db97a53890df1a6aff63a1">apr_file_seek</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile,
-<a name="l00631"></a>00631 apr_seek_where_t where,
-<a name="l00632"></a>00632 apr_off_t *offset);
-<a name="l00633"></a>00633 <span class="comment"></span>
-<a name="l00634"></a>00634 <span class="comment">/**</span>
-<a name="l00635"></a>00635 <span class="comment"> * Create an anonymous pipe.</span>
-<a name="l00636"></a>00636 <span class="comment"> * @param in The newly created pipe's file for reading.</span>
-<a name="l00637"></a>00637 <span class="comment"> * @param out The newly created pipe's file for writing.</span>
-<a name="l00638"></a>00638 <span class="comment"> * @param pool The pool to operate on.</span>
-<a name="l00639"></a>00639 <span class="comment"> * @remark By default, the returned file descriptors will be inherited</span>
-<a name="l00640"></a>00640 <span class="comment"> * by child processes created using apr_proc_create(). This can be</span>
-<a name="l00641"></a>00641 <span class="comment"> * changed using apr_file_inherit_unset().</span>
-<a name="l00642"></a>00642 <span class="comment"> * @bug Some platforms cannot toggle between blocking and nonblocking,</span>
-<a name="l00643"></a>00643 <span class="comment"> * and when passing a pipe as a standard handle to an application which</span>
-<a name="l00644"></a>00644 <span class="comment"> * does not expect it, a non-blocking stream will fluxor the client app.</span>
-<a name="l00645"></a>00645 <span class="comment"> * @deprecated @see apr_file_pipe_create_ex</span>
-<a name="l00646"></a>00646 <span class="comment"> */</span>
-<a name="l00647"></a>00647 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gae3b81342d239c58c351cf11190740ed">apr_file_pipe_create</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **in,
-<a name="l00648"></a>00648 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **out,
-<a name="l00649"></a>00649 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00650"></a>00650 <span class="comment"></span>
-<a name="l00651"></a>00651 <span class="comment">/**</span>
-<a name="l00652"></a>00652 <span class="comment"> * Create an anonymous pipe which portably supports async timeout options.</span>
-<a name="l00653"></a>00653 <span class="comment"> * @param in The newly created pipe's file for reading.</span>
-<a name="l00654"></a>00654 <span class="comment"> * @param out The newly created pipe's file for writing.</span>
-<a name="l00655"></a>00655 <span class="comment"> * @param blocking one of these values defined in apr_thread_proc.h;</span>
-<a name="l00656"></a>00656 <span class="comment"> * <pre></span>
-<a name="l00657"></a>00657 <span class="comment"> * APR_FULL_BLOCK</span>
-<a name="l00658"></a>00658 <span class="comment"> * APR_READ_BLOCK</span>
-<a name="l00659"></a>00659 <span class="comment"> * APR_WRITE_BLOCK</span>
-<a name="l00660"></a>00660 <span class="comment"> * APR_FULL_NONBLOCK</span>
-<a name="l00661"></a>00661 <span class="comment"> * </pre></span>
-<a name="l00662"></a>00662 <span class="comment"> * @remark By default, the returned file descriptors will be inherited</span>
-<a name="l00663"></a>00663 <span class="comment"> * by child processes created using apr_proc_create(). This can be</span>
-<a name="l00664"></a>00664 <span class="comment"> * changed using apr_file_inherit_unset().</span>
-<a name="l00665"></a>00665 <span class="comment"> * @remark Some platforms cannot toggle between blocking and nonblocking,</span>
-<a name="l00666"></a>00666 <span class="comment"> * and when passing a pipe as a standard handle to an application which</span>
-<a name="l00667"></a>00667 <span class="comment"> * does not expect it, a non-blocking stream will fluxor the client app.</span>
-<a name="l00668"></a>00668 <span class="comment"> * Use this function rather than apr_file_pipe_create to create pipes </span>
-<a name="l00669"></a>00669 <span class="comment"> * where one or both ends require non-blocking semantics.</span>
-<a name="l00670"></a>00670 <span class="comment"> */</span>
-<a name="l00671"></a>00671 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gc365ab74c583eb1df5cd05660a81b5c8">apr_file_pipe_create_ex</a>(<a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **in,
-<a name="l00672"></a>00672 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> **out,
-<a name="l00673"></a>00673 apr_int32_t blocking,
-<a name="l00674"></a>00674 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *p);
-<a name="l00675"></a>00675 <span class="comment"></span>
-<a name="l00676"></a>00676 <span class="comment">/**</span>
-<a name="l00677"></a>00677 <span class="comment"> * Create a named pipe.</span>
-<a name="l00678"></a>00678 <span class="comment"> * @param filename The filename of the named pipe</span>
-<a name="l00679"></a>00679 <span class="comment"> * @param perm The permissions for the newly created pipe.</span>
-<a name="l00680"></a>00680 <span class="comment"> * @param pool The pool to operate on.</span>
-<a name="l00681"></a>00681 <span class="comment"> */</span>
-<a name="l00682"></a>00682 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g60cec3e6717bab0f11577bd7c38b4c59">apr_file_namedpipe_create</a>(const <span class="keywordtype">char</span> *filename,
-<a name="l00683"></a>00683 <a class="code" href="group__apr__file__info.html#g3af19c4c47007169064a70f9351bc7d8">apr_fileperms_t</a> perm,
-<a name="l00684"></a>00684 <a class="code" href="group__apr__pools.html#gf137f28edcf9a086cd6bc36c20d7cdfb">apr_pool_t</a> *pool);
-<a name="l00685"></a>00685 <span class="comment"></span>
-<a name="l00686"></a>00686 <span class="comment">/**</span>
-<a name="l00687"></a>00687 <span class="comment"> * Get the timeout value for a pipe or manipulate the blocking state.</span>
-<a name="l00688"></a>00688 <span class="comment"> * @param thepipe The pipe we are getting a timeout for.</span>
-<a name="l00689"></a>00689 <span class="comment"> * @param timeout The current timeout value in microseconds. </span>
+<a name="l00542"></a>00542 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#g9d06778e719d596ab96bca812b01cb3a">apr_file_ungetc</a>(<span class="keywordtype">char</span> ch, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
+<a name="l00543"></a>00543 <span class="comment"></span>
+<a name="l00544"></a>00544 <span class="comment">/**</span>
+<a name="l00545"></a>00545 <span class="comment"> * Read a string from the specified file.</span>
+<a name="l00546"></a>00546 <span class="comment"> * @param str The buffer to store the string in. </span>
+<a name="l00547"></a>00547 <span class="comment"> * @param len The length of the string</span>
+<a name="l00548"></a>00548 <span class="comment"> * @param thefile The file descriptor to read from</span>
+<a name="l00549"></a>00549 <span class="comment"> * @remark The buffer will be NUL-terminated if any characters are stored.</span>
+<a name="l00550"></a>00550 <span class="comment"> */</span>
+<a name="l00551"></a>00551 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gf9513b769c10b09e5f37d6d0b86bdce9">apr_file_gets</a>(<span class="keywordtype">char</span> *str, <span class="keywordtype">int</span> len,
+<a name="l00552"></a>00552 <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
+<a name="l00553"></a>00553 <span class="comment"></span>
+<a name="l00554"></a>00554 <span class="comment">/**</span>
+<a name="l00555"></a>00555 <span class="comment"> * Write the string into the specified file.</span>
+<a name="l00556"></a>00556 <span class="comment"> * @param str The string to write. </span>
+<a name="l00557"></a>00557 <span class="comment"> * @param thefile The file descriptor to write to</span>
+<a name="l00558"></a>00558 <span class="comment"> */</span>
+<a name="l00559"></a>00559 <a class="code" href="group__apr__platform.html#gd7b91b811a172bfa802603c2fb688f98">APR_DECLARE</a>(<a class="code" href="group__apr__errno.html#gf76ee4543247e9fb3f3546203e590a6c">apr_status_t</a>) <a class="code" href="group__apr__file__io.html#gcde81145cc38660a1512d469886ddb16">apr_file_puts</a>(const <span class="keywordtype">char</span> *str, <a class="code" href="group__apr__file__io.html#ga46e4763ac375ea3c7a43ba6f6099e22">apr_file_t</a> *thefile);
+<a name="l00560"></a>00560 <span class="comment"></span>
+<a name="l00561"></a>00561 <span class="comment">/**</span>
[... 609 lines stripped ...]