Purpose
ucp is a script that copies files or directories. It is an URL-enabled
version of the cp system command. Via ll.url and ll.orasql
ucp supports ssh and oracle URLs.
Options
ucp supports the following options:
urlsTwo or more URLs. If more than two URLs are given or the last URL refers to an existing directory, the last URL is the target directory. All other sources are copied into this target directory. Otherwise one file is copied to another file.
-v,--verbose(false,no,0,true,yesor1)Give a report during the copy process about the files copied and their sizes.
-c,--color(yes,noorauto)Should the output be colored? If
autois specified (the default) then the output is colored if stdout is a terminal.-u,--userA user id or name. If given
ucpwill change the owner of the target files.-g,--groupA group id or name. If given
ucpwill change the group of the target files.-r,--recursive(false,no,0,true,yesor1)Copies files recursively.
-x,--ignoreerrors(false,no,0,true,yesor1)Ignores errors occuring during the copy process (otherwise the copy process is aborted).
-i,--include(pattern)Only copy files that match the pattern.
-e,--exclude(pattern)Don't copy files that match the pattern.
--enterdir(pattern)Only enter directories that match the pattern.
--skipdir(pattern)Skip directories that match the pattern.
--ignorecase(false,no,0,true,yesor1)Perform case-insensitive pattern matching.
Examples
Copy one file to another:
$ ucp foo.txt bar.txt
Copy a file into an existing directory:
$ ucp foo.txt dir/
Copy multiple files into a new or existing directory (and give a progress report):
$ ucp foo.txt bar.txt baz.txt dir/ -v ucp: foo.txt -> dir/foo.txt (1,114 bytes) ucp: bar.txt -> dir/bar.txt (2,916 bytes) ucp: baz.txt -> dir/baz.txt (35,812 bytes)
Recursively copy the schema objects in an Oracle database to a local directory:
ucp oracle://user:pwd@oracle.example.org/ db/ -r
Recursively copy the schema objects in an Oracle database to a remote directory:
ucp oracle://user:pwd@oracle.example.org/ ssh://user@www.example.org/~/db/ -r