tools/power/x86/intel-speed-select/isst.h

File Facts

System

Linux kernel

Corpus path

tools/power/x86/intel-speed-select/isst.h

Extension

.h

Size

11828 bytes

Lines

329

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

• stdio.h
• unistd.h
• sys/types.h
• sched.h
• sys/stat.h
• sys/resource.h
• getopt.h
• err.h
• fcntl.h
• signal.h
• sys/time.h
• limits.h
• stdlib.h
• string.h
• cpuid.h
• dirent.h
• errno.h
• stdarg.h
• sys/ioctl.h
• linux/isst_if.h

Detected Declarations

• struct isst_id
• struct isst_clos_config
• struct isst_fact_bucket_info
• struct isst_pbf_info
• struct isst_fact_info
• struct isst_pkg_ctdp_level_info
• struct isst_pkg_ctdp
• struct isst_platform_ops
• enum isst_platform_param

Annotated Snippet

struct isst_id {
	int cpu;
	int pkg;
	int die;
	int punit;
};

struct isst_clos_config {
	unsigned int clos_min;
	unsigned int clos_max;
	unsigned char epp;
	unsigned char clos_prop_prio;
	unsigned char clos_desired;
};

struct isst_fact_bucket_info {
	int hp_cores;
	int hp_ratios[TRL_MAX_LEVELS];
};

struct isst_pbf_info {
	int pbf_acticated;
	int pbf_available;
	size_t core_cpumask_size;
	cpu_set_t *core_cpumask;
	int p1_high;
	int p1_low;
	int t_control;
	int t_prochot;
	int tdp;
};

#define ISST_TRL_MAX_ACTIVE_CORES	8
#define ISST_FACT_MAX_BUCKETS		8
struct isst_fact_info {
	int lp_ratios[TRL_MAX_LEVELS];
	struct isst_fact_bucket_info bucket_info[ISST_FACT_MAX_BUCKETS];
};

struct isst_pkg_ctdp_level_info {
	int processed;
	int control_cpu;
	int pkg_id;
	int die_id;
	int level;
	int fact_support;
	int pbf_support;
	int fact_enabled;
	int pbf_enabled;
	int sst_cp_support;
	int sst_cp_enabled;
	int tdp_ratio;
	int active;
	int tdp_control;
	int pkg_tdp;
	int pkg_min_power;
	int pkg_max_power;
	int fact;
	int t_proc_hot;
	int cooling_type;
	int uncore_p0;
	int uncore_p1;
	int uncore_pm;
	int uncore1_p0;
	int uncore1_p1;
	int uncore1_pm;
	int sse_p1;
	int avx2_p1;
	int avx512_p1;
	int amx_p1;
	int mem_freq;
	size_t core_cpumask_size;
	cpu_set_t *core_cpumask;
	int cpu_count;
	unsigned long long trl_cores;	/* Buckets info */
	int trl_ratios[TRL_MAX_LEVELS][ISST_TRL_MAX_ACTIVE_CORES];
	int kobj_bucket_index;
	int active_bucket;
	int fact_max_index;
	int fact_max_config;
	int pbf_found;
	int pbf_active;
	struct isst_pbf_info pbf_info;
	struct isst_fact_info fact_info;
};

#define ISST_MAX_TDP_LEVELS	(4 + 1) /* +1 for base config */
struct isst_pkg_ctdp {
	int locked;
	int version;

Annotation

• Immediate include surface: `stdio.h`, `unistd.h`, `sys/types.h`, `sched.h`, `sys/stat.h`, `sys/resource.h`, `getopt.h`, `err.h`.
• Detected declarations: `struct isst_id`, `struct isst_clos_config`, `struct isst_fact_bucket_info`, `struct isst_pbf_info`, `struct isst_fact_info`, `struct isst_pkg_ctdp_level_info`, `struct isst_pkg_ctdp`, `struct isst_platform_ops`, `enum isst_platform_param`.
• 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.