From c2a49b7b1a81eb38894153d8bf9185fa79a2d6b4 Mon Sep 17 00:00:00 2001 From: Carsten Grohmann Date: Sat, 19 Feb 2022 17:24:38 +0100 Subject: [PATCH] Rephrase the description of notsup_compat_dir --- doc/man/s3fs.1 | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/doc/man/s3fs.1 b/doc/man/s3fs.1 index 468954a..70b1f9b 100644 --- a/doc/man/s3fs.1 +++ b/doc/man/s3fs.1 @@ -332,16 +332,16 @@ This name will be added to logging messages and user agent headers sent by s3fs. s3fs complements lack of information about file/directory mode if a file or a directory object does not have x-amz-meta-mode header. As default, s3fs does not complements stat information for a object, then the object will not be able to be allowed to list/modify. .TP -\fB\-o\fR notsup_compat_dir (not support compatibility directory naming) -As default, s3fs supports objects of the directory type as much as possible and recognizes them as directories. -Objects that can be recognized as directory objects are "dir/", "dir", "dir_$folder$", and there is a file object that does not have a directory object but contains that directory path. -s3fs needs redundant communication to support all these directory names. -The object as the directory created by s3fs is "dir/". -By restricting s3fs to recognize only "dir/" as a directory, communication traffic can be reduced. -This option is used to give this restriction to s3fs. -However, if there is a directory object other than "dir/" in the bucket, specifying this option is not recommended. -s3fs may not be able to recognize the object correctly if an object created by s3fs exists in the bucket. -Please use this option when the directory in the bucket is only "dir/" object. +\fB\-o\fR notsup_compat_dir (disable support of alternative directory names) +.RS +s3fs supports the three different naming schemas "dir/", "dir" and "dir_$folder$" to map directory names to S3 objects and vice versa. As a fourth variant, directories can be determined indirectly if there is a file object with a path (e.g. "/dir/file") but without the parent directory. +.TP +S3fs uses only the first schema "dir/" to create S3 objects for directories. +.TP +The support for these different naming schemas causes an increased communication effort. +.TP +If all applications exclusively use the "dir/" naming scheme and the bucket does not contain any objects with a different naming scheme, this option can be used to disable support for alternative naming schemes. This reduces access time and can save costs. +.RE .TP \fB\-o\fR use_wtf8 - support arbitrary file system encoding. S3 requires all object names to be valid UTF-8. But some