rbb 99/02/25 13:31:36
Modified: docs fileio.txt
Log:
Added the definitions for file stat'ing, and copying apr_file_t descriptors.
There are two ways to stat a file. 1) Provide filename, and get a new
instance of apr_file_t. 2) Provide an apr_file_t and it will update the
variable for you.
Revision Changes Path
1.5 +23 -2 apache-apr/docs/fileio.txt
Index: fileio.txt
===================================================================
RCS file: /home/cvs/apache-apr/docs/fileio.txt,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -r1.4 -r1.5
--- fileio.txt 1999/02/25 19:55:22 1.4
+++ fileio.txt 1999/02/25 21:31:36 1.5
@@ -61,11 +61,32 @@
Notes: apr_write tries to update the apr_file_t that is passed in, but it
fails
silently if it is unable to do so.
- APRStatus apr_getfileinfo(char *, APRFileInfo *)
+ apr_file_t apr_dupfile(apr_file_t *)
+ Copy data from one apr_file_t to a new one.
+ Arguments:
+ arg 1) the file info to save.
+ return) a new file structure.
+
+Notes: This does not duplicate the file descriptor, it just saves the data
+ from apr_file_t to a new apr_file_t. This is used so user programs
+ do not need access to the internals of apr_file_t
+
+ apr_status apr_getfileinfo(char *, apr_file_t *)
Get information about the file with the given path name.
Arguments:
arg 1) path to file to get information about
- arg 2) Structure to store file's information in. (Returned by APR)
+ arg 2) Structure to store file's information in.
+ return) APR_SUCCESS or APR_FAILURE.
+
+ apr_status apr_updatefileinfo(apr_file_t *)
+ Get information about the file with the given path name.
+ Arguments:
+ arg 1) Structure to store file's information in.
+ return) APR_SUCCESS or APR_FAILURE.
+
+Notes: apr_updatefileinfo overwrites the old info, so if it is needed, the
old
+ info should be saved off to the side, using apr_dupfile.
+
APRStatus apr_seek(APRFile, APRInt64, APRSeekWhere, APRInt64 *)
Moves the read/write file offset pointer
Arguments:
