Index: tools/telemetry/third_party/gsutilz/gslib/addlhelp/wildcards.py |
diff --git a/tools/telemetry/third_party/gsutilz/gslib/addlhelp/wildcards.py b/tools/telemetry/third_party/gsutilz/gslib/addlhelp/wildcards.py |
index ae2e74d1589304b85c98814b6b14a4b5ab227d61..6ffae29217a1fe282004b1a503e7dce1a573bc71 100644 |
--- a/tools/telemetry/third_party/gsutilz/gslib/addlhelp/wildcards.py |
+++ b/tools/telemetry/third_party/gsutilz/gslib/addlhelp/wildcards.py |
@@ -98,6 +98,22 @@ _DETAILED_HELP_TEXT = (""" |
gs://bucket/[a-m]??.j*g |
+<B>DIFFERENT BEHAVIOR FOR "DOT" FILES IN LOCAL FILE SYSTEM</B> |
+ Per standard Unix behavior, the wildcard "*" only matches files that don't |
+ start with a "." character (to avoid confusion with the "." and ".." |
+ directories present in all Unix directories). gsutil provides this same |
+ behavior when using wildcards over a file system URI, but does not provide |
+ this behavior over cloud URIs. For example, the following command will copy |
+ all objects from gs://bucket1 to gs://bucket2: |
+ |
+ gsutil cp gs://bucket1/* gs://bucket2 |
+ |
+ but the following command will copy only files that don't start with a "." |
+ from the directory "dir" to gs://bucket1: |
+ |
+ gsutil cp dir/* gs://bucket1 |
+ |
+ |
<B>EFFICIENCY CONSIDERATION: USING WILDCARDS OVER MANY OBJECTS</B> |
It is more efficient, faster, and less network traffic-intensive |
to use wildcards that have a non-wildcard object-name prefix, like: |