ring_buffer.c 130.1 KB
Newer Older
S
Steven Rostedt 已提交
1 2 3 4 5
/*
 * Generic ring buffer
 *
 * Copyright (C) 2008 Steven Rostedt <srostedt@redhat.com>
 */
6
#include <linux/trace_events.h>
S
Steven Rostedt 已提交
7
#include <linux/ring_buffer.h>
8
#include <linux/trace_clock.h>
9
#include <linux/sched/clock.h>
10
#include <linux/trace_seq.h>
S
Steven Rostedt 已提交
11
#include <linux/spinlock.h>
12
#include <linux/irq_work.h>
S
Steven Rostedt 已提交
13
#include <linux/uaccess.h>
14
#include <linux/hardirq.h>
15
#include <linux/kthread.h>	/* for self test */
16
#include <linux/kmemcheck.h>
S
Steven Rostedt 已提交
17 18 19
#include <linux/module.h>
#include <linux/percpu.h>
#include <linux/mutex.h>
20
#include <linux/delay.h>
21
#include <linux/slab.h>
S
Steven Rostedt 已提交
22 23 24
#include <linux/init.h>
#include <linux/hash.h>
#include <linux/list.h>
25
#include <linux/cpu.h>
S
Steven Rostedt 已提交
26

27
#include <asm/local.h>
28

29 30
static void update_pages_handler(struct work_struct *work);

31 32 33 34 35
/*
 * The ring buffer header is special. We must manually up keep it.
 */
int ring_buffer_print_entry_header(struct trace_seq *s)
{
36 37 38 39 40 41 42 43 44 45 46 47 48
	trace_seq_puts(s, "# compressed entry header\n");
	trace_seq_puts(s, "\ttype_len    :    5 bits\n");
	trace_seq_puts(s, "\ttime_delta  :   27 bits\n");
	trace_seq_puts(s, "\tarray       :   32 bits\n");
	trace_seq_putc(s, '\n');
	trace_seq_printf(s, "\tpadding     : type == %d\n",
			 RINGBUF_TYPE_PADDING);
	trace_seq_printf(s, "\ttime_extend : type == %d\n",
			 RINGBUF_TYPE_TIME_EXTEND);
	trace_seq_printf(s, "\tdata max type_len  == %d\n",
			 RINGBUF_TYPE_DATA_TYPE_LEN_MAX);

	return !trace_seq_has_overflowed(s);
49 50
}

51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118
/*
 * The ring buffer is made up of a list of pages. A separate list of pages is
 * allocated for each CPU. A writer may only write to a buffer that is
 * associated with the CPU it is currently executing on.  A reader may read
 * from any per cpu buffer.
 *
 * The reader is special. For each per cpu buffer, the reader has its own
 * reader page. When a reader has read the entire reader page, this reader
 * page is swapped with another page in the ring buffer.
 *
 * Now, as long as the writer is off the reader page, the reader can do what
 * ever it wants with that page. The writer will never write to that page
 * again (as long as it is out of the ring buffer).
 *
 * Here's some silly ASCII art.
 *
 *   +------+
 *   |reader|          RING BUFFER
 *   |page  |
 *   +------+        +---+   +---+   +---+
 *                   |   |-->|   |-->|   |
 *                   +---+   +---+   +---+
 *                     ^               |
 *                     |               |
 *                     +---------------+
 *
 *
 *   +------+
 *   |reader|          RING BUFFER
 *   |page  |------------------v
 *   +------+        +---+   +---+   +---+
 *                   |   |-->|   |-->|   |
 *                   +---+   +---+   +---+
 *                     ^               |
 *                     |               |
 *                     +---------------+
 *
 *
 *   +------+
 *   |reader|          RING BUFFER
 *   |page  |------------------v
 *   +------+        +---+   +---+   +---+
 *      ^            |   |-->|   |-->|   |
 *      |            +---+   +---+   +---+
 *      |                              |
 *      |                              |
 *      +------------------------------+
 *
 *
 *   +------+
 *   |buffer|          RING BUFFER
 *   |page  |------------------v
 *   +------+        +---+   +---+   +---+
 *      ^            |   |   |   |-->|   |
 *      |   New      +---+   +---+   +---+
 *      |  Reader------^               |
 *      |   page                       |
 *      +------------------------------+
 *
 *
 * After we make this swap, the reader can hand this page off to the splice
 * code and be done with it. It can even allocate a new page if it needs to
 * and swap that into the ring buffer.
 *
 * We will be using cmpxchg soon to make all this lockless.
 *
 */

119 120
/* Used for individual buffers (after the counter) */
#define RB_BUFFER_OFF		(1 << 20)
121

122
#define BUF_PAGE_HDR_SIZE offsetof(struct buffer_data_page, data)
123

124
#define RB_EVNT_HDR_SIZE (offsetof(struct ring_buffer_event, array))
125
#define RB_ALIGNMENT		4U
126
#define RB_MAX_SMALL_DATA	(RB_ALIGNMENT * RINGBUF_TYPE_DATA_TYPE_LEN_MAX)
127
#define RB_EVNT_MIN_SIZE	8U	/* two 32bit words */
128

129
#ifndef CONFIG_HAVE_64BIT_ALIGNED_ACCESS
130 131 132 133 134 135 136
# define RB_FORCE_8BYTE_ALIGNMENT	0
# define RB_ARCH_ALIGNMENT		RB_ALIGNMENT
#else
# define RB_FORCE_8BYTE_ALIGNMENT	1
# define RB_ARCH_ALIGNMENT		8U
#endif

137 138
#define RB_ALIGN_DATA		__aligned(RB_ARCH_ALIGNMENT)

139 140
/* define RINGBUF_TYPE_DATA for 'case RINGBUF_TYPE_DATA:' */
#define RINGBUF_TYPE_DATA 0 ... RINGBUF_TYPE_DATA_TYPE_LEN_MAX
S
Steven Rostedt 已提交
141 142 143 144 145 146

enum {
	RB_LEN_TIME_EXTEND = 8,
	RB_LEN_TIME_STAMP = 16,
};

147 148 149
#define skip_time_extend(event) \
	((struct ring_buffer_event *)((char *)event + RB_LEN_TIME_EXTEND))

150 151
static inline int rb_null_event(struct ring_buffer_event *event)
{
152
	return event->type_len == RINGBUF_TYPE_PADDING && !event->time_delta;
153 154 155 156
}

static void rb_event_set_padding(struct ring_buffer_event *event)
{
157
	/* padding has a NULL time_delta */
158
	event->type_len = RINGBUF_TYPE_PADDING;
159 160 161
	event->time_delta = 0;
}

162
static unsigned
163
rb_event_data_length(struct ring_buffer_event *event)
S
Steven Rostedt 已提交
164 165 166
{
	unsigned length;

167 168
	if (event->type_len)
		length = event->type_len * RB_ALIGNMENT;
169 170 171 172 173
	else
		length = event->array[0];
	return length + RB_EVNT_HDR_SIZE;
}

174 175 176 177 178 179
/*
 * Return the length of the given event. Will return
 * the length of the time extend if the event is a
 * time extend.
 */
static inline unsigned
180 181
rb_event_length(struct ring_buffer_event *event)
{
182
	switch (event->type_len) {
S
Steven Rostedt 已提交
183
	case RINGBUF_TYPE_PADDING:
184 185 186
		if (rb_null_event(event))
			/* undefined */
			return -1;
187
		return  event->array[0] + RB_EVNT_HDR_SIZE;
S
Steven Rostedt 已提交
188 189 190 191 192 193 194 195

	case RINGBUF_TYPE_TIME_EXTEND:
		return RB_LEN_TIME_EXTEND;

	case RINGBUF_TYPE_TIME_STAMP:
		return RB_LEN_TIME_STAMP;

	case RINGBUF_TYPE_DATA:
196
		return rb_event_data_length(event);
S
Steven Rostedt 已提交
197 198 199 200 201 202 203
	default:
		BUG();
	}
	/* not hit */
	return 0;
}

204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220
/*
 * Return total length of time extend and data,
 *   or just the event length for all other events.
 */
static inline unsigned
rb_event_ts_length(struct ring_buffer_event *event)
{
	unsigned len = 0;

	if (event->type_len == RINGBUF_TYPE_TIME_EXTEND) {
		/* time extends include the data event after it */
		len = RB_LEN_TIME_EXTEND;
		event = skip_time_extend(event);
	}
	return len + rb_event_length(event);
}

S
Steven Rostedt 已提交
221 222 223
/**
 * ring_buffer_event_length - return the length of the event
 * @event: the event to get the length of
224 225 226 227 228 229
 *
 * Returns the size of the data load of a data event.
 * If the event is something other than a data event, it
 * returns the size of the event itself. With the exception
 * of a TIME EXTEND, where it still returns the size of the
 * data load of the data event after it.
S
Steven Rostedt 已提交
230 231 232
 */
unsigned ring_buffer_event_length(struct ring_buffer_event *event)
{
233 234 235 236 237 238
	unsigned length;

	if (event->type_len == RINGBUF_TYPE_TIME_EXTEND)
		event = skip_time_extend(event);

	length = rb_event_length(event);
239
	if (event->type_len > RINGBUF_TYPE_DATA_TYPE_LEN_MAX)
240 241 242 243 244
		return length;
	length -= RB_EVNT_HDR_SIZE;
	if (length > RB_MAX_SMALL_DATA + sizeof(event->array[0]))
                length -= sizeof(event->array[0]);
	return length;
S
Steven Rostedt 已提交
245
}
246
EXPORT_SYMBOL_GPL(ring_buffer_event_length);
S
Steven Rostedt 已提交
247 248

/* inline for ring buffer fast paths */
249
static __always_inline void *
S
Steven Rostedt 已提交
250 251
rb_event_data(struct ring_buffer_event *event)
{
252 253
	if (event->type_len == RINGBUF_TYPE_TIME_EXTEND)
		event = skip_time_extend(event);
254
	BUG_ON(event->type_len > RINGBUF_TYPE_DATA_TYPE_LEN_MAX);
S
Steven Rostedt 已提交
255
	/* If length is in len field, then array[0] has the data */
256
	if (event->type_len)
S
Steven Rostedt 已提交
257 258 259 260 261 262 263 264 265 266 267 268 269
		return (void *)&event->array[0];
	/* Otherwise length is in array[0] and array[1] has the data */
	return (void *)&event->array[1];
}

/**
 * ring_buffer_event_data - return the data of the event
 * @event: the event to get the data from
 */
void *ring_buffer_event_data(struct ring_buffer_event *event)
{
	return rb_event_data(event);
}
270
EXPORT_SYMBOL_GPL(ring_buffer_event_data);
S
Steven Rostedt 已提交
271 272

#define for_each_buffer_cpu(buffer, cpu)		\
273
	for_each_cpu(cpu, buffer->cpumask)
S
Steven Rostedt 已提交
274 275 276 277 278

#define TS_SHIFT	27
#define TS_MASK		((1ULL << TS_SHIFT) - 1)
#define TS_DELTA_TEST	(~TS_MASK)

279 280
/* Flag when events were overwritten */
#define RB_MISSED_EVENTS	(1 << 31)
281 282
/* Missed count stored at end */
#define RB_MISSED_STORED	(1 << 30)
283

284
struct buffer_data_page {
285
	u64		 time_stamp;	/* page time stamp */
W
Wenji Huang 已提交
286
	local_t		 commit;	/* write committed index */
287
	unsigned char	 data[] RB_ALIGN_DATA;	/* data of buffer page */
288 289
};

S
Steven Rostedt 已提交
290 291 292 293 294 295 296 297
/*
 * Note, the buffer_page list must be first. The buffer pages
 * are allocated in cache lines, which means that each buffer
 * page will be at the beginning of a cache line, and thus
 * the least significant bits will be zero. We use this to
 * add flags in the list struct pointers, to make the ring buffer
 * lockless.
 */
298
struct buffer_page {
299
	struct list_head list;		/* list of buffer pages */
300
	local_t		 write;		/* index for next write */
301
	unsigned	 read;		/* index for next read */
302
	local_t		 entries;	/* entries on this page */
303
	unsigned long	 real_end;	/* real end of data */
304
	struct buffer_data_page *page;	/* Actual data page */
S
Steven Rostedt 已提交
305 306
};

S
Steven Rostedt 已提交
307 308 309 310 311 312 313 314 315 316 317 318 319 320 321
/*
 * The buffer page counters, write and entries, must be reset
 * atomically when crossing page boundaries. To synchronize this
 * update, two counters are inserted into the number. One is
 * the actual counter for the write position or count on the page.
 *
 * The other is a counter of updaters. Before an update happens
 * the update partition of the counter is incremented. This will
 * allow the updater to update the counter atomically.
 *
 * The counter is 20 bits, and the state data is 12.
 */
#define RB_WRITE_MASK		0xfffff
#define RB_WRITE_INTCNT		(1 << 20)

322
static void rb_init_page(struct buffer_data_page *bpage)
323
{
324
	local_set(&bpage->commit, 0);
325 326
}

327 328 329 330 331 332
/**
 * ring_buffer_page_len - the size of data on the page.
 * @page: The page to read
 *
 * Returns the amount of data on the page, including buffer page header.
 */
333 334
size_t ring_buffer_page_len(void *page)
{
335 336
	return local_read(&((struct buffer_data_page *)page)->commit)
		+ BUF_PAGE_HDR_SIZE;
337 338
}

339 340 341 342
/*
 * Also stolen from mm/slob.c. Thanks to Mathieu Desnoyers for pointing
 * this issue out.
 */
343
static void free_buffer_page(struct buffer_page *bpage)
344
{
345
	free_page((unsigned long)bpage->page);
346
	kfree(bpage);
347 348
}

S
Steven Rostedt 已提交
349 350 351 352 353 354 355 356 357 358
/*
 * We need to fit the time_stamp delta into 27 bits.
 */
static inline int test_time_stamp(u64 delta)
{
	if (delta & TS_DELTA_TEST)
		return 1;
	return 0;
}

359
#define BUF_PAGE_SIZE (PAGE_SIZE - BUF_PAGE_HDR_SIZE)
S
Steven Rostedt 已提交
360

361 362 363
/* Max payload is BUF_PAGE_SIZE - header (8bytes) */
#define BUF_MAX_DATA_SIZE (BUF_PAGE_SIZE - (sizeof(u32) * 2))

364 365 366
int ring_buffer_print_page_header(struct trace_seq *s)
{
	struct buffer_data_page field;
367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391

	trace_seq_printf(s, "\tfield: u64 timestamp;\t"
			 "offset:0;\tsize:%u;\tsigned:%u;\n",
			 (unsigned int)sizeof(field.time_stamp),
			 (unsigned int)is_signed_type(u64));

	trace_seq_printf(s, "\tfield: local_t commit;\t"
			 "offset:%u;\tsize:%u;\tsigned:%u;\n",
			 (unsigned int)offsetof(typeof(field), commit),
			 (unsigned int)sizeof(field.commit),
			 (unsigned int)is_signed_type(long));

	trace_seq_printf(s, "\tfield: int overwrite;\t"
			 "offset:%u;\tsize:%u;\tsigned:%u;\n",
			 (unsigned int)offsetof(typeof(field), commit),
			 1,
			 (unsigned int)is_signed_type(long));

	trace_seq_printf(s, "\tfield: char data;\t"
			 "offset:%u;\tsize:%u;\tsigned:%u;\n",
			 (unsigned int)offsetof(typeof(field), data),
			 (unsigned int)BUF_PAGE_SIZE,
			 (unsigned int)is_signed_type(char));

	return !trace_seq_has_overflowed(s);
392 393
}

394 395 396
struct rb_irq_work {
	struct irq_work			work;
	wait_queue_head_t		waiters;
397
	wait_queue_head_t		full_waiters;
398
	bool				waiters_pending;
399 400
	bool				full_waiters_pending;
	bool				wakeup_full;
401 402
};

403 404 405 406 407 408 409 410 411 412 413
/*
 * Structure to hold event state and handle nested events.
 */
struct rb_event_info {
	u64			ts;
	u64			delta;
	unsigned long		length;
	struct buffer_page	*tail_page;
	int			add_timestamp;
};

414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430
/*
 * Used for which event context the event is in.
 *  NMI     = 0
 *  IRQ     = 1
 *  SOFTIRQ = 2
 *  NORMAL  = 3
 *
 * See trace_recursive_lock() comment below for more details.
 */
enum {
	RB_CTX_NMI,
	RB_CTX_IRQ,
	RB_CTX_SOFTIRQ,
	RB_CTX_NORMAL,
	RB_CTX_MAX
};

S
Steven Rostedt 已提交
431 432 433 434 435
/*
 * head_page == tail_page && head == tail then buffer is empty.
 */
struct ring_buffer_per_cpu {
	int				cpu;
436
	atomic_t			record_disabled;
S
Steven Rostedt 已提交
437
	struct ring_buffer		*buffer;
438
	raw_spinlock_t			reader_lock;	/* serialize readers */
439
	arch_spinlock_t			lock;
S
Steven Rostedt 已提交
440
	struct lock_class_key		lock_key;
441
	unsigned long			nr_pages;
442
	unsigned int			current_context;
443
	struct list_head		*pages;
444 445
	struct buffer_page		*head_page;	/* read from head */
	struct buffer_page		*tail_page;	/* write to tail */
W
Wenji Huang 已提交
446
	struct buffer_page		*commit_page;	/* committed pages */
447
	struct buffer_page		*reader_page;
448 449
	unsigned long			lost_events;
	unsigned long			last_overrun;
450
	local_t				entries_bytes;
451
	local_t				entries;
452 453 454
	local_t				overrun;
	local_t				commit_overrun;
	local_t				dropped_events;
455 456
	local_t				committing;
	local_t				commits;
S
Steven Rostedt 已提交
457
	unsigned long			read;
458
	unsigned long			read_bytes;
S
Steven Rostedt 已提交
459 460
	u64				write_stamp;
	u64				read_stamp;
461
	/* ring buffer pages to update, > 0 to add, < 0 to remove */
462
	long				nr_pages_to_update;
463
	struct list_head		new_pages; /* new pages to add */
464
	struct work_struct		update_pages_work;
465
	struct completion		update_done;
466 467

	struct rb_irq_work		irq_work;
S
Steven Rostedt 已提交
468 469 470 471 472 473
};

struct ring_buffer {
	unsigned			flags;
	int				cpus;
	atomic_t			record_disabled;
474
	atomic_t			resize_disabled;
475
	cpumask_var_t			cpumask;
S
Steven Rostedt 已提交
476

477 478
	struct lock_class_key		*reader_lock_key;

S
Steven Rostedt 已提交
479 480 481
	struct mutex			mutex;

	struct ring_buffer_per_cpu	**buffers;
482

483
	struct hlist_node		node;
484
	u64				(*clock)(void);
485 486

	struct rb_irq_work		irq_work;
S
Steven Rostedt 已提交
487 488 489 490 491 492
};

struct ring_buffer_iter {
	struct ring_buffer_per_cpu	*cpu_buffer;
	unsigned long			head;
	struct buffer_page		*head_page;
493 494
	struct buffer_page		*cache_reader_page;
	unsigned long			cache_read;
S
Steven Rostedt 已提交
495 496 497
	u64				read_stamp;
};

498 499 500 501 502 503 504 505 506 507 508
/*
 * rb_wake_up_waiters - wake up tasks waiting for ring buffer input
 *
 * Schedules a delayed work to wake up any task that is blocked on the
 * ring buffer waiters queue.
 */
static void rb_wake_up_waiters(struct irq_work *work)
{
	struct rb_irq_work *rbwork = container_of(work, struct rb_irq_work, work);

	wake_up_all(&rbwork->waiters);
509 510 511 512
	if (rbwork->wakeup_full) {
		rbwork->wakeup_full = false;
		wake_up_all(&rbwork->full_waiters);
	}
513 514 515 516 517 518
}

/**
 * ring_buffer_wait - wait for input to the ring buffer
 * @buffer: buffer to wait on
 * @cpu: the cpu buffer to wait on
519
 * @full: wait until a full page is available, if @cpu != RING_BUFFER_ALL_CPUS
520 521 522 523 524
 *
 * If @cpu == RING_BUFFER_ALL_CPUS then the task will wake up as soon
 * as data is added to any of the @buffer's cpu buffers. Otherwise
 * it will wait for data to be added to a specific cpu buffer.
 */
525
int ring_buffer_wait(struct ring_buffer *buffer, int cpu, bool full)
526
{
527
	struct ring_buffer_per_cpu *uninitialized_var(cpu_buffer);
528 529
	DEFINE_WAIT(wait);
	struct rb_irq_work *work;
530
	int ret = 0;
531 532 533 534 535 536

	/*
	 * Depending on what the caller is waiting for, either any
	 * data in any cpu buffer, or a specific buffer, put the
	 * caller on the appropriate wait queue.
	 */
537
	if (cpu == RING_BUFFER_ALL_CPUS) {
538
		work = &buffer->irq_work;
539 540 541
		/* Full only makes sense on per cpu reads */
		full = false;
	} else {
542 543
		if (!cpumask_test_cpu(cpu, buffer->cpumask))
			return -ENODEV;
544 545 546 547 548
		cpu_buffer = buffer->buffers[cpu];
		work = &cpu_buffer->irq_work;
	}


549
	while (true) {
550 551 552 553
		if (full)
			prepare_to_wait(&work->full_waiters, &wait, TASK_INTERRUPTIBLE);
		else
			prepare_to_wait(&work->waiters, &wait, TASK_INTERRUPTIBLE);
554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574

		/*
		 * The events can happen in critical sections where
		 * checking a work queue can cause deadlocks.
		 * After adding a task to the queue, this flag is set
		 * only to notify events to try to wake up the queue
		 * using irq_work.
		 *
		 * We don't clear it even if the buffer is no longer
		 * empty. The flag only causes the next event to run
		 * irq_work to do the work queue wake up. The worse
		 * that can happen if we race with !trace_empty() is that
		 * an event will cause an irq_work to try to wake up
		 * an empty queue.
		 *
		 * There's no reason to protect this flag either, as
		 * the work queue and irq_work logic will do the necessary
		 * synchronization for the wake ups. The only thing
		 * that is necessary is that the wake up happens after
		 * a task has been queued. It's OK for spurious wake ups.
		 */
575 576 577 578
		if (full)
			work->full_waiters_pending = true;
		else
			work->waiters_pending = true;
579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602

		if (signal_pending(current)) {
			ret = -EINTR;
			break;
		}

		if (cpu == RING_BUFFER_ALL_CPUS && !ring_buffer_empty(buffer))
			break;

		if (cpu != RING_BUFFER_ALL_CPUS &&
		    !ring_buffer_empty_cpu(buffer, cpu)) {
			unsigned long flags;
			bool pagebusy;

			if (!full)
				break;

			raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
			pagebusy = cpu_buffer->reader_page == cpu_buffer->commit_page;
			raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);

			if (!pagebusy)
				break;
		}
603 604

		schedule();
605
	}
606

607 608 609 610
	if (full)
		finish_wait(&work->full_waiters, &wait);
	else
		finish_wait(&work->waiters, &wait);
611 612

	return ret;
613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637
}

/**
 * ring_buffer_poll_wait - poll on buffer input
 * @buffer: buffer to wait on
 * @cpu: the cpu buffer to wait on
 * @filp: the file descriptor
 * @poll_table: The poll descriptor
 *
 * If @cpu == RING_BUFFER_ALL_CPUS then the task will wake up as soon
 * as data is added to any of the @buffer's cpu buffers. Otherwise
 * it will wait for data to be added to a specific cpu buffer.
 *
 * Returns POLLIN | POLLRDNORM if data exists in the buffers,
 * zero otherwise.
 */
