...
|
...
|
@@ -66,7 +66,7 @@ Delete Bucket Policy
|
66
|
66
|
s3cmd \fBaccesslog\fR \fIs3://BUCKET\fR
|
67
|
67
|
Enable/disable bucket access logging
|
68
|
68
|
.TP
|
69
|
|
-s3cmd \fBsign\fR \fISTRING-TO-SIGN\fR
|
|
69
|
+s3cmd \fBsign\fR \fISTRING\-TO\-SIGN\fR
|
70
|
70
|
Sign arbitrary string using the secret key
|
71
|
71
|
.TP
|
72
|
72
|
s3cmd \fBsignurl\fR \fIs3://BUCKET/OBJECT expiry_epoch\fR
|
...
|
...
|
@@ -79,13 +79,13 @@ Fix invalid file names in a bucket
|
79
|
79
|
.PP
|
80
|
80
|
Commands for static WebSites configuration
|
81
|
81
|
.TP
|
82
|
|
-s3cmd \fBws-create\fR \fIs3://BUCKET\fR
|
|
82
|
+s3cmd \fBws\-create\fR \fIs3://BUCKET\fR
|
83
|
83
|
Create Website from bucket
|
84
|
84
|
.TP
|
85
|
|
-s3cmd \fBws-delete\fR \fIs3://BUCKET\fR
|
|
85
|
+s3cmd \fBws\-delete\fR \fIs3://BUCKET\fR
|
86
|
86
|
Delete Website
|
87
|
87
|
.TP
|
88
|
|
-s3cmd \fBws-info\fR \fIs3://BUCKET\fR
|
|
88
|
+s3cmd \fBws\-info\fR \fIs3://BUCKET\fR
|
89
|
89
|
Info about Website
|
90
|
90
|
|
91
|
91
|
|
...
|
...
|
@@ -124,7 +124,7 @@ changes you like.
|
124
|
124
|
show this help message and exit
|
125
|
125
|
.TP
|
126
|
126
|
\fB\-\-configure\fR
|
127
|
|
-Invoke interactive (re)configuration tool. Optionally use as '--configure s3://come-bucket' to test access to a specific bucket instead of attempting to list them all.
|
|
127
|
+Invoke interactive (re)configuration tool. Optionally use as '\-\-configure s3://come\-bucket' to test access to a specific bucket instead of attempting to list them all.
|
128
|
128
|
.TP
|
129
|
129
|
\fB\-c\fR FILE, \fB\-\-config\fR=FILE
|
130
|
130
|
Config file name. Defaults to /home/mludvig/.s3cfg
|
...
|
...
|
@@ -208,32 +208,32 @@ Don't store FS attributes
|
208
|
208
|
Filenames and paths matching GLOB will be excluded from sync
|
209
|
209
|
.TP
|
210
|
210
|
\fB\-\-exclude\-from\fR=FILE
|
211
|
|
-Read --exclude GLOBs from FILE
|
|
211
|
+Read \-\-exclude GLOBs from FILE
|
212
|
212
|
.TP
|
213
|
213
|
\fB\-\-rexclude\fR=REGEXP
|
214
|
214
|
Filenames and paths matching REGEXP (regular expression) will be excluded from sync
|
215
|
215
|
.TP
|
216
|
216
|
\fB\-\-rexclude\-from\fR=FILE
|
217
|
|
-Read --rexclude REGEXPs from FILE
|
|
217
|
+Read \-\-rexclude REGEXPs from FILE
|
218
|
218
|
.TP
|
219
|
219
|
\fB\-\-include\fR=GLOB
|
220
|
|
-Filenames and paths matching GLOB will be included even if previously excluded by one of --(r)exclude(-from) patterns
|
|
220
|
+Filenames and paths matching GLOB will be included even if previously excluded by one of \-\-(r)exclude(\-from) patterns
|
221
|
221
|
.TP
|
222
|
222
|
\fB\-\-include\-from\fR=FILE
|
223
|
|
-Read --include GLOBs from FILE
|
|
223
|
+Read \-\-include GLOBs from FILE
|
224
|
224
|
.TP
|
225
|
225
|
\fB\-\-rinclude\fR=REGEXP
|
226
|
|
-Same as --include but uses REGEXP (regular expression) instead of GLOB
|
|
226
|
+Same as \-\-include but uses REGEXP (regular expression) instead of GLOB
|
227
|
227
|
.TP
|
228
|
228
|
\fB\-\-rinclude\-from\fR=FILE
|
229
|
|
-Read --rinclude REGEXPs from FILE
|
|
229
|
+Read \-\-rinclude REGEXPs from FILE
|
230
|
230
|
.TP
|
231
|
231
|
\fB\-\-files\-from\fR=FILE
|
232
|
|
-Read list of source-file names from FILE. Use - to read from stdin.
|
|
232
|
+Read list of source-file names from FILE. Use \- to read from stdin.
|
233
|
233
|
May be repeated.
|
234
|
234
|
.TP
|
235
|
235
|
\fB\-\-bucket\-location\fR=BUCKET_LOCATION
|
236
|
|
-Datacentre to create bucket in. As of now the datacenters are: US (default), EU, ap-northeast-1, ap-southeast-1, sa-east-1, us-west-1 and us-west-2
|
|
236
|
+Datacentre to create bucket in. As of now the datacenters are: US (default), EU, ap\-northeast\-1, ap\-southeast\-1, sa\-east\-1, us\-west\-1 and us\-west\-2
|
237
|
237
|
.TP
|
238
|
238
|
\fB\-\-reduced\-redundancy\fR, \fB\-\-rr\fR
|
239
|
239
|
Store object with 'Reduced redundancy'. Lower per-GB price. [put, cp, mv]
|
...
|
...
|
@@ -245,22 +245,22 @@ Target prefix for access logs (S3 URI) (for [cfmodify] and [accesslog] commands)
|
245
|
245
|
Disable access logging (for [cfmodify] and [accesslog] commands)
|
246
|
246
|
.TP
|
247
|
247
|
\fB\-\-default\-mime\-type\fR
|
248
|
|
-Default MIME-type for stored objects. Application default is binary/octet-stream.
|
|
248
|
+Default MIME-type for stored objects. Application default is binary/octet\-stream.
|
249
|
249
|
.TP
|
250
|
250
|
\fB\-M\fR, \fB\-\-guess\-mime\-type\fR
|
251
|
|
-Guess MIME-type of files by their extension or mime magic. Fall back to default MIME-Type as specified by \fB--default-mime-type\fR option
|
|
251
|
+Guess MIME-type of files by their extension or mime magic. Fall back to default MIME-type as specified by \fB\-\-default\-mime\-type\fR option
|
252
|
252
|
.TP
|
253
|
253
|
\fB\-\-no\-guess\-mime\-type\fR
|
254
|
254
|
Don't guess MIME-type and use the default type instead.
|
255
|
255
|
.TP
|
256
|
256
|
\fB\-m\fR MIME/TYPE, \fB\-\-mime\-type\fR=MIME/TYPE
|
257
|
|
-Force MIME-type. Override both \fB--default-mime-type\fR and \fB--guess-mime-type\fR.
|
|
257
|
+Force MIME-type. Override both \fB\-\-default\-mime\-type\fR and \fB\-\-guess\-mime\-type\fR.
|
258
|
258
|
.TP
|
259
|
259
|
\fB\-\-add\-header\fR=NAME:VALUE
|
260
|
|
-Add a given HTTP header to the upload request. Can be used multiple times. For instance set 'Expires' or 'Cache-Control' headers (or both) using this options if you like.
|
|
260
|
+Add a given HTTP header to the upload request. Can be used multiple times. For instance set 'Expires' or 'Cache\-Control' headers (or both) using this options if you like.
|
261
|
261
|
.TP
|
262
|
262
|
\fB\-\-encoding\fR=ENCODING
|
263
|
|
-Override autodetected terminal and filesystem encoding (character set). Autodetected: UTF-8
|
|
263
|
+Override autodetected terminal and filesystem encoding (character set). Autodetected: UTF\-8
|
264
|
264
|
.TP
|
265
|
265
|
\fB\-\-disable\-content\-encoding\fR
|
266
|
266
|
Don't include a Content-encoding header to the the uploaded objects. Default: Off
|
...
|
...
|
@@ -272,7 +272,7 @@ Add encoding to these comma delimited extensions i.e. (css,js,html) when uploadi
|
272
|
272
|
Use the S3 name as given on the command line. No pre-processing, encoding, etc. Use with caution!
|
273
|
273
|
.TP
|
274
|
274
|
\fB\-\-disable\-multipart\fR
|
275
|
|
-Disable multipart upload on files bigger than --multipart-chunk-size-mb
|
|
275
|
+Disable multipart upload on files bigger than \-\-multipart\-chunk\-size\-mb
|
276
|
276
|
.TP
|
277
|
277
|
\fB\-\-multipart\-chunk\-size\-mb\fR=SIZE
|
278
|
278
|
Size of each chunk of a multipart upload. Files bigger than SIZE are automatically uploaded as multithreaded-multipart, smaller files are uploaded using the traditional method. SIZE is in Mega-Bytes,
|
...
|
...
|
@@ -285,10 +285,10 @@ Include MD5 sums in bucket listings (only for 'ls' command).
|
285
|
285
|
Print sizes in human readable form (eg 1kB instead of 1234).
|
286
|
286
|
.TP
|
287
|
287
|
\fB\-\-ws\-index\fR=WEBSITE_INDEX
|
288
|
|
-Name of index-document (only for [ws-create] command)
|
|
288
|
+Name of index-document (only for [ws\-create] command)
|
289
|
289
|
.TP
|
290
|
290
|
\fB\-\-ws\-error\fR=WEBSITE_ERROR
|
291
|
|
-Name of error-document (only for [ws-create] command)
|
|
291
|
+Name of error-document (only for [ws\-create] command)
|
292
|
292
|
.TP
|
293
|
293
|
\fB\-\-progress\fR
|
294
|
294
|
Display progress meter (default on TTY).
|
...
|
...
|
@@ -350,11 +350,11 @@ synchronising complete directory trees to or from remote S3 storage. To some ext
|
350
|
350
|
.PP
|
351
|
351
|
Basic usage common in backup scenarios is as simple as:
|
352
|
352
|
.nf
|
353
|
|
- s3cmd sync /local/path/ s3://test-bucket/backup/
|
|
353
|
+ s3cmd sync /local/path/ s3://test\-bucket/backup/
|
354
|
354
|
.fi
|
355
|
355
|
.PP
|
356
|
356
|
This command will find all files under /local/path directory and copy them
|
357
|
|
-to corresponding paths under s3://test-bucket/backup on the remote side.
|
|
357
|
+to corresponding paths under s3://test\-bucket/backup on the remote side.
|
358
|
358
|
For example:
|
359
|
359
|
.nf
|
360
|
360
|
/local/path/\fBfile1.ext\fR \-> s3://bucket/backup/\fBfile1.ext\fR
|
...
|
...
|
@@ -364,7 +364,7 @@ For example:
|
364
|
364
|
However if the local path doesn't end with a slash the last directory's name
|
365
|
365
|
is used on the remote side as well. Compare these with the previous example:
|
366
|
366
|
.nf
|
367
|
|
- s3cmd sync /local/path s3://test-bucket/backup/
|
|
367
|
+ s3cmd sync /local/path s3://test\-bucket/backup/
|
368
|
368
|
.fi
|
369
|
369
|
will sync:
|
370
|
370
|
.nf
|
...
|
...
|
@@ -374,7 +374,7 @@ will sync:
|
374
|
374
|
.PP
|
375
|
375
|
To retrieve the files back from S3 use inverted syntax:
|
376
|
376
|
.nf
|
377
|
|
- s3cmd sync s3://test-bucket/backup/ /tmp/restore/
|
|
377
|
+ s3cmd sync s3://test\-bucket/backup/ /tmp/restore/
|
378
|
378
|
.fi
|
379
|
379
|
that will download files:
|
380
|
380
|
.nf
|
...
|
...
|
@@ -385,7 +385,7 @@ that will download files:
|
385
|
385
|
Without the trailing slash on source the behaviour is similar to
|
386
|
386
|
what has been demonstrated with upload:
|
387
|
387
|
.nf
|
388
|
|
- s3cmd sync s3://test-bucket/backup /tmp/restore/
|
|
388
|
+ s3cmd sync s3://test\-bucket/backup /tmp/restore/
|
389
|
389
|
.fi
|
390
|
390
|
will download the files as:
|
391
|
391
|
.nf
|
...
|
...
|
@@ -417,7 +417,7 @@ about matching file names against exclude and include rules.
|
417
|
417
|
.PP
|
418
|
418
|
For example to exclude all files with ".jpg" extension except those beginning with a number use:
|
419
|
419
|
.PP
|
420
|
|
- \-\-exclude '*.jpg' \-\-rinclude '[0-9].*\.jpg'
|
|
420
|
+ \-\-exclude '*.jpg' \-\-rinclude '[0\-9].*\.jpg'
|
421
|
421
|
|
422
|
422
|
.SH ENVIRONMENT
|
423
|
423
|
.TP
|
...
|
...
|
@@ -437,7 +437,7 @@ Please consider a donation if you have found s3cmd useful:
|
437
|
437
|
.SH AUTHOR
|
438
|
438
|
Written by Michal Ludvig <mludvig@logix.net.nz> and 15+ contributors
|
439
|
439
|
.SH CONTACT, SUPPORT
|
440
|
|
-Prefered way to get support is our mailing list:
|
|
440
|
+Preferred way to get support is our mailing list:
|
441
|
441
|
.I s3tools\-general@lists.sourceforge.net
|
442
|
442
|
.SH REPORTING BUGS
|
443
|
443
|
Report bugs to
|