File Table

File Table. More...

Collaboration diagram for File Table:

Detailed Description

File Table.

The file table is a per-process structure that keeps track of all open files for a process.

Data Structures
struct	file_table_t
	File table structure. More...

Functions
void	file_table_init (file_table_t *table)
	Initialize a file table.
void	file_table_deinit (file_table_t *table)
	Deinitialize a file table.
file_t *	file_table_get (file_table_t *table, fd_t fd)
	Get a file from its file descriptor.
fd_t	file_table_alloc (file_table_t *table, file_t *file)
	Allocate a new file descriptor for a file.
uint64_t	file_table_free (file_table_t *table, fd_t fd)
	Free a file descriptor.
uint64_t	file_table_free_range (file_table_t *table, fd_t min, fd_t max)
	Free a range of file descriptors.
fd_t	file_table_set (file_table_t *table, fd_t fd, file_t *file)
	Set a specific file descriptor to a file.
fd_t	file_table_dup (file_table_t *table, fd_t oldFd)
	Duplicate a file descriptor.
fd_t	file_table_dup2 (file_table_t *table, fd_t oldFd, fd_t newFd)
	Duplicate a file descriptor to a specific file descriptor.
uint64_t	file_table_copy (file_table_t *dest, file_table_t *src, fd_t min, fd_t max)
	Copy a file table, closing any overlapping file descriptors.
void	file_table_close_all (file_table_t *table)
	Close all files in the file table.

Function Documentation

file_table_init()

void file_table_init

(

file_table_t *

table

)

Initialize a file table.

Parameters

table

The file table to initialize.

Definition at line 7 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_deinit()

void file_table_deinit

(

file_table_t *

table

)

Deinitialize a file table.

This will close all open files in the table.

Parameters

table

The file table to deinitialize.

Definition at line 17 of file file_table.c.

Here is the caller graph for this function:

file_table_get()

file_t * file_table_get	(	file_table_t *	table,
		fd_t	fd
	)

Get a file from its file descriptor.

Parameters

table	The file table.
fd	The file descriptor.

Returns

On success, a new reference to the file. On failure, returns NULL and errno is set to:

• EINVAL: Invalid parameters.
• EBADF: The file descriptor is invalid.

Definition at line 31 of file file_table.c.

Here is the caller graph for this function:

file_table_alloc()

fd_t file_table_alloc	(	file_table_t *	table,
		file_t *	file
	)

Allocate a new file descriptor for a file.

Parameters

table	The file table.
file	The file to associate with the new file descriptor.

Returns

On success, the allocated file descriptor. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.
• EMFILE: Too many open files.

Definition at line 50 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_free()

uint64_t file_table_free	(	file_table_t *	table,
		fd_t	fd
	)

Free a file descriptor.

If the file has no other references, it will be closed.

Parameters

table	The file table.
fd	The file descriptor to free.

Returns

On success, 0. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.
• EBADF: The file descriptor is invalid.

Definition at line 72 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_free_range()

uint64_t file_table_free_range	(	file_table_t *	table,
		fd_t	min,
		fd_t	max
	)

Free a range of file descriptors.

If the files have no other references, they will be closed.

Parameters

table	The file table.
min	The minimum file descriptor to free, inclusive.
max	The maximum file descriptor to free, exclusive.

Returns

On success, 0. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.

Definition at line 94 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_set()

fd_t file_table_set	(	file_table_t *	table,
		fd_t	fd,
		file_t *	file
	)

Set a specific file descriptor to a file.

If the file descriptor is already in use, the old file will be closed.

Parameters

table	The file table.
fd	The file descriptor to set.
file	The file to associate with the file descriptor.

Returns

On success, fd. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.
• EBADF: The file descriptor is invalid.

Definition at line 117 of file file_table.c.

Here is the call graph for this function:

file_table_dup()

fd_t file_table_dup	(	file_table_t *	table,
		fd_t	oldFd
	)

Duplicate a file descriptor.

Allocates a new file descriptor that refers to the same file as oldFd.

Parameters

table	The file table.
oldFd	The file descriptor to duplicate.

Returns

On success, the new file descriptor. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.
• EBADF: The file descriptor is invalid.
• EMFILE: Too many open files.

Definition at line 144 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_dup2()

fd_t file_table_dup2	(	file_table_t *	table,
		fd_t	oldFd,
		fd_t	newFd
	)

Duplicate a file descriptor to a specific file descriptor.

If newFd is already in use, the old file will be closed.

Parameters

table	The file table.
oldFd	The file descriptor to duplicate.
newFd	The file descriptor to duplicate to.

Returns

On success, newFd. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.
• EBADF: One of the file descriptors is invalid.
• EMFILE: Too many open files.

Definition at line 172 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_copy()

uint64_t file_table_copy	(	file_table_t *	dest,
		file_table_t *	src,
		fd_t	min,
		fd_t	max
	)

Copy a file table, closing any overlapping file descriptors.

Parameters

dest	The destination file table.
src	The source file table.
min	The minimum file descriptor to copy, inclusive.
max	The maximum file descriptor to copy, exclusive.

Returns

On success, the number of copied file descriptors. On failure, ERR and errno is set to:

• EINVAL: Invalid parameters.

Definition at line 204 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function:

file_table_close_all()

void file_table_close_all

(

file_table_t *

table

)

Close all files in the file table.

Parameters

table

The file table.

Definition at line 235 of file file_table.c.

Here is the call graph for this function:

Here is the caller graph for this function: