Documentation update

[fio.git] / file.h

diff --git a/file.h b/file.h
index f07216b9eced067ad0cc014716d032ac5211da53..30293fc9ddc34e4515a56cc8f5ab0091eb254030 100644 (file)
--- a/file.h
+++ b/file.h
@@ -20,6 +20,7 @@ enum fio_file_flags {
        FIO_FILE_done           = 1 << 3,       /* io completed to this file */
        FIO_FILE_size_known     = 1 << 4,       /* size has been set */
        FIO_FILE_hashed         = 1 << 5,       /* file is on hash */
+       FIO_FILE_partial_mmap   = 1 << 6,       /* can't do full mmap */
 };
 
 enum file_lock_mode {
@@ -28,6 +29,16 @@ enum file_lock_mode {
        FILE_LOCK_READWRITE,
 };
 
+/*
+ * roundrobin available files, or choose one at random, or do each one
+ * serially.
+ */
+enum {
+       FIO_FSERVICE_RANDOM     = 1,
+       FIO_FSERVICE_RR         = 2,
+       FIO_FSERVICE_SEQ        = 3,
+};
+
 /*
  * Each thread_data structure has a number of files associated with it,
  * this structure holds state information for a single file.
@@ -63,6 +74,14 @@ struct fio_file {
 
        unsigned long long last_pos;
 
+       unsigned long long first_write;
+       unsigned long long last_write;
+
+       /*
+        * For use by the io engine
+        */
+       unsigned long long file_pos;
+
        /*
         * if io is protected by a semaphore, this is set
         */
@@ -104,6 +123,41 @@ FILE_FLAG_FNS(extend);
 FILE_FLAG_FNS(done);
 FILE_FLAG_FNS(size_known);
 FILE_FLAG_FNS(hashed);
+FILE_FLAG_FNS(partial_mmap);
 #undef FILE_FLAG_FNS
 
+/*
+ * File setup/shutdown
+ */
+struct thread_data;
+extern void close_files(struct thread_data *);
+extern void close_and_free_files(struct thread_data *);
+extern int __must_check setup_files(struct thread_data *);
+extern int __must_check file_invalidate_cache(struct thread_data *, struct fio_file *);
+extern int __must_check generic_open_file(struct thread_data *, struct fio_file *);
+extern int __must_check generic_close_file(struct thread_data *, struct fio_file *);
+extern int __must_check generic_get_file_size(struct thread_data *, struct fio_file *);
+extern int __must_check pre_read_files(struct thread_data *);
+extern int add_file(struct thread_data *, const char *);
+extern void get_file(struct fio_file *);
+extern int __must_check put_file(struct thread_data *, struct fio_file *);
+extern void put_file_log(struct thread_data *, struct fio_file *);
+extern void lock_file(struct thread_data *, struct fio_file *, enum fio_ddir);
+extern void unlock_file(struct thread_data *, struct fio_file *);
+extern void unlock_file_all(struct thread_data *, struct fio_file *);
+extern int add_dir_files(struct thread_data *, const char *);
+extern int init_random_map(struct thread_data *);
+extern void dup_files(struct thread_data *, struct thread_data *);
+extern int get_fileno(struct thread_data *, const char *);
+extern void free_release_files(struct thread_data *);
+
+static inline void fio_file_reset(struct fio_file *f)
+{
+       f->last_free_lookup = 0;
+       f->last_pos = f->file_offset;
+       f->file_pos = -1ULL;
+       if (f->file_map)
+               memset(f->file_map, 0, f->num_maps * sizeof(int));
+}
+
 #endif