@@ -5,7 +5,10 @@ Copy storage files and directories between cloud and local storage.
55## Synopsis
66
77``` usage
8- usage: datachain cp [-h] [-v] [-q] [-r] [--team TEAM] [--local] [--anon] [--update] [--no-glob] [--force] source_path destination_path
8+ usage: datachain cp [-h] [-v] [-q] [-r] [--team TEAM]
9+ [--local] [--anon] [--update]
10+ [--no-glob] [--force]
11+ source_path destination_path
912```
1013
1114## Description
@@ -143,33 +146,9 @@ datachain cp --local --force s3://my-bucket/data /path/to/local/
143146datachain cp --local --update --no-glob s3://my-bucket/data/* .txt /path/to/local/
144147```
145148
146- ## Limitations and Edge Cases
147-
148- ### Bucket Restrictions
149+ ## Limitations
149150- ** Cannot copy between different buckets** : Remote-to-remote copies must be within the same bucket
150- - ** Cross-bucket operations** : Use local as intermediate step for cross-bucket copies
151-
152- ### Directory Operations
153- - ** Recursive flag required** : Copying directories requires the ` --recursive ` flag
154- - ** Directory structure preservation** : Directory structure is preserved during copy operations
155- - ** Empty directories** : Empty directories may not be copied in some scenarios
156-
157-
158- ### Error Handling
159- - ** File not found** : Missing source files result in operation failure
160- - ** Permission errors** : Insufficient permissions cause operation failure
161- - ** Network issues** : Network problems are reported with appropriate error messages
162-
163- ### Team Configuration
164- - ** Default team** : If no team is specified, uses the team from your configuration
165- - ** Team-specific storage** : Each team has its own storage namespace
166151
167152## Notes
168-
169- * Use the ` --verbose ` flag to get detailed information about the copy operation
170- * The ` --quiet ` flag suppresses output except for errors
171153* When using Studio mode, you must be authenticated with ` datachain auth login ` before using it
172154* The ` --local ` mode bypasses Studio and operates directly with storage providers
173- * Use ` --recursive ` flag when copying directories
174- * The ` --force ` flag is only available in local mode and will overwrite existing files
175- * For cross-bucket copies, consider using local storage as an intermediate step
0 commit comments