===============================================================================
Different Variants of PyTorch Build
===============================================================================

[CPU] The default build is the cpu-only variant.

[CUDA] The script debian/cudabuild.sh is provided to convert the debian
 directory for the cuda build.

[ROCM] The script debian/rocmbuild.sh is provided to convert the debian
 directory for the rocm build.

All the three variants must share a identical copy of the upstream source.
All changes towards the CUDA or the ROCM variant must be merged back to the
codebase of the CPU version, or they will be lost upon the next upload.

===============================================================================
Dependency Snapshot Tracker for Package Maintainer
===============================================================================

The following is the submodule list for the HEAD/refs/tags/v2.9.0.
To get this list, you need to run `git submodule` at the upstream git repository.
We track the dependency status here for convenience.

Updated: Oct 24 2025

[Ignored Dependencies : not for us]

3147391d946bb4b6c68edd901f2add6ac1f31f8c third_party/eigen (3.4.0)                                 [NOTE] 3.4.0 in sid, but requires feature in newer snapshot
299e5928955cc62af9968370293b916f5130916f third_party/benchmark (v1.9.3)                            [OK] 1.9.1-1 in sid
3af7f2c16147f3fbc6e4d717032daf505dc1652c third_party/cpp-httplib (v0.20.1)                         [TODO?] 0.18.7 in sid
40626af88bd7df9a5fb80be7b25ac85b122d6c21 third_party/fmt (11.2.2)                                  [TODO?] 10.1.1 in sid, 11.1.1 in exp (both can compile), needs transition and upgrade
52eb8108c5bdec04579160ae17225d66034bd723 third_party/googletest (1.17.0)                           [OK] 1.17.0 in sid
55f93686c01528224f448c19128836e7df245f72 third_party/nlohmann (v3.12.0)                            [OK] 3.12.0 in sid
a2e59f0e7065404b44dfe92a28aca47ba1378dc4 third_party/pybind11 (v2.13.6)                            [OK] 2.13.6 in sid
d1eca4e4b421cd2997495c4b4e65cea6be4e9b8a third_party/protobuf (v3.13.1)                            [OK] 3.21.12 in sid

1d8f600fd424278486eade7ed3e877c99f0846b1 third_party/VulkanMemoryAllocator (v3.3.0).               [DISABLED] GPU? needs investigation.
c07e3a0400713d546e0dea2d5466dd22ea389c73 third_party/NNPACK (c07e3a0)                              [DISABLED] we disabled this. see d/rules. has not been updated for very long time.
f45429b087dd7d5bc78bb40dc7cf06425c252d67 third_party/python-peachpy (remotes/origin/pre-generated) [DISABLED] not yet enabled. see d/rules.
3fb5c176c17c765a3492cd2f0321b0dab712f350 third_party/gemmlowp/gemmlowp                             [DISABLED] not enabled. see d/rules.
52791a2fd214b2a9dc5759d36725909c1daa7f2e third_party/tensorpipe                                    [DISABLED] 0.0~git20220513.bb1473a in sid. newer than this snapshot. but deprecated upstream.
a799f4aed9c94b765dcdaabaeab7d5e7e2310878 third_party/opentelemetry-cpp (v1.14.2)                   [DISABLED] newer version (v1.17.0) in debian. Pytorch does not actually use it now.

94036de6fe20bfd8a73d4a6d142fcf532ea604d9 third_party/mimalloc (v1.8.2)                             [SKIP] The *malloc libraries are generally optional.
dec1d23ca65ab069d225dfe40dea14f455170959 third_party/ittapi (v3.25.5)                              [SKIP] this is optional.
157e88b750c452bef2ab4653fe9d1eeb151ce4c3 third_party/fbgemm                                        [SKIP] This is optional.

[Dependencies maintained by Mo Zhou <lumin@debian.org>]

a2cd1ea3b6d3fee220106b5fed3f7ce8da9eb757 third_party/flatbuffers (v24.12.23) [TODO] 23.5.26 in sid.
5a1d179df9cf652951b59010a2d2075372d67f68 third_party/sleef (v3.8)            [OK] 3.9.3 in sid.
666996fe3960f27170d1527e5579ba24c8d3380a third_party/cudnn_frontend (v1.12)  [TODO CUDA] 1.8.0 in sid.
ad7b2f5e84fcfa124cb02b91d5bd26d238c0459e third_party/cutlass (v3.9.2)        [TODO CUDA] 3.4.1 in sid.

[Dependencies maintained by Debian Deep Learning Team <debian-ai@lists.debian.org>]

4dfe081cf6bcd15db339cf2680b9281b8451eeb3 third_party/FP16 (4dfe081)            [OK] 0.0~git20200514.4dfe081 in sid. up to date.
b408327ac2a15ec3e43352421954f5b1967701d1 third_party/FXdiv (b408327)           [OK] 0.0~git20200417.b408327 in sid. up to date.
072586a71b55b7f8c584153d223e95687148a900 third_party/psimd (heads/master)      [OK] 0.0~git20200517.072586a in sid. up to date.
5e3d2445e6a84d9599bee2bf78edbb4d80865e1d third_party/cpuinfo                   [OK] 0.0~git20250905.877328f-1 in sid.
719d8e6cd7f7a0e01b155657526d693acf97c2b3 third_party/ideep                     [OK] debian/0.0_git20251020.9275706-1 in sid. this is for onednn 3.10.
4fe0e1e183925bf8cfa6aae24237e724a96479b8 third_party/pthreadpool               [OK] 0.0~git20240616.560c60d in sid. newer than this snapshot. 
c7b7b022c124d9643957d9bd55f57ac59fce8fa2 third_party/gloo                      [OK] 0.0~git20250912.d97133a in sid. newer than this snapshot.
e709452ef2bbc1d113faf678c24e6d3467696e83 third_party/onnx (v1.18.0)            [TODO?] 1.17.0 in sid
51a0103656eff6fc9bfd39a4597923c4b542c883 third_party/XNNPACK                   [TODO] 0.0~git20241108.4ea82e5-2 in sid.
cca02c2f69dd18e1f12647c1c0bdc8cf90e680c7 third_party/kleidiai (v1.8.0)         [OK] v1.8.0 in sid

[Embedded Sources]

6fcbc53d33dd275c0aba1e5d7701d471b7f6eeb3 third_party/kineto                    [TODO] embedded d9753139d181b9ff42872465aac0e5d3018be415 in debian/
0fa0ef591e38c2758e3184c6c23e497b9f732ffa third_party/pocketfft                 [TODO] embedded 9d3ab05a7fffbc71a492bc6a17be034e83e8f0fe in debian/

[New Items]

2942f167cc30c5e3a44a2aecd5b0d9c07ff61a07 third_party/NVTX
[TODO] new dependency, seems optional and might be replaced with libnvtoolsext from nvidia-cuda-toolkit

8086bbe3a78d931eb96fe12fdc014082e18d18d3 third_party/composable_kernel
[NEW ROCM] ROCM-related.

01aae101b9e5e94d6c16a9514c9fb8df99c93150 third_party/aiter
[NEW ROCM] AI Tensor Enginer for ROCM. <https://github.com/ROCm/aiter/>

979702c87a8713a8e0a5e9fee122b90d2ef13be5 third_party/flash-attention (v2.7.4)
[NEW CUDA] Flash attention kernels.

[Bundled Sources]

third_party/miniz-3.0.2
[OK] kept as-is.

third_party/concurrentqueue
[OK] embedded in PyTorch, packaged in debian as concurrentqueue.

third_party/valgrind_headers
[SKIP] not used in Debian build.
