fastwriter/fastwriter.h

#ifndef _FASTWRITER_H
#define _FASTWRITER_H

typedef struct fastwrtier_s fastwriter_t;

typedef enum {
    FASTWRITER_FLAGS_DEFAULT = 0,
    FASTWRITER_FLAGS_BLOCK = 1,		/**< by default the error will be returned if there is no space in the buffer to accomodate the data */
    FASTWRITER_FLAGS_OVERWRITE = 2	/**< overwrite the data currently in the storage */
} fastwriter_flags_t;

typedef struct {
    size_t buffer_size;			/**< buffer size in bytes */
    size_t buffer_used;			/**< amount of data currently in the buffer */
    size_t buffer_max;			/**< maximal amount of data in the buffer */
    size_t commited;			/**< total commited data for current file */
    size_t written;			/**< total written data for currrent file */
} fastwriter_stats_t;

#define FASTWRITER_BUFFER_DEFAULT	0
#define FASTWRITER_BUFFER_MAX		((size_t)-1)

/*
 * @fs - defines which writter implementation will be actually used. One can
 * pass just a file name, then a type of partition will be autodetected.
 * Otherwise, it is possible to pass the name of storage device. In this 
 * case either RingFS will be used or data will be pushed to the RAW device.
 */
fastwriter_t *fastwriter_init(const char *fs, fastwriter_flags_t flags);
void fastwriter_destroy(fastwriter_t *ctx);

int fastwriter_set_buffer_size(fastwriter_t *ctx, size_t buffer_size);
int fastwriter_get_stats(fastwriter_t *ctx, fastwriter_stats_t *stats);

int fastwriter_open(fastwriter_t *ctx, const char *name, fastwriter_flags_t flags);
int fastwriter_close(fastwriter_t *ctx);

int fastwriter_push(fastwriter_t *ctx, size_t size, const void *buf);
int fastwriter_commit(fastwriter_t *ctx);
int fastwriter_cancel(fastwriter_t *ctx);

int fastwriter_push_data(fastwriter_t *ctx, size_t size, const void *buf);

#endif /* _FASTWRITER_H */