int ring_buffer_poll_wait(struct ring_buffer *buffer, int cpu,
			  struct file *filp, poll_table *poll_table)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	struct rb_irq_work *work;

	if (cpu == RING_BUFFER_ALL_CPUS)
		work = &buffer->irq_work;
	else {
638 639 640
		if (!cpumask_test_cpu(cpu, buffer->cpumask))
			return -EINVAL;

641 642 643 644 645
		cpu_buffer = buffer->buffers[cpu];
		work = &cpu_buffer->irq_work;
	}

	poll_wait(filp, &work->waiters, poll_table);
646 647 648 649 650 651 652 653 654 655 656 657 658 659 660
	work->waiters_pending = true;
	/*
	 * There's a tight race between setting the waiters_pending and
	 * checking if the ring buffer is empty.  Once the waiters_pending bit
	 * is set, the next event will wake the task up, but we can get stuck
	 * if there's only a single event in.
	 *
	 * FIXME: Ideally, we need a memory barrier on the writer side as well,
	 * but adding a memory barrier to all events will cause too much of a
	 * performance hit in the fast path.  We only need a memory barrier when
	 * the buffer goes from empty to having content.  But as this race is
	 * extremely small, and it's not a problem if another event comes in, we
	 * will fix it later.
	 */
	smp_mb();
661 662 663 664 665 666 667

	if ((cpu == RING_BUFFER_ALL_CPUS && !ring_buffer_empty(buffer)) ||
	    (cpu != RING_BUFFER_ALL_CPUS && !ring_buffer_empty_cpu(buffer, cpu)))
		return POLLIN | POLLRDNORM;
	return 0;
}

668
/* buffer may be either ring_buffer or ring_buffer_per_cpu */
669 670 671 672 673 674 675 676 677 678 679 680 681
#define RB_WARN_ON(b, cond)						\
	({								\
		int _____ret = unlikely(cond);				\
		if (_____ret) {						\
			if (__same_type(*(b), struct ring_buffer_per_cpu)) { \
				struct ring_buffer_per_cpu *__b =	\
					(void *)b;			\
				atomic_inc(&__b->buffer->record_disabled); \
			} else						\
				atomic_inc(&b->record_disabled);	\
			WARN_ON(1);					\
		}							\
		_____ret;						\
S
Steven Rostedt 已提交
682
	})
683

684 685 686
/* Up this if you want to test the TIME_EXTENTS and normalization */
#define DEBUG_SHIFT 0

687
static inline u64 rb_time_stamp(struct ring_buffer *buffer)
688 689 690 691 692
{
	/* shift to debug/test normalization and TIME_EXTENTS */
	return buffer->clock() << DEBUG_SHIFT;
}

693 694 695 696 697
u64 ring_buffer_time_stamp(struct ring_buffer *buffer, int cpu)
{
	u64 time;

	preempt_disable_notrace();
698
	time = rb_time_stamp(buffer);
699 700 701 702 703 704 705 706 707 708 709 710 711 712
	preempt_enable_no_resched_notrace();

	return time;
}
EXPORT_SYMBOL_GPL(ring_buffer_time_stamp);

void ring_buffer_normalize_time_stamp(struct ring_buffer *buffer,
				      int cpu, u64 *ts)
{
	/* Just stupid testing the normalize function and deltas */
	*ts >>= DEBUG_SHIFT;
}
EXPORT_SYMBOL_GPL(ring_buffer_normalize_time_stamp);

S
Steven Rostedt 已提交
713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802
/*
 * Making the ring buffer lockless makes things tricky.
 * Although writes only happen on the CPU that they are on,
 * and they only need to worry about interrupts. Reads can
 * happen on any CPU.
 *
 * The reader page is always off the ring buffer, but when the
 * reader finishes with a page, it needs to swap its page with
 * a new one from the buffer. The reader needs to take from
 * the head (writes go to the tail). But if a writer is in overwrite
 * mode and wraps, it must push the head page forward.
 *
 * Here lies the problem.
 *
 * The reader must be careful to replace only the head page, and
 * not another one. As described at the top of the file in the
 * ASCII art, the reader sets its old page to point to the next
 * page after head. It then sets the page after head to point to
 * the old reader page. But if the writer moves the head page
 * during this operation, the reader could end up with the tail.
 *
 * We use cmpxchg to help prevent this race. We also do something
 * special with the page before head. We set the LSB to 1.
 *
 * When the writer must push the page forward, it will clear the
 * bit that points to the head page, move the head, and then set
 * the bit that points to the new head page.
 *
 * We also don't want an interrupt coming in and moving the head
 * page on another writer. Thus we use the second LSB to catch
 * that too. Thus:
 *
 * head->list->prev->next        bit 1          bit 0
 *                              -------        -------
 * Normal page                     0              0
 * Points to head page             0              1
 * New head page                   1              0
 *
 * Note we can not trust the prev pointer of the head page, because:
 *
 * +----+       +-----+        +-----+
 * |    |------>|  T  |---X--->|  N  |
 * |    |<------|     |        |     |
 * +----+       +-----+        +-----+
 *   ^                           ^ |
 *   |          +-----+          | |
 *   +----------|  R  |----------+ |
 *              |     |<-----------+
 *              +-----+
 *
 * Key:  ---X-->  HEAD flag set in pointer
 *         T      Tail page
 *         R      Reader page
 *         N      Next page
 *
 * (see __rb_reserve_next() to see where this happens)
 *
 *  What the above shows is that the reader just swapped out
 *  the reader page with a page in the buffer, but before it
 *  could make the new header point back to the new page added
 *  it was preempted by a writer. The writer moved forward onto
 *  the new page added by the reader and is about to move forward
 *  again.
 *
 *  You can see, it is legitimate for the previous pointer of
 *  the head (or any page) not to point back to itself. But only
 *  temporarially.
 */

#define RB_PAGE_NORMAL		0UL
#define RB_PAGE_HEAD		1UL
#define RB_PAGE_UPDATE		2UL


#define RB_FLAG_MASK		3UL

/* PAGE_MOVED is not part of the mask */
#define RB_PAGE_MOVED		4UL

/*
 * rb_list_head - remove any bit
 */
static struct list_head *rb_list_head(struct list_head *list)
{
	unsigned long val = (unsigned long)list;

	return (struct list_head *)(val & ~RB_FLAG_MASK);
}

/*
803
 * rb_is_head_page - test if the given page is the head page
S
Steven Rostedt 已提交
804 805 806 807 808 809
 *
 * Because the reader may move the head_page pointer, we can
 * not trust what the head page is (it may be pointing to
 * the reader page). But if the next page is a header page,
 * its flags will be non zero.
 */
810
static inline int
S
Steven Rostedt 已提交
811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830
rb_is_head_page(struct ring_buffer_per_cpu *cpu_buffer,
		struct buffer_page *page, struct list_head *list)
{
	unsigned long val;

	val = (unsigned long)list->next;

	if ((val & ~RB_FLAG_MASK) != (unsigned long)&page->list)
		return RB_PAGE_MOVED;

	return val & RB_FLAG_MASK;
}

/*
 * rb_is_reader_page
 *
 * The unique thing about the reader page, is that, if the
 * writer is ever on it, the previous pointer never points
 * back to the reader page.
 */
831
static bool rb_is_reader_page(struct buffer_page *page)
S
Steven Rostedt 已提交
832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902
{
	struct list_head *list = page->list.prev;

	return rb_list_head(list->next) != &page->list;
}

/*
 * rb_set_list_to_head - set a list_head to be pointing to head.
 */
static void rb_set_list_to_head(struct ring_buffer_per_cpu *cpu_buffer,
				struct list_head *list)
{
	unsigned long *ptr;

	ptr = (unsigned long *)&list->next;
	*ptr |= RB_PAGE_HEAD;
	*ptr &= ~RB_PAGE_UPDATE;
}

/*
 * rb_head_page_activate - sets up head page
 */
static void rb_head_page_activate(struct ring_buffer_per_cpu *cpu_buffer)
{
	struct buffer_page *head;

	head = cpu_buffer->head_page;
	if (!head)
		return;

	/*
	 * Set the previous list pointer to have the HEAD flag.
	 */
	rb_set_list_to_head(cpu_buffer, head->list.prev);
}

static void rb_list_head_clear(struct list_head *list)
{
	unsigned long *ptr = (unsigned long *)&list->next;

	*ptr &= ~RB_FLAG_MASK;
}

/*
 * rb_head_page_dactivate - clears head page ptr (for free list)
 */
static void
rb_head_page_deactivate(struct ring_buffer_per_cpu *cpu_buffer)
{
	struct list_head *hd;

	/* Go through the whole list and clear any pointers found. */
	rb_list_head_clear(cpu_buffer->pages);

	list_for_each(hd, cpu_buffer->pages)
		rb_list_head_clear(hd);
}

static int rb_head_page_set(struct ring_buffer_per_cpu *cpu_buffer,
			    struct buffer_page *head,
			    struct buffer_page *prev,
			    int old_flag, int new_flag)
{
	struct list_head *list;
	unsigned long val = (unsigned long)&head->list;
	unsigned long ret;

	list = &prev->list;

	val &= ~RB_FLAG_MASK;

903 904
	ret = cmpxchg((unsigned long *)&list->next,
		      val | old_flag, val | new_flag);
S
Steven Rostedt 已提交
905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995

	/* check if the reader took the page */
	if ((ret & ~RB_FLAG_MASK) != val)
		return RB_PAGE_MOVED;

	return ret & RB_FLAG_MASK;
}

static int rb_head_page_set_update(struct ring_buffer_per_cpu *cpu_buffer,
				   struct buffer_page *head,
				   struct buffer_page *prev,
				   int old_flag)
{
	return rb_head_page_set(cpu_buffer, head, prev,
				old_flag, RB_PAGE_UPDATE);
}

static int rb_head_page_set_head(struct ring_buffer_per_cpu *cpu_buffer,
				 struct buffer_page *head,
				 struct buffer_page *prev,
				 int old_flag)
{
	return rb_head_page_set(cpu_buffer, head, prev,
				old_flag, RB_PAGE_HEAD);
}

static int rb_head_page_set_normal(struct ring_buffer_per_cpu *cpu_buffer,
				   struct buffer_page *head,
				   struct buffer_page *prev,
				   int old_flag)
{
	return rb_head_page_set(cpu_buffer, head, prev,
				old_flag, RB_PAGE_NORMAL);
}

static inline void rb_inc_page(struct ring_buffer_per_cpu *cpu_buffer,
			       struct buffer_page **bpage)
{
	struct list_head *p = rb_list_head((*bpage)->list.next);

	*bpage = list_entry(p, struct buffer_page, list);
}

static struct buffer_page *
rb_set_head_page(struct ring_buffer_per_cpu *cpu_buffer)
{
	struct buffer_page *head;
	struct buffer_page *page;
	struct list_head *list;
	int i;

	if (RB_WARN_ON(cpu_buffer, !cpu_buffer->head_page))
		return NULL;

	/* sanity check */
	list = cpu_buffer->pages;
	if (RB_WARN_ON(cpu_buffer, rb_list_head(list->prev->next) != list))
		return NULL;

	page = head = cpu_buffer->head_page;
	/*
	 * It is possible that the writer moves the header behind
	 * where we started, and we miss in one loop.
	 * A second loop should grab the header, but we'll do
	 * three loops just because I'm paranoid.
	 */
	for (i = 0; i < 3; i++) {
		do {
			if (rb_is_head_page(cpu_buffer, page, page->list.prev)) {
				cpu_buffer->head_page = page;
				return page;
			}
			rb_inc_page(cpu_buffer, &page);
		} while (page != head);
	}

	RB_WARN_ON(cpu_buffer, 1);

	return NULL;
}

static int rb_head_page_replace(struct buffer_page *old,
				struct buffer_page *new)
{
	unsigned long *ptr = (unsigned long *)&old->list.prev->next;
	unsigned long val;
	unsigned long ret;

	val = *ptr & ~RB_FLAG_MASK;
	val |= RB_PAGE_HEAD;

996
	ret = cmpxchg(ptr, val, (unsigned long)&new->list);
S
Steven Rostedt 已提交
997 998 999 1000 1001 1002 1003

	return ret == val;
}

/*
 * rb_tail_page_update - move the tail page forward
 */
1004
static void rb_tail_page_update(struct ring_buffer_per_cpu *cpu_buffer,
S
Steven Rostedt 已提交
1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033
			       struct buffer_page *tail_page,
			       struct buffer_page *next_page)
{
	unsigned long old_entries;
	unsigned long old_write;

	/*
	 * The tail page now needs to be moved forward.
	 *
	 * We need to reset the tail page, but without messing
	 * with possible erasing of data brought in by interrupts
	 * that have moved the tail page and are currently on it.
	 *
	 * We add a counter to the write field to denote this.
	 */
	old_write = local_add_return(RB_WRITE_INTCNT, &next_page->write);
	old_entries = local_add_return(RB_WRITE_INTCNT, &next_page->entries);

	/*
	 * Just make sure we have seen our old_write and synchronize
	 * with any interrupts that come in.
	 */
	barrier();

	/*
	 * If the tail page is still the same as what we think
	 * it is, then it is up to us to update the tail
	 * pointer.
	 */
1034
	if (tail_page == READ_ONCE(cpu_buffer->tail_page)) {
S
Steven Rostedt 已提交
1035 1036 1037 1038 1039 1040 1041 1042
		/* Zero the write counter */
		unsigned long val = old_write & ~RB_WRITE_MASK;
		unsigned long eval = old_entries & ~RB_WRITE_MASK;

		/*
		 * This will only succeed if an interrupt did
		 * not come in and change it. In which case, we
		 * do not want to modify it.
1043 1044 1045 1046 1047
		 *
		 * We add (void) to let the compiler know that we do not care
		 * about the return value of these functions. We use the
		 * cmpxchg to only update if an interrupt did not already
		 * do it for us. If the cmpxchg fails, we don't care.
S
Steven Rostedt 已提交
1048
		 */
1049 1050
		(void)local_cmpxchg(&next_page->write, old_write, val);
		(void)local_cmpxchg(&next_page->entries, old_entries, eval);
S
Steven Rostedt 已提交
1051 1052 1053 1054 1055 1056 1057 1058

		/*
		 * No need to worry about races with clearing out the commit.
		 * it only can increment when a commit takes place. But that
		 * only happens in the outer most nested commit.
		 */
		local_set(&next_page->page->commit, 0);

1059 1060
		/* Again, either we update tail_page or an interrupt does */
		(void)cmpxchg(&cpu_buffer->tail_page, tail_page, next_page);
S
Steven Rostedt 已提交
1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087
	}
}

static int rb_check_bpage(struct ring_buffer_per_cpu *cpu_buffer,
			  struct buffer_page *bpage)
{
	unsigned long val = (unsigned long)bpage;

	if (RB_WARN_ON(cpu_buffer, val & RB_FLAG_MASK))
		return 1;

	return 0;
}

/**
 * rb_check_list - make sure a pointer to a list has the last bits zero
 */
static int rb_check_list(struct ring_buffer_per_cpu *cpu_buffer,
			 struct list_head *list)
{
	if (RB_WARN_ON(cpu_buffer, rb_list_head(list->prev) != list->prev))
		return 1;
	if (RB_WARN_ON(cpu_buffer, rb_list_head(list->next) != list->next))
		return 1;
	return 0;
}

S
Steven Rostedt 已提交
1088
/**
1089
 * rb_check_pages - integrity check of buffer pages
S
Steven Rostedt 已提交
1090 1091
 * @cpu_buffer: CPU buffer with pages to test
 *
W
Wenji Huang 已提交
1092
 * As a safety measure we check to make sure the data pages have not
S
Steven Rostedt 已提交
1093 1094 1095 1096
 * been corrupted.
 */
static int rb_check_pages(struct ring_buffer_per_cpu *cpu_buffer)
{
1097
	struct list_head *head = cpu_buffer->pages;
1098
	struct buffer_page *bpage, *tmp;
S
Steven Rostedt 已提交
1099

1100 1101 1102 1103
	/* Reset the head page if it exists */
	if (cpu_buffer->head_page)
		rb_set_head_page(cpu_buffer);

S
Steven Rostedt 已提交
1104 1105
	rb_head_page_deactivate(cpu_buffer);

S
Steven Rostedt 已提交
1106 1107 1108 1109
	if (RB_WARN_ON(cpu_buffer, head->next->prev != head))
		return -1;
	if (RB_WARN_ON(cpu_buffer, head->prev->next != head))
		return -1;
S
Steven Rostedt 已提交
1110

S
Steven Rostedt 已提交
1111 1112 1113
	if (rb_check_list(cpu_buffer, head))
		return -1;

1114
	list_for_each_entry_safe(bpage, tmp, head, list) {
S
Steven Rostedt 已提交
1115
		if (RB_WARN_ON(cpu_buffer,
1116
			       bpage->list.next->prev != &bpage->list))
S
Steven Rostedt 已提交
1117 1118
			return -1;
		if (RB_WARN_ON(cpu_buffer,
1119
			       bpage->list.prev->next != &bpage->list))
S
Steven Rostedt 已提交
1120
			return -1;
S
Steven Rostedt 已提交
1121 1122
		if (rb_check_list(cpu_buffer, &bpage->list))
			return -1;
S
Steven Rostedt 已提交
1123 1124
	}

S
Steven Rostedt 已提交
1125 1126
	rb_head_page_activate(cpu_buffer);

S
Steven Rostedt 已提交
1127 1128 1129
	return 0;
}

1130
static int __rb_allocate_pages(long nr_pages, struct list_head *pages, int cpu)
S
Steven Rostedt 已提交
1131
{
1132
	struct buffer_page *bpage, *tmp;
1133
	long i;
1134

S
Steven Rostedt 已提交
1135
	for (i = 0; i < nr_pages; i++) {
1136
		struct page *page;
1137 1138 1139 1140 1141
		/*
		 * __GFP_NORETRY flag makes sure that the allocation fails
		 * gracefully without invoking oom-killer and the system is
		 * not destabilized.
		 */
1142
		bpage = kzalloc_node(ALIGN(sizeof(*bpage), cache_line_size()),
1143
				    GFP_KERNEL | __GFP_NORETRY,
1144
				    cpu_to_node(cpu));
1145
		if (!bpage)
1146
			goto free_pages;
S
Steven Rostedt 已提交
1147

1148
		list_add(&bpage->list, pages);
S
Steven Rostedt 已提交
1149

1150
		page = alloc_pages_node(cpu_to_node(cpu),
1151
					GFP_KERNEL | __GFP_NORETRY, 0);
1152
		if (!page)
S
Steven Rostedt 已提交
1153
			goto free_pages;
1154
		bpage->page = page_address(page);
1155
		rb_init_page(bpage->page);
S
Steven Rostedt 已提交
1156 1157
	}

1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169
	return 0;

free_pages:
	list_for_each_entry_safe(bpage, tmp, pages, list) {
		list_del_init(&bpage->list);
		free_buffer_page(bpage);
	}

	return -ENOMEM;
}

static int rb_allocate_pages(struct ring_buffer_per_cpu *cpu_buffer,
1170
			     unsigned long nr_pages)
1171 1172 1173 1174 1175 1176 1177 1178
{
	LIST_HEAD(pages);

	WARN_ON(!nr_pages);

	if (__rb_allocate_pages(nr_pages, &pages, cpu_buffer->cpu))
		return -ENOMEM;

1179 1180 1181 1182 1183 1184 1185
	/*
	 * The ring buffer page list is a circular list that does not
	 * start and end with a list head. All page list items point to
	 * other pages.
	 */
	cpu_buffer->pages = pages.next;
	list_del(&pages);
S
Steven Rostedt 已提交
1186

1187 1188
	cpu_buffer->nr_pages = nr_pages;

S
Steven Rostedt 已提交
1189 1190 1191 1192 1193 1194
	rb_check_pages(cpu_buffer);

	return 0;
}

static struct ring_buffer_per_cpu *
1195
rb_allocate_cpu_buffer(struct ring_buffer *buffer, long nr_pages, int cpu)
S
Steven Rostedt 已提交
1196 1197
{
	struct ring_buffer_per_cpu *cpu_buffer;
1198
	struct buffer_page *bpage;
1199
	struct page *page;
S
Steven Rostedt 已提交
1200 1201 1202 1203 1204 1205 1206 1207 1208
	int ret;

	cpu_buffer = kzalloc_node(ALIGN(sizeof(*cpu_buffer), cache_line_size()),
				  GFP_KERNEL, cpu_to_node(cpu));
	if (!cpu_buffer)
		return NULL;

	cpu_buffer->cpu = cpu;
	cpu_buffer->buffer = buffer;
1209
	raw_spin_lock_init(&cpu_buffer->reader_lock);
1210
	lockdep_set_class(&cpu_buffer->reader_lock, buffer->reader_lock_key);
1211
	cpu_buffer->lock = (arch_spinlock_t)__ARCH_SPIN_LOCK_UNLOCKED;
1212
	INIT_WORK(&cpu_buffer->update_pages_work, update_pages_handler);
1213
	init_completion(&cpu_buffer->update_done);
1214
	init_irq_work(&cpu_buffer->irq_work.work, rb_wake_up_waiters);
1215
	init_waitqueue_head(&cpu_buffer->irq_work.waiters);
1216
	init_waitqueue_head(&cpu_buffer->irq_work.full_waiters);
S
Steven Rostedt 已提交
1217

1218
	bpage = kzalloc_node(ALIGN(sizeof(*bpage), cache_line_size()),
1219
			    GFP_KERNEL, cpu_to_node(cpu));
1220
	if (!bpage)
1221 1222
		goto fail_free_buffer;

S
Steven Rostedt 已提交
1223 1224
	rb_check_bpage(cpu_buffer, bpage);

1225
	cpu_buffer->reader_page = bpage;
1226 1227
	page = alloc_pages_node(cpu_to_node(cpu), GFP_KERNEL, 0);
	if (!page)
1228
		goto fail_free_reader;
1229
	bpage->page = page_address(page);
1230
	rb_init_page(bpage->page);
1231

1232
	INIT_LIST_HEAD(&cpu_buffer->reader_page->list);
1233
	INIT_LIST_HEAD(&cpu_buffer->new_pages);
1234

1235
	ret = rb_allocate_pages(cpu_buffer, nr_pages);
S
Steven Rostedt 已提交
1236
	if (ret < 0)
1237
		goto fail_free_reader;
S
Steven Rostedt 已提交
1238 1239

	cpu_buffer->head_page
1240
		= list_entry(cpu_buffer->pages, struct buffer_page, list);
S
Steven Rostedt 已提交
1241
	cpu_buffer->tail_page = cpu_buffer->commit_page = cpu_buffer->head_page;
S
Steven Rostedt 已提交
1242

S
Steven Rostedt 已提交
1243 1244
	rb_head_page_activate(cpu_buffer);

S
Steven Rostedt 已提交
1245 1246
	return cpu_buffer;

1247 1248 1249
 fail_free_reader:
	free_buffer_page(cpu_buffer->reader_page);

S
Steven Rostedt 已提交
1250 1251 1252 1253 1254 1255 1256
 fail_free_buffer:
	kfree(cpu_buffer);
	return NULL;
}

static void rb_free_cpu_buffer(struct ring_buffer_per_cpu *cpu_buffer)
{
1257
	struct list_head *head = cpu_buffer->pages;
1258
	struct buffer_page *bpage, *tmp;
S
Steven Rostedt 已提交
1259

1260 1261
	free_buffer_page(cpu_buffer->reader_page);

S
Steven Rostedt 已提交
1262 1263
	rb_head_page_deactivate(cpu_buffer);

1264 1265 1266 1267 1268 1269
	if (head) {
		list_for_each_entry_safe(bpage, tmp, head, list) {
			list_del_init(&bpage->list);
			free_buffer_page(bpage);
		}
		bpage = list_entry(head, struct buffer_page, list);
1270
		free_buffer_page(bpage);
S
Steven Rostedt 已提交
1271
	}
1272

S
Steven Rostedt 已提交
1273 1274 1275 1276
	kfree(cpu_buffer);
}

