mirror of
https://gerrit.googlesource.com/git-repo
synced 2025-07-02 20:17:19 +00:00
85352825ff
Prepare for an interleaved fetch and checkout mode for `repo sync`. The goal of the new mode is to significantly speed up syncs by running fetch and checkout operations in parallel for different projects, rather than waiting for all fetches to complete before starting any checkouts. Bug: 421935613 Change-Id: I8c66d1e790c7bba6280e409b95238c5e4e61a9c8 Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/482821 Reviewed-by: Scott Lee <ddoman@google.com> Commit-Queue: Gavin Mak <gavinmak@google.com> Tested-by: Gavin Mak <gavinmak@google.com>
156 lines
4.1 KiB
Groff
156 lines
4.1 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
|
|
.TH REPO "1" "June 2025" "repo smartsync" "Repo Manual"
|
|
.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
|
|
number of jobs to run in parallel (default: based on
|
|
number of CPU cores)
|
|
.TP
|
|
\fB\-\-jobs\-network\fR=\fI\,JOBS\/\fR
|
|
number of network jobs to run in parallel (defaults to
|
|
\fB\-\-jobs\fR or 1)
|
|
.TP
|
|
\fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR
|
|
number of local checkout jobs to run in parallel
|
|
(defaults to \fB\-\-jobs\fR or 8)
|
|
.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
|
|
\fB\-\-force\-checkout\fR
|
|
force checkout even if it results in throwing away
|
|
uncommitted modifications. WARNING: this may cause
|
|
loss of data
|
|
.TP
|
|
\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
|
|
\fB\-\-rebase\fR
|
|
rebase local commits regardless of whether they are
|
|
published
|
|
.TP
|
|
\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\-\-interleaved\fR
|
|
fetch and checkout projects in parallel (experimental)
|
|
.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
|
|
use the manifest superproject to sync projects;
|
|
implies \fB\-c\fR
|
|
.TP
|
|
\fB\-\-no\-use\-superproject\fR
|
|
disable use of manifest superprojects
|
|
.TP
|
|
\fB\-\-tags\fR
|
|
fetch tags
|
|
.TP
|
|
\fB\-\-no\-tags\fR
|
|
don't fetch tags (default)
|
|
.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
|
|
(default)
|
|
.TP
|
|
\fB\-\-no\-prune\fR
|
|
do not delete refs that no longer exist on the remote
|
|
.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)
|
|
.SS Logging options:
|
|
.TP
|
|
\fB\-v\fR, \fB\-\-verbose\fR
|
|
show all output
|
|
.TP
|
|
\fB\-q\fR, \fB\-\-quiet\fR
|
|
only show errors
|
|
.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
|
|
.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.
|