xref: /spdk/examples/ioat/perf/perf.c (revision b78e763c1af2ace4c19d2932065a43357e3f5d3e)
1 /*-
2  *   BSD LICENSE
3  *
4  *   Copyright (c) Intel Corporation.
5  *   All rights reserved.
6  *
7  *   Redistribution and use in source and binary forms, with or without
8  *   modification, are permitted provided that the following conditions
9  *   are met:
10  *
11  *     * Redistributions of source code must retain the above copyright
12  *       notice, this list of conditions and the following disclaimer.
13  *     * Redistributions in binary form must reproduce the above copyright
14  *       notice, this list of conditions and the following disclaimer in
15  *       the documentation and/or other materials provided with the
16  *       distribution.
17  *     * Neither the name of Intel Corporation nor the names of its
18  *       contributors may be used to endorse or promote products derived
19  *       from this software without specific prior written permission.
20  *
21  *   THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
22  *   "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
23  *   LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
24  *   A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
25  *   OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
26  *   SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
27  *   LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
28  *   DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
29  *   THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
30  *   (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
31  *   OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32  */
33 
34 #include "spdk/stdinc.h"
35 
36 #include "spdk/ioat.h"
37 #include "spdk/env.h"
38 #include "spdk/queue.h"
39 #include "spdk/string.h"
40 
41 struct user_config {
42 	int xfer_size_bytes;
43 	int queue_depth;
44 	int time_in_sec;
45 	bool verify;
46 	char *core_mask;
47 	int ioat_chan_num;
48 };
49 
50 struct ioat_device {
51 	struct spdk_ioat_chan *ioat;
52 	TAILQ_ENTRY(ioat_device) tailq;
53 };
54 
55 static TAILQ_HEAD(, ioat_device) g_devices;
56 static struct ioat_device *g_next_device;
57 
58 static struct user_config g_user_config;
59 
60 struct ioat_chan_entry {
61 	struct spdk_ioat_chan *chan;
62 	int ioat_chan_id;
63 	uint64_t xfer_completed;
64 	uint64_t xfer_failed;
65 	uint64_t current_queue_depth;
66 	bool is_draining;
67 	struct spdk_mempool *data_pool;
68 	struct spdk_mempool *task_pool;
69 	struct ioat_chan_entry *next;
70 };
71 
72 struct worker_thread {
73 	struct ioat_chan_entry	*ctx;
74 	struct worker_thread	*next;
75 	unsigned		core;
76 };
77 
78 struct ioat_task {
79 	struct ioat_chan_entry *ioat_chan_entry;
80 	void *src;
81 	void *dst;
82 };
83 
84 static struct worker_thread *g_workers = NULL;
85 static int g_num_workers = 0;
86 static int g_ioat_chan_num = 0;
87 
88 static void submit_single_xfer(struct ioat_chan_entry *ioat_chan_entry, struct ioat_task *ioat_task,
89 			       void *dst, void *src);
90 
91 static void
92 construct_user_config(struct user_config *self)
93 {
94 	self->xfer_size_bytes = 4096;
95 	self->ioat_chan_num = 1;
96 	self->queue_depth = 256;
97 	self->time_in_sec = 10;
98 	self->verify = false;
99 	self->core_mask = "0x1";
100 }
101 
102 static void
103 dump_user_config(struct user_config *self)
104 {
105 	printf("User configuration:\n");
106 	printf("Number of channels:    %u\n", self->ioat_chan_num);
107 	printf("Transfer size:  %u bytes\n", self->xfer_size_bytes);
108 	printf("Queue depth:    %u\n", self->queue_depth);
109 	printf("Run time:       %u seconds\n", self->time_in_sec);
110 	printf("Core mask:      %s\n", self->core_mask);
111 	printf("Verify:         %s\n\n", self->verify ? "Yes" : "No");
112 }
113 
114 static void
115 ioat_exit(void)
116 {
117 	struct ioat_device *dev;
118 
119 	while (!TAILQ_EMPTY(&g_devices)) {
120 		dev = TAILQ_FIRST(&g_devices);
121 		TAILQ_REMOVE(&g_devices, dev, tailq);
122 		if (dev->ioat) {
123 			spdk_ioat_detach(dev->ioat);
124 		}
125 		spdk_dma_free(dev);
126 	}
127 }
128 
129 static void
130 ioat_done(void *cb_arg)
131 {
132 	struct ioat_task *ioat_task = (struct ioat_task *)cb_arg;
133 	struct ioat_chan_entry *ioat_chan_entry = ioat_task->ioat_chan_entry;
134 
135 	if (g_user_config.verify && memcmp(ioat_task->src, ioat_task->dst, g_user_config.xfer_size_bytes)) {
136 		ioat_chan_entry->xfer_failed++;
137 	} else {
138 		ioat_chan_entry->xfer_completed++;
139 	}
140 
141 	ioat_chan_entry->current_queue_depth--;
142 
143 	if (ioat_chan_entry->is_draining) {
144 		spdk_mempool_put(ioat_chan_entry->data_pool, ioat_task->src);
145 		spdk_mempool_put(ioat_chan_entry->data_pool, ioat_task->dst);
146 		spdk_mempool_put(ioat_chan_entry->task_pool, ioat_task);
147 	} else {
148 		submit_single_xfer(ioat_chan_entry, ioat_task, ioat_task->dst, ioat_task->src);
149 	}
150 }
151 
152 static int
153 register_workers(void)
154 {
155 	uint32_t i;
156 	struct worker_thread *worker;
157 
158 	g_workers = NULL;
159 	g_num_workers = 0;
160 
161 	SPDK_ENV_FOREACH_CORE(i) {
162 		worker = calloc(1, sizeof(*worker));
163 		if (worker == NULL) {
164 			fprintf(stderr, "Unable to allocate worker\n");
165 			return -1;
166 		}
167 
168 		worker->core = i;
169 		worker->next = g_workers;
170 		g_workers = worker;
171 		g_num_workers++;
172 	}
173 
174 	return 0;
175 }
176 
177 static void
178 unregister_workers(void)
179 {
180 	struct worker_thread *worker = g_workers;
181 	struct ioat_chan_entry *entry, *entry1;
182 
183 	/* Free ioat_chan_entry and worker thread */
184 	while (worker) {
185 		struct worker_thread *next_worker = worker->next;
186 		entry = worker->ctx;
187 		while (entry) {
188 			entry1 = entry->next;
189 			spdk_mempool_free(entry->data_pool);
190 			spdk_mempool_free(entry->task_pool);
191 			free(entry);
192 			entry = entry1;
193 		}
194 		free(worker);
195 		worker = next_worker;
196 	}
197 }
198 
199 static bool
200 probe_cb(void *cb_ctx, struct spdk_pci_device *pci_dev)
201 {
202 	printf(" Found matching device at %04x:%02x:%02x.%x "
203 	       "vendor:0x%04x device:0x%04x\n",
204 	       spdk_pci_device_get_domain(pci_dev),
205 	       spdk_pci_device_get_bus(pci_dev), spdk_pci_device_get_dev(pci_dev),
206 	       spdk_pci_device_get_func(pci_dev),
207 	       spdk_pci_device_get_vendor_id(pci_dev), spdk_pci_device_get_device_id(pci_dev));
208 
209 	return true;
210 }
211 
212 static void
213 attach_cb(void *cb_ctx, struct spdk_pci_device *pci_dev, struct spdk_ioat_chan *ioat)
214 {
215 	struct ioat_device *dev;
216 
217 	if (g_ioat_chan_num >= g_user_config.ioat_chan_num) {
218 		return;
219 	}
220 
221 	dev = spdk_dma_zmalloc(sizeof(*dev), 0, NULL);
222 	if (dev == NULL) {
223 		printf("Failed to allocate device struct\n");
224 		return;
225 	}
226 
227 	dev->ioat = ioat;
228 	g_ioat_chan_num++;
229 	TAILQ_INSERT_TAIL(&g_devices, dev, tailq);
230 }
231 
232 static int
233 ioat_init(void)
234 {
235 	TAILQ_INIT(&g_devices);
236 
237 	if (spdk_ioat_probe(NULL, probe_cb, attach_cb) != 0) {
238 		fprintf(stderr, "ioat_probe() failed\n");
239 		return 1;
240 	}
241 
242 	return 0;
243 }
244 
245 static void
246 usage(char *program_name)
247 {
248 	printf("%s options\n", program_name);
249 	printf("\t[-h help message]\n");
250 	printf("\t[-c core mask for distributing I/O submission/completion work]\n");
251 	printf("\t[-q queue depth]\n");
252 	printf("\t[-n number of channels]\n");
253 	printf("\t[-o transfer size in bytes]\n");
254 	printf("\t[-t time in seconds]\n");
255 	printf("\t[-v verify copy result if this switch is on]\n");
256 }
257 
258 static int
259 parse_args(int argc, char **argv)
260 {
261 	int op;
262 
263 	construct_user_config(&g_user_config);
264 	while ((op = getopt(argc, argv, "c:hn:o:q:t:v")) != -1) {
265 		switch (op) {
266 		case 'o':
267 			g_user_config.xfer_size_bytes = atoi(optarg);
268 			break;
269 		case 'n':
270 			g_user_config.ioat_chan_num = atoi(optarg);
271 			break;
272 		case 'q':
273 			g_user_config.queue_depth = atoi(optarg);
274 			break;
275 		case 't':
276 			g_user_config.time_in_sec = atoi(optarg);
277 			break;
278 		case 'c':
279 			g_user_config.core_mask = optarg;
280 			break;
281 		case 'v':
282 			g_user_config.verify = true;
283 			break;
284 		case 'h':
285 			usage(argv[0]);
286 			exit(0);
287 		default:
288 			usage(argv[0]);
289 			return 1;
290 		}
291 	}
292 	if (!g_user_config.xfer_size_bytes || !g_user_config.queue_depth ||
293 	    !g_user_config.time_in_sec || !g_user_config.core_mask ||
294 	    !g_user_config.ioat_chan_num) {
295 		usage(argv[0]);
296 		return 1;
297 	}
298 
299 	return 0;
300 }
301 
302 static void
303 drain_io(struct ioat_chan_entry *ioat_chan_entry)
304 {
305 	while (ioat_chan_entry->current_queue_depth > 0) {
306 		spdk_ioat_process_events(ioat_chan_entry->chan);
307 	}
308 }
309 
310 static void
311 submit_single_xfer(struct ioat_chan_entry *ioat_chan_entry, struct ioat_task *ioat_task, void *dst,
312 		   void *src)
313 {
314 	ioat_task->ioat_chan_entry = ioat_chan_entry;
315 	ioat_task->src = src;
316 	ioat_task->dst = dst;
317 
318 	spdk_ioat_submit_copy(ioat_chan_entry->chan, ioat_task, ioat_done, dst, src,
319 			      g_user_config.xfer_size_bytes);
320 
321 	ioat_chan_entry->current_queue_depth++;
322 }
323 
324 static int
325 submit_xfers(struct ioat_chan_entry *ioat_chan_entry, uint64_t queue_depth)
326 {
327 	while (queue_depth-- > 0) {
328 		void *src = NULL, *dst = NULL;
329 		struct ioat_task *ioat_task = NULL;
330 
331 		src = spdk_mempool_get(ioat_chan_entry->data_pool);
332 		dst = spdk_mempool_get(ioat_chan_entry->data_pool);
333 		ioat_task = spdk_mempool_get(ioat_chan_entry->task_pool);
334 		if (!ioat_task) {
335 			fprintf(stderr, "Unable to get ioat_task\n");
336 			return -1;
337 		}
338 
339 		submit_single_xfer(ioat_chan_entry, ioat_task, dst, src);
340 	}
341 	return 0;
342 }
343 
344 static int
345 work_fn(void *arg)
346 {
347 	uint64_t tsc_end;
348 	struct worker_thread *worker = (struct worker_thread *)arg;
349 	struct ioat_chan_entry *t = NULL;
350 
351 	printf("Starting thread on core %u\n", worker->core);
352 
353 	tsc_end = spdk_get_ticks() + g_user_config.time_in_sec * spdk_get_ticks_hz();
354 
355 	t = worker->ctx;
356 	while (t != NULL) {
357 		/* begin to submit transfers */
358 		if (submit_xfers(t, g_user_config.queue_depth) < 0) {
359 			return -1;
360 		}
361 		t = t->next;
362 	}
363 
364 	while (1) {
365 		t = worker->ctx;
366 		while (t != NULL) {
367 			spdk_ioat_process_events(t->chan);
368 			t = t->next;
369 		}
370 
371 		if (spdk_get_ticks() > tsc_end) {
372 			break;
373 		}
374 	}
375 
376 	t = worker->ctx;
377 	while (t != NULL) {
378 		/* begin to drain io */
379 		t->is_draining = true;
380 		drain_io(t);
381 		t = t->next;
382 	}
383 
384 	return 0;
385 }
386 
387 static int
388 init(void)
389 {
390 	struct spdk_env_opts opts;
391 
392 	spdk_env_opts_init(&opts);
393 	opts.name = "perf";
394 	opts.core_mask = g_user_config.core_mask;
395 	if (spdk_env_init(&opts) < 0) {
396 		return -1;
397 	}
398 
399 	return 0;
400 }
401 
402 static int
403 dump_result(void)
404 {
405 	uint64_t total_completed = 0;
406 	uint64_t total_failed = 0;
407 	uint64_t total_xfer_per_sec, total_bw_in_MiBps;
408 	struct worker_thread *worker = g_workers;
409 
410 	printf("Channel_ID     Core     Transfers     Bandwidth     Failed\n");
411 	printf("-----------------------------------------------------------\n");
412 	while (worker != NULL) {
413 		struct ioat_chan_entry *t = worker->ctx;
414 		while (t) {
415 			uint64_t xfer_per_sec = t->xfer_completed / g_user_config.time_in_sec;
416 			uint64_t bw_in_MiBps = (t->xfer_completed * g_user_config.xfer_size_bytes) /
417 					       (g_user_config.time_in_sec * 1024 * 1024);
418 
419 			total_completed += t->xfer_completed;
420 			total_failed += t->xfer_failed;
421 
422 			if (xfer_per_sec) {
423 				printf("%10d%10d%12" PRIu64 "/s%8" PRIu64 " MiB/s%11" PRIu64 "\n",
424 				       t->ioat_chan_id, worker->core, xfer_per_sec,
425 				       bw_in_MiBps, t->xfer_failed);
426 			}
427 			t = t->next;
428 		}
429 		worker = worker->next;
430 	}
431 
432 	total_xfer_per_sec = total_completed / g_user_config.time_in_sec;
433 	total_bw_in_MiBps = (total_completed * g_user_config.xfer_size_bytes) /
434 			    (g_user_config.time_in_sec * 1024 * 1024);
435 
436 	printf("===========================================================\n");
437 	printf("Total:%26" PRIu64 "/s%8" PRIu64 " MiB/s%11" PRIu64 "\n",
438 	       total_xfer_per_sec, total_bw_in_MiBps, total_failed);
439 
440 	return total_failed ? 1 : 0;
441 }
442 
443 static struct spdk_ioat_chan *
444 get_next_chan(void)
445 {
446 	struct spdk_ioat_chan *chan;
447 
448 	if (g_next_device == NULL) {
449 		return NULL;
450 	}
451 
452 	chan = g_next_device->ioat;
453 
454 	g_next_device = TAILQ_NEXT(g_next_device, tailq);
455 
456 	return chan;
457 }
458 
459 static int
460 associate_workers_with_chan(void)
461 {
462 	struct spdk_ioat_chan *chan = get_next_chan();
463 	struct worker_thread	*worker = g_workers;
464 	struct ioat_chan_entry	*t;
465 	char buf_pool_name[30], task_pool_name[30];
466 	int i = 0;
467 
468 	while (chan != NULL) {
469 		t = calloc(1, sizeof(struct ioat_chan_entry));
470 		if (!t) {
471 			return -1;
472 		}
473 
474 		t->ioat_chan_id = i;
475 		snprintf(buf_pool_name, sizeof(buf_pool_name), "buf_pool_%d", i);
476 		snprintf(task_pool_name, sizeof(task_pool_name), "task_pool_%d", i);
477 		t->data_pool = spdk_mempool_create(buf_pool_name, 512, g_user_config.xfer_size_bytes,
478 						   SPDK_MEMPOOL_DEFAULT_CACHE_SIZE,
479 						   SPDK_ENV_SOCKET_ID_ANY);
480 		t->task_pool = spdk_mempool_create(task_pool_name, 512, sizeof(struct ioat_task),
481 						   SPDK_MEMPOOL_DEFAULT_CACHE_SIZE,
482 						   SPDK_ENV_SOCKET_ID_ANY);
483 		if (!t->data_pool || !t->task_pool) {
484 			fprintf(stderr, "Could not allocate buffer pool.\n");
485 			spdk_mempool_free(t->data_pool);
486 			spdk_mempool_free(t->task_pool);
487 			free(t);
488 			return 1;
489 		}
490 		printf("Associating ioat_channel %d with core %d\n", i, worker->core);
491 		t->chan = chan;
492 		t->next = worker->ctx;
493 		worker->ctx = t;
494 
495 		worker = worker->next;
496 		if (worker == NULL) {
497 			worker = g_workers;
498 		}
499 
500 		chan = get_next_chan();
501 		i++;
502 	}
503 
504 	return 0;
505 }
506 
507 int
508 main(int argc, char **argv)
509 {
510 	int rc;
511 	struct worker_thread *worker, *master_worker;
512 	unsigned master_core;
513 
514 	if (parse_args(argc, argv) != 0) {
515 		return 1;
516 	}
517 
518 	if (init() != 0) {
519 		return 1;
520 	}
521 
522 	if (register_workers() != 0) {
523 		rc = -1;
524 		goto cleanup;
525 	}
526 
527 	if (ioat_init() != 0) {
528 		rc = -1;
529 		goto cleanup;
530 	}
531 
532 	if (g_ioat_chan_num == 0) {
533 		printf("No channels found\n");
534 		rc = 0;
535 		goto cleanup;
536 	}
537 
538 	if (g_user_config.ioat_chan_num > g_ioat_chan_num) {
539 		printf("%d channels are requested, but only %d are found,"
540 		       "so only test %d channels\n", g_user_config.ioat_chan_num,
541 		       g_ioat_chan_num, g_ioat_chan_num);
542 		g_user_config.ioat_chan_num = g_ioat_chan_num;
543 	}
544 
545 	g_next_device = TAILQ_FIRST(&g_devices);
546 	dump_user_config(&g_user_config);
547 
548 	if (associate_workers_with_chan() != 0) {
549 		rc = -1;
550 		goto cleanup;
551 	}
552 
553 	/* Launch all of the slave workers */
554 	master_core = spdk_env_get_current_core();
555 	master_worker = NULL;
556 	worker = g_workers;
557 	while (worker != NULL) {
558 		if (worker->core != master_core) {
559 			spdk_env_thread_launch_pinned(worker->core, work_fn, worker);
560 		} else {
561 			assert(master_worker == NULL);
562 			master_worker = worker;
563 		}
564 		worker = worker->next;
565 	}
566 
567 	assert(master_worker != NULL);
568 	rc = work_fn(master_worker);
569 	if (rc < 0) {
570 		goto cleanup;
571 	}
572 
573 	spdk_env_thread_wait_all();
574 
575 	rc = dump_result();
576 
577 cleanup:
578 	unregister_workers();
579 	ioat_exit();
580 
581 	return rc;
582 }
583