/**
1277
 * __ring_buffer_alloc - allocate a new ring_buffer
1278
 * @size: the size in bytes per cpu that is needed.
S
Steven Rostedt 已提交
1279 1280 1281 1282 1283 1284 1285
 * @flags: attributes to set for the ring buffer.
 *
 * Currently the only flag that is available is the RB_FL_OVERWRITE
 * flag. This flag means that the buffer will overwrite old data
 * when the buffer wraps. If this flag is not set, the buffer will
 * drop data when the tail hits the head.
 */
1286 1287
struct ring_buffer *__ring_buffer_alloc(unsigned long size, unsigned flags,
					struct lock_class_key *key)
S
Steven Rostedt 已提交
1288 1289
{
	struct ring_buffer *buffer;
1290
	long nr_pages;
S
Steven Rostedt 已提交
1291
	int bsize;
1292
	int cpu;
1293
	int ret;
S
Steven Rostedt 已提交
1294 1295 1296 1297 1298 1299 1300

	/* keep it in its own cache line */
	buffer = kzalloc(ALIGN(sizeof(*buffer), cache_line_size()),
			 GFP_KERNEL);
	if (!buffer)
		return NULL;

1301
	if (!zalloc_cpumask_var(&buffer->cpumask, GFP_KERNEL))
1302 1303
		goto fail_free_buffer;

1304
	nr_pages = DIV_ROUND_UP(size, BUF_PAGE_SIZE);
S
Steven Rostedt 已提交
1305
	buffer->flags = flags;
1306
	buffer->clock = trace_clock_local;
1307
	buffer->reader_lock_key = key;
S
Steven Rostedt 已提交
1308

1309
	init_irq_work(&buffer->irq_work.work, rb_wake_up_waiters);
1310
	init_waitqueue_head(&buffer->irq_work.waiters);
1311

S
Steven Rostedt 已提交
1312
	/* need at least two pages */
1313 1314
	if (nr_pages < 2)
		nr_pages = 2;
S
Steven Rostedt 已提交
1315 1316 1317 1318 1319 1320 1321

	buffer->cpus = nr_cpu_ids;

	bsize = sizeof(void *) * nr_cpu_ids;
	buffer->buffers = kzalloc(ALIGN(bsize, cache_line_size()),
				  GFP_KERNEL);
	if (!buffer->buffers)
1322
		goto fail_free_cpumask;
S
Steven Rostedt 已提交
1323

1324 1325 1326 1327 1328
	cpu = raw_smp_processor_id();
	cpumask_set_cpu(cpu, buffer->cpumask);
	buffer->buffers[cpu] = rb_allocate_cpu_buffer(buffer, nr_pages, cpu);
	if (!buffer->buffers[cpu])
		goto fail_free_buffers;
S
Steven Rostedt 已提交
1329

1330 1331 1332
	ret = cpuhp_state_add_instance(CPUHP_TRACE_RB_PREPARE, &buffer->node);
	if (ret < 0)
		goto fail_free_buffers;
1333

S
Steven Rostedt 已提交
1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344
	mutex_init(&buffer->mutex);

	return buffer;

 fail_free_buffers:
	for_each_buffer_cpu(buffer, cpu) {
		if (buffer->buffers[cpu])
			rb_free_cpu_buffer(buffer->buffers[cpu]);
	}
	kfree(buffer->buffers);

1345 1346 1347
 fail_free_cpumask:
	free_cpumask_var(buffer->cpumask);

S
Steven Rostedt 已提交
1348 1349 1350 1351
 fail_free_buffer:
	kfree(buffer);
	return NULL;
}
1352
EXPORT_SYMBOL_GPL(__ring_buffer_alloc);
S
Steven Rostedt 已提交
1353 1354 1355 1356 1357 1358 1359 1360 1361 1362

/**
 * ring_buffer_free - free a ring buffer.
 * @buffer: the buffer to free.
 */
void
ring_buffer_free(struct ring_buffer *buffer)
{
	int cpu;

1363
	cpuhp_state_remove_instance(CPUHP_TRACE_RB_PREPARE, &buffer->node);
1364

S
Steven Rostedt 已提交
1365 1366 1367
	for_each_buffer_cpu(buffer, cpu)
		rb_free_cpu_buffer(buffer->buffers[cpu]);

1368
	kfree(buffer->buffers);
1369 1370
	free_cpumask_var(buffer->cpumask);

S
Steven Rostedt 已提交
1371 1372
	kfree(buffer);
}
1373
EXPORT_SYMBOL_GPL(ring_buffer_free);
S
Steven Rostedt 已提交
1374

1375 1376 1377 1378 1379 1380
void ring_buffer_set_clock(struct ring_buffer *buffer,
			   u64 (*clock)(void))
{
	buffer->clock = clock;
}

S
Steven Rostedt 已提交
1381 1382
static void rb_reset_cpu(struct ring_buffer_per_cpu *cpu_buffer);

1383 1384 1385 1386 1387 1388 1389 1390 1391 1392
static inline unsigned long rb_page_entries(struct buffer_page *bpage)
{
	return local_read(&bpage->entries) & RB_WRITE_MASK;
}

static inline unsigned long rb_page_write(struct buffer_page *bpage)
{
	return local_read(&bpage->write) & RB_WRITE_MASK;
}

1393
static int
1394
rb_remove_pages(struct ring_buffer_per_cpu *cpu_buffer, unsigned long nr_pages)
S
Steven Rostedt 已提交
1395
{
1396 1397 1398
	struct list_head *tail_page, *to_remove, *next_page;
	struct buffer_page *to_remove_page, *tmp_iter_page;
	struct buffer_page *last_page, *first_page;
1399
	unsigned long nr_removed;
1400 1401 1402 1403
	unsigned long head_bit;
	int page_entries;

	head_bit = 0;
S
Steven Rostedt 已提交
1404

1405
	raw_spin_lock_irq(&cpu_buffer->reader_lock);
1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416
	atomic_inc(&cpu_buffer->record_disabled);
	/*
	 * We don't race with the readers since we have acquired the reader
	 * lock. We also don't race with writers after disabling recording.
	 * This makes it easy to figure out the first and the last page to be
	 * removed from the list. We unlink all the pages in between including
	 * the first and last pages. This is done in a busy loop so that we
	 * lose the least number of traces.
	 * The pages are freed after we restart recording and unlock readers.
	 */
	tail_page = &cpu_buffer->tail_page->list;
S
Steven Rostedt 已提交
1417

1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432
	/*
	 * tail page might be on reader page, we remove the next page
	 * from the ring buffer
	 */
	if (cpu_buffer->tail_page == cpu_buffer->reader_page)
		tail_page = rb_list_head(tail_page->next);
	to_remove = tail_page;

	/* start of pages to remove */
	first_page = list_entry(rb_list_head(to_remove->next),
				struct buffer_page, list);

	for (nr_removed = 0; nr_removed < nr_pages; nr_removed++) {
		to_remove = rb_list_head(to_remove)->next;
		head_bit |= (unsigned long)to_remove & RB_PAGE_HEAD;
S
Steven Rostedt 已提交
1433 1434
	}

1435
	next_page = rb_list_head(to_remove)->next;
S
Steven Rostedt 已提交
1436

1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462
	/*
	 * Now we remove all pages between tail_page and next_page.
	 * Make sure that we have head_bit value preserved for the
	 * next page
	 */
	tail_page->next = (struct list_head *)((unsigned long)next_page |
						head_bit);
	next_page = rb_list_head(next_page);
	next_page->prev = tail_page;

	/* make sure pages points to a valid page in the ring buffer */
	cpu_buffer->pages = next_page;

	/* update head page */
	if (head_bit)
		cpu_buffer->head_page = list_entry(next_page,
						struct buffer_page, list);

	/*
	 * change read pointer to make sure any read iterators reset
	 * themselves
	 */
	cpu_buffer->read = 0;

	/* pages are removed, resume tracing and then free the pages */
	atomic_dec(&cpu_buffer->record_disabled);
1463
	raw_spin_unlock_irq(&cpu_buffer->reader_lock);
1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482

	RB_WARN_ON(cpu_buffer, list_empty(cpu_buffer->pages));

	/* last buffer page to remove */
	last_page = list_entry(rb_list_head(to_remove), struct buffer_page,
				list);
	tmp_iter_page = first_page;

	do {
		to_remove_page = tmp_iter_page;
		rb_inc_page(cpu_buffer, &tmp_iter_page);

		/* update the counters */
		page_entries = rb_page_entries(to_remove_page);
		if (page_entries) {
			/*
			 * If something was added to this page, it was full
			 * since it is not the tail page. So we deduct the
			 * bytes consumed in ring buffer from here.
1483
			 * Increment overrun to account for the lost events.
1484
			 */
1485
			local_add(page_entries, &cpu_buffer->overrun);
1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498
			local_sub(BUF_PAGE_SIZE, &cpu_buffer->entries_bytes);
		}

		/*
		 * We have already removed references to this list item, just
		 * free up the buffer_page and its page
		 */
		free_buffer_page(to_remove_page);
		nr_removed--;

	} while (to_remove_page != last_page);

	RB_WARN_ON(cpu_buffer, nr_removed);
1499 1500

	return nr_removed == 0;
S
Steven Rostedt 已提交
1501 1502
}

1503 1504
static int
rb_insert_pages(struct ring_buffer_per_cpu *cpu_buffer)
S
Steven Rostedt 已提交
1505
{
1506 1507
	struct list_head *pages = &cpu_buffer->new_pages;
	int retries, success;
S
Steven Rostedt 已提交
1508

1509
	raw_spin_lock_irq(&cpu_buffer->reader_lock);
1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529
	/*
	 * We are holding the reader lock, so the reader page won't be swapped
	 * in the ring buffer. Now we are racing with the writer trying to
	 * move head page and the tail page.
	 * We are going to adapt the reader page update process where:
	 * 1. We first splice the start and end of list of new pages between
	 *    the head page and its previous page.
	 * 2. We cmpxchg the prev_page->next to point from head page to the
	 *    start of new pages list.
	 * 3. Finally, we update the head->prev to the end of new list.
	 *
	 * We will try this process 10 times, to make sure that we don't keep
	 * spinning.
	 */
	retries = 10;
	success = 0;
	while (retries--) {
		struct list_head *head_page, *prev_page, *r;
		struct list_head *last_page, *first_page;
		struct list_head *head_page_with_bit;
S
Steven Rostedt 已提交
1530

1531
		head_page = &rb_set_head_page(cpu_buffer)->list;
1532 1533
		if (!head_page)
			break;
1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556
		prev_page = head_page->prev;

		first_page = pages->next;
		last_page  = pages->prev;

		head_page_with_bit = (struct list_head *)
				     ((unsigned long)head_page | RB_PAGE_HEAD);

		last_page->next = head_page_with_bit;
		first_page->prev = prev_page;

		r = cmpxchg(&prev_page->next, head_page_with_bit, first_page);

		if (r == head_page_with_bit) {
			/*
			 * yay, we replaced the page pointer to our new list,
			 * now, we just have to update to head page's prev
			 * pointer to point to end of list
			 */
			head_page->prev = last_page;
			success = 1;
			break;
		}
S
Steven Rostedt 已提交
1557 1558
	}

1559 1560 1561 1562 1563 1564 1565
	if (success)
		INIT_LIST_HEAD(pages);
	/*
	 * If we weren't successful in adding in new pages, warn and stop
	 * tracing
	 */
	RB_WARN_ON(cpu_buffer, !success);
1566
	raw_spin_unlock_irq(&cpu_buffer->reader_lock);
1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577

	/* free pages if they weren't inserted */
	if (!success) {
		struct buffer_page *bpage, *tmp;
		list_for_each_entry_safe(bpage, tmp, &cpu_buffer->new_pages,
					 list) {
			list_del_init(&bpage->list);
			free_buffer_page(bpage);
		}
	}
	return success;
S
Steven Rostedt 已提交
1578 1579
}

1580
static void rb_update_pages(struct ring_buffer_per_cpu *cpu_buffer)
1581
{
1582 1583
	int success;

1584
	if (cpu_buffer->nr_pages_to_update > 0)
1585
		success = rb_insert_pages(cpu_buffer);
1586
	else
1587 1588
		success = rb_remove_pages(cpu_buffer,
					-cpu_buffer->nr_pages_to_update);
1589

1590 1591
	if (success)
		cpu_buffer->nr_pages += cpu_buffer->nr_pages_to_update;
1592 1593 1594 1595 1596 1597 1598
}

static void update_pages_handler(struct work_struct *work)
{
	struct ring_buffer_per_cpu *cpu_buffer = container_of(work,
			struct ring_buffer_per_cpu, update_pages_work);
	rb_update_pages(cpu_buffer);
1599
	complete(&cpu_buffer->update_done);
1600 1601
}

S
Steven Rostedt 已提交
1602 1603 1604 1605
/**
 * ring_buffer_resize - resize the ring buffer
 * @buffer: the buffer to resize.
 * @size: the new size.
1606
 * @cpu_id: the cpu buffer to resize
S
Steven Rostedt 已提交
1607 1608 1609
 *
 * Minimum size is 2 * BUF_PAGE_SIZE.
 *
1610
 * Returns 0 on success and < 0 on failure.
S
Steven Rostedt 已提交
1611
 */
1612 1613
int ring_buffer_resize(struct ring_buffer *buffer, unsigned long size,
			int cpu_id)
S
Steven Rostedt 已提交
1614 1615
{
	struct ring_buffer_per_cpu *cpu_buffer;
1616
	unsigned long nr_pages;
1617
	int cpu, err = 0;
S
Steven Rostedt 已提交
1618

1619 1620 1621 1622 1623 1624
	/*
	 * Always succeed at resizing a non-existent buffer:
	 */
	if (!buffer)
		return size;

1625 1626 1627 1628 1629
	/* Make sure the requested buffer exists */
	if (cpu_id != RING_BUFFER_ALL_CPUS &&
	    !cpumask_test_cpu(cpu_id, buffer->cpumask))
		return size;

1630
	nr_pages = DIV_ROUND_UP(size, BUF_PAGE_SIZE);
S
Steven Rostedt 已提交
1631 1632

	/* we need a minimum of two pages */
1633 1634
	if (nr_pages < 2)
		nr_pages = 2;
S
Steven Rostedt 已提交
1635

1636
	size = nr_pages * BUF_PAGE_SIZE;
1637

1638 1639 1640 1641 1642 1643 1644
	/*
	 * Don't succeed if resizing is disabled, as a reader might be
	 * manipulating the ring buffer and is expecting a sane state while
	 * this is true.
	 */
	if (atomic_read(&buffer->resize_disabled))
		return -EBUSY;
1645

1646
	/* prevent another thread from changing buffer sizes */
S
Steven Rostedt 已提交
1647 1648
	mutex_lock(&buffer->mutex);

1649 1650
	if (cpu_id == RING_BUFFER_ALL_CPUS) {
		/* calculate the pages to update */
S
Steven Rostedt 已提交
1651 1652 1653
		for_each_buffer_cpu(buffer, cpu) {
			cpu_buffer = buffer->buffers[cpu];

1654 1655 1656 1657 1658 1659 1660
			cpu_buffer->nr_pages_to_update = nr_pages -
							cpu_buffer->nr_pages;
			/*
			 * nothing more to do for removing pages or no update
			 */
			if (cpu_buffer->nr_pages_to_update <= 0)
				continue;
1661
			/*
1662 1663
			 * to add pages, make sure all new pages can be
			 * allocated without receiving ENOMEM
1664
			 */
1665 1666
			INIT_LIST_HEAD(&cpu_buffer->new_pages);
			if (__rb_allocate_pages(cpu_buffer->nr_pages_to_update,
1667
						&cpu_buffer->new_pages, cpu)) {
1668
				/* not enough memory for new pages */
1669 1670 1671 1672 1673 1674 1675 1676
				err = -ENOMEM;
				goto out_err;
			}
		}

		get_online_cpus();
		/*
		 * Fire off all the required work handlers
1677
		 * We can't schedule on offline CPUs, but it's not necessary
1678 1679 1680 1681
		 * since we can change their buffer sizes without any race.
		 */
		for_each_buffer_cpu(buffer, cpu) {
			cpu_buffer = buffer->buffers[cpu];
1682
			if (!cpu_buffer->nr_pages_to_update)
1683 1684
				continue;

1685 1686
			/* Can't run something on an offline CPU. */
			if (!cpu_online(cpu)) {
1687 1688 1689
				rb_update_pages(cpu_buffer);
				cpu_buffer->nr_pages_to_update = 0;
			} else {
1690 1691
				schedule_work_on(cpu,
						&cpu_buffer->update_pages_work);
1692
			}
S
Steven Rostedt 已提交
1693 1694
		}

1695 1696 1697
		/* wait for all the updates to complete */
		for_each_buffer_cpu(buffer, cpu) {
			cpu_buffer = buffer->buffers[cpu];
1698
			if (!cpu_buffer->nr_pages_to_update)
1699 1700
				continue;

1701 1702
			if (cpu_online(cpu))
				wait_for_completion(&cpu_buffer->update_done);
1703
			cpu_buffer->nr_pages_to_update = 0;
1704
		}
1705 1706

		put_online_cpus();
1707
	} else {
1708 1709 1710 1711
		/* Make sure this CPU has been intitialized */
		if (!cpumask_test_cpu(cpu_id, buffer->cpumask))
			goto out;

1712
		cpu_buffer = buffer->buffers[cpu_id];
1713

1714 1715
		if (nr_pages == cpu_buffer->nr_pages)
			goto out;
S
Steven Rostedt 已提交
1716

1717 1718 1719 1720 1721 1722
		cpu_buffer->nr_pages_to_update = nr_pages -
						cpu_buffer->nr_pages;

		INIT_LIST_HEAD(&cpu_buffer->new_pages);
		if (cpu_buffer->nr_pages_to_update > 0 &&
			__rb_allocate_pages(cpu_buffer->nr_pages_to_update,
1723 1724 1725 1726
					    &cpu_buffer->new_pages, cpu_id)) {
			err = -ENOMEM;
			goto out_err;
		}
1727

1728 1729
		get_online_cpus();

1730 1731
		/* Can't run something on an offline CPU. */
		if (!cpu_online(cpu_id))
1732 1733
			rb_update_pages(cpu_buffer);
		else {
1734 1735
			schedule_work_on(cpu_id,
					 &cpu_buffer->update_pages_work);
1736
			wait_for_completion(&cpu_buffer->update_done);
1737
		}
1738 1739

		cpu_buffer->nr_pages_to_update = 0;
1740
		put_online_cpus();
1741
	}
S
Steven Rostedt 已提交
1742 1743

 out:
1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766
	/*
	 * The ring buffer resize can happen with the ring buffer
	 * enabled, so that the update disturbs the tracing as little
	 * as possible. But if the buffer is disabled, we do not need
	 * to worry about that, and we can take the time to verify
	 * that the buffer is not corrupt.
	 */
	if (atomic_read(&buffer->record_disabled)) {
		atomic_inc(&buffer->record_disabled);
		/*
		 * Even though the buffer was disabled, we must make sure
		 * that it is truly disabled before calling rb_check_pages.
		 * There could have been a race between checking
		 * record_disable and incrementing it.
		 */
		synchronize_sched();
		for_each_buffer_cpu(buffer, cpu) {
			cpu_buffer = buffer->buffers[cpu];
			rb_check_pages(cpu_buffer);
		}
		atomic_dec(&buffer->record_disabled);
	}

S
Steven Rostedt 已提交
1767 1768 1769
	mutex_unlock(&buffer->mutex);
	return size;

1770
 out_err:
1771 1772
	for_each_buffer_cpu(buffer, cpu) {
		struct buffer_page *bpage, *tmp;
1773

1774 1775
		cpu_buffer = buffer->buffers[cpu];
		cpu_buffer->nr_pages_to_update = 0;
1776

1777 1778
		if (list_empty(&cpu_buffer->new_pages))
			continue;
1779

1780 1781 1782 1783 1784
		list_for_each_entry_safe(bpage, tmp, &cpu_buffer->new_pages,
					list) {
			list_del_init(&bpage->list);
			free_buffer_page(bpage);
		}
S
Steven Rostedt 已提交
1785
	}
1786
	mutex_unlock(&buffer->mutex);
1787
	return err;
S
Steven Rostedt 已提交
1788
}
1789
EXPORT_SYMBOL_GPL(ring_buffer_resize);
S
Steven Rostedt 已提交
1790

1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801
void ring_buffer_change_overwrite(struct ring_buffer *buffer, int val)
{
	mutex_lock(&buffer->mutex);
	if (val)
		buffer->flags |= RB_FL_OVERWRITE;
	else
		buffer->flags &= ~RB_FL_OVERWRITE;
	mutex_unlock(&buffer->mutex);
}
EXPORT_SYMBOL_GPL(ring_buffer_change_overwrite);

1802
static __always_inline void *
1803
__rb_data_page_index(struct buffer_data_page *bpage, unsigned index)
S
Steven Rostedt 已提交
1804
{
1805
	return bpage->data + index;
S
Steven Rostedt 已提交
1806 1807
}

1808
static __always_inline void *__rb_page_index(struct buffer_page *bpage, unsigned index)
S
Steven Rostedt 已提交
1809
{
1810
	return bpage->page->data + index;
S
Steven Rostedt 已提交
1811 1812
}

1813
static __always_inline struct ring_buffer_event *
1814
rb_reader_event(struct ring_buffer_per_cpu *cpu_buffer)
S
Steven Rostedt 已提交
1815
{
1816 1817 1818 1819
	return __rb_page_index(cpu_buffer->reader_page,
			       cpu_buffer->reader_page->read);
}

1820
static __always_inline struct ring_buffer_event *
S
Steven Rostedt 已提交
1821 1822
rb_iter_head_event(struct ring_buffer_iter *iter)
{
1823
	return __rb_page_index(iter->head_page, iter->head);
S
Steven Rostedt 已提交
1824 1825
}

1826
static __always_inline unsigned rb_page_commit(struct buffer_page *bpage)
S
Steven Rostedt 已提交
1827
{
1828
	return local_read(&bpage->page->commit);
S
Steven Rostedt 已提交
1829 1830
}

L
Lucas De Marchi 已提交
1831
/* Size is determined by what has been committed */
1832
static __always_inline unsigned rb_page_size(struct buffer_page *bpage)
S
Steven Rostedt 已提交
1833 1834 1835 1836
{
	return rb_page_commit(bpage);
}

1837
static __always_inline unsigned
S
Steven Rostedt 已提交
1838 1839 1840 1841 1842
rb_commit_index(struct ring_buffer_per_cpu *cpu_buffer)
{
	return rb_page_commit(cpu_buffer->commit_page);
}

1843
static __always_inline unsigned
S
Steven Rostedt 已提交
1844 1845 1846 1847
rb_event_index(struct ring_buffer_event *event)
{
	unsigned long addr = (unsigned long)event;

1848
	return (addr & ~PAGE_MASK) - BUF_PAGE_HDR_SIZE;
S
Steven Rostedt 已提交
1849 1850
}

