2 * pmemblk: IO engine that uses NVML libpmemblk to read and write data
4 * Copyright (C) 2016 Hewlett Packard Enterprise Development LP
6 * This program is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU General Public License,
8 * version 2 as published by the Free Software Foundation..
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public
16 * License along with this program; if not, write to the Free
17 * Software Foundation, Inc., 59 Temple Place, Suite 330,
18 * Boston, MA 02111-1307 USA
24 * IO engine that uses libpmemblk to read and write data
29 * Other relevant settings:
34 * filename=/pmem0/fiotestfile,BSIZE,FSIZEMB
36 * thread must be set to 1 for pmemblk as multiple processes cannot
37 * open the same block pool file.
39 * iodepth should be set to 1 as pmemblk is always synchronous.
40 * Use numjobs to scale up.
42 * direct=1 is implied as pmemblk is always direct.
44 * Can set unlink to 1 to remove the block pool file after testing.
46 * When specifying the filename, if the block pool file does not already
47 * exist, then the pmemblk engine can create the pool file if you specify
48 * the block and file sizes. BSIZE is the block size in bytes.
49 * FSIZEMB is the pool file size in MB.
51 * See examples/pmemblk.fio for more.
54 * By default, the pmemblk engine will let the system find the libpmemblk.so
55 * that it uses. You can use an alternative libpmemblk by setting the
56 * FIO_PMEMBLK_LIB environment variable to the full path to the desired
76 typedef struct PMEMblkpool_s PMEMblkpool;
78 PMEMblkpool *(*pmemblk_create) (const char *, size_t, size_t, mode_t) = NULL;
79 PMEMblkpool *(*pmemblk_open) (const char *, size_t) = NULL;
80 void (*pmemblk_close) (PMEMblkpool *) = NULL;
81 size_t(*pmemblk_nblock) (PMEMblkpool *) = NULL;
82 size_t(*pmemblk_bsize) (PMEMblkpool *) = NULL;
83 int (*pmemblk_read) (PMEMblkpool *, void *, off_t) = NULL;
84 int (*pmemblk_write) (PMEMblkpool *, const void *, off_t) = NULL;
86 int load_libpmemblk(const char *path)
91 path = "libpmemblk.so";
93 dl = dlopen(path, RTLD_NOW | RTLD_NODELETE);
97 if (NULL == (pmemblk_create = dlsym(dl, "pmemblk_create")))
99 if (NULL == (pmemblk_open = dlsym(dl, "pmemblk_open")))
101 if (NULL == (pmemblk_close = dlsym(dl, "pmemblk_close")))
103 if (NULL == (pmemblk_nblock = dlsym(dl, "pmemblk_nblock")))
105 if (NULL == (pmemblk_bsize = dlsym(dl, "pmemblk_bsize")))
107 if (NULL == (pmemblk_read = dlsym(dl, "pmemblk_read")))
109 if (NULL == (pmemblk_write = dlsym(dl, "pmemblk_write")))
115 log_err("fio: unable to load libpmemblk: %s\n", dlerror());
121 } /* load_libpmemblk() */
123 typedef struct fio_pmemblk_file *fio_pmemblk_file_t;
124 struct fio_pmemblk_file {
125 fio_pmemblk_file_t pmb_next;
128 PMEMblkpool *pmb_pool;
132 #define FIOFILEPMBSET(_f, _v) do { \
133 (_f)->engine_data = (uint64_t)(uintptr_t)(_v); \
135 #define FIOFILEPMBGET(_f) ((fio_pmemblk_file_t)((_f)->engine_data))
137 static fio_pmemblk_file_t Cache = NULL;
139 static pthread_mutex_t CacheLock = PTHREAD_MUTEX_INITIALIZER;
140 #define CACHE_LOCK() \
141 (void)pthread_mutex_lock(&CacheLock)
142 #define CACHE_UNLOCK() \
143 (void)pthread_mutex_unlock(&CacheLock)
145 #define PMB_CREATE (0x0001) /* should create file */
147 fio_pmemblk_file_t fio_pmemblk_cache_lookup(const char *filename)
149 fio_pmemblk_file_t i;
151 for (i = Cache; i != NULL; i = i->pmb_next)
152 if (0 == strcmp(filename, i->pmb_filename))
157 } /* fio_pmemblk_cache_lookup() */
159 static void fio_pmemblk_cache_insert(fio_pmemblk_file_t pmb)
161 pmb->pmb_next = Cache;
166 } /* fio_pmemblk_cache_insert() */
168 static void fio_pmemblk_cache_remove(fio_pmemblk_file_t pmb)
170 fio_pmemblk_file_t i;
173 Cache = Cache->pmb_next;
174 pmb->pmb_next = NULL;
178 for (i = Cache; i != NULL; i = i->pmb_next)
179 if (pmb == i->pmb_next) {
180 i->pmb_next = i->pmb_next->pmb_next;
181 pmb->pmb_next = NULL;
187 } /* fio_pmemblk_cache_remove() */
190 * to control block size and gross file size at the libpmemblk
191 * level, we allow the block size and file size to be appended
194 * path[,bsize,fsizemb]
196 * note that we do not use the fio option "filesize" to dictate
197 * the file size because we can only give libpmemblk the gross
198 * file size, which is different from the net or usable file
199 * size (which is probably what fio wants).
201 * the final path without the parameters is returned in ppath.
202 * the block size and file size are returned in pbsize and fsize.
204 * note that the user should specify the file size in MiB, but
205 * we return bytes from here.
208 pmb_parse_path(const char *pathspec,
209 char **ppath, uint64_t * pbsize, uint64_t * pfsize)
216 path = strdup(pathspec);
222 /* extract sizes, if given */
223 s = strrchr(path, ',');
224 if (s && (fsizemb = strtoull(s + 1, NULL, 10))) {
226 s = strrchr(path, ',');
227 if (s && (bsize = strtoull(s + 1, NULL, 10))) {
231 *pfsize = fsizemb << 20;
236 /* size specs not found */
237 strcpy(path, pathspec);
243 } /* pmb_parse_path() */
246 fio_pmemblk_file_t pmb_open(const char *pathspec, int flags)
248 fio_pmemblk_file_t pmb;
253 pmb_parse_path(pathspec, &path, &bsize, &fsize);
259 pmb = fio_pmemblk_cache_lookup(path);
262 /* load libpmemblk if needed */
263 if (NULL == pmemblk_open)
264 if (0 != load_libpmemblk(getenv("FIO_PMEMBLK_LIB")))
267 pmb = malloc(sizeof(*pmb));
271 /* try opening existing first, create it if needed */
272 pmb->pmb_pool = pmemblk_open(path, bsize);
273 if ((NULL == pmb->pmb_pool) &&
275 (flags & PMB_CREATE) && (0 < fsize) && (0 < bsize)) {
277 pmemblk_create(path, bsize, fsize, 0644);
279 if (NULL == pmb->pmb_pool) {
281 ("fio: enable to open pmemblk pool file (errno %d)\n",
286 pmb->pmb_filename = path;
287 pmb->pmb_next = NULL;
289 pmb->pmb_bsize = pmemblk_bsize(pmb->pmb_pool);
290 pmb->pmb_nblocks = pmemblk_nblock(pmb->pmb_pool);
292 fio_pmemblk_cache_insert(pmb);
295 pmb->pmb_refcnt += 1;
303 if (NULL != pmb->pmb_pool)
304 pmemblk_close(pmb->pmb_pool);
305 pmb->pmb_pool = NULL;
306 pmb->pmb_filename = NULL;
316 static void pmb_close(fio_pmemblk_file_t pmb, const int keep)
322 if (!keep && (0 == pmb->pmb_refcnt)) {
323 pmemblk_close(pmb->pmb_pool);
324 pmb->pmb_pool = NULL;
325 free(pmb->pmb_filename);
326 pmb->pmb_filename = NULL;
327 fio_pmemblk_cache_remove(pmb);
335 static int pmb_get_flags(struct thread_data *td, uint64_t * pflags)
337 static int thread_warned = 0;
338 static int odirect_warned = 0;
342 if (!td->o.use_thread) {
343 if (!thread_warned) {
345 log_err("fio: must set thread=1 for pmemblk engine\n");
350 if (!td->o.odirect && !odirect_warned) {
352 log_info("fio: direct == 0, but pmemblk is always direct\n");
355 if (td->o.allow_create)
361 } /* pmb_get_flags() */
363 static int fio_pmemblk_open_file(struct thread_data *td, struct fio_file *f)
366 fio_pmemblk_file_t pmb;
368 if (0 != pmb_get_flags(td, &flags))
371 pmb = pmb_open(f->file_name, flags);
375 FIOFILEPMBSET(f, pmb);
379 } /* fio_pmemblk_open_file() */
382 fio_pmemblk_close_file(struct thread_data fio_unused * td, struct fio_file *f)
384 fio_pmemblk_file_t pmb = FIOFILEPMBGET(f);
389 FIOFILEPMBSET(f, NULL);
393 } /* fio_pmemblk_close_file() */
395 static int fio_pmemblk_get_file_size(struct thread_data *td, struct fio_file *f)
398 fio_pmemblk_file_t pmb = FIOFILEPMBGET(f);
400 if (fio_file_size_known(f))
404 if (0 != pmb_get_flags(td, &flags))
406 pmb = pmb_open(f->file_name, flags);
411 f->real_file_size = pmb->pmb_bsize * pmb->pmb_nblocks;
413 fio_file_set_size_known(f);
415 if (NULL == FIOFILEPMBGET(f))
420 } /* fio_pmemblk_get_file_size() */
422 static int fio_pmemblk_queue(struct thread_data *td, struct io_u *io_u)
424 struct fio_file *f = io_u->file;
425 fio_pmemblk_file_t pmb = FIOFILEPMBGET(f);
427 unsigned long long off;
430 int (*blkop) (PMEMblkpool *, void *, off_t) = (void *)pmemblk_write;
432 fio_ro_check(td, io_u);
434 switch (io_u->ddir) {
436 blkop = pmemblk_read;
440 len = io_u->xfer_buflen;
442 io_u->error = EINVAL;
443 if (0 != (off % pmb->pmb_bsize))
445 if (0 != (len % pmb->pmb_bsize))
447 if ((off + len) / pmb->pmb_bsize > pmb->pmb_nblocks)
451 buf = io_u->xfer_buf;
452 off /= pmb->pmb_bsize;
453 len /= pmb->pmb_bsize;
455 if (0 != blkop(pmb->pmb_pool, buf, off)) {
459 buf += pmb->pmb_bsize;
463 off *= pmb->pmb_bsize;
464 len *= pmb->pmb_bsize;
465 io_u->resid = io_u->xfer_buflen - (off - io_u->offset);
469 case DDIR_SYNC_FILE_RANGE:
470 /* we're always sync'd */
474 io_u->error = EINVAL;
478 return FIO_Q_COMPLETED;
480 } /* fio_pmemblk_queue() */
482 static int fio_pmemblk_unlink_file(struct thread_data *td, struct fio_file *f)
489 * we need our own unlink in case the user has specified
490 * the block and file sizes in the path name. we parse
491 * the file_name to determine the file name we actually used.
494 pmb_parse_path(f->file_name, &path, &bsize, &fsize);
503 } /* fio_pmemblk_unlink_file() */
505 struct ioengine_ops ioengine = {
507 .version = FIO_IOOPS_VERSION,
508 .queue = fio_pmemblk_queue,
509 .open_file = fio_pmemblk_open_file,
510 .close_file = fio_pmemblk_close_file,
511 .get_file_size = fio_pmemblk_get_file_size,
512 .unlink_file = fio_pmemblk_unlink_file,
513 .flags = FIO_SYNCIO | FIO_DISKLESSIO | FIO_NOEXTEND | FIO_NODISKUTIL,
517 fio_init fio_pmemblk_register(void)
519 register_ioengine(&ioengine);
523 fio_exit fio_pmemblk_unregister(void)
525 unregister_ioengine(&ioengine);