blob: 7f8c65a8d8a99bca205f1b5c9f82f942b10ae5d3 [file] [log] [blame]
Roger Shimizu0a1f5332021-06-20 21:41:05 +09001.\" DO NOT MODIFY THIS FILE! It was generated by help2man.
Mike Frysingerd47d9ff2022-07-10 05:15:19 -04002.TH REPO "1" "July 2022" "repo smartsync" "Repo Manual"
Roger Shimizu0a1f5332021-06-20 21:41:05 +09003.SH NAME
4repo \- repo smartsync - manual page for repo smartsync
5.SH SYNOPSIS
6.B repo
7\fI\,smartsync \/\fR[\fI\,<project>\/\fR...]
8.SH DESCRIPTION
9Summary
10.PP
11Update working tree to the latest known good revision
12.SH OPTIONS
13.TP
14\fB\-h\fR, \fB\-\-help\fR
15show this help message and exit
16.TP
17\fB\-j\fR JOBS, \fB\-\-jobs\fR=\fI\,JOBS\/\fR
Mike Frysingerdf8b1cb2021-07-26 15:59:20 -040018number of jobs to run in parallel (default: based on
19number of CPU cores)
Roger Shimizu0a1f5332021-06-20 21:41:05 +090020.TP
21\fB\-\-jobs\-network\fR=\fI\,JOBS\/\fR
22number of network jobs to run in parallel (defaults to
23\fB\-\-jobs\fR)
24.TP
25\fB\-\-jobs\-checkout\fR=\fI\,JOBS\/\fR
26number of local checkout jobs to run in parallel
27(defaults to \fB\-\-jobs\fR)
28.TP
29\fB\-f\fR, \fB\-\-force\-broken\fR
30obsolete option (to be deleted in the future)
31.TP
32\fB\-\-fail\-fast\fR
33stop syncing after first error is hit
34.TP
35\fB\-\-force\-sync\fR
36overwrite an existing git directory if it needs to
37point to a different object directory. WARNING: this
38may cause loss of data
39.TP
40\fB\-\-force\-remove\-dirty\fR
41force remove projects with uncommitted modifications
42if projects no longer exist in the manifest. WARNING:
43this may cause loss of data
44.TP
45\fB\-l\fR, \fB\-\-local\-only\fR
46only update working tree, don't fetch
47.TP
48\fB\-\-no\-manifest\-update\fR, \fB\-\-nmu\fR
49use the existing manifest checkout as\-is. (do not
50update to the latest revision)
51.TP
52\fB\-n\fR, \fB\-\-network\-only\fR
53fetch only, don't update working tree
54.TP
55\fB\-d\fR, \fB\-\-detach\fR
56detach projects back to manifest revision
57.TP
58\fB\-c\fR, \fB\-\-current\-branch\fR
59fetch only current branch from server
60.TP
61\fB\-\-no\-current\-branch\fR
62fetch all branches from server
63.TP
64\fB\-m\fR NAME.xml, \fB\-\-manifest\-name\fR=\fI\,NAME\/\fR.xml
65temporary manifest to use for this sync
66.TP
67\fB\-\-clone\-bundle\fR
68enable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS
69.TP
70\fB\-\-no\-clone\-bundle\fR
71disable use of \fI\,/clone.bundle\/\fP on HTTP/HTTPS
72.TP
73\fB\-u\fR MANIFEST_SERVER_USERNAME, \fB\-\-manifest\-server\-username\fR=\fI\,MANIFEST_SERVER_USERNAME\/\fR
74username to authenticate with the manifest server
75.TP
76\fB\-p\fR MANIFEST_SERVER_PASSWORD, \fB\-\-manifest\-server\-password\fR=\fI\,MANIFEST_SERVER_PASSWORD\/\fR
77password to authenticate with the manifest server
78.TP
79\fB\-\-fetch\-submodules\fR
80fetch submodules from server
81.TP
82\fB\-\-use\-superproject\fR
Mike Frysingere6601062021-11-12 01:41:29 -050083use the manifest superproject to sync projects;
84implies \fB\-c\fR
Roger Shimizu0a1f5332021-06-20 21:41:05 +090085.TP
86\fB\-\-no\-use\-superproject\fR
87disable use of manifest superprojects
88.TP
89\fB\-\-tags\fR
90fetch tags
91.TP
92\fB\-\-no\-tags\fR
Mike Frysingere6601062021-11-12 01:41:29 -050093don't fetch tags (default)
Roger Shimizu0a1f5332021-06-20 21:41:05 +090094.TP
95\fB\-\-optimized\-fetch\fR
96only fetch projects fixed to sha1 if revision does not
97exist locally
98.TP
99\fB\-\-retry\-fetches\fR=\fI\,RETRY_FETCHES\/\fR
100number of times to retry fetches on transient errors
101.TP
102\fB\-\-prune\fR
103delete refs that no longer exist on the remote
Mike Frysingere6601062021-11-12 01:41:29 -0500104(default)
105.TP
106\fB\-\-no\-prune\fR
107do not delete refs that no longer exist on the remote
Roger Shimizu0a1f5332021-06-20 21:41:05 +0900108.SS Logging options:
109.TP
110\fB\-v\fR, \fB\-\-verbose\fR
111show all output
112.TP
113\fB\-q\fR, \fB\-\-quiet\fR
114only show errors
Mike Frysingerd47d9ff2022-07-10 05:15:19 -0400115.SS Multi\-manifest options:
116.TP
117\fB\-\-outer\-manifest\fR
118operate starting at the outermost manifest
119.TP
120\fB\-\-no\-outer\-manifest\fR
121do not operate on outer manifests
122.TP
123\fB\-\-this\-manifest\-only\fR
124only operate on this (sub)manifest
125.TP
126\fB\-\-no\-this\-manifest\-only\fR, \fB\-\-all\-manifests\fR
127operate on this manifest and its submanifests
Roger Shimizu0a1f5332021-06-20 21:41:05 +0900128.SS repo Version options:
129.TP
130\fB\-\-no\-repo\-verify\fR
131do not verify repo source code
132.PP
133Run `repo help smartsync` to view the detailed manual.
134.SH DETAILS
135.PP
136The 'repo smartsync' command is a shortcut for sync \fB\-s\fR.