1851
static void rb_inc_iter(struct ring_buffer_iter *iter)
1852 1853 1854 1855 1856 1857 1858 1859 1860 1861
{
	struct ring_buffer_per_cpu *cpu_buffer = iter->cpu_buffer;

	/*
	 * The iterator could be on the reader page (it starts there).
	 * But the head could have moved, since the reader was
	 * found. Check for this case and assign the iterator
	 * to the head page instead of next.
	 */
	if (iter->head_page == cpu_buffer->reader_page)
S
Steven Rostedt 已提交
1862
		iter->head_page = rb_set_head_page(cpu_buffer);
1863 1864 1865
	else
		rb_inc_page(cpu_buffer, &iter->head_page);

1866
	iter->read_stamp = iter->head_page->page->time_stamp;
S
Steven Rostedt 已提交
1867 1868 1869
	iter->head = 0;
}

S
Steven Rostedt 已提交
1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915
/*
 * rb_handle_head_page - writer hit the head page
 *
 * Returns: +1 to retry page
 *           0 to continue
 *          -1 on error
 */
static int
rb_handle_head_page(struct ring_buffer_per_cpu *cpu_buffer,
		    struct buffer_page *tail_page,
		    struct buffer_page *next_page)
{
	struct buffer_page *new_head;
	int entries;
	int type;
	int ret;

	entries = rb_page_entries(next_page);

	/*
	 * The hard part is here. We need to move the head
	 * forward, and protect against both readers on
	 * other CPUs and writers coming in via interrupts.
	 */
	type = rb_head_page_set_update(cpu_buffer, next_page, tail_page,
				       RB_PAGE_HEAD);

	/*
	 * type can be one of four:
	 *  NORMAL - an interrupt already moved it for us
	 *  HEAD   - we are the first to get here.
	 *  UPDATE - we are the interrupt interrupting
	 *           a current move.
	 *  MOVED  - a reader on another CPU moved the next
	 *           pointer to its reader page. Give up
	 *           and try again.
	 */

	switch (type) {
	case RB_PAGE_HEAD:
		/*
		 * We changed the head to UPDATE, thus
		 * it is our responsibility to update
		 * the counters.
		 */
		local_add(entries, &cpu_buffer->overrun);
1916
		local_sub(BUF_PAGE_SIZE, &cpu_buffer->entries_bytes);
S
Steven Rostedt 已提交
1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999

		/*
		 * The entries will be zeroed out when we move the
		 * tail page.
		 */

		/* still more to do */
		break;

	case RB_PAGE_UPDATE:
		/*
		 * This is an interrupt that interrupt the
		 * previous update. Still more to do.
		 */
		break;
	case RB_PAGE_NORMAL:
		/*
		 * An interrupt came in before the update
		 * and processed this for us.
		 * Nothing left to do.
		 */
		return 1;
	case RB_PAGE_MOVED:
		/*
		 * The reader is on another CPU and just did
		 * a swap with our next_page.
		 * Try again.
		 */
		return 1;
	default:
		RB_WARN_ON(cpu_buffer, 1); /* WTF??? */
		return -1;
	}

	/*
	 * Now that we are here, the old head pointer is
	 * set to UPDATE. This will keep the reader from
	 * swapping the head page with the reader page.
	 * The reader (on another CPU) will spin till
	 * we are finished.
	 *
	 * We just need to protect against interrupts
	 * doing the job. We will set the next pointer
	 * to HEAD. After that, we set the old pointer
	 * to NORMAL, but only if it was HEAD before.
	 * otherwise we are an interrupt, and only
	 * want the outer most commit to reset it.
	 */
	new_head = next_page;
	rb_inc_page(cpu_buffer, &new_head);

	ret = rb_head_page_set_head(cpu_buffer, new_head, next_page,
				    RB_PAGE_NORMAL);

	/*
	 * Valid returns are:
	 *  HEAD   - an interrupt came in and already set it.
	 *  NORMAL - One of two things:
	 *            1) We really set it.
	 *            2) A bunch of interrupts came in and moved
	 *               the page forward again.
	 */
	switch (ret) {
	case RB_PAGE_HEAD:
	case RB_PAGE_NORMAL:
		/* OK */
		break;
	default:
		RB_WARN_ON(cpu_buffer, 1);
		return -1;
	}

	/*
	 * It is possible that an interrupt came in,
	 * set the head up, then more interrupts came in
	 * and moved it again. When we get back here,
	 * the page would have been set to NORMAL but we
	 * just set it back to HEAD.
	 *
	 * How do you detect this? Well, if that happened
	 * the tail page would have moved.
	 */
	if (ret == RB_PAGE_NORMAL) {
2000 2001 2002
		struct buffer_page *buffer_tail_page;

		buffer_tail_page = READ_ONCE(cpu_buffer->tail_page);
S
Steven Rostedt 已提交
2003 2004 2005 2006
		/*
		 * If the tail had moved passed next, then we need
		 * to reset the pointer.
		 */
2007 2008
		if (buffer_tail_page != tail_page &&
		    buffer_tail_page != next_page)
S
Steven Rostedt 已提交
2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030
			rb_head_page_set_normal(cpu_buffer, new_head,
						next_page,
						RB_PAGE_HEAD);
	}

	/*
	 * If this was the outer most commit (the one that
	 * changed the original pointer from HEAD to UPDATE),
	 * then it is up to us to reset it to NORMAL.
	 */
	if (type == RB_PAGE_HEAD) {
		ret = rb_head_page_set_normal(cpu_buffer, next_page,
					      tail_page,
					      RB_PAGE_UPDATE);
		if (RB_WARN_ON(cpu_buffer,
			       ret != RB_PAGE_UPDATE))
			return -1;
	}

	return 0;
}

2031 2032
static inline void
rb_reset_tail(struct ring_buffer_per_cpu *cpu_buffer,
2033
	      unsigned long tail, struct rb_event_info *info)
2034
{
2035
	struct buffer_page *tail_page = info->tail_page;
2036
	struct ring_buffer_event *event;
2037
	unsigned long length = info->length;
2038 2039 2040 2041 2042 2043

	/*
	 * Only the event that crossed the page boundary
	 * must fill the old tail_page with padding.
	 */
	if (tail >= BUF_PAGE_SIZE) {
2044 2045 2046 2047 2048 2049 2050 2051
		/*
		 * If the page was filled, then we still need
		 * to update the real_end. Reset it to zero
		 * and the reader will ignore it.
		 */
		if (tail == BUF_PAGE_SIZE)
			tail_page->real_end = 0;

2052 2053 2054 2055 2056
		local_sub(length, &tail_page->write);
		return;
	}

	event = __rb_page_index(tail_page, tail);
2057
	kmemcheck_annotate_bitfield(event, bitfield);
2058

2059 2060 2061
	/* account for padding bytes */
	local_add(BUF_PAGE_SIZE - tail, &cpu_buffer->entries_bytes);

2062 2063 2064 2065 2066 2067 2068
	/*
	 * Save the original length to the meta data.
	 * This will be used by the reader to add lost event
	 * counter.
	 */
	tail_page->real_end = tail;

2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100
	/*
	 * If this event is bigger than the minimum size, then
	 * we need to be careful that we don't subtract the
	 * write counter enough to allow another writer to slip
	 * in on this page.
	 * We put in a discarded commit instead, to make sure
	 * that this space is not used again.
	 *
	 * If we are less than the minimum size, we don't need to
	 * worry about it.
	 */
	if (tail > (BUF_PAGE_SIZE - RB_EVNT_MIN_SIZE)) {
		/* No room for any events */

		/* Mark the rest of the page with padding */
		rb_event_set_padding(event);

		/* Set the write back to the previous setting */
		local_sub(length, &tail_page->write);
		return;
	}

	/* Put in a discarded event */
	event->array[0] = (BUF_PAGE_SIZE - tail) - RB_EVNT_HDR_SIZE;
	event->type_len = RINGBUF_TYPE_PADDING;
	/* time delta must be non zero */
	event->time_delta = 1;

	/* Set write to end of buffer */
	length = (tail + length) - BUF_PAGE_SIZE;
	local_sub(length, &tail_page->write);
}
2101

2102 2103
static inline void rb_end_commit(struct ring_buffer_per_cpu *cpu_buffer);

2104 2105 2106 2107
/*
 * This is the slow path, force gcc not to inline it.
 */
static noinline struct ring_buffer_event *
2108
rb_move_tail(struct ring_buffer_per_cpu *cpu_buffer,
2109
	     unsigned long tail, struct rb_event_info *info)
S
Steven Rostedt 已提交
2110
{
2111
	struct buffer_page *tail_page = info->tail_page;
2112
	struct buffer_page *commit_page = cpu_buffer->commit_page;
S
Steven Rostedt 已提交
2113
	struct ring_buffer *buffer = cpu_buffer->buffer;
S
Steven Rostedt 已提交
2114 2115
	struct buffer_page *next_page;
	int ret;
2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126

	next_page = tail_page;

	rb_inc_page(cpu_buffer, &next_page);

	/*
	 * If for some reason, we had an interrupt storm that made
	 * it all the way around the buffer, bail, and warn
	 * about it.
	 */
	if (unlikely(next_page == commit_page)) {
S
Steven Rostedt 已提交
2127
		local_inc(&cpu_buffer->commit_overrun);
2128 2129 2130
		goto out_reset;
	}

S
Steven Rostedt 已提交
2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145
	/*
	 * This is where the fun begins!
	 *
	 * We are fighting against races between a reader that
	 * could be on another CPU trying to swap its reader
	 * page with the buffer head.
	 *
	 * We are also fighting against interrupts coming in and
	 * moving the head or tail on us as well.
	 *
	 * If the next page is the head page then we have filled
	 * the buffer, unless the commit page is still on the
	 * reader page.
	 */
	if (rb_is_head_page(cpu_buffer, next_page, &tail_page->list)) {
2146

S
Steven Rostedt 已提交
2147 2148 2149 2150 2151 2152 2153 2154 2155
		/*
		 * If the commit is not on the reader page, then
		 * move the header page.
		 */
		if (!rb_is_reader_page(cpu_buffer->commit_page)) {
			/*
			 * If we are not in overwrite mode,
			 * this is easy, just stop here.
			 */
2156 2157
			if (!(buffer->flags & RB_FL_OVERWRITE)) {
				local_inc(&cpu_buffer->dropped_events);
S
Steven Rostedt 已提交
2158
				goto out_reset;
2159
			}
S
Steven Rostedt 已提交
2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185

			ret = rb_handle_head_page(cpu_buffer,
						  tail_page,
						  next_page);
			if (ret < 0)
				goto out_reset;
			if (ret)
				goto out_again;
		} else {
			/*
			 * We need to be careful here too. The
			 * commit page could still be on the reader
			 * page. We could have a small buffer, and
			 * have filled up the buffer with events
			 * from interrupts and such, and wrapped.
			 *
			 * Note, if the tail page is also the on the
			 * reader_page, we let it move out.
			 */
			if (unlikely((cpu_buffer->commit_page !=
				      cpu_buffer->tail_page) &&
				     (cpu_buffer->commit_page ==
				      cpu_buffer->reader_page))) {
				local_inc(&cpu_buffer->commit_overrun);
				goto out_reset;
			}
2186 2187 2188
		}
	}

2189
	rb_tail_page_update(cpu_buffer, tail_page, next_page);
2190

S
Steven Rostedt 已提交
2191
 out_again:
2192

2193
	rb_reset_tail(cpu_buffer, tail, info);
2194

2195 2196 2197 2198 2199
	/* Commit what we have for now. */
	rb_end_commit(cpu_buffer);
	/* rb_end_commit() decs committing */
	local_inc(&cpu_buffer->committing);

2200 2201 2202
	/* fail and let the caller try again */
	return ERR_PTR(-EAGAIN);

2203
 out_reset:
2204
	/* reset write */
2205
	rb_reset_tail(cpu_buffer, tail, info);
2206

S
Steven Rostedt 已提交
2207
	return NULL;
S
Steven Rostedt 已提交
2208 2209
}

2210 2211 2212
/* Slow path, do not inline */
static noinline struct ring_buffer_event *
rb_add_time_stamp(struct ring_buffer_event *event, u64 delta)
2213
{
2214
	event->type_len = RINGBUF_TYPE_TIME_EXTEND;
2215

2216 2217 2218 2219 2220 2221 2222 2223 2224
	/* Not the first event on the page? */
	if (rb_event_index(event)) {
		event->time_delta = delta & TS_MASK;
		event->array[0] = delta >> TS_SHIFT;
	} else {
		/* nope, just zero it */
		event->time_delta = 0;
		event->array[0] = 0;
	}
2225

2226 2227
	return skip_time_extend(event);
}
2228

2229
static inline bool rb_event_is_commit(struct ring_buffer_per_cpu *cpu_buffer,
2230 2231
				     struct ring_buffer_event *event);

2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242
/**
 * rb_update_event - update event type and data
 * @event: the event to update
 * @type: the type of event
 * @length: the size of the event field in the ring buffer
 *
 * Update the type and data fields of the event. The length
 * is the actual size that is written to the ring buffer,
 * and with this, we can determine what to place into the
 * data field.
 */
2243
static void
2244 2245 2246 2247 2248 2249
rb_update_event(struct ring_buffer_per_cpu *cpu_buffer,
		struct ring_buffer_event *event,
		struct rb_event_info *info)
{
	unsigned length = info->length;
	u64 delta = info->delta;
2250

2251 2252 2253 2254
	/* Only a commit updates the timestamp */
	if (unlikely(!rb_event_is_commit(cpu_buffer, event)))
		delta = 0;

2255
	/*
2256 2257
	 * If we need to add a timestamp, then we
	 * add it to the start of the resevered space.
2258
	 */
2259 2260 2261 2262
	if (unlikely(info->add_timestamp)) {
		event = rb_add_time_stamp(event, delta);
		length -= RB_LEN_TIME_EXTEND;
		delta = 0;
2263 2264
	}

2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326
	event->time_delta = delta;
	length -= RB_EVNT_HDR_SIZE;
	if (length > RB_MAX_SMALL_DATA || RB_FORCE_8BYTE_ALIGNMENT) {
		event->type_len = 0;
		event->array[0] = length;
	} else
		event->type_len = DIV_ROUND_UP(length, RB_ALIGNMENT);
}

static unsigned rb_calculate_event_length(unsigned length)
{
	struct ring_buffer_event event; /* Used only for sizeof array */

	/* zero length can cause confusions */
	if (!length)
		length++;

	if (length > RB_MAX_SMALL_DATA || RB_FORCE_8BYTE_ALIGNMENT)
		length += sizeof(event.array[0]);

	length += RB_EVNT_HDR_SIZE;
	length = ALIGN(length, RB_ARCH_ALIGNMENT);

	/*
	 * In case the time delta is larger than the 27 bits for it
	 * in the header, we need to add a timestamp. If another
	 * event comes in when trying to discard this one to increase
	 * the length, then the timestamp will be added in the allocated
	 * space of this event. If length is bigger than the size needed
	 * for the TIME_EXTEND, then padding has to be used. The events
	 * length must be either RB_LEN_TIME_EXTEND, or greater than or equal
	 * to RB_LEN_TIME_EXTEND + 8, as 8 is the minimum size for padding.
	 * As length is a multiple of 4, we only need to worry if it
	 * is 12 (RB_LEN_TIME_EXTEND + 4).
	 */
	if (length == RB_LEN_TIME_EXTEND + RB_ALIGNMENT)
		length += RB_ALIGNMENT;

	return length;
}

#ifndef CONFIG_HAVE_UNSTABLE_SCHED_CLOCK
static inline bool sched_clock_stable(void)
{
	return true;
}
#endif

static inline int
rb_try_to_discard(struct ring_buffer_per_cpu *cpu_buffer,
		  struct ring_buffer_event *event)
{
	unsigned long new_index, old_index;
	struct buffer_page *bpage;
	unsigned long index;
	unsigned long addr;

	new_index = rb_event_index(event);
	old_index = new_index + rb_event_ts_length(event);
	addr = (unsigned long)event;
	addr &= PAGE_MASK;

2327
	bpage = READ_ONCE(cpu_buffer->tail_page);
2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358

	if (bpage->page == (void *)addr && rb_page_write(bpage) == old_index) {
		unsigned long write_mask =
			local_read(&bpage->write) & ~RB_WRITE_MASK;
		unsigned long event_length = rb_event_length(event);
		/*
		 * This is on the tail page. It is possible that
		 * a write could come in and move the tail page
		 * and write to the next page. That is fine
		 * because we just shorten what is on this page.
		 */
		old_index += write_mask;
		new_index += write_mask;
		index = local_cmpxchg(&bpage->write, old_index, new_index);
		if (index == old_index) {
			/* update counters */
			local_sub(event_length, &cpu_buffer->entries_bytes);
			return 1;
		}
	}

	/* could not discard */
	return 0;
}

static void rb_start_commit(struct ring_buffer_per_cpu *cpu_buffer)
{
	local_inc(&cpu_buffer->committing);
	local_inc(&cpu_buffer->commits);
}

2359
static __always_inline void
2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374
rb_set_commit_to_write(struct ring_buffer_per_cpu *cpu_buffer)
{
	unsigned long max_count;

	/*
	 * We only race with interrupts and NMIs on this CPU.
	 * If we own the commit event, then we can commit
	 * all others that interrupted us, since the interruptions
	 * are in stack format (they finish before they come
	 * back to us). This allows us to do a simple loop to
	 * assign the commit to the tail.
	 */
 again:
	max_count = cpu_buffer->nr_pages * 100;

2375
	while (cpu_buffer->commit_page != READ_ONCE(cpu_buffer->tail_page)) {
2376 2377 2378 2379 2380 2381 2382 2383
		if (RB_WARN_ON(cpu_buffer, !(--max_count)))
			return;
		if (RB_WARN_ON(cpu_buffer,
			       rb_is_reader_page(cpu_buffer->tail_page)))
			return;
		local_set(&cpu_buffer->commit_page->page->commit,
			  rb_page_write(cpu_buffer->commit_page));
		rb_inc_page(cpu_buffer, &cpu_buffer->commit_page);
2384 2385 2386 2387
		/* Only update the write stamp if the page has an event */
		if (rb_page_write(cpu_buffer->commit_page))
			cpu_buffer->write_stamp =
				cpu_buffer->commit_page->page->time_stamp;
2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409
		/* add barrier to keep gcc from optimizing too much */
		barrier();
	}
	while (rb_commit_index(cpu_buffer) !=
	       rb_page_write(cpu_buffer->commit_page)) {

		local_set(&cpu_buffer->commit_page->page->commit,
			  rb_page_write(cpu_buffer->commit_page));
		RB_WARN_ON(cpu_buffer,
			   local_read(&cpu_buffer->commit_page->page->commit) &
			   ~RB_WRITE_MASK);
		barrier();
	}

	/* again, keep gcc from optimizing */
	barrier();

	/*
	 * If an interrupt came in just after the first while loop
	 * and pushed the tail page forward, we will be left with
	 * a dangling commit that will never go forward.
	 */
2410
	if (unlikely(cpu_buffer->commit_page != READ_ONCE(cpu_buffer->tail_page)))
2411 2412 2413
		goto again;
}

2414
static __always_inline void rb_end_commit(struct ring_buffer_per_cpu *cpu_buffer)
2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458
{
	unsigned long commits;

	if (RB_WARN_ON(cpu_buffer,
		       !local_read(&cpu_buffer->committing)))
		return;

 again:
	commits = local_read(&cpu_buffer->commits);
	/* synchronize with interrupts */
	barrier();
	if (local_read(&cpu_buffer->committing) == 1)
		rb_set_commit_to_write(cpu_buffer);

	local_dec(&cpu_buffer->committing);

	/* synchronize with interrupts */
	barrier();

	/*
	 * Need to account for interrupts coming in between the
	 * updating of the commit page and the clearing of the
	 * committing counter.
	 */
	if (unlikely(local_read(&cpu_buffer->commits) != commits) &&
	    !local_read(&cpu_buffer->committing)) {
		local_inc(&cpu_buffer->committing);
		goto again;
	}
}

static inline void rb_event_discard(struct ring_buffer_event *event)
{
	if (event->type_len == RINGBUF_TYPE_TIME_EXTEND)
		event = skip_time_extend(event);

	/* array[0] holds the actual length for the discarded event */
	event->array[0] = rb_event_data_length(event) - RB_EVNT_HDR_SIZE;
	event->type_len = RINGBUF_TYPE_PADDING;
	/* time delta must be non zero */
	if (!event->time_delta)
		event->time_delta = 1;
}

2459
static __always_inline bool
2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471 2472
rb_event_is_commit(struct ring_buffer_per_cpu *cpu_buffer,
		   struct ring_buffer_event *event)
{
	unsigned long addr = (unsigned long)event;
	unsigned long index;

	index = rb_event_index(event);
	addr &= PAGE_MASK;

	return cpu_buffer->commit_page->page == (void *)addr &&
		rb_commit_index(cpu_buffer) == index;
}

2473
static __always_inline void
2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646
rb_update_write_stamp(struct ring_buffer_per_cpu *cpu_buffer,
		      struct ring_buffer_event *event)
{
	u64 delta;

	/*
	 * The event first in the commit queue updates the
	 * time stamp.
	 */
	if (rb_event_is_commit(cpu_buffer, event)) {
		/*
		 * A commit event that is first on a page
		 * updates the write timestamp with the page stamp
		 */
		if (!rb_event_index(event))
			cpu_buffer->write_stamp =
				cpu_buffer->commit_page->page->time_stamp;
		else if (event->type_len == RINGBUF_TYPE_TIME_EXTEND) {
			delta = event->array[0];
			delta <<= TS_SHIFT;
			delta += event->time_delta;
			cpu_buffer->write_stamp += delta;
		} else
			cpu_buffer->write_stamp += event->time_delta;
	}
}

static void rb_commit(struct ring_buffer_per_cpu *cpu_buffer,
		      struct ring_buffer_event *event)
{
	local_inc(&cpu_buffer->entries);
	rb_update_write_stamp(cpu_buffer, event);
	rb_end_commit(cpu_buffer);
}

static __always_inline void
rb_wakeups(struct ring_buffer *buffer, struct ring_buffer_per_cpu *cpu_buffer)
{
	bool pagebusy;

	if (buffer->irq_work.waiters_pending) {
		buffer->irq_work.waiters_pending = false;
		/* irq_work_queue() supplies it's own memory barriers */
		irq_work_queue(&buffer->irq_work.work);
	}

	if (cpu_buffer->irq_work.waiters_pending) {
		cpu_buffer->irq_work.waiters_pending = false;
		/* irq_work_queue() supplies it's own memory barriers */
		irq_work_queue(&cpu_buffer->irq_work.work);
	}

	pagebusy = cpu_buffer->reader_page == cpu_buffer->commit_page;

	if (!pagebusy && cpu_buffer->irq_work.full_waiters_pending) {
		cpu_buffer->irq_work.wakeup_full = true;
		cpu_buffer->irq_work.full_waiters_pending = false;
		/* irq_work_queue() supplies it's own memory barriers */
		irq_work_queue(&cpu_buffer->irq_work.work);
	}
}

/*
 * The lock and unlock are done within a preempt disable section.
 * The current_context per_cpu variable can only be modified
 * by the current task between lock and unlock. But it can
 * be modified more than once via an interrupt. To pass this
 * information from the lock to the unlock without having to
 * access the 'in_interrupt()' functions again (which do show
 * a bit of overhead in something as critical as function tracing,
 * we use a bitmask trick.
 *
 *  bit 0 =  NMI context
 *  bit 1 =  IRQ context
 *  bit 2 =  SoftIRQ context
 *  bit 3 =  normal context.
 *
 * This works because this is the order of contexts that can
 * preempt other contexts. A SoftIRQ never preempts an IRQ
 * context.
 *
 * When the context is determined, the corresponding bit is
 * checked and set (if it was set, then a recursion of that context
 * happened).
 *
 * On unlock, we need to clear this bit. To do so, just subtract
 * 1 from the current_context and AND it to itself.
 *
 * (binary)
 *  101 - 1 = 100
 *  101 & 100 = 100 (clearing bit zero)
 *
 *  1010 - 1 = 1001
 *  1010 & 1001 = 1000 (clearing bit 1)
 *
 * The least significant bit can be cleared this way, and it
 * just so happens that it is the same bit corresponding to
 * the current context.
 */

