ECAG (Extract CPU Attribute) kernel API. More...

import std;
import lib.bit;
import lib.error;
import zxfoundation.base.types;

Include dependency graph for ecag.cxxm:

Data Structures
union	arch::s390x::cpu::ecag::cache_summary
	Full topology summary (ASI=cache, AI=extract_topo_summary). More...
union	arch::s390x::cpu::ecag::cache_summary_entry
	One byte of a topology-summary result. More...
struct	arch::s390x::cpu::ecag::cpu_speed
	CPU-speed result (ASI=cpu, AI=extract_cpu_speed). More...

Enumerations
enum class	attribute_indication : u8 { extract_topo_summary = 0 , extract_cache_line_size = 1 , extract_cache_size = 2 , extract_cache_associativity = 3 }
enum class	attribute_set_indication : u32 { cache = 0 , cpu = 1 }
enum class	cache_level : u8 { l1 = 0 , l2 = 1 , l3 = 2 , l4 = 3 , l5 = 4 , l6 = 5 , l7 = 6 , l8 = 7 }
enum class	cache_scope : u8 { does_not_exist = 0b00 , private_to_cpu = 0b01 , may_be_shared = 0b10 , reserved = 0b11 }
enum class	cache_type : u8 { separate = 0b00 , instruction = 0b01 , data = 0b10 , unified = 0b11 }
enum class	cpu_attribute_indication : u8 { extract_cpu_speed = 0 }
enum class	type_indication : u8 { data = 0b0 , instruction = 0b1 }

Functions
	__endian__ (BIG)
	arch::s390x::cpu::ecag::assert_size (cache_summary, 8)
	arch::s390x::cpu::ecag::assert_size (cache_summary_entry, 1)
	arch::s390x::cpu::ecag::assert_size (cpu_speed, 8)
constexpr auto	arch::s390x::cpu::ecag::begin (const cache_summary &s) noexcept
constexpr auto	arch::s390x::cpu::ecag::end (const cache_summary &s) noexcept
template<attribute_set_indication Asi>
auto	arch::s390x::cpu::ecag::detail::invoke (u8 parm) noexcept -> std::expected< u64, lib::kernel_error >
	Invoke raw ECAG.
constexpr auto	arch::s390x::cpu::ecag::detail::pack_cache_parm (attribute_indication ai, cache_level li, type_indication ti) noexcept -> u8
	Build the AI[4] \| LI[3] \| TI[1] byte for a cache-set query.
template<attribute_indication Indication, cache_level Level, type_indication Type> requires (Indication != attribute_indication::extract_topo_summary)
auto	arch::s390x::cpu::ecag::query_cache_attribute () noexcept -> std::expected< u64, lib::kernel_error >
	Extract a scalar cache attribute.
auto	arch::s390x::cpu::ecag::query_cpu_speed () noexcept -> std::expected< cpu_speed, lib::kernel_error >
	Extract dynamic/static CPU speed via ECAG.
auto	arch::s390x::cpu::ecag::query_topology () noexcept -> std::expected< cache_summary, lib::kernel_error >
	Extract the per-level cache topology summary.

Variables
constexpr u64	arch::s390x::cpu::ecag::detail::invalid_sentinel = ~u64{0}

Detailed Description

ECAG (Extract CPU Attribute) kernel API.

SPDX-License-Identifier: Apache-2.0

ZXFoundation™ 26h2

Data Structures