STXXL  1.4.0
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
stxxl::syscall_file Class Reference

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
filenamepath of file
modeopen mode, see stxxl::file::open_modes
queue_iddisk queue identifier
allocator_idlinked 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: