The "clone" command:
Make a clone of a repository specified by URI in the local file named FILENAME. If FILENAME is omitted, then an appropriate filename is deduced from last element of the path in the URL.
URI may be one of the following forms ([...] denotes optional elements):
- HTTP/HTTPS protocol:
http[s]://[userid[:password]@]host[:port][/path]
-
SSH protocol:
ssh://[userid@]host[:port]/path/to/repo.fossil[?fossil=path/fossil.exe]
-
Filesystem:
[file://]path/to/repo.fossil
For ssh and filesystem, path must have an extra leading '/' to use an absolute path.
Use %HH escapes for special characters in the userid and password. For example "%40" in place of "@", "%2f" in place of "/", and "%3a" in place of ":".
Note that in Fossil (in contrast to some other DVCSes) a repository is distinct from a check-out. Cloning a repository is not the same thing as opening a repository. This command always clones the repository. This command might also open the repository, but only if the --no-open option is omitted and either the --workdir option is included or the FILENAME argument is omitted. Use the separate open command to open a repository that was previously cloned and already exists on the local machine.
By default, the current login name is used to create the default admin user for the new clone. This can be overridden using the -A|--admin-user parameter.
Options:
- -A|--admin-user USERNAME
- Make USERNAME the administrator
- -B|--httpauth USER:PASS
- Add HTTP Basic Authorization to requests
- --nested
- Allow opening a repository inside an opened check-out
- --nocompress
- Omit extra delta compression
- --no-open
- Clone only. Do not open a check-out.
- --once
- Don't remember the URI.
- --private
- Also clone private branches
- --proxy PROXY
- Use the specified HTTP proxy
- --save-http-password
- Remember the HTTP password without asking
- -c|--ssh-command SSH
- Use SSH as the "ssh" command
- --ssl-identity FILENAME
- Use the SSL identity if requested by the server
- --transport-command CMD
- Use CMD to move messages to the server and back
- -u|--unversioned
- Also sync unversioned content
- -v|--verbose
- Show more statistics in output
- --workdir DIR
- Also open a check-out in DIR
- --xverbose
- Extra debugging output