1 ========================
2 Client Config Reference
3 ========================
7 :Description: Set the ACL type. Currently, only possible value is ``"posix_acl"`` to enable POSIX ACL, or an empty string. This option only takes effect when the ``fuse_default_permissions`` is set to ``false``.
10 :Default: ``""`` (no ACL enforcement)
14 :Description: Set client cache midpoint. The midpoint splits the least recently used lists into a hot and warm list.
20 :Description: Set the number of inodes that the client keeps in the metadata cache.
24 ``client_caps_release_delay``
26 :Description: Set the delay between capability releases in seconds. The delay sets how many seconds a client waits to release capabilities that it no longer needs in case the capabilities are needed for another user space operation.
28 :Default: ``5`` (seconds)
30 ``client_debug_force_sync_read``
32 :Description: If set to ``true``, clients read data directly from OSDs instead of using a local page cache.
36 ``client_dirsize_rbytes``
38 :Description: If set to ``true``, use the recursive size of a directory (that is, total of all descendants).
42 ``client_max_inline_size``
44 :Description: Set the maximum size of inlined data stored in a file inode rather than in a separate data object in RADOS. This setting only applies if the ``inline_data`` flag is set on the MDS map.
50 :Description: Comma-delimited strings for client metadata sent to each MDS, in addition to the automatically generated version, host name, and other metadata.
52 :Default: ``""`` (no additional metadata)
56 :Description: Set the group ID of CephFS mount.
60 ``client_mount_timeout``
62 :Description: Set the timeout for CephFS mount in seconds.
68 :Description: Set the user ID of CephFS mount.
74 :Description: Directory to mount on the CephFS file system. An alternative to the ``-r`` option of the ``ceph-fuse`` command.
80 :Description: Enable object caching.
84 ``client_oc_max_dirty``
86 :Description: Set the maximum number of dirty bytes in the object cache.
88 :Default: ``104857600`` (100MB)
90 ``client_oc_max_dirty_age``
92 :Description: Set the maximum age in seconds of dirty data in the object cache before writeback.
94 :Default: ``5.0`` (seconds)
96 ``client_oc_max_objects``
98 :Description: Set the maximum number of objects in the object cache.
104 :Description: Set how many bytes of data will the client cache.
106 :Default: ``209715200`` (200 MB)
108 ``client_oc_target_dirty``
110 :Description: Set the target size of dirty data. We recommend to keep this number low.
112 :Default: ``8388608`` (8MB)
114 ``client_permissions``
116 :Description: Check client permissions on all I/O operations.
122 :Description: Enable client quota checking if set to ``true``.
128 :Description: Report root directory quota for the ``statfs`` operation.
132 ``client_readahead_max_bytes``
134 :Description: Set the maximum number of bytes that the kernel reads ahead for future read operations. Overridden by the ``client_readahead_max_periods`` setting.
136 :Default: ``0`` (unlimited)
138 ``client_readahead_max_periods``
140 :Description: Set the number of file layout periods (object size * number of stripes) that the kernel reads ahead. Overrides the ``client_readahead_max_bytes`` setting.
144 ``client_readahead_min``
146 :Description: Set the minimum number bytes that the kernel reads ahead.
148 :Default: ``131072`` (128KB)
150 ``client_reconnect_stale``
152 :Description: Automatically reconnect stale session.
158 :Description: Set the snapshot directory name.
160 :Default: ``".snap"``
162 ``client_tick_interval``
164 :Description: Set the interval in seconds between capability renewal and other upkeep.
166 :Default: ``1.0`` (seconds)
168 ``client_use_random_mds``
170 :Description: Choose random MDS for each request.
174 ``fuse_default_permissions``
176 :Description: When set to ``false``, ``ceph-fuse`` utility checks does its own permissions checking, instead of relying on the permissions enforcement in FUSE. Set to ``false`` together with the ``client acl type=posix_acl`` option to enable POSIX ACL.
183 .. important:: These options are internal. They are listed here only to complete the list of options.
185 ``client_debug_getattr_caps``
187 :Description: Check if the reply from the MDS contains required capabilities.
191 ``client_debug_inject_tick_delay``
193 :Description: Add artificial delay between client ticks.
197 ``client_inject_fixed_oldest_tid``
203 ``client_inject_release_failure``
211 :Description: The path to the trace file for all file operations. The output is designed to be used by the Ceph `synthetic client <../../man/8/ceph-syn>`_.
213 :Default: ``""`` (disabled)