static __always_inline int
trace_recursive_lock(struct ring_buffer_per_cpu *cpu_buffer)
{
	unsigned int val = cpu_buffer->current_context;
	int bit;

	if (in_interrupt()) {
		if (in_nmi())
			bit = RB_CTX_NMI;
		else if (in_irq())
			bit = RB_CTX_IRQ;
		else
			bit = RB_CTX_SOFTIRQ;
	} else
		bit = RB_CTX_NORMAL;

	if (unlikely(val & (1 << bit)))
		return 1;

	val |= (1 << bit);
	cpu_buffer->current_context = val;

	return 0;
}

static __always_inline void
trace_recursive_unlock(struct ring_buffer_per_cpu *cpu_buffer)
{
	cpu_buffer->current_context &= cpu_buffer->current_context - 1;
}

/**
 * ring_buffer_unlock_commit - commit a reserved
 * @buffer: The buffer to commit to
 * @event: The event pointer to commit.
 *
 * This commits the data to the ring buffer, and releases any locks held.
 *
 * Must be paired with ring_buffer_lock_reserve.
 */
int ring_buffer_unlock_commit(struct ring_buffer *buffer,
			      struct ring_buffer_event *event)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	int cpu = raw_smp_processor_id();

	cpu_buffer = buffer->buffers[cpu];

	rb_commit(cpu_buffer, event);

	rb_wakeups(buffer, cpu_buffer);

	trace_recursive_unlock(cpu_buffer);

	preempt_enable_notrace();

	return 0;
}
EXPORT_SYMBOL_GPL(ring_buffer_unlock_commit);

static noinline void
rb_handle_timestamp(struct ring_buffer_per_cpu *cpu_buffer,
		    struct rb_event_info *info)
{
	WARN_ONCE(info->delta > (1ULL << 59),
		  KERN_WARNING "Delta way too big! %llu ts=%llu write stamp = %llu\n%s",
		  (unsigned long long)info->delta,
		  (unsigned long long)info->ts,
		  (unsigned long long)cpu_buffer->write_stamp,
		  sched_clock_stable() ? "" :
		  "If you just came from a suspend/resume,\n"
		  "please switch to the trace global clock:\n"
		  "  echo global > /sys/kernel/debug/tracing/trace_clock\n");
2647
	info->add_timestamp = 1;
2648 2649
}

2650 2651
static struct ring_buffer_event *
__rb_reserve_next(struct ring_buffer_per_cpu *cpu_buffer,
2652
		  struct rb_event_info *info)
2653 2654
{
	struct ring_buffer_event *event;
2655
	struct buffer_page *tail_page;
2656
	unsigned long tail, write;
2657 2658 2659 2660 2661 2662 2663 2664

	/*
	 * If the time delta since the last event is too big to
	 * hold in the time field of the event, then we append a
	 * TIME EXTEND event ahead of the data event.
	 */
	if (unlikely(info->add_timestamp))
		info->length += RB_LEN_TIME_EXTEND;
2665

2666 2667
	/* Don't let the compiler play games with cpu_buffer->tail_page */
	tail_page = info->tail_page = READ_ONCE(cpu_buffer->tail_page);
2668
	write = local_add_return(info->length, &tail_page->write);
S
Steven Rostedt 已提交
2669 2670 2671

	/* set write to only the index of the write */
	write &= RB_WRITE_MASK;
2672
	tail = write - info->length;
2673 2674

	/*
2675
	 * If this is the first commit on the page, then it has the same
2676
	 * timestamp as the page itself.
2677
	 */
2678
	if (!tail)
2679 2680
		info->delta = 0;

2681 2682 2683
	/* See if we shot pass the end of this buffer page */
	if (unlikely(write > BUF_PAGE_SIZE))
		return rb_move_tail(cpu_buffer, tail, info);
2684

2685 2686 2687
	/* We reserved something on the buffer */

	event = __rb_page_index(tail_page, tail);
2688 2689 2690 2691
	kmemcheck_annotate_bitfield(event, bitfield);
	rb_update_event(cpu_buffer, event, info);

	local_inc(&tail_page->entries);
2692

2693 2694 2695 2696 2697 2698 2699
	/*
	 * If this is the first commit on the page, then update
	 * its timestamp.
	 */
	if (!tail)
		tail_page->page->time_stamp = info->ts;

2700
	/* account for these added bytes */
2701
	local_add(info->length, &cpu_buffer->entries_bytes);
2702

2703 2704 2705
	return event;
}

2706
static __always_inline struct ring_buffer_event *
2707 2708
rb_reserve_next_event(struct ring_buffer *buffer,
		      struct ring_buffer_per_cpu *cpu_buffer,
2709
		      unsigned long length)
S
Steven Rostedt 已提交
2710 2711
{
	struct ring_buffer_event *event;
2712
	struct rb_event_info info;
2713
	int nr_loops = 0;
2714
	u64 diff;
S
Steven Rostedt 已提交
2715

2716 2717
	rb_start_commit(cpu_buffer);

2718
#ifdef CONFIG_RING_BUFFER_ALLOW_SWAP
2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730
	/*
	 * Due to the ability to swap a cpu buffer from a buffer
	 * it is possible it was swapped before we committed.
	 * (committing stops a swap). We check for it here and
	 * if it happened, we have to fail the write.
	 */
	barrier();
	if (unlikely(ACCESS_ONCE(cpu_buffer->buffer) != buffer)) {
		local_dec(&cpu_buffer->committing);
		local_dec(&cpu_buffer->commits);
		return NULL;
	}
2731
#endif
2732

2733
	info.length = rb_calculate_event_length(length);
2734
 again:
2735 2736 2737
	info.add_timestamp = 0;
	info.delta = 0;

2738 2739 2740 2741 2742 2743 2744 2745 2746
	/*
	 * We allow for interrupts to reenter here and do a trace.
	 * If one does, it will cause this original code to loop
	 * back here. Even with heavy interrupts happening, this
	 * should only happen a few times in a row. If this happens
	 * 1000 times in a row, there must be either an interrupt
	 * storm or we have something buggy.
	 * Bail!
	 */
S
Steven Rostedt 已提交
2747
	if (RB_WARN_ON(cpu_buffer, ++nr_loops > 1000))
2748
		goto out_fail;
2749

2750 2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762
	info.ts = rb_time_stamp(cpu_buffer->buffer);
	diff = info.ts - cpu_buffer->write_stamp;

	/* make sure this diff is calculated here */
	barrier();

	/* Did the write stamp get updated already? */
	if (likely(info.ts >= cpu_buffer->write_stamp)) {
		info.delta = diff;
		if (unlikely(test_time_stamp(info.delta)))
			rb_handle_timestamp(cpu_buffer, &info);
	}

2763 2764
	event = __rb_reserve_next(cpu_buffer, &info);

2765 2766 2767
	if (unlikely(PTR_ERR(event) == -EAGAIN)) {
		if (info.add_timestamp)
			info.length -= RB_LEN_TIME_EXTEND;
S
Steven Rostedt 已提交
2768
		goto again;
2769
	}
S
Steven Rostedt 已提交
2770

2771 2772
	if (!event)
		goto out_fail;
S
Steven Rostedt 已提交
2773 2774

	return event;
2775 2776 2777 2778

 out_fail:
	rb_end_commit(cpu_buffer);
	return NULL;
S
Steven Rostedt 已提交
2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796
}

/**
 * ring_buffer_lock_reserve - reserve a part of the buffer
 * @buffer: the ring buffer to reserve from
 * @length: the length of the data to reserve (excluding event header)
 *
 * Returns a reseverd event on the ring buffer to copy directly to.
 * The user of this interface will need to get the body to write into
 * and can use the ring_buffer_event_data() interface.
 *
 * The length is the length of the data needed, not the event length
 * which also includes the event header.
 *
 * Must be paired with ring_buffer_unlock_commit, unless NULL is returned.
 * If NULL is returned, then nothing has been allocated or locked.
 */
struct ring_buffer_event *
2797
ring_buffer_lock_reserve(struct ring_buffer *buffer, unsigned long length)
S
Steven Rostedt 已提交
2798 2799 2800
{
	struct ring_buffer_per_cpu *cpu_buffer;
	struct ring_buffer_event *event;
2801
	int cpu;
S
Steven Rostedt 已提交
2802

S
Steven Rostedt 已提交
2803
	/* If we are tracing schedule, we don't want to recurse */
2804
	preempt_disable_notrace();
S
Steven Rostedt 已提交
2805

2806
	if (unlikely(atomic_read(&buffer->record_disabled)))
2807
		goto out;
2808

S
Steven Rostedt 已提交
2809 2810
	cpu = raw_smp_processor_id();

2811
	if (unlikely(!cpumask_test_cpu(cpu, buffer->cpumask)))
2812
		goto out;
S
Steven Rostedt 已提交
2813 2814 2815

	cpu_buffer = buffer->buffers[cpu];

2816
	if (unlikely(atomic_read(&cpu_buffer->record_disabled)))
2817
		goto out;
S
Steven Rostedt 已提交
2818

2819
	if (unlikely(length > BUF_MAX_DATA_SIZE))
S
Steven Rostedt 已提交
2820
		goto out;
S
Steven Rostedt 已提交
2821

2822 2823 2824
	if (unlikely(trace_recursive_lock(cpu_buffer)))
		goto out;

2825
	event = rb_reserve_next_event(buffer, cpu_buffer, length);
S
Steven Rostedt 已提交
2826
	if (!event)
2827
		goto out_unlock;
S
Steven Rostedt 已提交
2828 2829 2830

	return event;

2831 2832
 out_unlock:
	trace_recursive_unlock(cpu_buffer);
2833
 out:
2834
	preempt_enable_notrace();
S
Steven Rostedt 已提交
2835 2836
	return NULL;
}
2837
EXPORT_SYMBOL_GPL(ring_buffer_lock_reserve);
S
Steven Rostedt 已提交
2838

2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878
/*
 * Decrement the entries to the page that an event is on.
 * The event does not even need to exist, only the pointer
 * to the page it is on. This may only be called before the commit
 * takes place.
 */
static inline void
rb_decrement_entry(struct ring_buffer_per_cpu *cpu_buffer,
		   struct ring_buffer_event *event)
{
	unsigned long addr = (unsigned long)event;
	struct buffer_page *bpage = cpu_buffer->commit_page;
	struct buffer_page *start;

	addr &= PAGE_MASK;

	/* Do the likely case first */
	if (likely(bpage->page == (void *)addr)) {
		local_dec(&bpage->entries);
		return;
	}

	/*
	 * Because the commit page may be on the reader page we
	 * start with the next page and check the end loop there.
	 */
	rb_inc_page(cpu_buffer, &bpage);
	start = bpage;
	do {
		if (bpage->page == (void *)addr) {
			local_dec(&bpage->entries);
			return;
		}
		rb_inc_page(cpu_buffer, &bpage);
	} while (bpage != start);

	/* commit not part of this buffer?? */
	RB_WARN_ON(cpu_buffer, 1);
}

2879 2880 2881 2882 2883
/**
 * ring_buffer_commit_discard - discard an event that has not been committed
 * @buffer: the ring buffer
 * @event: non committed event to discard
 *
2884 2885 2886 2887 2888 2889
 * Sometimes an event that is in the ring buffer needs to be ignored.
 * This function lets the user discard an event in the ring buffer
 * and then that event will not be read later.
 *
 * This function only works if it is called before the the item has been
 * committed. It will try to free the event from the ring buffer
2890 2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904
 * if another event has not been added behind it.
 *
 * If another event has been added behind it, it will set the event
 * up as discarded, and perform the commit.
 *
 * If this function is called, do not call ring_buffer_unlock_commit on
 * the event.
 */
void ring_buffer_discard_commit(struct ring_buffer *buffer,
				struct ring_buffer_event *event)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	int cpu;

	/* The event is discarded regardless */
2905
	rb_event_discard(event);
2906

2907 2908 2909
	cpu = smp_processor_id();
	cpu_buffer = buffer->buffers[cpu];

2910 2911 2912 2913 2914
	/*
	 * This must only be called if the event has not been
	 * committed yet. Thus we can assume that preemption
	 * is still disabled.
	 */
2915
	RB_WARN_ON(buffer, !local_read(&cpu_buffer->committing));
2916

2917
	rb_decrement_entry(cpu_buffer, event);
2918
	if (rb_try_to_discard(cpu_buffer, event))
2919
		goto out;
2920 2921 2922

	/*
	 * The commit is still visible by the reader, so we
2923
	 * must still update the timestamp.
2924
	 */
2925
	rb_update_write_stamp(cpu_buffer, event);
2926
 out:
2927
	rb_end_commit(cpu_buffer);
2928

2929
	trace_recursive_unlock(cpu_buffer);
2930

2931
	preempt_enable_notrace();
2932 2933 2934 2935

}
EXPORT_SYMBOL_GPL(ring_buffer_discard_commit);

S
Steven Rostedt 已提交
2936 2937 2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949
/**
 * ring_buffer_write - write data to the buffer without reserving
 * @buffer: The ring buffer to write to.
 * @length: The length of the data being written (excluding the event header)
 * @data: The data to write to the buffer.
 *
 * This is like ring_buffer_lock_reserve and ring_buffer_unlock_commit as
 * one function. If you already have the data to write to the buffer, it
 * may be easier to simply call this function.
 *
 * Note, like ring_buffer_lock_reserve, the length is the length of the data
 * and not the length of the event which would hold the header.
 */
int ring_buffer_write(struct ring_buffer *buffer,
D
David Sharp 已提交
2950 2951
		      unsigned long length,
		      void *data)
S
Steven Rostedt 已提交
2952 2953 2954 2955 2956
{
	struct ring_buffer_per_cpu *cpu_buffer;
	struct ring_buffer_event *event;
	void *body;
	int ret = -EBUSY;
2957
	int cpu;
S
Steven Rostedt 已提交
2958

2959
	preempt_disable_notrace();
S
Steven Rostedt 已提交
2960

2961 2962 2963
	if (atomic_read(&buffer->record_disabled))
		goto out;

S
Steven Rostedt 已提交
2964 2965
	cpu = raw_smp_processor_id();

2966
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
2967
		goto out;
S
Steven Rostedt 已提交
2968 2969 2970 2971 2972 2973

	cpu_buffer = buffer->buffers[cpu];

	if (atomic_read(&cpu_buffer->record_disabled))
		goto out;

2974 2975 2976
	if (length > BUF_MAX_DATA_SIZE)
		goto out;

2977 2978 2979
	if (unlikely(trace_recursive_lock(cpu_buffer)))
		goto out;

2980
	event = rb_reserve_next_event(buffer, cpu_buffer, length);
S
Steven Rostedt 已提交
2981
	if (!event)
2982
		goto out_unlock;
S
Steven Rostedt 已提交
2983 2984 2985 2986 2987 2988 2989

	body = rb_event_data(event);

	memcpy(body, data, length);

	rb_commit(cpu_buffer, event);

2990 2991
	rb_wakeups(buffer, cpu_buffer);

S
Steven Rostedt 已提交
2992
	ret = 0;
2993 2994 2995 2996

 out_unlock:
	trace_recursive_unlock(cpu_buffer);

S
Steven Rostedt 已提交
2997
 out:
2998
	preempt_enable_notrace();
S
Steven Rostedt 已提交
2999 3000 3001

	return ret;
}
3002
EXPORT_SYMBOL_GPL(ring_buffer_write);
S
Steven Rostedt 已提交
3003

3004
static bool rb_per_cpu_empty(struct ring_buffer_per_cpu *cpu_buffer)
S
Steven Rostedt 已提交
3005 3006
{
	struct buffer_page *reader = cpu_buffer->reader_page;
S
Steven Rostedt 已提交
3007
	struct buffer_page *head = rb_set_head_page(cpu_buffer);
S
Steven Rostedt 已提交
3008 3009
	struct buffer_page *commit = cpu_buffer->commit_page;

S
Steven Rostedt 已提交
3010 3011
	/* In case of error, head will be NULL */
	if (unlikely(!head))
3012
		return true;
S
Steven Rostedt 已提交
3013

S
Steven Rostedt 已提交
3014 3015 3016 3017 3018 3019
	return reader->read == rb_page_commit(reader) &&
		(commit == reader ||
		 (commit == head &&
		  head->read == rb_page_commit(commit)));
}

S
Steven Rostedt 已提交
3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032
/**
 * ring_buffer_record_disable - stop all writes into the buffer
 * @buffer: The ring buffer to stop writes to.
 *
 * This prevents all writes to the buffer. Any attempt to write
 * to the buffer after this will fail and return NULL.
 *
 * The caller should call synchronize_sched() after this.
 */
void ring_buffer_record_disable(struct ring_buffer *buffer)
{
	atomic_inc(&buffer->record_disabled);
}
3033
EXPORT_SYMBOL_GPL(ring_buffer_record_disable);
S
Steven Rostedt 已提交
3034 3035 3036 3037 3038 3039

/**
 * ring_buffer_record_enable - enable writes to the buffer
 * @buffer: The ring buffer to enable writes
 *
 * Note, multiple disables will need the same number of enables
3040
 * to truly enable the writing (much like preempt_disable).
S
Steven Rostedt 已提交
3041 3042 3043 3044 3045
 */
void ring_buffer_record_enable(struct ring_buffer *buffer)
{
	atomic_dec(&buffer->record_disabled);
}
3046
EXPORT_SYMBOL_GPL(ring_buffer_record_enable);
S
Steven Rostedt 已提交
3047

3048 3049 3050 3051 3052 3053 3054 3055
/**
 * ring_buffer_record_off - stop all writes into the buffer
 * @buffer: The ring buffer to stop writes to.
 *
 * This prevents all writes to the buffer. Any attempt to write
 * to the buffer after this will fail and return NULL.
 *
 * This is different than ring_buffer_record_disable() as
3056
 * it works like an on/off switch, where as the disable() version
3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078
 * must be paired with a enable().
 */
void ring_buffer_record_off(struct ring_buffer *buffer)
{
	unsigned int rd;
	unsigned int new_rd;

	do {
		rd = atomic_read(&buffer->record_disabled);
		new_rd = rd | RB_BUFFER_OFF;
	} while (atomic_cmpxchg(&buffer->record_disabled, rd, new_rd) != rd);
}
EXPORT_SYMBOL_GPL(ring_buffer_record_off);

/**
 * ring_buffer_record_on - restart writes into the buffer
 * @buffer: The ring buffer to start writes to.
 *
 * This enables all writes to the buffer that was disabled by
 * ring_buffer_record_off().
 *
 * This is different than ring_buffer_record_enable() as
3079
 * it works like an on/off switch, where as the enable() version
3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104
 * must be paired with a disable().
 */
void ring_buffer_record_on(struct ring_buffer *buffer)
{
	unsigned int rd;
	unsigned int new_rd;

	do {
		rd = atomic_read(&buffer->record_disabled);
		new_rd = rd & ~RB_BUFFER_OFF;
	} while (atomic_cmpxchg(&buffer->record_disabled, rd, new_rd) != rd);
}
EXPORT_SYMBOL_GPL(ring_buffer_record_on);

/**
 * ring_buffer_record_is_on - return true if the ring buffer can write
 * @buffer: The ring buffer to see if write is enabled
 *
 * Returns true if the ring buffer is in a state that it accepts writes.
 */
int ring_buffer_record_is_on(struct ring_buffer *buffer)
{
	return !atomic_read(&buffer->record_disabled);
}

S
Steven Rostedt 已提交
3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118
/**
 * ring_buffer_record_disable_cpu - stop all writes into the cpu_buffer
 * @buffer: The ring buffer to stop writes to.
 * @cpu: The CPU buffer to stop
 *
 * This prevents all writes to the buffer. Any attempt to write
 * to the buffer after this will fail and return NULL.
 *
 * The caller should call synchronize_sched() after this.
 */
void ring_buffer_record_disable_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;

3119
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3120
		return;
S
Steven Rostedt 已提交
3121 3122 3123 3124

	cpu_buffer = buffer->buffers[cpu];
	atomic_inc(&cpu_buffer->record_disabled);
}
3125
EXPORT_SYMBOL_GPL(ring_buffer_record_disable_cpu);
S
Steven Rostedt 已提交
3126 3127 3128 3129 3130 3131 3132

/**
 * ring_buffer_record_enable_cpu - enable writes to the buffer
 * @buffer: The ring buffer to enable writes
 * @cpu: The CPU to enable.
 *
 * Note, multiple disables will need the same number of enables
3133
 * to truly enable the writing (much like preempt_disable).
S
Steven Rostedt 已提交
3134 3135 3136 3137 3138
 */
void ring_buffer_record_enable_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;

3139
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3140
		return;
S
Steven Rostedt 已提交
3141 3142 3143 3144

	cpu_buffer = buffer->buffers[cpu];
	atomic_dec(&cpu_buffer->record_disabled);
}
3145
EXPORT_SYMBOL_GPL(ring_buffer_record_enable_cpu);
S
Steven Rostedt 已提交
3146

3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159
/*
 * The total entries in the ring buffer is the running counter
 * of entries entered into the ring buffer, minus the sum of
 * the entries read from the ring buffer and the number of
 * entries that were overwritten.
 */
static inline unsigned long
rb_num_of_entries(struct ring_buffer_per_cpu *cpu_buffer)
{
	return local_read(&cpu_buffer->entries) -
		(local_read(&cpu_buffer->overrun) + cpu_buffer->read);
}

3160 3161 3162 3163 3164
/**
 * ring_buffer_oldest_event_ts - get the oldest event timestamp from the buffer
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to read from.
 */
3165
u64 ring_buffer_oldest_event_ts(struct ring_buffer *buffer, int cpu)
3166 3167 3168 3169
{
	unsigned long flags;
	struct ring_buffer_per_cpu *cpu_buffer;
	struct buffer_page *bpage;
3170
	u64 ret = 0;
3171 3172 3173 3174 3175

	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	cpu_buffer = buffer->buffers[cpu];
3176
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
3177 3178 3179 3180 3181 3182 3183 3184
	/*
	 * if the tail is on reader_page, oldest time stamp is on the reader
	 * page
	 */
	if (cpu_buffer->tail_page == cpu_buffer->reader_page)
		bpage = cpu_buffer->reader_page;
	else
		bpage = rb_set_head_page(cpu_buffer);
3185 3186
	if (bpage)
		ret = bpage->page->time_stamp;
3187
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212

	return ret;
}
EXPORT_SYMBOL_GPL(ring_buffer_oldest_event_ts);

/**
 * ring_buffer_bytes_cpu - get the number of bytes consumed in a cpu buffer
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to read from.
 */
unsigned long ring_buffer_bytes_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long ret;

	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	cpu_buffer = buffer->buffers[cpu];
	ret = local_read(&cpu_buffer->entries_bytes) - cpu_buffer->read_bytes;

	return ret;
}
EXPORT_SYMBOL_GPL(ring_buffer_bytes_cpu);

S
Steven Rostedt 已提交
3213 3214 3215 3216 3217 3218 3219 3220 3221
/**
 * ring_buffer_entries_cpu - get the number of entries in a cpu buffer
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to get the entries from.
 */
unsigned long ring_buffer_entries_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;

3222
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3223
		return 0;
S
Steven Rostedt 已提交
3224 3225

	cpu_buffer = buffer->buffers[cpu];
3226

