File I/O Handling Functions

Collaboration diagram for File I/O Handling Functions:

Modules
	File Seek Flags
	File Permissions flags
	File Lock Types
	File Open Flags/Routines

Data Structures
struct	switch_array_header_t

Typedefs
typedef struct apr_file_t	switch_file_t
typedef int32_t	switch_fileperms_t
typedef int	switch_seek_where_t
typedef struct switch_dir	switch_dir_t
typedef struct switch_array_header_t	switch_array_header_t

Functions
switch_status_t	switch_file_open (switch_file_t **newf, const char *fname, int32_t flag, switch_fileperms_t perm, switch_memory_pool_t *pool)
switch_status_t	switch_file_seek (switch_file_t *thefile, switch_seek_where_t where, int64_t *offset)
switch_status_t	switch_file_copy (const char *from_path, const char *to_path, switch_fileperms_t perms, switch_memory_pool_t *pool)
switch_status_t	switch_file_close (switch_file_t *thefile)
switch_status_t	switch_file_trunc (switch_file_t *thefile, int64_t offset)
switch_status_t	switch_file_lock (switch_file_t *thefile, int type)
switch_status_t	switch_file_remove (const char *path, switch_memory_pool_t *pool)
switch_status_t	switch_file_rename (const char *from_path, const char *to_path, switch_memory_pool_t *pool)
switch_status_t	switch_file_read (switch_file_t *thefile, void *buf, switch_size_t *nbytes)
switch_status_t	switch_file_write (switch_file_t *thefile, const void *buf, switch_size_t *nbytes)
int	switch_file_printf (switch_file_t *thefile, const char *format,...)
switch_status_t	switch_file_mktemp (switch_file_t **thefile, char *templ, int32_t flags, switch_memory_pool_t *pool)
switch_size_t	switch_file_get_size (switch_file_t *thefile)
switch_status_t	switch_file_exists (const char *filename, switch_memory_pool_t *pool)
switch_status_t	switch_directory_exists (const char *dirname, switch_memory_pool_t *pool)
switch_status_t	switch_dir_make (const char *path, switch_fileperms_t perm, switch_memory_pool_t *pool)
switch_status_t	switch_dir_make_recursive (const char *path, switch_fileperms_t perm, switch_memory_pool_t *pool)
switch_status_t	switch_dir_open (switch_dir_t **new_dir, const char *dirname, switch_memory_pool_t *pool)
switch_status_t	switch_dir_close (switch_dir_t *thedir)
const char *	switch_dir_next_file (switch_dir_t *thedir, char *buf, switch_size_t len)
uint32_t	switch_dir_count (switch_dir_t *thedir)

Detailed Description

Typedef Documentation

typedef struct switch_array_header_t switch_array_header_t

Definition at line 925 of file switch_apr.h.

typedef struct switch_dir switch_dir_t

Definition at line 911 of file switch_apr.h.

typedef struct apr_file_t switch_file_t

Structure for referencing files.

Definition at line 685 of file switch_apr.h.

typedef int32_t switch_fileperms_t

Definition at line 687 of file switch_apr.h.

typedef int switch_seek_where_t

Definition at line 688 of file switch_apr.h.

Function Documentation

switch_status_t switch_dir_close

(

switch_dir_t *

thedir

)

Definition at line 559 of file switch_apr.c.

Referenced by switch_loadable_module_enumerate_available().

{
        switch_status_t status = apr_dir_close(thedir->dir_handle);

        free(thedir);
        return status;
}

uint32_t switch_dir_count

(

switch_dir_t *

thedir

)

Definition at line 567 of file switch_apr.c.

References SWITCH_STATUS_SUCCESS.

