readme
Usage:
s3 [--usage] [--help] [--man] [--version]
# generic options, valid for all commands
s3 <command> [--id <id>] [--secret <string>] [<options...>]
# "pure" commands
s3 acl [--clear] [--add <spec>] [--del <spec>] <s3path>
s3 add [--meta <meta>] [--header <header>] [--acl <acl>]
[--data <data>] [--location <place>] <s3path> [<filename>]
s3 copy [--meta <meta>] [--header <header>] [--acl <acl>]
<s3path-src> <s3path-dst>
s3 create [--acl <acl>] [--location <location>] <bucket-name>
s3 delete <s3path>
s3 get <s3path> [<filename|dirname>]
s3 list [--ls] [-l] [--delimiter <string>] [--max-keys <n>]
[--marker <n>] [<s3path>]
s3 locate <s3path>
s3 meta [--clear] [--add <spec>] [--del <spec>] <s3path>
s3 show <s3path>
# "filesyste-oriented" commands
s3 cat [<filename|s3path>] ...
s3 cp <src> [<src2> [<src3 ...]] <dst>
s3 dir [--delimiter <string>] [--max-keys <n>]
[--marker <n>] [<s3path>]
s3 ls [-l] [--delimiter <string>] [--max-keys <n>]
[--marker <n>] [<s3path>]
s3 rm <s3path> [<s3path2> [<s3path3> ...]]
Examples:
# list all buckets
s3 list
# create two buckets
s3 create mybucket
s3 add mybucket-x
# locate a bucket
s3 localte :mybucket
# list keys
s3 list :mybucket
s3 list :mybucket/some/prefix
s3 ls :mybucket/some/directory
s3 ls -l :mybucket/some/directory/extended-print
s3 dir :mybucket/ditto/as/above
# create a key
s3 add :mybucket/empty
s3 add :mybucket/cmdline-data --data 'Hello, World!'
s3 add :mybucket/fromfile /path/to/somefile
# get contents of one or more keys
s3 get :mybucket/key
s3 get :mybucket/tofile /path/to/destination
s3 cat :mybucket/key :mybucket-x/key-x
# make copies...
s3 copy :mybucket/source :mybucket-x/destination-copy
s3 cp /path/to/localfile :mybucket/remote
s3 cp /local/file :mybucket/remote/file /path/to/localdir
s3 cp /local/file :mybucket/remote/file :mybucket-x/path/to/remotedir/
# move stuff
s3 mv :mybucket/something /path/to/local
s3 mv /path/to/something :mybucket/remote
s3 mv /local/file :mybucket/remote/file :mybucket-x/path/to/remotedir/
# get headers
s3 show :mybucket/somekey
# get/set metadata
s3 meta :mybucket/somekey
s3 meta :mybucket/somekey --add colour:green --del taste:awful
# get/set ACL
s3 acl :mybucket
s3 acl :mybucket/somekey
s3 acl :mybucket/somekey --add any:read --del foo@example.com
# finally, delete stuff
s3 delete :mybucket/somekey
s3 delete :mybucket-x
s3 rm :mybucket