Main Page | Modules | Data Structures | File List | Data Fields | Globals | Related Pages

Stat Functions
[File Information]


Data Structures

struct  apr_finfo_t

Defines

#define APR_FINFO_LINK   0x00000001 /**< Stat the link not the file itself if it is a link */
#define APR_FINFO_MTIME   0x00000010 /**< Modification Time */
#define APR_FINFO_CTIME   0x00000020 /**< Creation Time */
#define APR_FINFO_ATIME   0x00000040 /**< Access Time */
#define APR_FINFO_SIZE   0x00000100 /**< Size of the file */
#define APR_FINFO_CSIZE   0x00000200 /**< Storage size consumed by the file */
#define APR_FINFO_DEV   0x00001000 /**< Device */
#define APR_FINFO_INODE   0x00002000 /**< Inode */
#define APR_FINFO_NLINK   0x00004000 /**< Number of links */
#define APR_FINFO_TYPE   0x00008000 /**< Type */
#define APR_FINFO_USER   0x00010000 /**< User */
#define APR_FINFO_GROUP   0x00020000 /**< Group */
#define APR_FINFO_UPROT   0x00100000 /**< User protection bits */
#define APR_FINFO_GPROT   0x00200000 /**< Group protection bits */
#define APR_FINFO_WPROT   0x00400000 /**< World protection bits */
#define APR_FINFO_ICASE   0x01000000 /**< if dev is case insensitive */
#define APR_FINFO_NAME   0x02000000 /**< ->name in proper case */
#define APR_FINFO_MIN   0x00008170 /**< type, mtime, ctime, atime, size */
#define APR_FINFO_IDENT   0x00003000 /**< dev and inode */
#define APR_FINFO_OWNER   0x00030000 /**< user and group */
#define APR_FINFO_PROT   0x00700000 /**< all protections */
#define APR_FINFO_NORM   0x0073b170 /**< an atomic unix apr_stat() */
#define APR_FINFO_DIRENT   0x02000000 /**< an atomic unix apr_dir_read() */

Typedefs

typedef apr_finfo_t apr_finfo_t

Functions

apr_status_t apr_stat (apr_finfo_t *finfo, const char *fname, apr_int32_t wanted, apr_pool_t *cont)
apr_status_t apr_lstat (apr_finfo_t *finfo, const char *fname, apr_int32_t wanted, apr_pool_t *cont)

Define Documentation

#define APR_FINFO_ATIME   0x00000040 /**< Access Time */
 

Access Time

#define APR_FINFO_CSIZE   0x00000200 /**< Storage size consumed by the file */
 

Storage size consumed by the file

#define APR_FINFO_CTIME   0x00000020 /**< Creation Time */
 

Creation Time

#define APR_FINFO_DEV   0x00001000 /**< Device */
 

Device

#define APR_FINFO_DIRENT   0x02000000 /**< an atomic unix apr_dir_read() */
 

an atomic unix apr_dir_read()

#define APR_FINFO_GPROT   0x00200000 /**< Group protection bits */
 

Group protection bits

#define APR_FINFO_GROUP   0x00020000 /**< Group */
 

Group

#define APR_FINFO_ICASE   0x01000000 /**< if dev is case insensitive */
 

if dev is case insensitive

#define APR_FINFO_IDENT   0x00003000 /**< dev and inode */
 

dev and inode

#define APR_FINFO_INODE   0x00002000 /**< Inode */
 

Inode

#define APR_FINFO_LINK   0x00000001 /**< Stat the link not the file itself if it is a link */
 

Stat the link not the file itself if it is a link

#define APR_FINFO_MIN   0x00008170 /**< type, mtime, ctime, atime, size */
 

type, mtime, ctime, atime, size

#define APR_FINFO_MTIME   0x00000010 /**< Modification Time */
 

Modification Time

#define APR_FINFO_NAME   0x02000000 /**< ->name in proper case */
 

->name in proper case

#define APR_FINFO_NLINK   0x00004000 /**< Number of links */
 

Number of links

#define APR_FINFO_NORM   0x0073b170 /**< an atomic unix apr_stat() */
 

an atomic unix apr_stat()

#define APR_FINFO_OWNER   0x00030000 /**< user and group */
 

user and group

#define APR_FINFO_PROT   0x00700000 /**< all protections */
 

all protections

#define APR_FINFO_SIZE   0x00000100 /**< Size of the file */
 

Size of the file

#define APR_FINFO_TYPE   0x00008000 /**< Type */
 

Type

#define APR_FINFO_UPROT   0x00100000 /**< User protection bits */
 

User protection bits

#define APR_FINFO_USER   0x00010000 /**< User */
 

User

#define APR_FINFO_WPROT   0x00400000 /**< World protection bits */
 

World protection bits


Typedef Documentation

typedef struct apr_finfo_t apr_finfo_t
 

file info structure


Function Documentation

apr_status_t apr_lstat apr_finfo_t finfo,
const char *  fname,
apr_int32_t  wanted,
apr_pool_t cont
 

get the specified file's stats. The file is specified by filename, instead of using a pre-opened file. If the file is a symlink, this function will get the stats for the symlink not the file the symlink refers to.

Parameters:
finfo Where to store the information about the file, which is never touched if the call fails.
fname The name of the file to stat.
wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values
cont the pool to use to allocate the new file.

Deprecated:
This function is depreciated, it's equivilant to calling apr_stat with the wanted flag value APR_FINFO_LINK

apr_status_t apr_stat apr_finfo_t finfo,
const char *  fname,
apr_int32_t  wanted,
apr_pool_t cont
 

get the specified file's stats. The file is specified by filename, instead of using a pre-opened file.

Parameters:
finfo Where to store the information about the file, which is never touched if the call fails.
fname The name of the file to stat.
wanted The desired apr_finfo_t fields, as a bit flag of APR_FINFO_ values
cont the pool to use to allocate the new file.


Generated on Wed Mar 24 15:18:10 2004 for Apache Portable Runtime by doxygen 1.3.6