3227
	return rb_num_of_entries(cpu_buffer);
S
Steven Rostedt 已提交
3228
}
3229
EXPORT_SYMBOL_GPL(ring_buffer_entries_cpu);
S
Steven Rostedt 已提交
3230 3231

/**
3232 3233
 * ring_buffer_overrun_cpu - get the number of overruns caused by the ring
 * buffer wrapping around (only if RB_FL_OVERWRITE is on).
S
Steven Rostedt 已提交
3234 3235 3236 3237 3238 3239
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to get the number of overruns from
 */
unsigned long ring_buffer_overrun_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;
3240
	unsigned long ret;
S
Steven Rostedt 已提交
3241

3242
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3243
		return 0;
S
Steven Rostedt 已提交
3244 3245

	cpu_buffer = buffer->buffers[cpu];
S
Steven Rostedt 已提交
3246
	ret = local_read(&cpu_buffer->overrun);
3247 3248

	return ret;
S
Steven Rostedt 已提交
3249
}
3250
EXPORT_SYMBOL_GPL(ring_buffer_overrun_cpu);
S
Steven Rostedt 已提交
3251

3252
/**
3253 3254 3255
 * ring_buffer_commit_overrun_cpu - get the number of overruns caused by
 * commits failing due to the buffer wrapping around while there are uncommitted
 * events, such as during an interrupt storm.
3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to get the number of overruns from
 */
unsigned long
ring_buffer_commit_overrun_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long ret;

	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	cpu_buffer = buffer->buffers[cpu];
S
Steven Rostedt 已提交
3269
	ret = local_read(&cpu_buffer->commit_overrun);
3270 3271 3272 3273 3274

	return ret;
}
EXPORT_SYMBOL_GPL(ring_buffer_commit_overrun_cpu);

3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296
/**
 * ring_buffer_dropped_events_cpu - get the number of dropped events caused by
 * the ring buffer filling up (only if RB_FL_OVERWRITE is off).
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to get the number of overruns from
 */
unsigned long
ring_buffer_dropped_events_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long ret;

	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	cpu_buffer = buffer->buffers[cpu];
	ret = local_read(&cpu_buffer->dropped_events);

	return ret;
}
EXPORT_SYMBOL_GPL(ring_buffer_dropped_events_cpu);

3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314
/**
 * ring_buffer_read_events_cpu - get the number of events successfully read
 * @buffer: The ring buffer
 * @cpu: The per CPU buffer to get the number of events read
 */
unsigned long
ring_buffer_read_events_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer;

	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	cpu_buffer = buffer->buffers[cpu];
	return cpu_buffer->read;
}
EXPORT_SYMBOL_GPL(ring_buffer_read_events_cpu);

S
Steven Rostedt 已提交
3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330
/**
 * ring_buffer_entries - get the number of entries in a buffer
 * @buffer: The ring buffer
 *
 * Returns the total number of entries in the ring buffer
 * (all CPU entries)
 */
unsigned long ring_buffer_entries(struct ring_buffer *buffer)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long entries = 0;
	int cpu;

	/* if you care about this being correct, lock the buffer */
	for_each_buffer_cpu(buffer, cpu) {
		cpu_buffer = buffer->buffers[cpu];
3331
		entries += rb_num_of_entries(cpu_buffer);
S
Steven Rostedt 已提交
3332 3333 3334 3335
	}

	return entries;
}
3336
EXPORT_SYMBOL_GPL(ring_buffer_entries);
S
Steven Rostedt 已提交
3337 3338

/**
3339
 * ring_buffer_overruns - get the number of overruns in buffer
S
Steven Rostedt 已提交
3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353
 * @buffer: The ring buffer
 *
 * Returns the total number of overruns in the ring buffer
 * (all CPU entries)
 */
unsigned long ring_buffer_overruns(struct ring_buffer *buffer)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long overruns = 0;
	int cpu;

	/* if you care about this being correct, lock the buffer */
	for_each_buffer_cpu(buffer, cpu) {
		cpu_buffer = buffer->buffers[cpu];
S
Steven Rostedt 已提交
3354
		overruns += local_read(&cpu_buffer->overrun);
S
Steven Rostedt 已提交
3355 3356 3357 3358
	}

	return overruns;
}
3359
EXPORT_SYMBOL_GPL(ring_buffer_overruns);
S
Steven Rostedt 已提交
3360

3361
static void rb_iter_reset(struct ring_buffer_iter *iter)
S
Steven Rostedt 已提交
3362 3363 3364
{
	struct ring_buffer_per_cpu *cpu_buffer = iter->cpu_buffer;

3365
	/* Iterator usage is expected to have record disabled */
3366 3367 3368 3369
	iter->head_page = cpu_buffer->reader_page;
	iter->head = cpu_buffer->reader_page->read;

	iter->cache_reader_page = iter->head_page;
3370
	iter->cache_read = cpu_buffer->read;
3371

3372 3373 3374
	if (iter->head)
		iter->read_stamp = cpu_buffer->read_stamp;
	else
3375
		iter->read_stamp = iter->head_page->page->time_stamp;
3376
}
S
Steven Rostedt 已提交
3377

3378 3379 3380 3381 3382 3383 3384 3385 3386
/**
 * ring_buffer_iter_reset - reset an iterator
 * @iter: The iterator to reset
 *
 * Resets the iterator, so that it will start from the beginning
 * again.
 */
void ring_buffer_iter_reset(struct ring_buffer_iter *iter)
{
3387
	struct ring_buffer_per_cpu *cpu_buffer;
3388 3389
	unsigned long flags;

3390 3391 3392 3393 3394
	if (!iter)
		return;

	cpu_buffer = iter->cpu_buffer;

3395
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
3396
	rb_iter_reset(iter);
3397
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
3398
}
3399
EXPORT_SYMBOL_GPL(ring_buffer_iter_reset);
S
Steven Rostedt 已提交
3400 3401 3402 3403 3404 3405 3406 3407

/**
 * ring_buffer_iter_empty - check if an iterator has no more to read
 * @iter: The iterator to check
 */
int ring_buffer_iter_empty(struct ring_buffer_iter *iter)
{
	struct ring_buffer_per_cpu *cpu_buffer;
3408 3409 3410 3411
	struct buffer_page *reader;
	struct buffer_page *head_page;
	struct buffer_page *commit_page;
	unsigned commit;
S
Steven Rostedt 已提交
3412 3413 3414

	cpu_buffer = iter->cpu_buffer;

3415 3416 3417 3418 3419 3420 3421 3422 3423 3424
	/* Remember, trace recording is off when iterator is in use */
	reader = cpu_buffer->reader_page;
	head_page = cpu_buffer->head_page;
	commit_page = cpu_buffer->commit_page;
	commit = rb_page_commit(commit_page);

	return ((iter->head_page == commit_page && iter->head == commit) ||
		(iter->head_page == reader && commit_page == head_page &&
		 head_page->read == commit &&
		 iter->head == rb_page_commit(cpu_buffer->reader_page)));
S
Steven Rostedt 已提交
3425
}
3426
EXPORT_SYMBOL_GPL(ring_buffer_iter_empty);
S
Steven Rostedt 已提交
3427 3428 3429 3430 3431 3432 3433

static void
rb_update_read_stamp(struct ring_buffer_per_cpu *cpu_buffer,
		     struct ring_buffer_event *event)
{
	u64 delta;

3434
	switch (event->type_len) {
S
Steven Rostedt 已提交
3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464
	case RINGBUF_TYPE_PADDING:
		return;

	case RINGBUF_TYPE_TIME_EXTEND:
		delta = event->array[0];
		delta <<= TS_SHIFT;
		delta += event->time_delta;
		cpu_buffer->read_stamp += delta;
		return;

	case RINGBUF_TYPE_TIME_STAMP:
		/* FIXME: not implemented */
		return;

	case RINGBUF_TYPE_DATA:
		cpu_buffer->read_stamp += event->time_delta;
		return;

	default:
		BUG();
	}
	return;
}

static void
rb_update_iter_read_stamp(struct ring_buffer_iter *iter,
			  struct ring_buffer_event *event)
{
	u64 delta;

3465
	switch (event->type_len) {
S
Steven Rostedt 已提交
3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489
	case RINGBUF_TYPE_PADDING:
		return;

	case RINGBUF_TYPE_TIME_EXTEND:
		delta = event->array[0];
		delta <<= TS_SHIFT;
		delta += event->time_delta;
		iter->read_stamp += delta;
		return;

	case RINGBUF_TYPE_TIME_STAMP:
		/* FIXME: not implemented */
		return;

	case RINGBUF_TYPE_DATA:
		iter->read_stamp += event->time_delta;
		return;

	default:
		BUG();
	}
	return;
}

3490 3491
static struct buffer_page *
rb_get_reader_page(struct ring_buffer_per_cpu *cpu_buffer)
S
Steven Rostedt 已提交
3492
{
3493
	struct buffer_page *reader = NULL;
3494
	unsigned long overwrite;
3495
	unsigned long flags;
3496
	int nr_loops = 0;
S
Steven Rostedt 已提交
3497
	int ret;
3498

3499
	local_irq_save(flags);
3500
	arch_spin_lock(&cpu_buffer->lock);
3501 3502

 again:
3503 3504 3505 3506 3507 3508
	/*
	 * This should normally only loop twice. But because the
	 * start of the reader inserts an empty page, it causes
	 * a case where we will loop three times. There should be no
	 * reason to loop four times (that I know of).
	 */
S
Steven Rostedt 已提交
3509
	if (RB_WARN_ON(cpu_buffer, ++nr_loops > 3)) {
3510 3511 3512 3513
		reader = NULL;
		goto out;
	}

3514 3515 3516
	reader = cpu_buffer->reader_page;

	/* If there's more to read, return this page */
S
Steven Rostedt 已提交
3517
	if (cpu_buffer->reader_page->read < rb_page_size(reader))
3518 3519 3520
		goto out;

	/* Never should we have an index greater than the size */
S
Steven Rostedt 已提交
3521 3522 3523
	if (RB_WARN_ON(cpu_buffer,
		       cpu_buffer->reader_page->read > rb_page_size(reader)))
		goto out;
3524 3525 3526

	/* check if we caught up to the tail */
	reader = NULL;
S
Steven Rostedt 已提交
3527
	if (cpu_buffer->commit_page == cpu_buffer->reader_page)
3528
		goto out;
S
Steven Rostedt 已提交
3529

3530 3531 3532 3533
	/* Don't bother swapping if the ring buffer is empty */
	if (rb_num_of_entries(cpu_buffer) == 0)
		goto out;

S
Steven Rostedt 已提交
3534
	/*
3535
	 * Reset the reader page to size zero.
S
Steven Rostedt 已提交
3536
	 */
S
Steven Rostedt 已提交
3537 3538 3539
	local_set(&cpu_buffer->reader_page->write, 0);
	local_set(&cpu_buffer->reader_page->entries, 0);
	local_set(&cpu_buffer->reader_page->page->commit, 0);
3540
	cpu_buffer->reader_page->real_end = 0;
S
Steven Rostedt 已提交
3541

S
Steven Rostedt 已提交
3542 3543 3544 3545 3546
 spin:
	/*
	 * Splice the empty reader page into the list around the head.
	 */
	reader = rb_set_head_page(cpu_buffer);
3547 3548
	if (!reader)
		goto out;
3549
	cpu_buffer->reader_page->list.next = rb_list_head(reader->list.next);
3550
	cpu_buffer->reader_page->list.prev = reader->list.prev;
S
Steven Rostedt 已提交
3551

3552 3553 3554
	/*
	 * cpu_buffer->pages just needs to point to the buffer, it
	 *  has no specific buffer page to point to. Lets move it out
L
Lucas De Marchi 已提交
3555
	 *  of our way so we don't accidentally swap it.
3556 3557 3558
	 */
	cpu_buffer->pages = reader->list.prev;

S
Steven Rostedt 已提交
3559 3560
	/* The reader page will be pointing to the new head */
	rb_set_list_to_head(cpu_buffer, &cpu_buffer->reader_page->list);
S
Steven Rostedt 已提交
3561

3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573
	/*
	 * We want to make sure we read the overruns after we set up our
	 * pointers to the next object. The writer side does a
	 * cmpxchg to cross pages which acts as the mb on the writer
	 * side. Note, the reader will constantly fail the swap
	 * while the writer is updating the pointers, so this
	 * guarantees that the overwrite recorded here is the one we
	 * want to compare with the last_overrun.
	 */
	smp_mb();
	overwrite = local_read(&(cpu_buffer->overrun));

S
Steven Rostedt 已提交
3574 3575 3576 3577 3578 3579 3580 3581 3582 3583 3584 3585
	/*
	 * Here's the tricky part.
	 *
	 * We need to move the pointer past the header page.
	 * But we can only do that if a writer is not currently
	 * moving it. The page before the header page has the
	 * flag bit '1' set if it is pointing to the page we want.
	 * but if the writer is in the process of moving it
	 * than it will be '2' or already moved '0'.
	 */

	ret = rb_head_page_replace(reader, cpu_buffer->reader_page);
S
Steven Rostedt 已提交
3586 3587

	/*
S
Steven Rostedt 已提交
3588
	 * If we did not convert it, then we must try again.
S
Steven Rostedt 已提交
3589
	 */
S
Steven Rostedt 已提交
3590 3591
	if (!ret)
		goto spin;
S
Steven Rostedt 已提交
3592

S
Steven Rostedt 已提交
3593 3594 3595 3596 3597
	/*
	 * Yeah! We succeeded in replacing the page.
	 *
	 * Now make the new head point back to the reader page.
	 */
3598
	rb_list_head(reader->list.next)->prev = &cpu_buffer->reader_page->list;
S
Steven Rostedt 已提交
3599
	rb_inc_page(cpu_buffer, &cpu_buffer->head_page);
3600 3601 3602

	/* Finally update the reader page to the new head */
	cpu_buffer->reader_page = reader;
3603
	cpu_buffer->reader_page->read = 0;
3604

3605 3606 3607 3608 3609
	if (overwrite != cpu_buffer->last_overrun) {
		cpu_buffer->lost_events = overwrite - cpu_buffer->last_overrun;
		cpu_buffer->last_overrun = overwrite;
	}

3610 3611 3612
	goto again;

 out:
3613 3614 3615 3616
	/* Update the read_stamp on the first event */
	if (reader && reader->read == 0)
		cpu_buffer->read_stamp = reader->page->time_stamp;

3617
	arch_spin_unlock(&cpu_buffer->lock);
3618
	local_irq_restore(flags);
3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629

	return reader;
}

static void rb_advance_reader(struct ring_buffer_per_cpu *cpu_buffer)
{
	struct ring_buffer_event *event;
	struct buffer_page *reader;
	unsigned length;

	reader = rb_get_reader_page(cpu_buffer);
S
Steven Rostedt 已提交
3630

3631
	/* This function should not be called when buffer is empty */
S
Steven Rostedt 已提交
3632 3633
	if (RB_WARN_ON(cpu_buffer, !reader))
		return;
S
Steven Rostedt 已提交
3634

3635 3636
	event = rb_reader_event(cpu_buffer);

3637
	if (event->type_len <= RINGBUF_TYPE_DATA_TYPE_LEN_MAX)
3638
		cpu_buffer->read++;
3639 3640 3641 3642

	rb_update_read_stamp(cpu_buffer, event);

	length = rb_event_length(event);
3643
	cpu_buffer->reader_page->read += length;
S
Steven Rostedt 已提交
3644 3645 3646 3647 3648 3649 3650 3651 3652 3653 3654 3655 3656
}

static void rb_advance_iter(struct ring_buffer_iter *iter)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	struct ring_buffer_event *event;
	unsigned length;

	cpu_buffer = iter->cpu_buffer;

	/*
	 * Check if we are at the end of the buffer.
	 */
S
Steven Rostedt 已提交
3657
	if (iter->head >= rb_page_size(iter->head_page)) {
3658 3659
		/* discarded commits can make the page empty */
		if (iter->head_page == cpu_buffer->commit_page)
S
Steven Rostedt 已提交
3660
			return;
3661
		rb_inc_iter(iter);
S
Steven Rostedt 已提交
3662 3663 3664 3665 3666 3667 3668 3669 3670 3671 3672
		return;
	}

	event = rb_iter_head_event(iter);

	length = rb_event_length(event);

	/*
	 * This should not be called to advance the header if we are
	 * at the tail of the buffer.
	 */
S
Steven Rostedt 已提交
3673
	if (RB_WARN_ON(cpu_buffer,
3674
		       (iter->head_page == cpu_buffer->commit_page) &&
S
Steven Rostedt 已提交
3675 3676
		       (iter->head + length > rb_commit_index(cpu_buffer))))
		return;
S
Steven Rostedt 已提交
3677 3678 3679 3680 3681 3682

	rb_update_iter_read_stamp(iter, event);

	iter->head += length;

	/* check for end of page padding */
S
Steven Rostedt 已提交
3683 3684
	if ((iter->head >= rb_page_size(iter->head_page)) &&
	    (iter->head_page != cpu_buffer->commit_page))
3685
		rb_inc_iter(iter);
S
Steven Rostedt 已提交
3686 3687
}

3688 3689 3690 3691 3692
static int rb_lost_events(struct ring_buffer_per_cpu *cpu_buffer)
{
	return cpu_buffer->lost_events;
}

S
Steven Rostedt 已提交
3693
static struct ring_buffer_event *
3694 3695
rb_buffer_peek(struct ring_buffer_per_cpu *cpu_buffer, u64 *ts,
	       unsigned long *lost_events)
S
Steven Rostedt 已提交
3696 3697
{
	struct ring_buffer_event *event;
3698
	struct buffer_page *reader;
3699
	int nr_loops = 0;
S
Steven Rostedt 已提交
3700 3701

 again:
3702
	/*
3703 3704 3705 3706
	 * We repeat when a time extend is encountered.
	 * Since the time extend is always attached to a data event,
	 * we should never loop more than once.
	 * (We never hit the following condition more than twice).
3707
	 */
3708
	if (RB_WARN_ON(cpu_buffer, ++nr_loops > 2))
3709 3710
		return NULL;

3711 3712
	reader = rb_get_reader_page(cpu_buffer);
	if (!reader)
S
Steven Rostedt 已提交
3713 3714
		return NULL;

3715
	event = rb_reader_event(cpu_buffer);
S
Steven Rostedt 已提交
3716

3717
	switch (event->type_len) {
S
Steven Rostedt 已提交
3718
	case RINGBUF_TYPE_PADDING:
3719 3720 3721 3722 3723 3724 3725 3726 3727 3728 3729
		if (rb_null_event(event))
			RB_WARN_ON(cpu_buffer, 1);
		/*
		 * Because the writer could be discarding every
		 * event it creates (which would probably be bad)
		 * if we were to go back to "again" then we may never
		 * catch up, and will trigger the warn on, or lock
		 * the box. Return the padding, and we will release
		 * the current locks, and try again.
		 */
		return event;
S
Steven Rostedt 已提交
3730 3731 3732

	case RINGBUF_TYPE_TIME_EXTEND:
		/* Internal data, OK to advance */
3733
		rb_advance_reader(cpu_buffer);
S
Steven Rostedt 已提交
3734 3735 3736 3737
		goto again;

	case RINGBUF_TYPE_TIME_STAMP:
		/* FIXME: not implemented */
3738
		rb_advance_reader(cpu_buffer);
S
Steven Rostedt 已提交
3739 3740 3741 3742 3743
		goto again;

	case RINGBUF_TYPE_DATA:
		if (ts) {
			*ts = cpu_buffer->read_stamp + event->time_delta;
3744
			ring_buffer_normalize_time_stamp(cpu_buffer->buffer,
3745
							 cpu_buffer->cpu, ts);
S
Steven Rostedt 已提交
3746
		}
3747 3748
		if (lost_events)
			*lost_events = rb_lost_events(cpu_buffer);
S
Steven Rostedt 已提交
3749 3750 3751 3752 3753 3754 3755 3756
		return event;

	default:
		BUG();
	}

	return NULL;
}
3757
EXPORT_SYMBOL_GPL(ring_buffer_peek);
S
Steven Rostedt 已提交
3758

S
Steven Rostedt 已提交
3759 3760
static struct ring_buffer_event *
rb_iter_peek(struct ring_buffer_iter *iter, u64 *ts)
S
Steven Rostedt 已提交
3761 3762 3763 3764
{
	struct ring_buffer *buffer;
	struct ring_buffer_per_cpu *cpu_buffer;
	struct ring_buffer_event *event;
3765
	int nr_loops = 0;
S
Steven Rostedt 已提交
3766 3767 3768 3769

	cpu_buffer = iter->cpu_buffer;
	buffer = cpu_buffer->buffer;

3770 3771 3772 3773 3774 3775 3776 3777 3778
	/*
	 * Check if someone performed a consuming read to
	 * the buffer. A consuming read invalidates the iterator
	 * and we need to reset the iterator in this case.
	 */
	if (unlikely(iter->cache_read != cpu_buffer->read ||
		     iter->cache_reader_page != cpu_buffer->reader_page))
		rb_iter_reset(iter);

S
Steven Rostedt 已提交
3779
 again:
3780 3781 3782
	if (ring_buffer_iter_empty(iter))
		return NULL;

3783
	/*
3784 3785 3786 3787 3788 3789
	 * We repeat when a time extend is encountered or we hit
	 * the end of the page. Since the time extend is always attached
	 * to a data event, we should never loop more than three times.
	 * Once for going to next page, once on time extend, and
	 * finally once to get the event.
	 * (We never hit the following condition more than thrice).
3790
	 */
3791
	if (RB_WARN_ON(cpu_buffer, ++nr_loops > 3))
3792 3793
		return NULL;

S
Steven Rostedt 已提交
3794 3795 3796
	if (rb_per_cpu_empty(cpu_buffer))
		return NULL;

3797
	if (iter->head >= rb_page_size(iter->head_page)) {
3798 3799 3800 3801
		rb_inc_iter(iter);
		goto again;
	}

S
Steven Rostedt 已提交
3802 3803
	event = rb_iter_head_event(iter);

3804
	switch (event->type_len) {
S
Steven Rostedt 已提交
3805
	case RINGBUF_TYPE_PADDING:
3806 3807 3808 3809 3810 3811
		if (rb_null_event(event)) {
			rb_inc_iter(iter);
			goto again;
		}
		rb_advance_iter(iter);
		return event;
S
Steven Rostedt 已提交
3812 3813 3814 3815 3816 3817 3818 3819 3820 3821 3822 3823 3824 3825

	case RINGBUF_TYPE_TIME_EXTEND:
		/* Internal data, OK to advance */
		rb_advance_iter(iter);
		goto again;

	case RINGBUF_TYPE_TIME_STAMP:
		/* FIXME: not implemented */
		rb_advance_iter(iter);
		goto again;

	case RINGBUF_TYPE_DATA:
		if (ts) {
			*ts = iter->read_stamp + event->time_delta;
3826 3827
			ring_buffer_normalize_time_stamp(buffer,
							 cpu_buffer->cpu, ts);
S
Steven Rostedt 已提交
3828 3829 3830 3831 3832 3833 3834 3835 3836
		}
		return event;

	default:
		BUG();
	}

	return NULL;
}
3837
EXPORT_SYMBOL_GPL(ring_buffer_iter_peek);
S
Steven Rostedt 已提交
3838