{
        const char *name;
        apr_int32_t finfo_flags = APR_FINFO_DIRENT | APR_FINFO_TYPE | APR_FINFO_NAME;
        uint32_t count = 0;

        apr_dir_rewind(thedir->dir_handle);

        while (apr_dir_read(&(thedir->finfo), finfo_flags, thedir->dir_handle) == SWITCH_STATUS_SUCCESS) {

                if (thedir->finfo.filetype != APR_REG && thedir->finfo.filetype != APR_LNK) {
                        continue;
                }

                if (!(name = thedir->finfo.fname)) {
                        name = thedir->finfo.name;
                }

                if (name) {
                        count++;
                }
        }

        apr_dir_rewind(thedir->dir_handle);

        return count;
}

switch_status_t switch_dir_make	(	const char *	path,
		switch_fileperms_t	perm,
		switch_memory_pool_t *	pool
	)

Create a new directory on the file system.

Parameters

path	the path for the directory to be created. (use / on all systems)
perm	Permissions for the new direcoty.
pool	the pool to use.

Definition at line 523 of file switch_apr.c.

{
        return apr_dir_make(path, perm, pool);
}

switch_status_t switch_dir_make_recursive	(	const char *	path,
		switch_fileperms_t	perm,
		switch_memory_pool_t *	pool
	)

Creates a new directory on the file system, but behaves like 'mkdir -p'. Creates intermediate directories as required. No error will be reported if PATH already exists.

Parameters

path	the path for the directory to be created. (use / on all systems)
perm	Permissions for the new direcoty.
pool	the pool to use.

Definition at line 528 of file switch_apr.c.

Referenced by main(), switch_core_init(), and switch_ivr_record_session().

{
        return apr_dir_make_recursive(path, perm, pool);
}

const char* switch_dir_next_file	(	switch_dir_t *	thedir,
		char *	buf,
		switch_size_t	len
	)

Definition at line 595 of file switch_apr.c.

References buf, switch_copy_string(), and SWITCH_STATUS_SUCCESS.

Referenced by switch_loadable_module_enumerate_available().

{
        const char *fname = NULL;
        apr_int32_t finfo_flags = APR_FINFO_DIRENT | APR_FINFO_TYPE | APR_FINFO_NAME;
        const char *name;

        while (apr_dir_read(&(thedir->finfo), finfo_flags, thedir->dir_handle) == SWITCH_STATUS_SUCCESS) {

                if (thedir->finfo.filetype != APR_REG && thedir->finfo.filetype != APR_LNK) {
                        continue;
                }

                if (!(name = thedir->finfo.fname)) {
                        name = thedir->finfo.name;
                }

                if (name) {
                        switch_copy_string(buf, name, len);
                        fname = buf;
                        break;
                } else {
                        continue;
                }
        }
        return fname;
}

switch_status_t switch_dir_open	(	switch_dir_t **	new_dir,
		const char *	dirname,
		switch_memory_pool_t *	pool
	)

Definition at line 538 of file switch_apr.c.

References switch_dir::dir_handle, memset(), and SWITCH_STATUS_FALSE.

Referenced by switch_loadable_module_enumerate_available().

{
        switch_status_t status;
        switch_dir_t *dir = malloc(sizeof(*dir));

        if (!dir) {
                *new_dir = NULL;
                return SWITCH_STATUS_FALSE;
        }

        memset(dir, 0, sizeof(*dir));
        if ((status = apr_dir_open(&(dir->dir_handle), dirname, pool)) == APR_SUCCESS) {
                *new_dir = dir;
        } else {
                free(dir);
                *new_dir = NULL;
        }

        return status;
}

switch_status_t switch_directory_exists	(	const char *	dirname,
		switch_memory_pool_t *	pool
	)

Definition at line 474 of file switch_apr.c.

References switch_core_destroy_memory_pool, and switch_core_new_memory_pool.

Referenced by switch_core_perform_file_open().

{
        apr_dir_t *dir_handle;
        switch_memory_pool_t *our_pool = NULL;
        switch_status_t status;

        if (!pool) {
                switch_core_new_memory_pool(&our_pool);
                pool = our_pool;
        }

        if ((status = apr_dir_open(&dir_handle, dirname, pool)) == APR_SUCCESS) {
                apr_dir_close(dir_handle);
        }

        if (our_pool) {
                switch_core_destroy_memory_pool(&our_pool);
        }

        return status;
}

