Skill Tracer
Skills › Scientific Agent Skills › get-available-resources › sources.md

sources.md

121 lines · skills/get-available-resources/references/sources.md at 5f2bc03

Open on GitHub

Most marks come from matching words in the file, so treat them as pointers.

1# Official Sources and Verification
2
3Reviewed **2026-10-01**. This ledger covers all bundled commands, parsers,
4planning assumptions, and reference guidance. Living documentation is not a
5claim that every host, driver, or scheduler configuration was exercised.
6

Official Sources and Verification

Reviewed 2026-10-01. This ledger covers all bundled commands, parsers, planning assumptions, and reference guidance. Living documentation is not a claim that every host, driver, or scheduler configuration was exercised.

Raw lines 1 to 6
7## Python and psutil
8
9- [psutil 7.2.2 reference](https://psutil.readthedocs.io/stable/index.html) and
10 [release source](https://github.com/giampaolo/psutil/tree/release-7.2.2) verify
11 `cpu_count(logical=...)`, `Process.cpu_affinity()`, `virtual_memory()`,
12 `swap_memory()`, disk semantics, and `psutil.Error` failures. The optional
13 tested package remains **7.2.2**, matching the current
14 [PyPI release metadata](https://pypi.org/pypi/psutil/json). Development/latest
15 documentation can describe a newer version; it does not change this pin.
16- [Python os reference](https://docs.python.org/3/library/os.html) verifies
17 CPU affinity, `statvfs`, `sysconf`, and CPU-count overrides introduced in
18 Python 3.13. The calling-thread/process count is not a cgroup quota detector.
19- [CPython 3.14.8 shutil source](https://github.com/python/cpython/blob/v3.14.8/Lib/shutil.py)
20 confirms POSIX `disk_usage().free` uses `f_bavail`, not `f_bfree`. Both are
21 read separately by the detector when available.
22- [Python 3.14.8 concurrent.futures documentation source](https://github.com/python/cpython/blob/v3.14.8/Doc/library/concurrent.futures.rst)
23 confirms process-aware defaults, the Windows ProcessPoolExecutor ceiling
24 of 61, and the changed process start method.
25- [Python 3.14.8 multiprocessing documentation source](https://github.com/python/cpython/blob/v3.14.8/Doc/library/multiprocessing.rst)
26 confirms the forkserver/spawn defaults and `os.process_cpu_count()` pool
27 default. These are executor-specific constraints; the generic planner does
28 not launch an executor or promise that every worker count fits every API.

Python and psutil

  • psutil 7.2.2 reference and release source verify cpu_count(logical=...), Process.cpu_affinity(), virtual_memory(), swap_memory(), disk semantics, and psutil.Error failures. The optional tested package remains 7.2.2, matching the current PyPI release metadata. Development/latest documentation can describe a newer version; it does not change this pin.
  • Python os reference verifies CPU affinity, statvfs, sysconf, and CPU-count overrides introduced in Python 3.13. The calling-thread/process count is not a cgroup quota detector.
  • CPython 3.14.8 shutil source confirms POSIX disk_usage().free uses f_bavail, not f_bfree. Both are read separately by the detector when available.
  • Python 3.14.8 concurrent.futures documentation source confirms process-aware defaults, the Windows ProcessPoolExecutor ceiling of 61, and the changed process start method.
  • Python 3.14.8 multiprocessing documentation source confirms the forkserver/spawn defaults and os.process_cpu_count() pool default. These are executor-specific constraints; the generic planner does not launch an executor or promise that every worker count fits every API.
Raw lines 7 to 29
Starts an agent spawn :26
30## Linux, containers, and disk
32- [Kernel procfs documentation](https://docs.kernel.org/filesystems/proc.html)
33 verifies `MemAvailable`, CPU topology/affinity fields, and the mountinfo
34 root/mountpoint fields used to locate a cgroup2 mount.
35- [Kernel cgroup v2 documentation](https://docs.kernel.org/admin-guide/cgroup-v2.html)
36 verifies `cpu.max`, `cpuset.cpus.effective`, `memory.current`, `memory.high`,
37 `memory.max`, hierarchical limits, and namespace-relative membership.
38 Hidden ancestors cannot be measured from a restricted mount. `memory.high`
39 remains a pressure boundary; remaining capacity is not a reservation.
40- [Docker resource constraints](https://docs.docker.com/engine/containers/resource_constraints/)
41 verifies default unconstrained configuration, quota/period, cpusets, memory,
42 and why host-visible swap is not necessarily container-usable swap.
43- [OCI Runtime Specification 1.3.0 Linux configuration](https://github.com/opencontainers/runtime-spec/blob/v1.3.0/config-linux.md)
44 verifies CPU/memory/device controls independently of container markers.

Linux, containers, and disk

  • Kernel procfs documentation verifies MemAvailable, CPU topology/affinity fields, and the mountinfo root/mountpoint fields used to locate a cgroup2 mount.
  • Kernel cgroup v2 documentation verifies cpu.max, cpuset.cpus.effective, memory.current, memory.high, memory.max, hierarchical limits, and namespace-relative membership. Hidden ancestors cannot be measured from a restricted mount. memory.high remains a pressure boundary; remaining capacity is not a reservation.
  • Docker resource constraints verifies default unconstrained configuration, quota/period, cpusets, memory, and why host-visible swap is not necessarily container-usable swap.
  • OCI Runtime Specification 1.3.0 Linux configuration verifies CPU/memory/device controls independently of container markers.
Raw lines 30 to 45
46## NVIDIA
48- [nvidia-smi manual](https://docs.nvidia.com/deploy/nvidia-smi/index.html)
49 verifies selective `--query-gpu` and `--format=csv,noheader,nounits` queries,
50 unsupported `N/A` values, unstable indices, and output compatibility limits.
51 The detector requests index/name/memory/driver/compute capability and retries
52 without compute capability on a command error. No NVIDIA hardware was
53 available for a driver-specific `--help-query-gpu` check in this review.
54- [Container Toolkit configuration](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/docker-specialized.html)
55 verifies `NVIDIA_VISIBLE_DEVICES` and driver-capability semantics. These are
56 container-start configuration inputs; their presence in a running process
57 does not prove kernel device isolation.
58- [CUDA visibility](https://docs.nvidia.com/deploy/topics/topic_5_2_1.html) and
59 [CUDA compatibility](https://docs.nvidia.com/deploy/cuda-compatibility/latest/why-cuda-compatibility.html)
60 distinguish application enumeration from management visibility and runtime
61 compatibility.
62- [MIG device enumeration](https://docs.nvidia.com/datacenter/tesla/mig-user-guide/mig-device-names.html)
63 explains why physical management GPU counts are not framework-device counts.

NVIDIA

  • nvidia-smi manual verifies selective --query-gpu and --format=csv,noheader,nounits queries, unsupported N/A values, unstable indices, and output compatibility limits. The detector requests index/name/memory/driver/compute capability and retries without compute capability on a command error. No NVIDIA hardware was available for a driver-specific --help-query-gpu check in this review.
  • Container Toolkit configuration verifies NVIDIA_VISIBLE_DEVICES and driver-capability semantics. These are container-start configuration inputs; their presence in a running process does not prove kernel device isolation.
  • CUDA visibility and CUDA compatibility distinguish application enumeration from management visibility and runtime compatibility.
  • MIG device enumeration explains why physical management GPU counts are not framework-device counts.
Raw lines 46 to 64
65## AMD
67- [AMD SMI CLI reference](https://rocm.docs.amd.com/projects/amdsmi/en/latest/how-to/amdsmi-cli-tool.html)
68 currently identifies **27.0.0**. It verifies `static --asic --vram --json`,
69 unavailable fields, and APU/partition differences. The narrower query avoids
70 collecting every static field, including unrelated board and topology data.
71- [AMD SMI command source](https://github.com/ROCm/amdsmi/blob/a044536b8d690a9ae5962a93e7596d9eec2030b7/amdsmi_cli/amdsmi_commands.py)
72 verifies nested JSON `vram.size: {value, unit}`.
73 [The matching C++ implementation](https://github.com/ROCm/amdsmi/blob/a044536b8d690a9ae5962a93e7596d9eec2030b7/src/amd_smi/amd_smi.cc)
74 divides byte totals by 1024 squared despite labeling the result `MB`.
75 The parser preserves that binary conversion. This pinned source check does
76 not establish every installed AMD SMI release's output shape.
77- [ROCm SMI CLI reference](https://rocm.docs.amd.com/projects/rocm_smi_lib/en/latest/how-to/use-python.html)
78 and [official CLI source](https://github.com/ROCm/rocm_smi_lib/blob/master/python_smi_tools/rocm_smi.py)
79 verify the retained `--showproductname --showmeminfo vram --json` fallback
80 and flat byte-valued memory fields.
81- [ROCm environment variables](https://rocm.docs.amd.com/en/latest/reference/environment-variables/index.html)
82 verifies visibility-variable scopes and recommends `ROCR_VISIBLE_DEVICES`
83 on Linux and `HIP_VISIBLE_DEVICES` on Windows. The detector does not claim
84 to cover every isolation variable or runtime. The old separate GPU-isolation
85 URL was inaccessible; the current environment reference and container
86 documentation support the bounded guidance retained here.

AMD

  • AMD SMI CLI reference currently identifies 27.0.0. It verifies static --asic --vram --json, unavailable fields, and APU/partition differences. The narrower query avoids collecting every static field, including unrelated board and topology data.
  • AMD SMI command source verifies nested JSON vram.size: {value, unit}. The matching C++ implementation divides byte totals by 1024 squared despite labeling the result MB. The parser preserves that binary conversion. This pinned source check does not establish every installed AMD SMI release's output shape.
  • ROCm SMI CLI reference and official CLI source verify the retained --showproductname --showmeminfo vram --json fallback and flat byte-valued memory fields.
  • ROCm environment variables verifies visibility-variable scopes and recommends ROCR_VISIBLE_DEVICES on Linux and HIP_VISIBLE_DEVICES on Windows. The detector does not claim to cover every isolation variable or runtime. The old separate GPU-isolation URL was inaccessible; the current environment reference and container documentation support the bounded guidance retained here.
Raw lines 65 to 87
88## Apple, Windows, and Slurm
90- [Apple system capabilities](https://developer.apple.com/documentation/kernel/1387446-sysctlbyname/determining_system_capabilities)
91 was read through its official documentation JSON representation; it verifies
92 `hw.logicalcpu`/`hw.physicalcpu` and performance-level semantics.
93 [Archived sysctl manual](https://developer.apple.com/library/archive/documentation/System/Conceptual/ManPages_iPhoneOS/man3/sysctl.3.html)
94 cross-checks memory reporting.
95- [Apple DTS system_profiler discussion](https://developer.apple.com/forums/thread/688443)
96 explains integrated/SoC memory interpretation. The fixed `sysctl -n` and
97 `system_profiler SPDisplaysDataType -json` probes were executed locally on
98 macOS during this review. Intel/AMD display-vendor handling is synthetic,
99 and no Metal framework workload was executed.
100- [Windows processor groups](https://learn.microsoft.com/en-us/windows/win32/procthread/processor-groups),
101 [GetLogicalProcessorInformation](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getlogicalprocessorinformation),
102 and [GetLogicalProcessorInformationEx](https://learn.microsoft.com/en-us/windows/win32/api/sysinfoapi/nf-sysinfoapi-getlogicalprocessorinformationex)
103 distinguish topology, group-limited observations, and Windows 11/Server 2022
104 defaults spanning groups. Windows behavior was covered by mocks only.
105- [Slurm sbatch](https://slurm.schedmd.com/sbatch.html),
106 [srun](https://slurm.schedmd.com/srun.html), and
107 [CPU management](https://slurm.schedmd.com/cpu_management.html) verify every
108 allowlisted allocation variable, compressed task lists, the current
109 `SLURM_NODEID` index, memory units/scope, and site-dependent enforcement.
110 Scheduler tests are synthetic; no Slurm allocation or accounting call was
111 executed. Job/step and heterogeneous-component scope must still be checked
112 in the workload's actual environment.

Apple, Windows, and Slurm

  • Apple system capabilities was read through its official documentation JSON representation; it verifies hw.logicalcpu/hw.physicalcpu and performance-level semantics. Archived sysctl manual cross-checks memory reporting.
  • Apple DTS system_profiler discussion explains integrated/SoC memory interpretation. The fixed sysctl -n and system_profiler SPDisplaysDataType -json probes were executed locally on macOS during this review. Intel/AMD display-vendor handling is synthetic, and no Metal framework workload was executed.
  • Windows processor groups, GetLogicalProcessorInformation, and GetLogicalProcessorInformationEx distinguish topology, group-limited observations, and Windows 11/Server 2022 defaults spanning groups. Windows behavior was covered by mocks only.
  • Slurm sbatch, srun, and CPU management verify every allowlisted allocation variable, compressed task lists, the current SLURM_NODEID index, memory units/scope, and site-dependent enforcement. Scheduler tests are synthetic; no Slurm allocation or accounting call was executed. Job/step and heterogeneous-component scope must still be checked in the workload's actual environment.
Raw lines 88 to 113
114## Verification boundary
116The network-free suite exercises Linux cgroup hierarchy/delegated mounts,
117Slurm heterogeneous node counts, macOS/Windows probes, legacy/current AMD
118parsers, NVIDIA CSV, malformed snapshots, private output, and infeasible
119memory plans. All four CLI helpers were exercised on redacted local snapshots.
120No stress tests, large allocations, write-capacity probes, device changes,
121framework accelerator execution, or scheduler submissions were performed.

Verification boundary

The network-free suite exercises Linux cgroup hierarchy/delegated mounts, Slurm heterogeneous node counts, macOS/Windows probes, legacy/current AMD parsers, NVIDIA CSV, malformed snapshots, private output, and infeasible memory plans. All four CLI helpers were exercised on redacted local snapshots. No stress tests, large allocations, write-capacity probes, device changes, framework accelerator execution, or scheduler submissions were performed.

Raw lines 114 to 121