CamelStreamFs

CamelStreamFs —

Synopsis

struct              CamelStreamFs;
CamelStream *       camel_stream_fs_new_with_name       (const gchar *name,
                                                         gint flags,
                                                         mode_t mode);
CamelStream *       camel_stream_fs_new_with_name_and_bounds
                                                        (const gchar *name,
                                                         gint flags,
                                                         mode_t mode,
                                                         off_t start,
                                                         off_t end);
CamelStream *       camel_stream_fs_new_with_fd         (gint fd);
CamelStream *       camel_stream_fs_new_with_fd_and_bounds
                                                        (gint fd,
                                                         off_t start,
                                                         off_t end);

Description

Details

struct CamelStreamFs

struct CamelStreamFs {
	CamelSeekableStream parent_object;

	gint fd;             /* file descriptor on the underlying file */
};


camel_stream_fs_new_with_name ()

CamelStream *       camel_stream_fs_new_with_name       (const gchar *name,
                                                         gint flags,
                                                         mode_t mode);

Creates a new CamelStreamFs corresponding to the named file, flags, and mode.

name : a local filename
flags : flags as in open(2)
mode : a file mode
Returns : the new stream, or NULL on error.

camel_stream_fs_new_with_name_and_bounds ()

CamelStream *       camel_stream_fs_new_with_name_and_bounds
                                                        (const gchar *name,
                                                         gint flags,
                                                         mode_t mode,
                                                         off_t start,
                                                         off_t end);

Creates a new CamelStream corresponding to the given arguments.

name : a local filename
flags : flags as in open(2)
mode : a file mode
start : the first valid position in the file
end : the first invalid position in the file, or CAMEL_STREAM_UNBOUND
Returns : the stream, or NULL on error.

camel_stream_fs_new_with_fd ()

CamelStream *       camel_stream_fs_new_with_fd         (gint fd);

Creates a new fs stream using the given file descriptor fd as the backing store. When the stream is destroyed, the file descriptor will be closed.

fd : a file descriptor
Returns : a new CamelStreamFs

camel_stream_fs_new_with_fd_and_bounds ()

CamelStream *       camel_stream_fs_new_with_fd_and_bounds
                                                        (gint fd,
                                                         off_t start,
                                                         off_t end);

Gets a stream associated with the given file descriptor and bounds. When the stream is destroyed, the file descriptor will be closed.

fd : a file descriptor
start : the first valid position in the file
end : the first invalid position in the file, or CAMEL_STREAM_UNBOUND
Returns : the bound stream