switch_status_t switch_file_close

(

switch_file_t *

thefile

)

Close the specified file.

Parameters

thefile

The file descriptor to close.

Definition at line 409 of file switch_apr.c.

Referenced by main().

{
        return apr_file_close(thefile);
}

switch_status_t switch_file_copy	(	const char *	from_path,
		const char *	to_path,
		switch_fileperms_t	perms,
		switch_memory_pool_t *	pool
	)

Definition at line 403 of file switch_apr.c.

{
        return apr_file_copy(from_path, to_path, perms, pool);
}

switch_status_t switch_file_exists	(	const char *	filename,
		switch_memory_pool_t *	pool
	)

Definition at line 496 of file switch_apr.c.

References switch_core_destroy_memory_pool, switch_core_new_memory_pool, SWITCH_STATUS_FALSE, SWITCH_STATUS_SUCCESS, and zstr.

Referenced by switch_core_cert_gen_fingerprint(), switch_core_gen_certs(), switch_core_perform_file_open(), switch_img_txt_handle_create(), and switch_rtp_add_dtls().

{
        int32_t wanted = APR_FINFO_TYPE;
        switch_memory_pool_t *our_pool = NULL;
        switch_status_t status = SWITCH_STATUS_FALSE;
        apr_finfo_t info = { 0 };

        if (zstr(filename)) {
                return status;
        }

        if (!pool) {
                switch_core_new_memory_pool(&our_pool);
        }

        apr_stat(&info, filename, wanted, pool ? pool : our_pool);
        if (info.filetype != APR_NOFILE) {
                status = SWITCH_STATUS_SUCCESS;
        }

        if (our_pool) {
                switch_core_destroy_memory_pool(&our_pool);
        }

        return status;
}

switch_size_t switch_file_get_size

(

switch_file_t *

thefile

)

Definition at line 468 of file switch_apr.c.

References SWITCH_STATUS_SUCCESS.

{
        struct apr_finfo_t finfo;
        return apr_file_info_get(&finfo, APR_FINFO_SIZE, thefile) == SWITCH_STATUS_SUCCESS ? (switch_size_t) finfo.size : 0;
}

switch_status_t switch_file_lock	(	switch_file_t *	thefile,
		int	type
	)

Definition at line 419 of file switch_apr.c.

Referenced by main().

{
        return apr_file_lock(thefile, type);
}

switch_status_t switch_file_mktemp	(	switch_file_t **	thefile,
		char *	templ,
		int32_t	flags,
		switch_memory_pool_t *	pool
	)

Definition at line 463 of file switch_apr.c.

{
        return apr_file_mktemp(thefile, templ, flags, pool);
}

switch_status_t switch_file_open	(	switch_file_t **	newf,
		const char *	fname,
		int32_t	flag,
		switch_fileperms_t	perm,
		switch_memory_pool_t *	pool
	)

Open the specified file.

Parameters

newf	The opened file descriptor.
fname	The full path to the file (using / on all systems)
flag	Or'ed value of: SWITCH_FOPEN_READ open for reading SWITCH_FOPEN_WRITE open for writing SWITCH_FOPEN_CREATE create the file if not there SWITCH_FOPEN_APPEND file ptr is set to end prior to all writes SWITCH_FOPEN_TRUNCATE set length to zero if file exists SWITCH_FOPEN_BINARY not a text file (This flag is ignored on UNIX because it has no meaning) SWITCH_FOPEN_BUFFERED buffer the data. Default is non-buffered SWITCH_FOPEN_EXCL return error if APR_CREATE and file exists SWITCH_FOPEN_DELONCLOSE delete the file after closing. SWITCH_FOPEN_XTHREAD Platform dependent tag to open the file for use across multiple threads SWITCH_FOPEN_SHARELOCK Platform dependent support for higher level locked read/write access to support writes across process/machines SWITCH_FOPEN_NOCLEANUP Do not register a cleanup with the pool passed in on the pool argument (see below). The apr_os_file_t handle in apr_file_t will not be closed when the pool is destroyed. SWITCH_FOPEN_SENDFILE_ENABLED Open with appropriate platform semantics for sendfile operations. Advisory only, apr_socket_sendfile does not check this flag.
perm	Access permissions for file.
pool	The pool to use.

Remarks

If perm is SWITCH_FPROT_OS_DEFAULT and the file is being created, appropriate default permissions will be used.

Definition at line 388 of file switch_apr.c.

Referenced by main().

{
        return apr_file_open(newf, fname, flag, perm, pool);
}

int switch_file_printf	(	switch_file_t *	thefile,
		const char *	format,
			...
	)

Definition at line 444 of file switch_apr.c.

References switch_file_write(), and switch_vasprintf().

{
        va_list ap;
        int ret;
        char *data;

        va_start(ap, format);

        if ((ret = switch_vasprintf(&data, format, ap)) != -1) {
                switch_size_t bytes = strlen(data);
                switch_file_write(thefile, data, &bytes);
                free(data);
        }

        va_end(ap);

        return ret;
}

switch_status_t switch_file_read	(	switch_file_t *	thefile,
		void *	buf,
		switch_size_t *	nbytes
	)

Read data from the specified file.

Parameters

thefile	The file descriptor to read from.
buf	The buffer to store the data to.
nbytes	On entry, the number of bytes to read; on exit, the number of bytes read.

Remarks

apr_file_read will read up to the specified number of bytes, but never more. If there isn't enough data to fill that number of bytes, all of the available data is read. The third argument is modified to reflect the number of bytes read. If a char was put back into the stream via ungetc, it will be the first character returned.

It is not possible for both bytes to be read and an APR_EOF or other error to be returned. APR_EINTR is never returned.

Definition at line 434 of file switch_apr.c.

Referenced by main().

{
        return apr_file_read(thefile, buf, nbytes);
}

switch_status_t switch_file_remove	(	const char *	path,
		switch_memory_pool_t *	pool
	)

Delete the specified file.

Parameters

path	The full path to the file (using / on all systems)
pool	The pool to use.

Remarks

If the file is open, it won't be removed until all instances are closed.

Definition at line 429 of file switch_apr.c.

Referenced by record_callback().

{
        return apr_file_remove(path, pool);
}

switch_status_t switch_file_rename	(	const char *	from_path,
		const char *	to_path,
		switch_memory_pool_t *	pool
	)

Definition at line 424 of file switch_apr.c.

Referenced by switch_ivr_insert_file().

{
        return apr_file_rename(from_path, to_path, pool);
}

switch_status_t switch_file_seek	(	switch_file_t *	thefile,
		switch_seek_where_t	where,
		int64_t *	offset
	)

Definition at line 394 of file switch_apr.c.

{
        apr_status_t rv;
        apr_off_t off = (apr_off_t) (*offset);
        rv = apr_file_seek(thefile, where, &off);
        *offset = (int64_t) off;
        return rv;
}

switch_status_t switch_file_trunc	(	switch_file_t *	thefile,
		int64_t	offset
	)

Definition at line 414 of file switch_apr.c.

{
        return apr_file_trunc(thefile, offset);
}

switch_status_t switch_file_write	(	switch_file_t *	thefile,
		const void *	buf,
		switch_size_t *	nbytes
	)

Write data to the specified file.

Parameters

thefile	The file descriptor to write to.
buf	The buffer which contains the data.
nbytes	On entry, the number of bytes to write; on exit, the number of bytes written.

Remarks

apr_file_write will write up to the specified number of bytes, but never more. If the OS cannot write that many bytes, it will write as many as it can. The third argument is modified to reflect the * number of bytes written.

It is possible for both bytes to be written and an error to be returned. APR_EINTR is never returned.

Definition at line 439 of file switch_apr.c.

Referenced by main(), and switch_file_printf().

{
        return apr_file_write(thefile, buf, nbytes);
}