skip to content

detached 34db907

docs(snapshot): clarify maintenance cursor state

commit: 34db9072b76ff5de73812a7f629765fcee72a0f5
author: brice · 3mo ago · 2026-07-21 21:37 UTC
parent: 725406b
signature: GPG VerifiedCD88F9E564E0102646FB6077A1A07C7C7C3E349D · arch-gpg Verified for the committer email

1 file · +3 -3

M internal/adapters/snapshot/repository.go +3 -3


@@ -31,9 +31,9 @@ type Repository struct {
31	31		// on-disk namespace.
32	32		storageEpochs map[string]uint64
33	33
34		-	// maintenanceMu owns continuation state for bounded maintenance. Keeping
35		-	// directory handles on the repository makes successive calls advance rather
36		-	// than repeatedly reading the first batch of a large directory.
	34	+	// maintenanceMu owns bounded continuation metadata: seek cookies and
	35	+	// pending directory entries. Directory descriptors are opened and closed
	36	+	// for each maintenance call.
37	37		maintenanceMu sync.Mutex
38	38		maintenanceCursors map[string]*maintenanceCursor
39	39		maintenanceSessions map[string]*sessionMaintenance


@@ -31,9 +31,9 @@ type Repository struct {
31		// on-disk namespace.	31		// on-disk namespace.
32		storageEpochs map[string]uint64	32		storageEpochs map[string]uint64
33			33
34	-	// maintenanceMu owns continuation state for bounded maintenance. Keeping	34	+	// maintenanceMu owns bounded continuation metadata: seek cookies and
35	-	// directory handles on the repository makes successive calls advance rather	35	+	// pending directory entries. Directory descriptors are opened and closed
36	-	// than repeatedly reading the first batch of a large directory.	36	+	// for each maintenance call.
37		maintenanceMu sync.Mutex	37		maintenanceMu sync.Mutex
38		maintenanceCursors map[string]*maintenanceCursor	38		maintenanceCursors map[string]*maintenanceCursor
39		maintenanceSessions map[string]*sessionMaintenance	39		maintenanceSessions map[string]*sessionMaintenance