Stat Functions
[File Information]

Data Structures
struct	apr_finfo_t
Defines
#define	APR_FINFO_LINK   0x00000001
#define	APR_FINFO_MTIME   0x00000010
#define	APR_FINFO_CTIME   0x00000020
#define	APR_FINFO_ATIME   0x00000040
#define	APR_FINFO_SIZE   0x00000100
#define	APR_FINFO_CSIZE   0x00000200
#define	APR_FINFO_DEV   0x00001000
#define	APR_FINFO_INODE   0x00002000
#define	APR_FINFO_NLINK   0x00004000
#define	APR_FINFO_TYPE   0x00008000
#define	APR_FINFO_USER   0x00010000
#define	APR_FINFO_GROUP   0x00020000
#define	APR_FINFO_UPROT   0x00100000
#define	APR_FINFO_GPROT   0x00200000
#define	APR_FINFO_WPROT   0x00400000
#define	APR_FINFO_ICASE   0x01000000
#define	APR_FINFO_NAME   0x02000000
#define	APR_FINFO_MIN   0x00008170
#define	APR_FINFO_IDENT   0x00003000
#define	APR_FINFO_OWNER   0x00030000
#define	APR_FINFO_PROT   0x00700000
#define	APR_FINFO_NORM   0x0073b170
#define	APR_FINFO_DIRENT   0x02000000
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

#define APR_FINFO_CSIZE   0x00000200

Storage size consumed by the file

#define APR_FINFO_CTIME   0x00000020

Creation Time

#define APR_FINFO_DEV   0x00001000

Device

#define APR_FINFO_DIRENT   0x02000000

an atomic unix apr_dir_read()

#define APR_FINFO_GPROT   0x00200000

Group protection bits

#define APR_FINFO_GROUP   0x00020000

Group

#define APR_FINFO_ICASE   0x01000000

if dev is case insensitive

#define APR_FINFO_IDENT   0x00003000

dev and inode

#define APR_FINFO_INODE   0x00002000

Inode

#define APR_FINFO_LINK   0x00000001

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

#define APR_FINFO_MIN   0x00008170

type, mtime, ctime, atime, size

#define APR_FINFO_MTIME   0x00000010

Modification Time

#define APR_FINFO_NAME   0x02000000

->name in proper case

#define APR_FINFO_NLINK   0x00004000

Number of links

#define APR_FINFO_NORM   0x0073b170

an atomic unix apr_stat()

#define APR_FINFO_OWNER   0x00030000

user and group

#define APR_FINFO_PROT   0x00700000

all protections

#define APR_FINFO_SIZE   0x00000100

Size of the file

#define APR_FINFO_TYPE   0x00008000

Type

#define APR_FINFO_UPROT   0x00100000

User protection bits

#define APR_FINFO_USER   0x00010000

User

#define APR_FINFO_WPROT   0x00400000

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 deprecated, it's equivalent 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.

Note:

If APR_INCOMPLETE is returned all the fields in finfo may not be filled in, and you need to check the finfo->valid bitmask to verify that what you're looking for is there.

---