QingStor(1)			Qsctl Reference 		   QingStor(1)

NAME
       qsctl-cp

SYNOPSIS
       qsctl cp
	   <local-path> <qs-path> or <qs-path> <local-path>
	   [--force]
	   [-r, --recursive]
	   [--exclude]
	   [--include]

DESCRIPTION
       Copy  local  file(s) to qingstor or qingstor key(s) to local. The first
       path argument is the source and second the destination.

       When a key or file already exists at destination, program will  ask  to
       overwrite or skip. You can use --force option to forcely overwrite.

OPTIONS
       --force
	   Forcely overwrite existing key(file) without asking.

       -r, --recursive
	   Recursively transfer keys(files).

       --include
	   Exclude all keys or files that match the specified pattern.

       --exclude
	   Do not exclude keys or files that match the specified pattern.

EXAMPLES
       The following cp command copies a single file to bucket mybucket:

	   $ qsctl cp test.txt qs://mybucket

       Output:

	   Key <test.txt> created
	   File 'test.txt' deleted

       The  following  cp  command copies all keys in bucket mybucket to local
       directory:

	   $ qsctl cp qs://mybucket test/ -r

       Output:

	   File 'test/test1.txt' written
	   File 'test/test2.txt' written
	   File 'test/test3.jpg' written

       The following cp command with the --exclude  option  will  exclude  the
       keys match the patten value "*.txt":

	   $ qsctl cp qs://mybucket test -r --exclude "*.txt"

       Output:

	   File 'test/test3.jpg' written

       The  following  cp command with the --exclude and --include option will
       include the keys match the patten value "*.txt":

	   $ qsctl cp qs://mybucket test -r --exclude "*" --include "*.txt"

       Output:

	   File 'test/test1.txt' written
	   File 'test/test2.txt' written

REPORTING BUGS
       Report bugs to email <daniel@yunify.com>.

COPYRIGHT
       Copyright (C) 2016 Yunify Inc.

0.1				 May 03, 2016			   QingStor(1)
