Skip to content

Commit 2f9f58c

Browse files
committed
Move standalone articles to a different repo
Signed-off-by: Artem Bityutskiy <artem.bityutskiy@linux.intel.com>
1 parent b40537e commit 2f9f58c

17 files changed

Lines changed: 74 additions & 2665 deletions

README.md

Lines changed: 26 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -12,17 +12,20 @@ Author: Artem Bityutskiy <artem.bityutskiy@linux.intel.com>
1212

1313
## Table of Contents
1414

15-
- [Introduction](#introduction)
16-
- [Disclaimer](#disclaimer)
17-
- [Privileges](#privileges)
18-
- [Requirements](#requirements)
19-
- [Installation](#installation)
20-
- [User Guide](#user-guide)
21-
- [Repository Tools](#repository-tools)
22-
- [Contributing](#contributing)
23-
- [Man pages](#man-pages)
24-
- [Helpful resources](#helpful-resources)
25-
- [FAQ](#faq)
15+
- [pepc](#pepc)
16+
- [Table of Contents](#table-of-contents)
17+
- [Introduction](#introduction)
18+
- [Disclaimer](#disclaimer)
19+
- [Privileges](#privileges)
20+
- [Requirements](#requirements)
21+
- [Installation](#installation)
22+
- [User Guide](#user-guide)
23+
- [Repository Tools](#repository-tools)
24+
- [Contributing](#contributing)
25+
- [Man pages](#man-pages)
26+
- [Helpful resources](#helpful-resources)
27+
- [FAQ](#faq)
28+
- [What to do if my platform is not supported?](#what-to-do-if-my-platform-is-not-supported)
2629

2730
## Introduction
2831

@@ -77,7 +80,7 @@ must be run from the repository.
7780
[Tests Guide](docs/guide-tests.md).
7881
- `tools/msr-ioscope`: determines the I/O scope (package, die, core, CPU) of MSR bits on a real
7982
system.
80-
See [MSR Scope](docs/misc-msr-scope.md).
83+
See [MSR Scope](https://github.com/dedekind/dedekind-share/blob/master/2025/msr-scope.md).
8184
- `tools/make-standalone`: packages `pepc` and its dependencies into a single standalone executable.
8285
- `tools/tpmi-spec-files-generator`: generates TPMI specification XML files from raw data.
8386
- `tools/make-a-release`: prepares a new `pepc` release (changelog, version bump, commit, tag).
@@ -106,23 +109,17 @@ Some features are hardware-agnostic, while others depend on specific hardware ca
106109

107110
## Helpful resources
108111

109-
- [Intel CPU Base Frequency Explained](docs/misc-cpu-base-freq.md) - explains the concept of CPU base
110-
frequency and many CPU performance scaling topics.
111-
- [Intel C-state namespaces](docs/misc-cstate-namespaces.md) - explains C-state naming conventions.
112-
- [Xeon C6P and C6SP Idle States](docs/misc-c6p-c6sp.md) - explains the C6P and C6SP idle states on
113-
Intel Xeon platforms.
114-
115-
- [Uncore ELC and Frequency Scaling](docs/misc-uncore-elc.md) - explains the uncore ELC mechanism.
116-
- [MSR scope](docs/misc-msr-scope.md) - explains the concept of MSR scope (per-core, per-module,
117-
per-package) and related pitfalls.
118-
119-
The following articles are not directly related to `pepc`, but may be helpful to understand some of
120-
the features `pepc` manages.
121-
122-
- [Measured CPU Frequency and C-states](docs/misc-c1e-cpu-freq.md) - explains why measured CPU
123-
frequency may be lower than expected when C1E or deeper C-states are enabled.
124-
- [TSC, APERF, and MPERF Counters](docs/misc-tsc-amperf.md) - explains the TSC, APERF, and MPERF
125-
counters and their interaction.
112+
- [Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md):
113+
explains the concept of CPU base frequency and many CPU performance scaling topics.
114+
- [Intel C-state namespaces](https://github.com/dedekind/dedekind-share/blob/master/2025/cstate-namespaces.md):
115+
explains C-state naming conventions.
116+
- [Xeon C6P and C6SP Idle States](https://github.com/dedekind/dedekind-share/blob/master/2025/c6p-c6sp.md):
117+
explains the C6P and C6SP idle states on Intel Xeon platforms.
118+
119+
- [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md):
120+
explains the uncore ELC mechanism.
121+
- [MSR scope](https://github.com/dedekind/dedekind-share/blob/master/2025/msr-scope.md):
122+
explains the concept of MSR scope (per-core, per-module, per-package) and related pitfalls.
126123

127124
## FAQ
128125

docs/guide-cstates.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ other hand, the 'pepc uncore info --min-freq' option supports both 'sysfs' and '
9898
because the minimum uncore frequency is supposed to be the same when read via sysfs or TPMI.
9999

100100
**Note:** The difference between CPPC and HWP guaranteed performance levels is explained in the
101-
[Intel CPU Base Frequency Explained](misc-cpu-base-freq.md) article.
101+
[Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md) article.
102102

103103
### Getting Help
104104

@@ -180,7 +180,7 @@ The `pepc pstates` command groups operations related to CPU performance states (
180180
example, it supports reading and changing CPU frequency limits.
181181

182182
If you are new to Intel CPU P-states, the
183-
[Intel CPU Base Frequency Explained](misc-cpu-base-freq.md)
183+
[Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md)
184184
article explains many concepts related to CPU performance scaling.
185185

186186
### Examples
@@ -337,8 +337,8 @@ demotion" feature.
337337
If you are new to Linux and Intel CPU C-states, the following articles available in the `pepc` repository
338338
may be helpful:
339339

340-
- [Intel C-state namespaces](misc-cstate-namespaces.md) - explains C-state naming conventions.
341-
- [Xeon C6P and C6SP Idle States](misc-c6p-c6sp.md) - explains the C6P and C6SP idle states on
340+
- [Intel C-state namespaces](https://github.com/dedekind/dedekind-share/blob/master/2025/cstate-namespaces.md) - explains C-state naming conventions.
341+
- [Xeon C6P and C6SP Idle States](https://github.com/dedekind/dedekind-share/blob/master/2025/c6p-c6sp.md) - explains the C6P and C6SP idle states on
342342
Intel Xeon platforms.
343343

344344
### Examples
@@ -456,7 +456,7 @@ example, it typically includes components like the last level cache (LLC), memor
456456
north complex interconnects (e.g., between cores).
457457

458458
Some concepts related to uncore frequency scaling and the ELC (Efficiency Latency Control) feature
459-
are explained in [Uncore ELC and Frequency Scaling](misc-uncore-elc.md).
459+
are explained in [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md).
460460

461461
### Uncore Frequency and Dies
462462

@@ -577,7 +577,7 @@ Non-compute dies do not contain CPUs. The `pepc` tool enumerates them via TPMI a
577577
**Additional Examples**
578578
579579
For more examples related to uncore frequency scaling and ELC configuration, refer to
580-
the [Uncore ELC and Frequency Scaling](misc-uncore-elc.md) article.
580+
the [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md) article.
581581
582582
## CPU Hotplug
583583

docs/guide-main.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -93,7 +93,7 @@ mechanisms,
9393
because the minimum uncore frequency is supposed to be the same when read via sysfs or TPMI.
9494

9595
**Note:** The difference between CPPC and HWP guaranteed performance levels is explained in the
96-
[Intel CPU Base Frequency Explained](misc-cpu-base-freq.md) article.
96+
[Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md) article.
9797

9898
### Getting Help
9999

docs/guide-pstates.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ other hand, the 'pepc uncore info --min-freq' option supports both 'sysfs' and '
9898
because the minimum uncore frequency is supposed to be the same when read via sysfs or TPMI.
9999

100100
**Note:** The difference between CPPC and HWP guaranteed performance levels is explained in the
101-
[Intel CPU Base Frequency Explained](misc-cpu-base-freq.md) article.
101+
[Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md) article.
102102

103103
### Getting Help
104104

@@ -180,7 +180,7 @@ The `pepc pstates` command groups operations related to CPU performance states (
180180
example, it supports reading and changing CPU frequency limits.
181181

182182
If you are new to Intel CPU P-states, the
183-
[Intel CPU Base Frequency Explained](misc-cpu-base-freq.md)
183+
[Intel CPU Base Frequency Explained](https://github.com/dedekind/dedekind-share/blob/master/2026/cpu-base-freq.md)
184184
article explains many concepts related to CPU performance scaling.
185185

186186
### Examples
@@ -337,8 +337,8 @@ demotion" feature.
337337
If you are new to Linux and Intel CPU C-states, the following articles available in the `pepc` repository
338338
may be helpful:
339339

340-
- [Intel C-state namespaces](misc-cstate-namespaces.md) - explains C-state naming conventions.
341-
- [Xeon C6P and C6SP Idle States](misc-c6p-c6sp.md) - explains the C6P and C6SP idle states on
340+
- [Intel C-state namespaces](https://github.com/dedekind/dedekind-share/blob/master/2025/cstate-namespaces.md) - explains C-state naming conventions.
341+
- [Xeon C6P and C6SP Idle States](https://github.com/dedekind/dedekind-share/blob/master/2025/c6p-c6sp.md) - explains the C6P and C6SP idle states on
342342
Intel Xeon platforms.
343343

344344
### Examples
@@ -456,7 +456,7 @@ example, it typically includes components like the last level cache (LLC), memor
456456
north complex interconnects (e.g., between cores).
457457

458458
Some concepts related to uncore frequency scaling and the ELC (Efficiency Latency Control) feature
459-
are explained in [Uncore ELC and Frequency Scaling](misc-uncore-elc.md).
459+
are explained in [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md).
460460

461461
### Uncore Frequency and Dies
462462

@@ -577,7 +577,7 @@ Non-compute dies do not contain CPUs. The `pepc` tool enumerates them via TPMI a
577577
**Additional Examples**
578578
579579
For more examples related to uncore frequency scaling and ELC configuration, refer to
580-
the [Uncore ELC and Frequency Scaling](misc-uncore-elc.md) article.
580+
the [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md) article.
581581
582582
## CPU Hotplug
583583

docs/guide-uncore.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ example, it typically includes components like the last level cache (LLC), memor
4141
north complex interconnects (e.g., between cores).
4242

4343
Some concepts related to uncore frequency scaling and the ELC (Efficiency Latency Control) feature
44-
are explained in [Uncore ELC and Frequency Scaling](misc-uncore-elc.md).
44+
are explained in [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md).
4545

4646
## Uncore Frequency Control Mechanisms
4747

@@ -189,7 +189,7 @@ For information about die IDs and how they are assigned, see the
189189
### ELC Examples
190190
191191
For more examples related to uncore frequency scaling and ELC configuration, refer to
192-
the [Uncore ELC and Frequency Scaling](misc-uncore-elc.md) article.
192+
the [Uncore ELC and Frequency Scaling](https://github.com/dedekind/dedekind-share/blob/master/2025/uncore-elc.md) article.
193193
194194
## CPU Hotplug
195195

docs/man/pepc-cstates.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,7 @@ target CPU specification options to define a subset of CPUs, cores, dies, or pac
154154
Use 'all' to include all available Linux C-states (default). Linux C-states (e.g., C6) are
155155
requests Linux can make, while hardware C-states (e.g., Core C6 or Package C6 on Intel
156156
platforms) are platform-specific states entered upon such requests. See
157-
https://github.com/intel/pepc/blob/main/docs/misc-cstate-namespaces.md for details. Reads
157+
https://github.com/dedekind/dedekind-share/blob/master/2025/cstate-namespaces.md for details. Reads
158158
C-state information from `/sys/devices/system/cpu/cpu<N>/cpuidle/state<M>/`.
159159

160160
**--pkg-cstate-limit**
@@ -230,7 +230,7 @@ packages.
230230
: A comma-separated list of C-state names to enable. Use 'all' to include all available Linux
231231
C-states (default). Linux C-states (e.g., C6) are requests Linux can make, while hardware
232232
C-states (e.g., Core C6 or Package C6 on Intel platforms) are platform-specific states entered
233-
upon such requests. See https://github.com/intel/pepc/blob/main/docs/misc-cstate-namespaces.md
233+
upon such requests. See https://github.com/dedekind/dedekind-share/blob/master/2025/cstate-namespaces.md
234234
for details. Enables a C-state by writing '0' to
235235
`/sys/devices/system/cpu/cpu<N>/cpuidle/state<M>/disable`.
236236

0 commit comments

Comments
 (0)