Skip to content

Commit

Permalink
Update semantics for MinObject in stat-cache (#1787)
Browse files Browse the repository at this point in the history
This updates the semantics.md for the changes
related to replacement of gcs.Object with MinObject
in stat-cache and in other places.
  • Loading branch information
gargnitingoogle committed Mar 13, 2024
1 parent 8558fa8 commit 3349a76
Showing 1 changed file with 6 additions and 2 deletions.
8 changes: 6 additions & 2 deletions docs/semantics.md
Expand Up @@ -79,9 +79,13 @@ The behavior of stat cache is controlled by the following flags/config parameter
This has been deprecated (starting v2.0) and is ignored if the user sets `metadata-cache:stat-cache-max-size-mb` .
This can be set to 0 for disabling stat-cache and > 0 for setting a finite stat-cache size.

If neither of these two is set, then a size of 32MB is used, which is equivalent to about 12710 stat-cache entries (assuming just as many negative stat-cache entries).
If neither of these two is set, then a size of 32MB is used, which is
equivalent to about 20460 stat-cache entries (assuming just as many negative
stat-cache entries).

If you have more objects (folders or files) than that in your bucket that you want to access, then you may want to increase this, otherwise the caching will not function properly when listing that folder's contents:
If you have more objects (folders or files) than that in your bucket that you
want to access, then you may want to increase this, otherwise the caching
will not function properly when listing that folder's contents:
- ListObjects will return information on the items within the folder. Each item's data is cached
- Because there are more objects than cache capacity, the earliest entries will be evicted
- The linux kernel then asks for a little more information on each file.
Expand Down

0 comments on commit 3349a76

Please sign in to comment.