Detailed Description

Implementation of file based on UNIX syscalls.

Examples:: examples/algo/copy_and_sort_file.cpp, examples/algo/sort_file.cpp, examples/applications/skew3.cpp, and examples/containers/copy_file.cpp.

Definition at line 28 of file syscall_file.h.

Inheritance diagram for stxxl::syscall_file:

Collaboration diagram for stxxl::syscall_file:

Public Member Functions
	syscall_file (const std::string &filename, int mode, int queue_id=DEFAULT_QUEUE, int allocator_id=NO_ALLOCATOR)
	Constructs file object. More...

const char *	io_type () const
	Identifies the type of I/O implementation. More...

void	serve (const request *req) throw (io_error)

Public Member Functions inherited from stxxl::ufs_file_base
	~ufs_file_base ()

void	close_remove ()
	close and remove file More...

const char *	io_type () const
	Identifies the type of I/O implementation. More...

bool	is_device () const
	return true if file is special device node More...

void	lock ()
	Locks file for reading and writing (acquires a lock in the file system). More...

void	set_size (offset_type newsize)

offset_type	size ()
	Returns size of the file. More...

void	unlink ()
	unlink file without closing it. More...

Public Member Functions inherited from stxxl::file
virtual	~file ()

void	add_request_ref ()

virtual request_ptr	aread (void *buffer, offset_type pos, size_type bytes, const completion_handler &on_cmpl)=0
	Schedules an asynchronous read request to the file. More...

virtual request_ptr	awrite (void *buffer, offset_type pos, size_type bytes, const completion_handler &on_cmpl)=0
	Schedules an asynchronous write request to the file. More...

void	delete_request_ref ()

virtual void	discard (offset_type offset, offset_type size)
	Discard a region of the file (mark it unused). Some specialized file types may need to know freed regions. More...

virtual void	export_files (offset_type offset, offset_type length, std::string prefix)

virtual int	get_physical_device_id () const

int	get_request_nref ()

virtual void	set_size (offset_type newsize)=0
	Changes the size of the file. More...

Public Member Functions inherited from stxxl::disk_queued_file
	disk_queued_file (int queue_id, int allocator_id)

request_ptr	aread (void *buffer, offset_type pos, size_type bytes, const completion_handler &on_cmpl)

request_ptr	awrite (void *buffer, offset_type pos, size_type bytes, const completion_handler &on_cmpl)

virtual int	get_allocator_id () const
	Returns the file's allocator. More...

virtual int	get_queue_id () const
	Returns the identifier of the file's queue. More...

Additional Inherited Members
Public Types inherited from stxxl::file
typedef request::offset_type	offset_type
	the offset of a request, also the size of the file More...

enum	open_mode { RDONLY = 1, WRONLY = 2, RDWR = 4, CREAT = 8, DIRECT = 16, TRUNC = 32, SYNC = 64, NO_LOCK = 128, REQUIRE_DIRECT = 256 }
	Definition of acceptable file open modes. More...

typedef request::size_type	size_type
	the size of a request More...

Static Public Member Functions inherited from stxxl::file
static int	unlink (const char *path)
	unlink path from filesystem More...

static int	truncate (const char *path, external_size_type length)
	truncate a path to given length. Use this only if you dont have a fileio-specific object, which provides truncate(). More...

Static Public Attributes inherited from stxxl::file
static const int	DEFAULT_QUEUE = -1

static const int	NO_ALLOCATOR = -1

static const int	NO_QUEUE = -2

Protected Member Functions inherited from stxxl::ufs_file_base
	ufs_file_base (const std::string &filename, int mode)

void	_after_open ()

void	_set_size (offset_type newsize)

offset_type	_size ()

void	close ()

Protected Member Functions inherited from stxxl::file
	file ()
	Initializes file object. More...

Protected Attributes inherited from stxxl::ufs_file_base
mutex	fd_mutex

int	file_des

const std::string	filename

bool	m_is_device
	is special device node More...

int	m_mode

Constructor & Destructor Documentation

stxxl::syscall_file::syscall_file	(	const std::string &	filename,
		int	mode,
		int	queue_id = `DEFAULT_QUEUE`,
		int	allocator_id = `NO_ALLOCATOR`
	)

inline

Constructs file object.

Parameters

filename	path of file
mode	open mode, see `stxxl::file::open_modes`
queue_id	disk queue identifier
allocator_id	linked disk_allocator

Definition at line 36 of file syscall_file.h.

Member Function Documentation

const char * stxxl::syscall_file::io_type ( ) const

virtual

Identifies the type of I/O implementation.

Returns: pointer to null terminated string of characters, containing the name of I/O implementation

Reimplemented from stxxl::file.

Definition at line 117 of file syscall_file.cpp.

void stxxl::syscall_file::serve	(	const request *	req	)
throw	(	io_error
	)

virtual

Implements stxxl::file.

Definition at line 27 of file syscall_file.cpp.

References bytes, lseek, max(), off_t, and STXXL_THROW_ERRNO.

The documentation for this class was generated from the following files:

include/stxxl/bits/io/syscall_file.h
lib/io/syscall_file.cpp

Detailed Description

Public Member Functions

Additional Inherited Members

Constructor & Destructor Documentation

Member Function Documentation