2021-06-20 12:41:05 +00:00
|
|
|
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
|
2024-09-24 23:17:05 +00:00
|
|
|
.TH REPO "1" "September 2024" "repo smartsync" "Repo Manual"
|
2021-06-20 12:41:05 +00:00
|
|
|
.SH NAME
|
|
|
|
|
repo \- repo smartsync - manual page for repo smartsync
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B repo
|
|
|
|
|
\fI\,smartsync \/\fR[\fI\,<project>\/\fR...]
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
Summary
|
|
|
|
|
.PP
|
|
|
|
|
Update working tree to the latest known good revision
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-h\fR, \fB\-\-help\fR
|
|
|
|
|
show this help message and exit
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR
|
2021-07-26 19:59:20 +00:00
|
|
|
number of jobs to run in parallel (default: based on
|
|
|
|
|
number of CPU cores)
|
2021-06-20 12:41:05 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-\-jobs\-network\fR=\fI\,JOBS\/\fR
|
|
|
|
|
number of network jobs to run in parallel (defaults to
|
2022-08-04 08:27:17 +00:00
|
|
|
\fB\-\-jobs\fR or 1)
|
2021-06-20 12:41:05 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR
|
|
|
|
|
number of local checkout jobs to run in parallel
|
2022-08-04 08:27:17 +00:00
|
|
|
(defaults to \fB\-\-jobs\fR or 8)
|
2021-06-20 12:41:05 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-f\fR, \fB\-\-force\-broken\fR
|
|
|
|
|
obsolete option (to be deleted in the future)
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-fail\-fast\fR
|
|
|
|
|
stop syncing after first error is hit
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-force\-sync\fR
|
|
|
|
|
overwrite an existing git directory if it needs to
|
|
|
|
|
point to a different object directory. WARNING: this
|
|
|
|
|
may cause loss of data
|
|
|
|
|
.TP
|
2024-04-11 12:32:40 +00:00
|
|
|
\fB\-\-force\-checkout\fR
|
|
|
|
|
force checkout even if it results in throwing away
|
|
|
|
|
uncommitted modifications. WARNING: this may cause
|
|
|
|
|
loss of data
|
|
|
|
|
.TP
|
2021-06-20 12:41:05 +00:00
|
|
|
\fB\-\-force\-remove\-dirty\fR
|
|
|
|
|
force remove projects with uncommitted modifications
|
|
|
|
|
if projects no longer exist in the manifest. WARNING:
|
|
|
|
|
this may cause loss of data
|
|
|
|
|
.TP
|
2024-09-24 23:17:05 +00:00
|
|
|
\fB\-\-rebase\fR
|
|
|
|
|
rebase local commits regardless of whether they are
|
|
|
|
|
published
|
|
|
|
|
.TP
|
2021-06-20 12:41:05 +00:00
|
|
|
\fB\-l\fR, \fB\-\-local\-only\fR
|
|
|
|
|
only update working tree, don't fetch
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-manifest\-update\fR, \fB\-\-nmu\fR
|
|
|
|
|
use the existing manifest checkout as\-is. (do not
|
|
|
|
|
update to the latest revision)
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-n\fR, \fB\-\-network\-only\fR
|
|
|
|
|
fetch only, don't update working tree
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-d\fR, \fB\-\-detach\fR
|
|
|
|
|
detach projects back to manifest revision
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-c\fR, \fB\-\-current\-branch\fR
|
|
|
|
|
fetch only current branch from server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-current\-branch\fR
|
|
|
|
|
fetch all branches from server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml
|
|
|
|
|
temporary manifest to use for this sync
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-clone\-bundle\fR
|
|
|
|
|
enable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-clone\-bundle\fR
|
|
|
|
|
disable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-u\fR MANIFEST_SERVER_USERNAME, \fB\-\-manifest\-server\-username\fR=\fI\,MANIFEST_SERVER_USERNAME\/\fR
|
|
|
|
|
username to authenticate with the manifest server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-p\fR MANIFEST_SERVER_PASSWORD, \fB\-\-manifest\-server\-password\fR=\fI\,MANIFEST_SERVER_PASSWORD\/\fR
|
|
|
|
|
password to authenticate with the manifest server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-fetch\-submodules\fR
|
|
|
|
|
fetch submodules from server
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-use\-superproject\fR
|
2021-11-12 06:41:29 +00:00
|
|
|
use the manifest superproject to sync projects;
|
|
|
|
|
implies \fB\-c\fR
|
2021-06-20 12:41:05 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-use\-superproject\fR
|
|
|
|
|
disable use of manifest superprojects
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-tags\fR
|
|
|
|
|
fetch tags
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-tags\fR
|
2021-11-12 06:41:29 +00:00
|
|
|
don't fetch tags (default)
|
2021-06-20 12:41:05 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-\-optimized\-fetch\fR
|
|
|
|
|
only fetch projects fixed to sha1 if revision does not
|
|
|
|
|
exist locally
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-retry\-fetches\fR=\fI\,RETRY_FETCHES\/\fR
|
|
|
|
|
number of times to retry fetches on transient errors
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-prune\fR
|
|
|
|
|
delete refs that no longer exist on the remote
|
2021-11-12 06:41:29 +00:00
|
|
|
(default)
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-prune\fR
|
|
|
|
|
do not delete refs that no longer exist on the remote
|
2022-09-01 15:41:12 +00:00
|
|
|
.TP
|
|
|
|
|
\fB\-\-auto\-gc\fR
|
|
|
|
|
run garbage collection on all synced projects
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-auto\-gc\fR
|
|
|
|
|
do not run garbage collection on any projects
|
|
|
|
|
(default)
|
2021-06-20 12:41:05 +00:00
|
|
|
.SS Logging options:
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
|
|
|
show all output
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
|
|
|
only show errors
|
2022-07-10 09:15:19 +00:00
|
|
|
.SS Multi\-manifest options:
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-outer\-manifest\fR
|
|
|
|
|
operate starting at the outermost manifest
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-outer\-manifest\fR
|
|
|
|
|
do not operate on outer manifests
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-this\-manifest\-only\fR
|
|
|
|
|
only operate on this (sub)manifest
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR
|
|
|
|
|
operate on this manifest and its submanifests
|
2021-06-20 12:41:05 +00:00
|
|
|
.SS repo Version options:
|
|
|
|
|
.TP
|
|
|
|
|
\fB\-\-no\-repo\-verify\fR
|
|
|
|
|
do not verify repo source code
|
|
|
|
|
.PP
|
|
|
|
|
Run `repo help smartsync` to view the detailed manual.
|
|
|
|
|
.SH DETAILS
|
|
|
|
|
.PP
|
|
|
|
|
The 'repo smartsync' command is a shortcut for sync \fB\-s\fR.
|
