Skip to content

Commit a2c69cd

Browse files
committed
docs: sync upstream HDF5 C library (34 new commits)
- Updated to commit bc8f6bb02a (2025-12-19) - Identified 2 new CVEs (CVE-2025-2308, CVE-2025-2309) - CVE-2025-2308: Not affected (scale-offset filter not implemented) - CVE-2025-2309: Review needed (TASK-034 created) - Added sync history with GitHub commit links - Updated feature parity table
1 parent 77bb64a commit a2c69cd

File tree

1 file changed

+51
-16
lines changed

1 file changed

+51
-16
lines changed

UPSTREAM.md

Lines changed: 51 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -14,24 +14,54 @@ Status: Fully supported (superblock v0, v2, v3)
1414
### HDF5 C Library (Reference Implementation)
1515
Repository: https://github.com/HDFGroup/hdf5
1616
Branch: develop
17-
Commit: (see last sync below)
18-
Local Copy: D:\projects\scigolibs\hdf5c\src (for development reference)
17+
Commit: [`bc8f6bb02a`](https://github.com/HDFGroup/hdf5/commit/bc8f6bb02aaa8b162bf04b42f2b59bcbbbfcf9f8)
18+
Date: 2025-12-19 (local sync)
19+
Local Copy: D:\projects\scigolibs\hdf5c (for development reference)
1920

20-
## Last Upstream Sync
21+
## Upstream Sync History
2122

22-
Date: 2025-11-13
23-
Version: HDF5 2.0.0 (Format Spec v4.0)
24-
Commit: 54 commits analyzed for v0.13.0 release
25-
Focus: Security fixes, 64-bit dimensions, AI/ML datatypes
23+
### Latest Sync: 2025-12-19
2624

27-
### Changes Incorporated (v0.13.0)
28-
- CVE-2025-7067: Buffer overflow in chunk reading (HIGH)
29-
- CVE-2025-6269: Heap overflow in fractal heap (MEDIUM)
30-
- CVE-2025-2926: Stack overflow in B-tree recursion (MEDIUM)
31-
- CVE-2025-44905: Integer overflow in dataspace (MEDIUM)
25+
**Commit**: [`bc8f6bb02a`](https://github.com/HDFGroup/hdf5/commit/bc8f6bb02aaa8b162bf04b42f2b59bcbbbfcf9f8)
26+
**Commits Analyzed**: 34 new commits since last sync
27+
28+
#### New CVEs Identified
29+
30+
| CVE | Severity | File | Status |
31+
|-----|----------|------|--------|
32+
| [CVE-2025-2308](https://github.com/HDFGroup/hdf5/pull/5960) | HIGH | H5Zscaleoffset.c | ✅ Not affected (filter not implemented) |
33+
| [CVE-2025-2309](https://github.com/HDFGroup/hdf5/pull/5963) | HIGH | H5Odtype.c | ⚠️ Review needed (TASK-034) |
34+
35+
#### Other Notable Changes
36+
- R-tree optimizations ([#6039](https://github.com/HDFGroup/hdf5/pull/6039))
37+
- Zero-element reads on virtual datasets fix ([#6083](https://github.com/HDFGroup/hdf5/pull/6083))
38+
- HDF5 2.0.0 HISTORY files updated
39+
40+
#### Tasks Created
41+
- **TASK-034**: CVE-2025-2309 bitfield datatype security review (MEDIUM)
42+
- **TASK-035**: CVE-2025-2308 documentation (N/A - not affected)
43+
- **TASK-036**: R-tree optimizations review (LOW)
44+
45+
---
46+
47+
### Previous Sync: 2025-11-13 (v0.13.0 Release)
48+
49+
**Commit**: `e99a49585760aeb34f2bb2144d8e80e207a68ec4`
50+
**Version**: HDF5 2.0.0 (Format Spec v4.0)
51+
**Commits Analyzed**: 54 commits
52+
53+
#### CVEs Incorporated (v0.13.0)
54+
- CVE-2025-7067: Buffer overflow in chunk reading (HIGH) ✅
55+
- CVE-2025-6269: Heap overflow in fractal heap (MEDIUM) ✅
56+
- CVE-2025-2926: Stack overflow in B-tree recursion (MEDIUM) ✅
57+
- CVE-2025-44905: Integer overflow in dataspace (MEDIUM) ✅
58+
59+
#### Features Added
3260
- 64-bit chunk dimensions (breaking change, internal API)
3361
- FP8 (E4M3, E5M2) and bfloat16 datatypes
3462

63+
---
64+
3565
## Implementation Notes
3666

3767
This is a **Pure Go implementation**, not a CGo wrapper or line-by-line port.
@@ -55,7 +85,9 @@ This is a **Pure Go implementation**, not a CGo wrapper or line-by-line port.
5585
| Superblock v0,v2,v3 ||| Full support |
5686
| Object Header v1,v2 ||| With continuations |
5787
| All Datatypes ||| Including FP8, bfloat16 |
88+
| Bitfield Datatype ||| Not supported (explicit rejection) |
5889
| Chunked + Filters ||| GZIP, Shuffle, Fletcher32 |
90+
| Scale-Offset Filter ||| Not implemented |
5991
| Dense Attributes ||| Fractal heap + B-tree v2 |
6092
| Soft/External Links ||| Full support |
6193
| SWMR Mode ||| Planned v0.14.0+ |
@@ -69,9 +101,10 @@ When syncing with upstream changes:
69101

70102
1. **Check HDF5 releases**: https://github.com/HDFGroup/hdf5/releases
71103
2. **Review security advisories**: Check for CVEs affecting our supported formats
72-
3. **Analyze relevant commits**: Focus on format changes, not C-specific code
73-
4. **Update this file**: Document what was synced and when
74-
5. **Create tasks**: Add implementation tasks to docs/dev/backlog/
104+
3. **Pull latest**: `cd D:\projects\scigolibs\hdf5c && git pull origin develop`
105+
4. **Analyze relevant commits**: Focus on format changes, not C-specific code
106+
5. **Update this file**: Document what was synced and when
107+
6. **Create tasks**: Add implementation tasks to docs/dev/backlog/
75108

76109
### Files to Monitor in C Library
77110
```
@@ -81,6 +114,8 @@ src/H5Dchunk.c # Chunked dataset I/O
81114
src/H5HFdblock.c # Fractal heap direct blocks
82115
src/H5B2*.c # B-tree v2 implementation
83116
src/H5Tconv.c # Datatype conversions
117+
src/H5Odtype.c # Datatype object header messages
118+
src/H5Zscaleoffset.c # Scale-offset filter (not implemented)
84119
```
85120

86121
## Quality Validation
@@ -97,5 +132,5 @@ src/H5Tconv.c # Datatype conversions
97132
- ✅ MATLAB HDF5 functions
98133

99134
---
100-
Last Updated: 2025-11-13
135+
Last Updated: 2025-12-19
101136
Maintainer: Claude (Autonomous Developer)

0 commit comments

Comments
 (0)