tools/perf/builtin-kwork.c

File Facts

System

Linux kernel

Corpus path

tools/perf/builtin-kwork.c

Extension

.c

Size

65155 bytes

Lines

2547

Domain

Support Tooling And Documentation

Bucket

tools

Inferred role

Support Tooling And Documentation: implementation source

Status

source implementation candidate

Why This File Exists

Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.

• Repository support layer: documentation, build tooling, samples, user-space helper tools, generated initramfs support, licenses, and validation utilities.
• Defines or uses C structs; map object ownership, embedded links, reference counts, and lock ownership.

Dependency Surface

• builtin.h
• perf.h
• util/data.h
• util/evlist.h
• util/evsel.h
• util/header.h
• util/kwork.h
• util/debug.h
• util/session.h
• util/symbol.h
• util/thread.h
• util/string2.h
• util/callchain.h
• util/evsel_fprintf.h
• util/util.h
• subcmd/pager.h
• subcmd/parse-options.h
• event-parse.h
• errno.h
• inttypes.h
• signal.h
• linux/err.h
• linux/time64.h
• linux/zalloc.h

Detected Declarations

• struct sort_dimension
• function id_cmp
• function count_cmp
• function runtime_cmp
• function max_runtime_cmp
• function avg_latency_cmp
• function max_latency_cmp
• function cpu_usage_cmp
• function id_or_cpu_r_cmp
• function sort_dimension__add
• function setup_sorting
• function list_for_each_entry
• function atom_free
• function atom_del
• function work_cmp
• function list_for_each_entry
• function work_insert
• function profile_update_timespan
• function profile_name_match
• function profile_event_match
• function work_push_atom
• function list_for_each_entry
• function report_update_exit_event
• function report_entry_event
• function report_exit_event
• function latency_update_entry_event
• function latency_raise_event
• function latency_entry_event
• function timehist_save_callchain
• function timehist_print_event
• function timehist_raise_event
• function timehist_entry_event
• function timehist_exit_event
• function top_update_runtime
• function top_entry_event
• function top_exit_event
• function top_sched_switch_event
• function process_irq_handler_entry_event
• function process_irq_handler_exit_event
• function irq_class_init
• function irq_work_init
• function irq_work_name
• function process_softirq_raise_event
• function process_softirq_entry_event
• function process_softirq_exit_event
• function softirq_class_init
• function softirq_work_init
• function softirq_work_name

Annotated Snippet

struct sort_dimension {
	const char      *name;
	int             (*cmp)(struct kwork_work *l, struct kwork_work *r);
	struct          list_head list;
};

static int id_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->cpu > r->cpu)
		return 1;
	if (l->cpu < r->cpu)
		return -1;

	if (l->id > r->id)
		return 1;
	if (l->id < r->id)
		return -1;

	return 0;
}

static int count_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->nr_atoms > r->nr_atoms)
		return 1;
	if (l->nr_atoms < r->nr_atoms)
		return -1;

	return 0;
}

static int runtime_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->total_runtime > r->total_runtime)
		return 1;
	if (l->total_runtime < r->total_runtime)
		return -1;

	return 0;
}

static int max_runtime_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->max_runtime > r->max_runtime)
		return 1;
	if (l->max_runtime < r->max_runtime)
		return -1;

	return 0;
}

static int avg_latency_cmp(struct kwork_work *l, struct kwork_work *r)
{
	u64 avgl, avgr;

	if (!r->nr_atoms)
		return 1;
	if (!l->nr_atoms)
		return -1;

	avgl = l->total_latency / l->nr_atoms;
	avgr = r->total_latency / r->nr_atoms;

	if (avgl > avgr)
		return 1;
	if (avgl < avgr)
		return -1;

	return 0;
}

static int max_latency_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->max_latency > r->max_latency)
		return 1;
	if (l->max_latency < r->max_latency)
		return -1;

	return 0;
}

static int cpu_usage_cmp(struct kwork_work *l, struct kwork_work *r)
{
	if (l->cpu_usage > r->cpu_usage)
		return 1;
	if (l->cpu_usage < r->cpu_usage)
		return -1;

	return 0;
}

Annotation

• Immediate include surface: `builtin.h`, `perf.h`, `util/data.h`, `util/evlist.h`, `util/evsel.h`, `util/header.h`, `util/kwork.h`, `util/debug.h`.
• Detected declarations: `struct sort_dimension`, `function id_cmp`, `function count_cmp`, `function runtime_cmp`, `function max_runtime_cmp`, `function avg_latency_cmp`, `function max_latency_cmp`, `function cpu_usage_cmp`, `function id_or_cpu_r_cmp`, `function sort_dimension__add`.
• Atlas domain: Support Tooling And Documentation / tools.
• Implementation status: source implementation candidate.

Implementation Notes

• This generated page is the file-by-file coverage layer; curated subsystem chapters should link here when they synthesize a multi-file control flow.
• Core OS pages should be promoted from atlas-only to deep-reviewed when they explain data structures, invariants, locking, lifecycle, and C implementation snippets.
• Driver-family pages are intentionally pattern-oriented unless they are part of the selected PCIe/NVMe representative device path.