3839
static inline bool rb_reader_lock(struct ring_buffer_per_cpu *cpu_buffer)
3840
{
3841 3842 3843 3844 3845
	if (likely(!in_nmi())) {
		raw_spin_lock(&cpu_buffer->reader_lock);
		return true;
	}

3846 3847
	/*
	 * If an NMI die dumps out the content of the ring buffer
3848 3849 3850 3851 3852 3853
	 * trylock must be used to prevent a deadlock if the NMI
	 * preempted a task that holds the ring buffer locks. If
	 * we get the lock then all is fine, if not, then continue
	 * to do the read, but this can corrupt the ring buffer,
	 * so it must be permanently disabled from future writes.
	 * Reading from NMI is a oneshot deal.
3854
	 */
3855 3856
	if (raw_spin_trylock(&cpu_buffer->reader_lock))
		return true;
3857

3858 3859 3860 3861 3862 3863 3864 3865 3866 3867 3868
	/* Continue without locking, but disable the ring buffer */
	atomic_inc(&cpu_buffer->record_disabled);
	return false;
}

static inline void
rb_reader_unlock(struct ring_buffer_per_cpu *cpu_buffer, bool locked)
{
	if (likely(locked))
		raw_spin_unlock(&cpu_buffer->reader_lock);
	return;
3869 3870
}

S
Steven Rostedt 已提交
3871 3872 3873 3874 3875
/**
 * ring_buffer_peek - peek at the next event to be read
 * @buffer: The ring buffer to read
 * @cpu: The cpu to peak at
 * @ts: The timestamp counter of this event.
3876
 * @lost_events: a variable to store if events were lost (may be NULL)
S
Steven Rostedt 已提交
3877 3878 3879 3880 3881
 *
 * This will return the event that will be read next, but does
 * not consume the data.
 */
struct ring_buffer_event *
3882 3883
ring_buffer_peek(struct ring_buffer *buffer, int cpu, u64 *ts,
		 unsigned long *lost_events)
S
Steven Rostedt 已提交
3884 3885
{
	struct ring_buffer_per_cpu *cpu_buffer = buffer->buffers[cpu];
3886
	struct ring_buffer_event *event;
S
Steven Rostedt 已提交
3887
	unsigned long flags;
3888
	bool dolock;
S
Steven Rostedt 已提交
3889

3890
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3891
		return NULL;
3892

3893
 again:
3894
	local_irq_save(flags);
3895
	dolock = rb_reader_lock(cpu_buffer);
3896
	event = rb_buffer_peek(cpu_buffer, ts, lost_events);
3897 3898
	if (event && event->type_len == RINGBUF_TYPE_PADDING)
		rb_advance_reader(cpu_buffer);
3899
	rb_reader_unlock(cpu_buffer, dolock);
3900
	local_irq_restore(flags);
S
Steven Rostedt 已提交
3901

3902
	if (event && event->type_len == RINGBUF_TYPE_PADDING)
3903 3904
		goto again;

S
Steven Rostedt 已提交
3905 3906 3907 3908 3909 3910 3911 3912 3913 3914 3915 3916 3917 3918 3919 3920 3921 3922
	return event;
}

/**
 * ring_buffer_iter_peek - peek at the next event to be read
 * @iter: The ring buffer iterator
 * @ts: The timestamp counter of this event.
 *
 * This will return the event that will be read next, but does
 * not increment the iterator.
 */
struct ring_buffer_event *
ring_buffer_iter_peek(struct ring_buffer_iter *iter, u64 *ts)
{
	struct ring_buffer_per_cpu *cpu_buffer = iter->cpu_buffer;
	struct ring_buffer_event *event;
	unsigned long flags;

3923
 again:
3924
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
3925
	event = rb_iter_peek(iter, ts);
3926
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
3927

3928
	if (event && event->type_len == RINGBUF_TYPE_PADDING)
3929 3930
		goto again;

S
Steven Rostedt 已提交
3931 3932 3933
	return event;
}

S
Steven Rostedt 已提交
3934 3935 3936
/**
 * ring_buffer_consume - return an event and consume it
 * @buffer: The ring buffer to get the next event from
3937 3938 3939
 * @cpu: the cpu to read the buffer from
 * @ts: a variable to store the timestamp (may be NULL)
 * @lost_events: a variable to store if events were lost (may be NULL)
S
Steven Rostedt 已提交
3940 3941 3942 3943 3944 3945
 *
 * Returns the next event in the ring buffer, and that event is consumed.
 * Meaning, that sequential reads will keep returning a different event,
 * and eventually empty the ring buffer if the producer is slower.
 */
struct ring_buffer_event *
3946 3947
ring_buffer_consume(struct ring_buffer *buffer, int cpu, u64 *ts,
		    unsigned long *lost_events)
S
Steven Rostedt 已提交
3948
{
3949 3950
	struct ring_buffer_per_cpu *cpu_buffer;
	struct ring_buffer_event *event = NULL;
S
Steven Rostedt 已提交
3951
	unsigned long flags;
3952
	bool dolock;
S
Steven Rostedt 已提交
3953

3954
 again:
3955 3956 3957
	/* might be called in atomic */
	preempt_disable();

3958
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
3959
		goto out;
S
Steven Rostedt 已提交
3960

3961
	cpu_buffer = buffer->buffers[cpu];
3962
	local_irq_save(flags);
3963
	dolock = rb_reader_lock(cpu_buffer);
S
Steven Rostedt 已提交
3964

3965 3966 3967
	event = rb_buffer_peek(cpu_buffer, ts, lost_events);
	if (event) {
		cpu_buffer->lost_events = 0;
3968
		rb_advance_reader(cpu_buffer);
3969
	}
S
Steven Rostedt 已提交
3970

3971
	rb_reader_unlock(cpu_buffer, dolock);
3972
	local_irq_restore(flags);
S
Steven Rostedt 已提交
3973

3974 3975 3976
 out:
	preempt_enable();

3977
	if (event && event->type_len == RINGBUF_TYPE_PADDING)
3978 3979
		goto again;

S
Steven Rostedt 已提交
3980 3981
	return event;
}
3982
EXPORT_SYMBOL_GPL(ring_buffer_consume);
S
Steven Rostedt 已提交
3983 3984

/**
3985
 * ring_buffer_read_prepare - Prepare for a non consuming read of the buffer
S
Steven Rostedt 已提交
3986 3987 3988
 * @buffer: The ring buffer to read from
 * @cpu: The cpu buffer to iterate over
 *
3989 3990 3991
 * This performs the initial preparations necessary to iterate
 * through the buffer.  Memory is allocated, buffer recording
 * is disabled, and the iterator pointer is returned to the caller.
S
Steven Rostedt 已提交
3992
 *
3993 3994 3995 3996 3997
 * Disabling buffer recordng prevents the reading from being
 * corrupted. This is not a consuming read, so a producer is not
 * expected.
 *
 * After a sequence of ring_buffer_read_prepare calls, the user is
3998
 * expected to make at least one call to ring_buffer_read_prepare_sync.
3999 4000 4001
 * Afterwards, ring_buffer_read_start is invoked to get things going
 * for real.
 *
4002
 * This overall must be paired with ring_buffer_read_finish.
S
Steven Rostedt 已提交
4003 4004
 */
struct ring_buffer_iter *
4005
ring_buffer_read_prepare(struct ring_buffer *buffer, int cpu)
S
Steven Rostedt 已提交
4006 4007
{
	struct ring_buffer_per_cpu *cpu_buffer;
4008
	struct ring_buffer_iter *iter;
S
Steven Rostedt 已提交
4009

4010
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
4011
		return NULL;
S
Steven Rostedt 已提交
4012 4013 4014

	iter = kmalloc(sizeof(*iter), GFP_KERNEL);
	if (!iter)
4015
		return NULL;
S
Steven Rostedt 已提交
4016 4017 4018 4019 4020

	cpu_buffer = buffer->buffers[cpu];

	iter->cpu_buffer = cpu_buffer;

4021
	atomic_inc(&buffer->resize_disabled);
S
Steven Rostedt 已提交
4022
	atomic_inc(&cpu_buffer->record_disabled);
4023 4024 4025 4026 4027 4028 4029 4030 4031 4032 4033 4034 4035 4036 4037

	return iter;
}
EXPORT_SYMBOL_GPL(ring_buffer_read_prepare);

/**
 * ring_buffer_read_prepare_sync - Synchronize a set of prepare calls
 *
 * All previously invoked ring_buffer_read_prepare calls to prepare
 * iterators will be synchronized.  Afterwards, read_buffer_read_start
 * calls on those iterators are allowed.
 */
void
ring_buffer_read_prepare_sync(void)
{
S
Steven Rostedt 已提交
4038
	synchronize_sched();
4039 4040 4041 4042 4043 4044 4045 4046 4047 4048 4049 4050
}
EXPORT_SYMBOL_GPL(ring_buffer_read_prepare_sync);

/**
 * ring_buffer_read_start - start a non consuming read of the buffer
 * @iter: The iterator returned by ring_buffer_read_prepare
 *
 * This finalizes the startup of an iteration through the buffer.
 * The iterator comes from a call to ring_buffer_read_prepare and
 * an intervening ring_buffer_read_prepare_sync must have been
 * performed.
 *
4051
 * Must be paired with ring_buffer_read_finish.
4052 4053 4054 4055 4056 4057 4058 4059 4060 4061 4062
 */
void
ring_buffer_read_start(struct ring_buffer_iter *iter)
{
	struct ring_buffer_per_cpu *cpu_buffer;
	unsigned long flags;

	if (!iter)
		return;

	cpu_buffer = iter->cpu_buffer;
S
Steven Rostedt 已提交
4063

4064
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
4065
	arch_spin_lock(&cpu_buffer->lock);
4066
	rb_iter_reset(iter);
4067
	arch_spin_unlock(&cpu_buffer->lock);
4068
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
4069
}
4070
EXPORT_SYMBOL_GPL(ring_buffer_read_start);
S
Steven Rostedt 已提交
4071 4072

/**
4073
 * ring_buffer_read_finish - finish reading the iterator of the buffer
S
Steven Rostedt 已提交
4074 4075 4076 4077 4078 4079 4080 4081 4082
 * @iter: The iterator retrieved by ring_buffer_start
 *
 * This re-enables the recording to the buffer, and frees the
 * iterator.
 */
void
ring_buffer_read_finish(struct ring_buffer_iter *iter)
{
	struct ring_buffer_per_cpu *cpu_buffer = iter->cpu_buffer;
4083
	unsigned long flags;
S
Steven Rostedt 已提交
4084

4085 4086
	/*
	 * Ring buffer is disabled from recording, here's a good place
4087 4088 4089
	 * to check the integrity of the ring buffer.
	 * Must prevent readers from trying to read, as the check
	 * clears the HEAD page and readers require it.
4090
	 */
4091
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
4092
	rb_check_pages(cpu_buffer);
4093
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
4094

S
Steven Rostedt 已提交
4095
	atomic_dec(&cpu_buffer->record_disabled);
4096
	atomic_dec(&cpu_buffer->buffer->resize_disabled);
S
Steven Rostedt 已提交
4097 4098
	kfree(iter);
}
4099
EXPORT_SYMBOL_GPL(ring_buffer_read_finish);
S
Steven Rostedt 已提交
4100 4101 4102 4103 4104 4105 4106 4107 4108 4109 4110 4111

/**
 * ring_buffer_read - read the next item in the ring buffer by the iterator
 * @iter: The ring buffer iterator
 * @ts: The time stamp of the event read.
 *
 * This reads the next event in the ring buffer and increments the iterator.
 */
struct ring_buffer_event *
ring_buffer_read(struct ring_buffer_iter *iter, u64 *ts)
{
	struct ring_buffer_event *event;
S
Steven Rostedt 已提交
4112 4113
	struct ring_buffer_per_cpu *cpu_buffer = iter->cpu_buffer;
	unsigned long flags;
S
Steven Rostedt 已提交
4114

4115
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
4116
 again:
S
Steven Rostedt 已提交
4117
	event = rb_iter_peek(iter, ts);
S
Steven Rostedt 已提交
4118
	if (!event)
S
Steven Rostedt 已提交
4119
		goto out;
S
Steven Rostedt 已提交
4120

4121 4122 4123
	if (event->type_len == RINGBUF_TYPE_PADDING)
		goto again;

S
Steven Rostedt 已提交
4124
	rb_advance_iter(iter);
S
Steven Rostedt 已提交
4125
 out:
4126
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
4127 4128 4129

	return event;
}
4130
EXPORT_SYMBOL_GPL(ring_buffer_read);
S
Steven Rostedt 已提交
4131 4132 4133 4134 4135

/**
 * ring_buffer_size - return the size of the ring buffer (in bytes)
 * @buffer: The ring buffer.
 */
4136
unsigned long ring_buffer_size(struct ring_buffer *buffer, int cpu)
S
Steven Rostedt 已提交
4137
{
4138 4139 4140 4141 4142 4143 4144 4145 4146 4147
	/*
	 * Earlier, this method returned
	 *	BUF_PAGE_SIZE * buffer->nr_pages
	 * Since the nr_pages field is now removed, we have converted this to
	 * return the per cpu buffer value.
	 */
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	return BUF_PAGE_SIZE * buffer->buffers[cpu]->nr_pages;
S
Steven Rostedt 已提交
4148
}
4149
EXPORT_SYMBOL_GPL(ring_buffer_size);
S
Steven Rostedt 已提交
4150 4151 4152 4153

static void
rb_reset_cpu(struct ring_buffer_per_cpu *cpu_buffer)
{
S
Steven Rostedt 已提交
4154 4155
	rb_head_page_deactivate(cpu_buffer);

S
Steven Rostedt 已提交
4156
	cpu_buffer->head_page
4157
		= list_entry(cpu_buffer->pages, struct buffer_page, list);
S
Steven Rostedt 已提交
4158
	local_set(&cpu_buffer->head_page->write, 0);
4159
	local_set(&cpu_buffer->head_page->entries, 0);
4160
	local_set(&cpu_buffer->head_page->page->commit, 0);
4161

4162
	cpu_buffer->head_page->read = 0;
S
Steven Rostedt 已提交
4163 4164 4165 4166 4167

	cpu_buffer->tail_page = cpu_buffer->head_page;
	cpu_buffer->commit_page = cpu_buffer->head_page;

	INIT_LIST_HEAD(&cpu_buffer->reader_page->list);
4168
	INIT_LIST_HEAD(&cpu_buffer->new_pages);
S
Steven Rostedt 已提交
4169
	local_set(&cpu_buffer->reader_page->write, 0);
4170
	local_set(&cpu_buffer->reader_page->entries, 0);
4171
	local_set(&cpu_buffer->reader_page->page->commit, 0);
4172
	cpu_buffer->reader_page->read = 0;
S
Steven Rostedt 已提交
4173

4174
	local_set(&cpu_buffer->entries_bytes, 0);
S
Steven Rostedt 已提交
4175
	local_set(&cpu_buffer->overrun, 0);
4176 4177
	local_set(&cpu_buffer->commit_overrun, 0);
	local_set(&cpu_buffer->dropped_events, 0);
4178
	local_set(&cpu_buffer->entries, 0);
4179 4180
	local_set(&cpu_buffer->committing, 0);
	local_set(&cpu_buffer->commits, 0);
S
Steven Rostedt 已提交
4181
	cpu_buffer->read = 0;
4182
	cpu_buffer->read_bytes = 0;
4183 4184 4185

	cpu_buffer->write_stamp = 0;
	cpu_buffer->read_stamp = 0;
S
Steven Rostedt 已提交
4186

4187 4188 4189
	cpu_buffer->lost_events = 0;
	cpu_buffer->last_overrun = 0;

S
Steven Rostedt 已提交
4190
	rb_head_page_activate(cpu_buffer);
S
Steven Rostedt 已提交
4191 4192 4193 4194 4195 4196 4197 4198 4199 4200 4201 4202
}

/**
 * ring_buffer_reset_cpu - reset a ring buffer per CPU buffer
 * @buffer: The ring buffer to reset a per cpu buffer of
 * @cpu: The CPU buffer to be reset
 */
void ring_buffer_reset_cpu(struct ring_buffer *buffer, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer = buffer->buffers[cpu];
	unsigned long flags;

4203
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
4204
		return;
S
Steven Rostedt 已提交
4205

4206
	atomic_inc(&buffer->resize_disabled);
4207 4208
	atomic_inc(&cpu_buffer->record_disabled);

4209 4210 4211
	/* Make sure all commits have finished */
	synchronize_sched();

4212
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
4213

4214 4215 4216
	if (RB_WARN_ON(cpu_buffer, local_read(&cpu_buffer->committing)))
		goto out;

4217
	arch_spin_lock(&cpu_buffer->lock);
S
Steven Rostedt 已提交
4218 4219 4220

	rb_reset_cpu(cpu_buffer);

4221
	arch_spin_unlock(&cpu_buffer->lock);
S
Steven Rostedt 已提交
4222

4223
 out:
4224
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
4225 4226

	atomic_dec(&cpu_buffer->record_disabled);
4227
	atomic_dec(&buffer->resize_disabled);
S
Steven Rostedt 已提交
4228
}
4229
EXPORT_SYMBOL_GPL(ring_buffer_reset_cpu);
S
Steven Rostedt 已提交
4230 4231 4232 4233 4234 4235 4236 4237 4238 4239

/**
 * ring_buffer_reset - reset a ring buffer
 * @buffer: The ring buffer to reset all cpu buffers
 */
void ring_buffer_reset(struct ring_buffer *buffer)
{
	int cpu;

	for_each_buffer_cpu(buffer, cpu)
4240
		ring_buffer_reset_cpu(buffer, cpu);
S
Steven Rostedt 已提交
4241
}
4242
EXPORT_SYMBOL_GPL(ring_buffer_reset);
S
Steven Rostedt 已提交
4243 4244 4245 4246 4247

/**
 * rind_buffer_empty - is the ring buffer empty?
 * @buffer: The ring buffer to test
 */
4248
bool ring_buffer_empty(struct ring_buffer *buffer)
S
Steven Rostedt 已提交
4249 4250
{
	struct ring_buffer_per_cpu *cpu_buffer;
4251
	unsigned long flags;
4252
	bool dolock;
S
Steven Rostedt 已提交
4253
	int cpu;
4254
	int ret;
S
Steven Rostedt 已提交
4255 4256 4257 4258

	/* yes this is racy, but if you don't like the race, lock the buffer */
	for_each_buffer_cpu(buffer, cpu) {
		cpu_buffer = buffer->buffers[cpu];
4259
		local_irq_save(flags);
4260
		dolock = rb_reader_lock(cpu_buffer);
4261
		ret = rb_per_cpu_empty(cpu_buffer);
4262
		rb_reader_unlock(cpu_buffer, dolock);
4263 4264
		local_irq_restore(flags);

4265
		if (!ret)
4266
			return false;
S
Steven Rostedt 已提交
4267
	}
4268

4269
	return true;
S
Steven Rostedt 已提交
4270
}
4271
EXPORT_SYMBOL_GPL(ring_buffer_empty);
S
Steven Rostedt 已提交
4272 4273 4274 4275 4276 4277

/**
 * ring_buffer_empty_cpu - is a cpu buffer of a ring buffer empty?
 * @buffer: The ring buffer
 * @cpu: The CPU buffer to test
 */
4278
bool ring_buffer_empty_cpu(struct ring_buffer *buffer, int cpu)
S
Steven Rostedt 已提交
4279 4280
{
	struct ring_buffer_per_cpu *cpu_buffer;
4281
	unsigned long flags;
4282
	bool dolock;
4283
	int ret;
S
Steven Rostedt 已提交
4284

4285
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
4286
		return true;
S
Steven Rostedt 已提交
4287 4288

	cpu_buffer = buffer->buffers[cpu];
4289
	local_irq_save(flags);
4290
	dolock = rb_reader_lock(cpu_buffer);
4291
	ret = rb_per_cpu_empty(cpu_buffer);
4292
	rb_reader_unlock(cpu_buffer, dolock);
4293
	local_irq_restore(flags);
4294 4295

	return ret;
S
Steven Rostedt 已提交
4296
}
4297
EXPORT_SYMBOL_GPL(ring_buffer_empty_cpu);
S
Steven Rostedt 已提交
4298

4299
#ifdef CONFIG_RING_BUFFER_ALLOW_SWAP
S
Steven Rostedt 已提交
4300 4301 4302 4303 4304 4305 4306 4307 4308 4309 4310 4311 4312 4313 4314
/**
 * ring_buffer_swap_cpu - swap a CPU buffer between two ring buffers
 * @buffer_a: One buffer to swap with
 * @buffer_b: The other buffer to swap with
 *
 * This function is useful for tracers that want to take a "snapshot"
 * of a CPU buffer and has another back up buffer lying around.
 * it is expected that the tracer handles the cpu buffer not being
 * used at the moment.
 */
int ring_buffer_swap_cpu(struct ring_buffer *buffer_a,
			 struct ring_buffer *buffer_b, int cpu)
{
	struct ring_buffer_per_cpu *cpu_buffer_a;
	struct ring_buffer_per_cpu *cpu_buffer_b;
4315 4316
	int ret = -EINVAL;

4317 4318
	if (!cpumask_test_cpu(cpu, buffer_a->cpumask) ||
	    !cpumask_test_cpu(cpu, buffer_b->cpumask))
4319
		goto out;
S
Steven Rostedt 已提交
4320

4321 4322 4323
	cpu_buffer_a = buffer_a->buffers[cpu];
	cpu_buffer_b = buffer_b->buffers[cpu];

S
Steven Rostedt 已提交
4324
	/* At least make sure the two buffers are somewhat the same */
4325
	if (cpu_buffer_a->nr_pages != cpu_buffer_b->nr_pages)
4326 4327 4328
		goto out;

	ret = -EAGAIN;
S
Steven Rostedt 已提交
4329

4330
	if (atomic_read(&buffer_a->record_disabled))
4331
		goto out;
4332 4333

	if (atomic_read(&buffer_b->record_disabled))
4334
		goto out;
4335 4336

	if (atomic_read(&cpu_buffer_a->record_disabled))
4337
		goto out;
4338 4339

	if (atomic_read(&cpu_buffer_b->record_disabled))
4340
		goto out;
4341

S
Steven Rostedt 已提交
4342 4343 4344 4345 4346 4347 4348 4349 4350
	/*
	 * We can't do a synchronize_sched here because this
	 * function can be called in atomic context.
	 * Normally this will be called from the same CPU as cpu.
	 * If not it's up to the caller to protect this.
	 */
	atomic_inc(&cpu_buffer_a->record_disabled);
	atomic_inc(&cpu_buffer_b->record_disabled);

4351 4352 4353 4354 4355 4356
	ret = -EBUSY;
	if (local_read(&cpu_buffer_a->committing))
		goto out_dec;
	if (local_read(&cpu_buffer_b->committing))
		goto out_dec;

S
Steven Rostedt 已提交
4357 4358 4359 4360 4361 4362
	buffer_a->buffers[cpu] = cpu_buffer_b;
	buffer_b->buffers[cpu] = cpu_buffer_a;

	cpu_buffer_b->buffer = buffer_a;
	cpu_buffer_a->buffer = buffer_b;

4363 4364 4365
	ret = 0;

out_dec:
S
Steven Rostedt 已提交
4366 4367
	atomic_dec(&cpu_buffer_a->record_disabled);
	atomic_dec(&cpu_buffer_b->record_disabled);
4368 4369
out:
	return ret;
S
Steven Rostedt 已提交
4370
}
4371
EXPORT_SYMBOL_GPL(ring_buffer_swap_cpu);
4372
#endif /* CONFIG_RING_BUFFER_ALLOW_SWAP */
S
Steven Rostedt 已提交
4373

