mirror of
https://gerrit.googlesource.com/git-repo
synced 2026-05-31 15:09:48 +00:00
Gavin Mak
2d54384a5e
Allow syncing the outer manifest to a state defined by a specific superproject revision. It updates the superproject, reads the manifest commit from .supermanifest, and checks out the outer manifest project to that commit. Submanifests are then processed normally, allowing them to be updated to the revisions specified in the new outer manifest state. Bug: 416589884 Change-Id: I304c37a2b8794f9b74cb7e5e209a8a93762bdb52 Reviewed-on: https://gerrit-review.googlesource.com/c/git-repo/+/576321 Commit-Queue: Gavin Mak <gavinmak@google.com> Tested-by: Gavin Mak <gavinmak@google.com> Reviewed-by: Mike Frysinger <vapier@google.com>
173 lines
4.6 KiB
Groff
173 lines
4.6 KiB
Groff
.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
|
|
.TH REPO "1" "May 2026" "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). Ignored unless \fB\-\-no\-interleaved\fR is set
|
|
.TP
|
|
\fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR
|
|
number of local checkout jobs to run in parallel
|
|
(defaults to \fB\-\-jobs\fR or 8). Ignored unless \fB\-\-nointerleaved\fR is set
|
|
.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 (default)
|
|
.TP
|
|
\fB\-\-no\-interleaved\fR
|
|
fetch and checkout projects in phases
|
|
.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\-\-superproject\-revision\fR=\fI\,SUPERPROJECT_REVISION\/\fR
|
|
sync to superproject revision (applies to outer
|
|
manifest)
|
|
.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
|
|
.SS post\-sync hooks:
|
|
.TP
|
|
\fB\-\-no\-verify\fR
|
|
Do not run the post\-sync hook.
|
|
.TP
|
|
\fB\-\-verify\fR
|
|
Run the post\-sync hook without prompting.
|
|
.TP
|
|
\fB\-\-ignore\-hooks\fR
|
|
Do not abort if post\-sync hooks fail.
|
|
.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.
|