Skip to content

chore(master): Improve empty reserved files docs LS-336 #747

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rolysr merged 1 commit into from
Feb 13, 2026
Merged

chore(master): Improve empty reserved files docs LS-336 #747

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions doc/sfsmaster.cfg.5.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -290,6 +290,23 @@ for TLS connections (there is no default value).
Path to the trusted CA certificate which is used to authenticate
the TLS connection (there is no default value).

*EMPTY_RESERVED_FILES_PERIOD_MSECONDS (EXPERIMENTAL)*::
Interval for periodic cleaning of reserved files, in milliseconds.
If set to 0, the reserved files deletion is disabled. (Default: 0)

[WARNING]
====
Administrator-only option. Enabling periodic deletion may remove master-side
references to reserved files that are still held by other applications or
client instances that have not released them yet. This can disrupt ongoing
operations and lead to unexpected errors.

Recommended approach: Do not enable automatic deletion unless you fully
understand the impact on running workloads. Prefer manually freeing reserved
files by locating each reference or process using them and stopping it before
releasing the reservation.
====

== NOTES

Chunks in master are tested in loop. Speed (or frequency) is regulated by two
Expand Down
16 changes: 11 additions & 5 deletions src/data/sfsmaster.cfg.in
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -244,11 +244,6 @@
## (Default: 3600)
# METADATA_DUMP_PERIOD_SECONDS = 3600

## Interval for periodically cleaning of reserved files, in milliseconds. If set to 0, the reserved files
## deletion is disabled.
## (Default: 0)
# EMPTY_RESERVED_FILES_PERIOD_MSECONDS = 0

# deprecated:
# CHUNKS_DEL_LIMIT - use CHUNKS_SOFT_DEL_LIMIT instead

Expand Down Expand Up @@ -355,3 +350,14 @@
## Example: /etc/saunafs/ssl/ca.crt
## (There is no default)
# TLS_CA_CERT_FILE =

## Interval for periodic cleaning of reserved files, in milliseconds.
## If set to 0, the reserved files deletion is disabled.
## (Default: 0)
##
## Note: Administrator-only option. Enabling periodic deletion may remove
## master-side references to reserved files that are still held by other
## applications or client instances that have not released them yet. This
## can disrupt ongoing operations and lead to unexpected errors.
##
# EMPTY_RESERVED_FILES_PERIOD_MSECONDS = 0