Skip to content

v0.4.1

Compare
Choose a tag to compare
@github-actions github-actions released this 26 Apr 18:20
· 167 commits to master since this release

This release adds a retention policy to the reference store, which allows to (optionally) keep the size of the stored files within limits. From the README:

texd supports three different retention policies:

  1. keep (or none) will keep all file references forever. This is the default setting.
  2. purge-on-start (or just purge) will delete file references once on startup.
  3. access will keep an access list with LRU semantics, and delete file references, either if
    a max. number of items is reached, or if the total size of items exeedes a threshold, or both.

To select a specific retention policy, use the --retention-policy CLI flag:

$ texd --reference-store=dir://./refs --retention-policy=purge

To configure the access list (--retention-policy=access), you can adopt the quota to your needs:

$ texd --reference-store=dir://./refs \
    --retention-policy=access \
    --rp-access-items=1000 \
    --rp-access-size=100MB

Notes:

  • The default quota for the max. number of items (--rp-access-items) is 1000.
  • The default quota for the max. total file size (--rp-access-size) is 100MB.
  • Total file size is measured in bytes, common suffixes (100KB, 2MiB, 1.3GB) work as expected.
  • To disable either limit, set the value to 0 (e.g. --rp-access-items=0).
  • It is an error to disable both limits (in this case just use --retention-policy=keep).