S
Steven Rostedt 已提交
4374 4375 4376
/**
 * ring_buffer_alloc_read_page - allocate a page to read from buffer
 * @buffer: the buffer to allocate for.
4377
 * @cpu: the cpu buffer to allocate.
S
Steven Rostedt 已提交
4378 4379 4380 4381 4382 4383 4384 4385 4386 4387 4388 4389
 *
 * This function is used in conjunction with ring_buffer_read_page.
 * When reading a full page from the ring buffer, these functions
 * can be used to speed up the process. The calling function should
 * allocate a few pages first with this function. Then when it
 * needs to get pages from the ring buffer, it passes the result
 * of this function into ring_buffer_read_page, which will swap
 * the page that was allocated, with the read page of the buffer.
 *
 * Returns:
 *  The page allocated, or NULL on error.
 */
4390
void *ring_buffer_alloc_read_page(struct ring_buffer *buffer, int cpu)
S
Steven Rostedt 已提交
4391
{
4392
	struct buffer_data_page *bpage;
4393
	struct page *page;
S
Steven Rostedt 已提交
4394

4395 4396
	page = alloc_pages_node(cpu_to_node(cpu),
				GFP_KERNEL | __GFP_NORETRY, 0);
4397
	if (!page)
S
Steven Rostedt 已提交
4398 4399
		return NULL;

4400
	bpage = page_address(page);
S
Steven Rostedt 已提交
4401

4402 4403
	rb_init_page(bpage);

4404
	return bpage;
S
Steven Rostedt 已提交
4405
}
S
Steven Rostedt 已提交
4406
EXPORT_SYMBOL_GPL(ring_buffer_alloc_read_page);
S
Steven Rostedt 已提交
4407 4408 4409 4410 4411 4412 4413 4414 4415 4416 4417 4418

/**
 * ring_buffer_free_read_page - free an allocated read page
 * @buffer: the buffer the page was allocate for
 * @data: the page to free
 *
 * Free a page allocated from ring_buffer_alloc_read_page.
 */
void ring_buffer_free_read_page(struct ring_buffer *buffer, void *data)
{
	free_page((unsigned long)data);
}
S
Steven Rostedt 已提交
4419
EXPORT_SYMBOL_GPL(ring_buffer_free_read_page);
S
Steven Rostedt 已提交
4420 4421 4422 4423 4424

/**
 * ring_buffer_read_page - extract a page from the ring buffer
 * @buffer: buffer to extract from
 * @data_page: the page to use allocated from ring_buffer_alloc_read_page
4425
 * @len: amount to extract
S
Steven Rostedt 已提交
4426 4427 4428 4429 4430 4431 4432 4433 4434
 * @cpu: the cpu of the buffer to extract
 * @full: should the extraction only happen when the page is full.
 *
 * This function will pull out a page from the ring buffer and consume it.
 * @data_page must be the address of the variable that was returned
 * from ring_buffer_alloc_read_page. This is because the page might be used
 * to swap with a page in the ring buffer.
 *
 * for example:
4435
 *	rpage = ring_buffer_alloc_read_page(buffer, cpu);
S
Steven Rostedt 已提交
4436 4437
 *	if (!rpage)
 *		return error;
4438
 *	ret = ring_buffer_read_page(buffer, &rpage, len, cpu, 0);
4439 4440
 *	if (ret >= 0)
 *		process_page(rpage, ret);
S
Steven Rostedt 已提交
4441 4442 4443 4444 4445 4446 4447 4448 4449 4450
 *
 * When @full is set, the function will not return true unless
 * the writer is off the reader page.
 *
 * Note: it is up to the calling functions to handle sleeps and wakeups.
 *  The ring buffer can be used anywhere in the kernel and can not
 *  blindly call wake_up. The layer that uses the ring buffer must be
 *  responsible for that.
 *
 * Returns:
4451 4452
 *  >=0 if data has been transferred, returns the offset of consumed data.
 *  <0 if no data has been transferred.
S
Steven Rostedt 已提交
4453 4454
 */
int ring_buffer_read_page(struct ring_buffer *buffer,
4455
			  void **data_page, size_t len, int cpu, int full)
S
Steven Rostedt 已提交
4456 4457 4458
{
	struct ring_buffer_per_cpu *cpu_buffer = buffer->buffers[cpu];
	struct ring_buffer_event *event;
4459
	struct buffer_data_page *bpage;
4460
	struct buffer_page *reader;
4461
	unsigned long missed_events;
S
Steven Rostedt 已提交
4462
	unsigned long flags;
4463
	unsigned int commit;
4464
	unsigned int read;
4465
	u64 save_timestamp;
4466
	int ret = -1;
S
Steven Rostedt 已提交
4467

4468 4469 4470
	if (!cpumask_test_cpu(cpu, buffer->cpumask))
		goto out;

4471 4472 4473 4474 4475
	/*
	 * If len is not big enough to hold the page header, then
	 * we can not copy anything.
	 */
	if (len <= BUF_PAGE_HDR_SIZE)
4476
		goto out;
4477 4478 4479

	len -= BUF_PAGE_HDR_SIZE;

S
Steven Rostedt 已提交
4480
	if (!data_page)
4481
		goto out;
S
Steven Rostedt 已提交
4482

4483 4484
	bpage = *data_page;
	if (!bpage)
4485
		goto out;
S
Steven Rostedt 已提交
4486

4487
	raw_spin_lock_irqsave(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
4488

4489 4490
	reader = rb_get_reader_page(cpu_buffer);
	if (!reader)
4491
		goto out_unlock;
S
Steven Rostedt 已提交
4492

4493 4494 4495 4496
	event = rb_reader_event(cpu_buffer);

	read = reader->read;
	commit = rb_page_commit(reader);
4497

4498
	/* Check if any events were dropped */
4499
	missed_events = cpu_buffer->lost_events;
4500

S
Steven Rostedt 已提交
4501
	/*
4502 4503 4504 4505 4506
	 * If this page has been partially read or
	 * if len is not big enough to read the rest of the page or
	 * a writer is still on the page, then
	 * we must copy the data from the page to the buffer.
	 * Otherwise, we can simply swap the page with the one passed in.
S
Steven Rostedt 已提交
4507
	 */
4508
	if (read || (len < (commit - read)) ||
4509
	    cpu_buffer->reader_page == cpu_buffer->commit_page) {
4510
		struct buffer_data_page *rpage = cpu_buffer->reader_page->page;
4511 4512
		unsigned int rpos = read;
		unsigned int pos = 0;
4513
		unsigned int size;
S
Steven Rostedt 已提交
4514 4515

		if (full)
4516
			goto out_unlock;
S
Steven Rostedt 已提交
4517

4518 4519 4520
		if (len > (commit - read))
			len = (commit - read);

4521 4522
		/* Always keep the time extend and data together */
		size = rb_event_ts_length(event);
4523 4524

		if (len < size)
4525
			goto out_unlock;
4526

4527 4528 4529
		/* save the current timestamp, since the user will need it */
		save_timestamp = cpu_buffer->read_stamp;

4530 4531
		/* Need to copy one event at a time */
		do {
4532 4533 4534 4535 4536 4537 4538
			/* We need the size of one event, because
			 * rb_advance_reader only advances by one event,
			 * whereas rb_event_ts_length may include the size of
			 * one or two events.
			 * We have already ensured there's enough space if this
			 * is a time extend. */
			size = rb_event_length(event);
4539
			memcpy(bpage->data + pos, rpage->data + rpos, size);
4540 4541 4542 4543

			len -= size;

			rb_advance_reader(cpu_buffer);
4544 4545
			rpos = reader->read;
			pos += size;
4546

4547 4548 4549
			if (rpos >= commit)
				break;

4550
			event = rb_reader_event(cpu_buffer);
4551 4552
			/* Always keep the time extend and data together */
			size = rb_event_ts_length(event);
4553
		} while (len >= size);
4554 4555

		/* update bpage */
4556
		local_set(&bpage->commit, pos);
4557
		bpage->time_stamp = save_timestamp;
4558

4559 4560
		/* we copied everything to the beginning */
		read = 0;
S
Steven Rostedt 已提交
4561
	} else {
4562
		/* update the entry counter */
S
Steven Rostedt 已提交
4563
		cpu_buffer->read += rb_page_entries(reader);
4564
		cpu_buffer->read_bytes += BUF_PAGE_SIZE;
4565

S
Steven Rostedt 已提交
4566
		/* swap the pages */
4567
		rb_init_page(bpage);
4568 4569 4570
		bpage = reader->page;
		reader->page = *data_page;
		local_set(&reader->write, 0);
4571
		local_set(&reader->entries, 0);
4572
		reader->read = 0;
4573
		*data_page = bpage;
4574 4575 4576 4577 4578 4579 4580 4581

		/*
		 * Use the real_end for the data size,
		 * This gives us a chance to store the lost events
		 * on the page.
		 */
		if (reader->real_end)
			local_set(&bpage->commit, reader->real_end);
S
Steven Rostedt 已提交
4582
	}
4583
	ret = read;
S
Steven Rostedt 已提交
4584

4585
	cpu_buffer->lost_events = 0;
4586 4587

	commit = local_read(&bpage->commit);
4588 4589 4590
	/*
	 * Set a flag in the commit field if we lost events
	 */
4591 4592 4593 4594 4595 4596 4597 4598
	if (missed_events) {
		/* If there is room at the end of the page to save the
		 * missed events, then record it there.
		 */
		if (BUF_PAGE_SIZE - commit >= sizeof(missed_events)) {
			memcpy(&bpage->data[commit], &missed_events,
			       sizeof(missed_events));
			local_add(RB_MISSED_STORED, &bpage->commit);
4599
			commit += sizeof(missed_events);
4600
		}
4601
		local_add(RB_MISSED_EVENTS, &bpage->commit);
4602
	}
4603

4604 4605 4606 4607 4608 4609
	/*
	 * This page may be off to user land. Zero it out here.
	 */
	if (commit < BUF_PAGE_SIZE)
		memset(&bpage->data[commit], 0, BUF_PAGE_SIZE - commit);

4610
 out_unlock:
4611
	raw_spin_unlock_irqrestore(&cpu_buffer->reader_lock, flags);
S
Steven Rostedt 已提交
4612

4613
 out:
S
Steven Rostedt 已提交
4614 4615
	return ret;
}
S
Steven Rostedt 已提交
4616
EXPORT_SYMBOL_GPL(ring_buffer_read_page);
S
Steven Rostedt 已提交
4617

4618 4619 4620 4621 4622 4623
/*
 * We only allocate new buffers, never free them if the CPU goes down.
 * If we were to free the buffer, then the user would lose any trace that was in
 * the buffer.
 */
int trace_rb_cpu_prepare(unsigned int cpu, struct hlist_node *node)
4624
{
4625
	struct ring_buffer *buffer;
4626 4627 4628
	long nr_pages_same;
	int cpu_i;
	unsigned long nr_pages;
4629

4630 4631 4632 4633 4634 4635 4636 4637 4638 4639 4640 4641 4642 4643
	buffer = container_of(node, struct ring_buffer, node);
	if (cpumask_test_cpu(cpu, buffer->cpumask))
		return 0;

	nr_pages = 0;
	nr_pages_same = 1;
	/* check if all cpu sizes are same */
	for_each_buffer_cpu(buffer, cpu_i) {
		/* fill in the size from first enabled cpu */
		if (nr_pages == 0)
			nr_pages = buffer->buffers[cpu_i]->nr_pages;
		if (nr_pages != buffer->buffers[cpu_i]->nr_pages) {
			nr_pages_same = 0;
			break;
4644 4645
		}
	}
4646 4647 4648 4649 4650 4651 4652 4653 4654 4655 4656 4657 4658
	/* allocate minimum pages, user can later expand it */
	if (!nr_pages_same)
		nr_pages = 2;
	buffer->buffers[cpu] =
		rb_allocate_cpu_buffer(buffer, nr_pages, cpu);
	if (!buffer->buffers[cpu]) {
		WARN(1, "failed to allocate ring buffer on CPU %u\n",
		     cpu);
		return -ENOMEM;
	}
	smp_wmb();
	cpumask_set_cpu(cpu, buffer->cpumask);
	return 0;
4659
}
4660 4661 4662 4663 4664 4665 4666 4667 4668 4669 4670 4671 4672 4673 4674 4675 4676 4677 4678 4679 4680 4681 4682 4683 4684 4685 4686 4687 4688 4689 4690 4691 4692 4693 4694 4695 4696 4697 4698 4699 4700 4701 4702 4703 4704 4705 4706 4707 4708 4709 4710 4711 4712 4713 4714 4715 4716 4717 4718 4719 4720 4721 4722 4723 4724 4725 4726 4727 4728 4729 4730 4731 4732 4733 4734 4735 4736 4737 4738 4739 4740 4741 4742 4743 4744 4745 4746 4747 4748 4749 4750 4751 4752 4753 4754 4755 4756 4757 4758 4759 4760 4761 4762 4763 4764 4765 4766 4767 4768 4769 4770 4771 4772 4773 4774 4775 4776 4777 4778 4779 4780 4781 4782 4783 4784 4785 4786 4787 4788 4789 4790 4791 4792 4793 4794 4795 4796 4797 4798 4799 4800 4801 4802 4803 4804 4805 4806 4807 4808 4809 4810 4811 4812 4813 4814 4815 4816 4817 4818 4819 4820 4821 4822 4823 4824 4825 4826 4827 4828 4829 4830 4831 4832 4833 4834 4835 4836 4837 4838 4839 4840

#ifdef CONFIG_RING_BUFFER_STARTUP_TEST
/*
 * This is a basic integrity check of the ring buffer.
 * Late in the boot cycle this test will run when configured in.
 * It will kick off a thread per CPU that will go into a loop
 * writing to the per cpu ring buffer various sizes of data.
 * Some of the data will be large items, some small.
 *
 * Another thread is created that goes into a spin, sending out
 * IPIs to the other CPUs to also write into the ring buffer.
 * this is to test the nesting ability of the buffer.
 *
 * Basic stats are recorded and reported. If something in the
 * ring buffer should happen that's not expected, a big warning
 * is displayed and all ring buffers are disabled.
 */
static struct task_struct *rb_threads[NR_CPUS] __initdata;

struct rb_test_data {
	struct ring_buffer	*buffer;
	unsigned long		events;
	unsigned long		bytes_written;
	unsigned long		bytes_alloc;
	unsigned long		bytes_dropped;
	unsigned long		events_nested;
	unsigned long		bytes_written_nested;
	unsigned long		bytes_alloc_nested;
	unsigned long		bytes_dropped_nested;
	int			min_size_nested;
	int			max_size_nested;
	int			max_size;
	int			min_size;
	int			cpu;
	int			cnt;
};

static struct rb_test_data rb_data[NR_CPUS] __initdata;

/* 1 meg per cpu */
#define RB_TEST_BUFFER_SIZE	1048576

static char rb_string[] __initdata =
	"abcdefghijklmnopqrstuvwxyz1234567890!@#$%^&*()?+\\"
	"?+|:';\",.<>/?abcdefghijklmnopqrstuvwxyz1234567890"
	"!@#$%^&*()?+\\?+|:';\",.<>/?abcdefghijklmnopqrstuv";

static bool rb_test_started __initdata;

struct rb_item {
	int size;
	char str[];
};

static __init int rb_write_something(struct rb_test_data *data, bool nested)
{
	struct ring_buffer_event *event;
	struct rb_item *item;
	bool started;
	int event_len;
	int size;
	int len;
	int cnt;

	/* Have nested writes different that what is written */
	cnt = data->cnt + (nested ? 27 : 0);

	/* Multiply cnt by ~e, to make some unique increment */
	size = (data->cnt * 68 / 25) % (sizeof(rb_string) - 1);

	len = size + sizeof(struct rb_item);

	started = rb_test_started;
	/* read rb_test_started before checking buffer enabled */
	smp_rmb();

	event = ring_buffer_lock_reserve(data->buffer, len);
	if (!event) {
		/* Ignore dropped events before test starts. */
		if (started) {
			if (nested)
				data->bytes_dropped += len;
			else
				data->bytes_dropped_nested += len;
		}
		return len;
	}

	event_len = ring_buffer_event_length(event);

	if (RB_WARN_ON(data->buffer, event_len < len))
		goto out;

	item = ring_buffer_event_data(event);
	item->size = size;
	memcpy(item->str, rb_string, size);

	if (nested) {
		data->bytes_alloc_nested += event_len;
		data->bytes_written_nested += len;
		data->events_nested++;
		if (!data->min_size_nested || len < data->min_size_nested)
			data->min_size_nested = len;
		if (len > data->max_size_nested)
			data->max_size_nested = len;
	} else {
		data->bytes_alloc += event_len;
		data->bytes_written += len;
		data->events++;
		if (!data->min_size || len < data->min_size)
			data->max_size = len;
		if (len > data->max_size)
			data->max_size = len;
	}

 out:
	ring_buffer_unlock_commit(data->buffer, event);

	return 0;
}

static __init int rb_test(void *arg)
{
	struct rb_test_data *data = arg;

	while (!kthread_should_stop()) {
		rb_write_something(data, false);
		data->cnt++;

		set_current_state(TASK_INTERRUPTIBLE);
		/* Now sleep between a min of 100-300us and a max of 1ms */
		usleep_range(((data->cnt % 3) + 1) * 100, 1000);
	}

	return 0;
}

static __init void rb_ipi(void *ignore)
{
	struct rb_test_data *data;
	int cpu = smp_processor_id();

	data = &rb_data[cpu];
	rb_write_something(data, true);
}

static __init int rb_hammer_test(void *arg)
{
	while (!kthread_should_stop()) {

		/* Send an IPI to all cpus to write data! */
		smp_call_function(rb_ipi, NULL, 1);
		/* No sleep, but for non preempt, let others run */
		schedule();
	}

	return 0;
}

static __init int test_ringbuffer(void)
{
	struct task_struct *rb_hammer;
	struct ring_buffer *buffer;
	int cpu;
	int ret = 0;

	pr_info("Running ring buffer tests...\n");

	buffer = ring_buffer_alloc(RB_TEST_BUFFER_SIZE, RB_FL_OVERWRITE);
	if (WARN_ON(!buffer))
		return 0;

	/* Disable buffer so that threads can't write to it yet */
	ring_buffer_record_off(buffer);

	for_each_online_cpu(cpu) {
		rb_data[cpu].buffer = buffer;
		rb_data[cpu].cpu = cpu;
		rb_data[cpu].cnt = cpu;
		rb_threads[cpu] = kthread_create(rb_test, &rb_data[cpu],
						 "rbtester/%d", cpu);
4841
		if (WARN_ON(IS_ERR(rb_threads[cpu]))) {
4842
			pr_cont("FAILED\n");
4843
			ret = PTR_ERR(rb_threads[cpu]);
4844 4845 4846 4847 4848 4849 4850 4851 4852
			goto out_free;
		}

		kthread_bind(rb_threads[cpu], cpu);
 		wake_up_process(rb_threads[cpu]);
	}

	/* Now create the rb hammer! */
	rb_hammer = kthread_run(rb_hammer_test, NULL, "rbhammer");
4853
	if (WARN_ON(IS_ERR(rb_hammer))) {
4854
		pr_cont("FAILED\n");
4855
		ret = PTR_ERR(rb_hammer);
4856 4857 4858 4859 4860 4861 4862 4863 4864 4865 4866 4867 4868 4869 4870 4871 4872 4873 4874 4875 4876 4877 4878 4879 4880 4881 4882 4883 4884 4885 4886 4887 4888 4889 4890 4891 4892 4893 4894 4895 4896 4897 4898 4899 4900 4901 4902 4903 4904 4905 4906 4907 4908 4909 4910 4911 4912 4913 4914 4915 4916 4917 4918 4919 4920 4921 4922 4923 4924 4925 4926 4927 4928 4929 4930 4931 4932 4933 4934 4935 4936 4937 4938 4939 4940 4941 4942 4943 4944 4945 4946 4947 4948 4949 4950 4951 4952 4953 4954 4955 4956 4957 4958 4959 4960 4961 4962 4963 4964 4965 4966 4967 4968 4969 4970 4971 4972 4973 4974 4975 4976
		goto out_free;
	}

	ring_buffer_record_on(buffer);
	/*
	 * Show buffer is enabled before setting rb_test_started.
	 * Yes there's a small race window where events could be
	 * dropped and the thread wont catch it. But when a ring
	 * buffer gets enabled, there will always be some kind of
	 * delay before other CPUs see it. Thus, we don't care about
	 * those dropped events. We care about events dropped after
	 * the threads see that the buffer is active.
	 */
	smp_wmb();
	rb_test_started = true;

	set_current_state(TASK_INTERRUPTIBLE);
	/* Just run for 10 seconds */;
	schedule_timeout(10 * HZ);

	kthread_stop(rb_hammer);

 out_free:
	for_each_online_cpu(cpu) {
		if (!rb_threads[cpu])
			break;
		kthread_stop(rb_threads[cpu]);
	}
	if (ret) {
		ring_buffer_free(buffer);
		return ret;
	}

	/* Report! */
	pr_info("finished\n");
	for_each_online_cpu(cpu) {
		struct ring_buffer_event *event;
		struct rb_test_data *data = &rb_data[cpu];
		struct rb_item *item;
		unsigned long total_events;
		unsigned long total_dropped;
		unsigned long total_written;
		unsigned long total_alloc;
		unsigned long total_read = 0;
		unsigned long total_size = 0;
		unsigned long total_len = 0;
		unsigned long total_lost = 0;
		unsigned long lost;
		int big_event_size;
		int small_event_size;

		ret = -1;

		total_events = data->events + data->events_nested;
		total_written = data->bytes_written + data->bytes_written_nested;
		total_alloc = data->bytes_alloc + data->bytes_alloc_nested;
		total_dropped = data->bytes_dropped + data->bytes_dropped_nested;

		big_event_size = data->max_size + data->max_size_nested;
		small_event_size = data->min_size + data->min_size_nested;

		pr_info("CPU %d:\n", cpu);
		pr_info("              events:    %ld\n", total_events);
		pr_info("       dropped bytes:    %ld\n", total_dropped);
		pr_info("       alloced bytes:    %ld\n", total_alloc);
		pr_info("       written bytes:    %ld\n", total_written);
		pr_info("       biggest event:    %d\n", big_event_size);
		pr_info("      smallest event:    %d\n", small_event_size);

		if (RB_WARN_ON(buffer, total_dropped))
			break;

		ret = 0;

		while ((event = ring_buffer_consume(buffer, cpu, NULL, &lost))) {
			total_lost += lost;
			item = ring_buffer_event_data(event);
			total_len += ring_buffer_event_length(event);
			total_size += item->size + sizeof(struct rb_item);
			if (memcmp(&item->str[0], rb_string, item->size) != 0) {
				pr_info("FAILED!\n");
				pr_info("buffer had: %.*s\n", item->size, item->str);
				pr_info("expected:   %.*s\n", item->size, rb_string);
				RB_WARN_ON(buffer, 1);
				ret = -1;
				break;
			}
			total_read++;
		}
		if (ret)
			break;

		ret = -1;

		pr_info("         read events:   %ld\n", total_read);
		pr_info("         lost events:   %ld\n", total_lost);
		pr_info("        total events:   %ld\n", total_lost + total_read);
		pr_info("  recorded len bytes:   %ld\n", total_len);
		pr_info(" recorded size bytes:   %ld\n", total_size);
		if (total_lost)
			pr_info(" With dropped events, record len and size may not match\n"
				" alloced and written from above\n");
		if (!total_lost) {
			if (RB_WARN_ON(buffer, total_len != total_alloc ||
				       total_size != total_written))
				break;
		}
		if (RB_WARN_ON(buffer, total_lost + total_read != total_events))
			break;

		ret = 0;
	}
	if (!ret)
		pr_info("Ring buffer PASSED!\n");

	ring_buffer_free(buffer);
	return 0;
}

late_initcall(test_ringbuffer);
#endif /* CONFIG_RING_BUFFER_STARTUP_TEST */