| .\" DO NOT MODIFY THIS FILE! It was generated by help2man. |
| .TH REPO "1" "September 2024" "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\-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. |