tools/power/x86/intel-speed-select/isst-config.c

File Facts

System

Linux kernel

Corpus path

tools/power/x86/intel-speed-select/isst-config.c

Extension

.c

Size

81377 bytes

Lines

3387

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

• ctype.h
• linux/isst_if.h
• isst.h

Detected Declarations

• struct process_cmd_struct
• struct _cpu_map
• struct cpu_topology
• struct process_cmd_help_struct
• function print_version
• function check_privilege
• function is_debug_enabled
• function debug_printf
• function is_clx_n_platform
• function is_skx_based_platform
• function is_spr_platform
• function is_emr_platform
• function is_icx_platform
• function is_dmr_plus_platform
• function update_cpu_model
• function api_version
• function parse_int_file
• function cpufreq_sysfs_present
• function out_format_is_json
• function get_stored_topology_info
• function store_cpu_topology
• function get_physical_package_id
• function get_physical_core_id
• function get_physical_die_id
• function get_physical_punit_id
• function set_isst_id
• function is_cpu_in_power_domain
• function get_cpufreq_base_freq
• function get_topo_max_cpus
• function is_cpu_online
• function set_cpu_online_offline
• function force_all_cpus_online
• function for_each_online_power_domain_in_set
• function for_each_online_target_cpu_in_set
• function set_max_cpu_num
• function alloc_cpu_set
• function free_cpu_set
• function get_max_punit_core_id
• function get_cpu_count
• function update_punit_cpu_info
• function create_cpu_map
• function set_cpu_mask_from_punit_coremask
• function find_phy_core_num
• function use_cgroupv2
• function enable_cpuset_controller
• function isolate_cpus
• function cpu_0_workaround
• function isst_fill_platform_info

Annotated Snippet

struct process_cmd_struct {
	char *feature;
	char *command;
	void (*process_fn)(int arg);
	int arg;
};

static const char *version_str = "v1.26";

static const int supported_api_ver = 3;
static struct isst_if_platform_info isst_platform_info;
static char *progname;
static int debug_flag;
static FILE *outf;

static int cpu_model;
static int cpu_stepping;
static int cpu_family;

#define MAX_CPUS_IN_ONE_REQ 512
static short max_target_cpus;
static unsigned short target_cpus[MAX_CPUS_IN_ONE_REQ];

static int topo_max_cpus;
static size_t present_cpumask_size;
static cpu_set_t *present_cpumask;
static size_t target_cpumask_size;
static cpu_set_t *target_cpumask;
static int tdp_level = 0xFF;
static int fact_bucket = 0xFF;
static int fact_avx = 0xFF;
static unsigned long long fact_trl;
static int out_format_json;
static int cmd_help;
static int force_online_offline;
static int auto_mode;
static int fact_enable_fail;
static int cgroupv2;
static int max_pkg_id;
static int max_die_id;
static int max_die_id_package_0;

/* clos related */
static int current_clos = -1;
static int clos_epp = -1;
static int clos_prop_prio = -1;
static int clos_min = -1;
static int clos_max = -1;
static int clos_desired = -1;
static int clos_priority_type;
static int cpu_0_cgroupv2;
static int cpu_0_workaround(int isolate);

struct _cpu_map {
	unsigned short core_id;
	unsigned short pkg_id;
	unsigned short die_id;
	unsigned short punit_id;
	unsigned short punit_cpu;
	unsigned short punit_cpu_core;
	unsigned short initialized;
};
struct _cpu_map *cpu_map;

struct cpu_topology {
	short cpu;
	short core_id;
	short pkg_id;
	short die_id;
};

static int read_only;

static void print_version(void)
{
	fprintf(outf, "Version %s\n", version_str);
}

static void check_privilege(void)
{
	if (!read_only)
		return;

	isst_display_error_info_message(1, "Insufficient privileges", 0, 0);
	isst_ctdp_display_information_end(outf);
	exit(1);
}

FILE *get_output_file(void)
{

Annotation

• Immediate include surface: `ctype.h`, `linux/isst_if.h`, `isst.h`.
• Detected declarations: `struct process_cmd_struct`, `struct _cpu_map`, `struct cpu_topology`, `struct process_cmd_help_struct`, `function print_version`, `function check_privilege`, `function is_debug_enabled`, `function debug_printf`, `function is_clx_n_platform`, `function is_skx_based_platform`.
• 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.