X-Git-Url: https://git.kernel.dk/?p=fio.git;a=blobdiff_plain;f=fio.h;h=c168fe708bcb3e49a9dda7762a94975881159dc7;hp=b94bf4313081bfed79fbed4ff8b67274a134ad83;hb=0c6e75175bcaf8d05bfa88aa8caa584fbb848b74;hpb=c7b0818d2a9d1b8597256ea002d9cf9346ea97f3 diff --git a/fio.h b/fio.h index b94bf431..c168fe70 100644 --- a/fio.h +++ b/fio.h @@ -18,32 +18,67 @@ #include "arch.h" #include "os.h" +#ifdef FIO_HAVE_SYSLET +#include "syslet.h" +#endif + +enum fio_ddir { + DDIR_READ = 0, + DDIR_WRITE, + DDIR_SYNC, +}; + +/* + * Use for maintaining statistics + */ struct io_stat { - unsigned long val; - unsigned long val_sq; unsigned long max_val; unsigned long min_val; unsigned long samples; + + double mean; + double S; }; +/* + * A single data sample + */ struct io_sample { unsigned long time; unsigned long val; - unsigned int ddir; + enum fio_ddir ddir; }; +/* + * Dynamically growing data sample log + */ struct io_log { unsigned long nr_samples; unsigned long max_samples; struct io_sample *log; }; +/* + * When logging io actions, this matches a single sent io_u + */ struct io_piece { struct list_head list; struct fio_file *file; unsigned long long offset; - unsigned int len; - int ddir; + unsigned long len; + enum fio_ddir ddir; +}; + +#ifdef FIO_HAVE_SYSLET +struct syslet_req { + struct syslet_uatom atom; + long ret; +}; +#endif + +enum { + IO_U_F_FREE = 1 << 0, + IO_U_F_FLIGHT = 1 << 1, }; /* @@ -59,19 +94,32 @@ struct io_u { #endif #ifdef FIO_HAVE_SGIO struct sg_io_hdr hdr; +#endif +#ifdef FIO_HAVE_SYSLET + struct syslet_req req; #endif }; struct timeval start_time; struct timeval issue_time; + /* + * Allocated/set buffer and length + */ void *buf; - unsigned int buflen; + unsigned long buflen; unsigned long long offset; + /* + * IO engine state, may be different from above when we get + * partial transfers / residual data counts + */ + void *xfer_buf; + unsigned long xfer_buflen; + unsigned int resid; unsigned int error; - unsigned char ddir; + enum fio_ddir ddir; /* * io engine private data @@ -81,19 +129,33 @@ struct io_u { unsigned int seen; }; + unsigned int flags; + struct fio_file *file; struct list_head list; }; +/* + * io_ops->queue() return values + */ +enum { + FIO_Q_COMPLETED = 0, /* completed sync */ + FIO_Q_QUEUED = 1, /* queued, will complete async */ + FIO_Q_BUSY = 2, /* no more room, call ->commit() */ +}; + #define FIO_HDR_MAGIC 0xf00baaef enum { - VERIFY_NONE = 0, - VERIFY_MD5, - VERIFY_CRC32, + VERIFY_NONE = 0, /* no verification */ + VERIFY_MD5, /* md5 sum data blocks */ + VERIFY_CRC32, /* crc32 sum data blocks */ }; +/* + * A header structure associated with each checksummed data block + */ struct verify_header { unsigned int fio_magic; unsigned int len; @@ -111,37 +173,39 @@ struct group_run_stats { unsigned long long agg[2]; }; -enum fio_ddir { - DDIR_READ = 0, - DDIR_WRITE, - DDIR_SYNC, -}; - /* * What type of allocation to use for io buffers */ enum fio_memtype { MEM_MALLOC = 0, /* ordinary malloc */ MEM_SHM, /* use shared memory segments */ + MEM_SHMHUGE, /* use shared memory segments with huge pages */ MEM_MMAP, /* use anonynomous mmap */ + MEM_MMAPHUGE, /* memory mapped huge file */ }; /* * The type of object we are working on */ enum fio_filetype { - FIO_TYPE_FILE = 1, - FIO_TYPE_BD, - FIO_TYPE_CHAR, + FIO_TYPE_FILE = 1, /* plain file */ + FIO_TYPE_BD, /* block device */ + FIO_TYPE_CHAR, /* character device */ }; enum fio_ioengine_flags { - FIO_SYNCIO = 1 << 0, - FIO_CPUIO = 1 << 1, - FIO_MMAPIO = 1 << 2, - FIO_RAWIO = 1 << 3, + FIO_SYNCIO = 1 << 0, /* io engine has synchronous ->queue */ + FIO_CPUIO = 1 << 1, /* cpu burner, doesn't do real io */ + FIO_MMAPIO = 1 << 2, /* uses memory mapped io */ + FIO_RAWIO = 1 << 3, /* some sort of direct/raw io */ + FIO_NETIO = 1 << 4, /* networked io */ + FIO_NULLIO = 1 << 5, /* no real data transfer (cpu/null) */ }; +/* + * Each thread_data structure has a number of files associated with it, + * this structure holds state information for a single file. + */ struct fio_file { /* * A file may not be a file descriptor, let the io engine decide @@ -156,15 +220,54 @@ struct fio_file { unsigned long long real_file_size; unsigned long long file_offset; unsigned long long last_pos; + unsigned long long last_completed_pos; + /* + * block map for random io + */ unsigned long *file_map; unsigned int num_maps; + unsigned int last_free_lookup; + + unsigned int unlink; +}; + +struct thread_stat { + struct io_log *slat_log; + struct io_log *clat_log; + struct io_log *bw_log; + + /* + * bandwidth and latency stats + */ + struct io_stat clat_stat[2]; /* completion latency */ + struct io_stat slat_stat[2]; /* submission latency */ + struct io_stat bw_stat[2]; /* bandwidth stats */ + + unsigned long long stat_io_bytes[2]; + struct timeval stat_sample_time[2]; + + /* + * fio system usage accounting + */ + struct rusage ru_start; + struct rusage ru_end; + unsigned long usr_time; + unsigned long sys_time; + unsigned long ctx; }; +/* + * How many depth levels to log + */ +#define FIO_IO_U_MAP_NR 8 +#define FIO_IO_U_LAT_NR 12 + /* * This describes a single thread/process executing a fio job. */ struct thread_data { + char *description; char *name; char *directory; char *filename; @@ -172,6 +275,7 @@ struct thread_data { pthread_t thread; int thread_number; int groupid; + struct thread_stat ts; enum fio_filetype filetype; struct fio_file *files; unsigned int nr_files; @@ -209,8 +313,11 @@ struct thread_data { unsigned int bs[2]; unsigned int min_bs[2]; unsigned int max_bs[2]; + unsigned int hugepage_size; unsigned int rw_min_bs; unsigned int thinktime; + unsigned int thinktime_spin; + unsigned int thinktime_blocks; unsigned int fsync_blocks; unsigned int start_delay; unsigned long timeout; @@ -220,9 +327,12 @@ struct thread_data { unsigned long long zone_size; unsigned long long zone_skip; enum fio_memtype mem_type; + char *mmapfile; + int mmapfd; unsigned int stonewall; unsigned int numjobs; unsigned int iodepth; + unsigned int iodepth_low; os_cpu_mask_t cpumask; unsigned int iolog; unsigned int read_iolog; @@ -254,8 +364,12 @@ struct thread_data { * Current IO depth and list of free and busy io_u's. */ unsigned int cur_depth; + unsigned int io_u_map[FIO_IO_U_MAP_NR]; + unsigned int io_u_lat[FIO_IO_U_LAT_NR]; + unsigned long total_io_u; struct list_head io_u_freelist; struct list_head io_u_busylist; + struct list_head io_u_requeues; /* * Rate state @@ -274,10 +388,11 @@ struct thread_data { unsigned long long start_offset; unsigned long long total_io_size; + unsigned long io_issues[2]; unsigned long long io_blocks[2]; unsigned long long io_bytes[2]; - unsigned long long zone_bytes; unsigned long long this_io_bytes[2]; + unsigned long long zone_bytes; volatile int mutex; /* @@ -291,31 +406,9 @@ struct thread_data { unsigned int cpuload; unsigned int cpucycle; - /* - * bandwidth and latency stats - */ - struct io_stat clat_stat[2]; /* completion latency */ - struct io_stat slat_stat[2]; /* submission latency */ - struct io_stat bw_stat[2]; /* bandwidth stats */ - - unsigned long long stat_io_bytes[2]; - struct timeval stat_sample_time[2]; - - struct io_log *slat_log; - struct io_log *clat_log; - struct io_log *bw_log; - struct timeval start; /* start of this loop */ struct timeval epoch; /* time job was started */ - - /* - * fio system usage accounting - */ - struct rusage ru_start; - struct rusage ru_end; - unsigned long usr_time; - unsigned long sys_time; - unsigned long ctx; + struct timeval end_time;/* time job ended */ /* * read/write mixed workload state @@ -339,6 +432,8 @@ struct thread_data { #define __td_verror(td, err, msg) \ do { \ + if ((td)->error) \ + break; \ int e = (err); \ (td)->error = e; \ snprintf(td->verror, sizeof(td->verror) - 1, "file:%s:%d, error=%s", __FILE__, __LINE__, (msg)); \ @@ -348,7 +443,6 @@ struct thread_data { #define td_verror(td, err) __td_verror((td), (err), strerror((err))) #define td_vmsg(td, err, msg) __td_verror((td), (err), (msg)) -extern int rate_quit; extern int exitall_on_terminate; extern int thread_number; extern int shm_id; @@ -356,8 +450,8 @@ extern int groupid; extern int terse_output; extern FILE *f_out; extern FILE *f_err; -extern char *fio_inst_prefix; extern int temp_stall_ts; +extern unsigned long long mlock_size; extern struct thread_data *threads; @@ -384,6 +478,9 @@ static inline int should_fsync(struct thread_data *td) return 0; } +/* + * Disk utils as read in /sys/block//stat + */ struct disk_util_stat { unsigned ios[2]; unsigned merges[2]; @@ -393,6 +490,9 @@ struct disk_util_stat { unsigned time_in_queue; }; +/* + * Per-device disk util management + */ struct disk_util { struct list_head list; @@ -407,12 +507,10 @@ struct disk_util { struct timeval time; }; -struct io_completion_data { - int nr; /* input */ - - int error; /* output */ - unsigned long bytes_done[2]; /* output */ -}; +/* + * Callback for io completion + */ +typedef int (endio_handler)(struct io_u *); #define DISK_UTIL_MSEC (250) @@ -426,9 +524,9 @@ struct io_completion_data { /* * Log exports */ -extern int read_iolog_get(struct thread_data *, struct io_u *); +extern int __must_check read_iolog_get(struct thread_data *, struct io_u *); extern void write_iolog_put(struct thread_data *, struct io_u *); -extern int init_iolog(struct thread_data *td); +extern int __must_check init_iolog(struct thread_data *td); extern void log_io_piece(struct thread_data *, struct io_u *); extern void prune_io_piece_log(struct thread_data *); extern void write_iolog_close(struct thread_data *); @@ -436,9 +534,9 @@ extern void write_iolog_close(struct thread_data *); /* * Logging */ -extern void add_clat_sample(struct thread_data *, int, unsigned long); -extern void add_slat_sample(struct thread_data *, int, unsigned long); -extern void add_bw_sample(struct thread_data *, int); +extern void add_clat_sample(struct thread_data *, enum fio_ddir, unsigned long); +extern void add_slat_sample(struct thread_data *, enum fio_ddir, unsigned long); +extern void add_bw_sample(struct thread_data *, enum fio_ddir, struct timeval *); extern void show_run_stats(void); extern void init_disk_util(struct thread_data *); extern void update_rusage_stat(struct thread_data *); @@ -446,13 +544,17 @@ extern void update_io_ticks(void); extern void disk_util_timer_arm(void); extern void setup_log(struct io_log **); extern void finish_log(struct thread_data *, struct io_log *, const char *); +extern void __finish_log(struct io_log *, const char *); extern int setup_rate(struct thread_data *); +extern struct io_log *agg_io_log[2]; +extern int write_bw_log; +extern void add_agg_sample(unsigned long, enum fio_ddir); /* * Time functions */ -extern void time_init(void); extern unsigned long utime_since(struct timeval *, struct timeval *); +extern unsigned long utime_since_now(struct timeval *); extern unsigned long mtime_since(struct timeval *, struct timeval *); extern unsigned long mtime_since_now(struct timeval *); extern unsigned long time_since_now(struct timeval *); @@ -461,19 +563,21 @@ extern void __usec_sleep(unsigned int); extern void usec_sleep(struct thread_data *, unsigned long); extern void rate_throttle(struct thread_data *, unsigned long, unsigned int, int); extern void fill_start_time(struct timeval *); +extern void fio_gettime(struct timeval *, void *); /* * Init functions */ -extern int parse_options(int, char **); -extern int init_random_state(struct thread_data *); +extern int __must_check parse_options(int, char **); +extern int __must_check init_random_state(struct thread_data *); /* * File setup/shutdown */ extern void close_files(struct thread_data *); -extern int setup_files(struct thread_data *); -extern int file_invalidate_cache(struct thread_data *, struct fio_file *); +extern int __must_check setup_files(struct thread_data *); +extern int __must_check open_files(struct thread_data *); +extern int __must_check file_invalidate_cache(struct thread_data *, struct fio_file *); /* * ETA/status stuff @@ -502,15 +606,15 @@ enum { * Verify helpers */ extern void populate_verify_io_u(struct thread_data *, struct io_u *); -extern int get_next_verify(struct thread_data *td, struct io_u *); -extern int do_io_u_verify(struct thread_data *, struct io_u **); +extern int __must_check get_next_verify(struct thread_data *td, struct io_u *); +extern int __must_check verify_io_u(struct io_u *); /* * Memory helpers */ -extern int fio_pin_memory(void); +extern int __must_check fio_pin_memory(void); extern void fio_unpin_memory(void); -extern int allocate_io_mem(struct thread_data *); +extern int __must_check allocate_io_mem(struct thread_data *); extern void free_io_mem(struct thread_data *); /* @@ -518,19 +622,22 @@ extern void free_io_mem(struct thread_data *); */ #define queue_full(td) list_empty(&(td)->io_u_freelist) extern struct io_u *__get_io_u(struct thread_data *); -extern struct io_u *get_io_u(struct thread_data *, struct fio_file *); +extern struct io_u *get_io_u(struct thread_data *); extern void put_io_u(struct thread_data *, struct io_u *); -extern void ios_completed(struct thread_data *, struct io_completion_data *); -extern void io_completed(struct thread_data *, struct io_u *, struct io_completion_data *); +extern void requeue_io_u(struct thread_data *, struct io_u **); +extern long __must_check io_u_sync_complete(struct thread_data *, struct io_u *, endio_handler *); +extern long __must_check io_u_queued_complete(struct thread_data *, int, endio_handler *); +extern void io_u_queued(struct thread_data *, struct io_u *); /* * io engine entry points */ -extern int td_io_init(struct thread_data *); -extern int td_io_prep(struct thread_data *, struct io_u *); -extern int td_io_queue(struct thread_data *, struct io_u *); -extern int td_io_sync(struct thread_data *, struct fio_file *); -extern int td_io_getevents(struct thread_data *, int, int, struct timespec *); +extern int __must_check td_io_init(struct thread_data *); +extern int __must_check td_io_prep(struct thread_data *, struct io_u *); +extern int __must_check td_io_queue(struct thread_data *, struct io_u *); +extern int __must_check td_io_sync(struct thread_data *, struct fio_file *); +extern int __must_check td_io_getevents(struct thread_data *, int, int, struct timespec *); +extern int __must_check td_io_commit(struct thread_data *); /* * This is a pretty crappy semaphore implementation, but with the use that fio @@ -566,6 +673,7 @@ static inline void fio_sem_up(volatile int *sem) } while (0) struct ioengine_ops { + struct list_head list; char name[16]; int version; int flags; @@ -573,27 +681,43 @@ struct ioengine_ops { int (*init)(struct thread_data *); int (*prep)(struct thread_data *, struct io_u *); int (*queue)(struct thread_data *, struct io_u *); + int (*commit)(struct thread_data *); int (*getevents)(struct thread_data *, int, int, struct timespec *); struct io_u *(*event)(struct thread_data *, int); int (*cancel)(struct thread_data *, struct io_u *); void (*cleanup)(struct thread_data *); void *data; void *dlhandle; + unsigned long priv; }; -#define FIO_IOOPS_VERSION 3 +#define FIO_IOOPS_VERSION 5 extern struct ioengine_ops *load_ioengine(struct thread_data *, const char *); +extern void register_ioengine(struct ioengine_ops *); +extern void unregister_ioengine(struct ioengine_ops *); extern void close_ioengine(struct thread_data *); /* * Mark unused variables passed to ops functions as unused, to silence gcc */ #define fio_unused __attribute((__unused__)) +#define fio_init __attribute__((constructor)) +#define fio_exit __attribute__((destructor)) #define for_each_td(td, i) \ for ((i) = 0, (td) = &threads[0]; (i) < (int) thread_number; (i)++, (td)++) #define for_each_file(td, f, i) \ for ((i) = 0, (f) = &(td)->files[0]; (i) < (int) (td)->nr_files; (i)++, (f)++) +#define fio_assert(td, cond) do { \ + if (!(cond)) { \ + int *__foo = NULL; \ + fprintf(stderr, "file:%s:%d, assert %s failed\n", __FILE__, __LINE__, #cond); \ + (td)->runstate = TD_EXITED; \ + (td)->error = EFAULT; \ + *__foo = 0; \ + } \ +} while (0) + #endif