httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From r..@hyperreal.org
Subject cvs commit: apache-apr/docs fileio.txt
Date Thu, 25 Feb 1999 21:31:37 GMT
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:
  
  
  

Mime
View raw message