1REPO(1)                           Repo Manual                          REPO(1)
2
3
4

NAME

6       repo - repo gitc-init - manual page for repo gitc-init
7

SYNOPSIS

9       repo gitc-init [options] [client name]
10

DESCRIPTION

12       Summary
13
14       Initialize a GITC Client.
15

OPTIONS

17       -h, --help
18              show this help message and exit
19
20   Logging options:
21       -v, --verbose
22              show all output
23
24       -q, --quiet
25              only show errors
26
27   Manifest options:
28       -u URL, --manifest-url=URL
29              manifest repository location
30
31       -b REVISION, --manifest-branch=REVISION
32              manifest branch or revision (use HEAD for default)
33
34       -m NAME.xml, --manifest-name=NAME.xml
35              initial manifest file
36
37       -g GROUP, --groups=GROUP
38              restrict  manifest projects to ones with specified group(s) [de‐
39              fault|all|G1,G2,G3|G4,-G5,-G6]
40
41       -p PLATFORM, --platform=PLATFORM
42              restrict manifest projects to ones  with  a  specified  platform
43              group [auto|all|none|linux|darwin|...]
44
45       --submodules
46              sync any submodules associated with the manifest repo
47
48       --standalone-manifest
49              download  the manifest as a static file rather then create a git
50              checkout of the manifest repo
51
52       --manifest-depth=DEPTH
53              create a shallow clone of the manifest repo  with  given  depth;
54              see git clone (default: 1)
55
56   Manifest (only) checkout options:
57       --current-branch
58              fetch only current manifest branch from server (default)
59
60       --no-current-branch
61              fetch all manifest branches from server
62
63       --tags fetch tags in the manifest
64
65       --no-tags
66              don't fetch tags in the manifest
67
68   Checkout modes:
69       --mirror
70              create a replica of the remote repositories rather than a client
71              working directory
72
73       --archive
74              checkout an  archive  instead  of  a  git  repository  for  each
75              project. See git archive.
76
77       --worktree
78              use git-worktree to manage projects
79
80   Project checkout optimizations:
81       --reference=DIR
82              location of mirror directory
83
84       --dissociate
85              dissociate from reference mirrors after clone
86
87       --depth=DEPTH
88              create a shallow clone with given depth; see git clone
89
90       --partial-clone
91              perform partial clone (https://gitscm.com/docs/gitrepositorylay‐
92              out#_code_partialclone_code)
93
94       --no-partial-clone
95              disable use of partial clone (https://gitscm.com/docs/gitreposi‐
96              torylayout#_code_partialclone_code)
97
98       --partial-clone-exclude=PARTIAL_CLONE_EXCLUDE
99              exclude the specified projects (a comma-delimited project names)
100              from  partial  clone  (https://gitscm.com/docs/gitrepositorylay‐
101              out#_code_partialclone_code)
102
103       --clone-filter=CLONE_FILTER
104              filter for use with --partial-clone [default: blob:none]
105
106       --use-superproject
107              use the manifest superproject to sync projects; implies -c
108
109       --no-use-superproject
110              disable use of manifest superprojects
111
112       --clone-bundle
113              enable use of /clone.bundle on HTTP/HTTPS (default if not --par‐
114              tial-clone)
115
116       --no-clone-bundle
117              disable use of /clone.bundle on HTTP/HTTPS  (default  if  --par‐
118              tial-clone)
119
120       --git-lfs
121              enable Git LFS support
122
123       --no-git-lfs
124              disable Git LFS support
125
126   repo Version options:
127       --repo-url=URL
128              repo repository location ($REPO_URL)
129
130       --repo-rev=REV
131              repo branch or revision ($REPO_REV)
132
133       --no-repo-verify
134              do not verify repo source code
135
136   Other options:
137       --config-name
138              Always prompt for name/e-mail
139
140   GITC options:
141       -f MANIFEST_FILE, --manifest-file=MANIFEST_FILE
142              Optional manifest file to use for this GITC client.
143
144       -c GITC_CLIENT, --gitc-client=GITC_CLIENT
145              Name of the gitc_client instance to create or modify.
146
147   Multi-manifest:
148       --outer-manifest
149              operate starting at the outermost manifest
150
151       --no-outer-manifest
152              do not operate on outer manifests
153
154       --this-manifest-only
155              only operate on this (sub)manifest
156
157       --no-this-manifest-only, --all-manifests
158              operate on this manifest and its submanifests
159
160       Run `repo help gitc-init` to view the detailed manual.
161

DETAILS

163       The 'repo gitc-init' command is ran to initialize a new GITC client for
164       use with the GITC file system.
165
166       This command will setup the client  directory,  initialize  repo,  just
167       like repo init does, and then downloads the manifest collection and in‐
168       stalls it in the .repo/directory of the GITC client.
169
170       Once this is done, a GITC manifest is generated by pulling the HEAD SHA
171       for  each project and generates the properly formatted XML file and in‐
172       stalls it as .manifest in the GITC client directory.
173
174       The -c argument is required to specify the GITC client name.
175
176       The optional -f argument can be used to specify the  manifest  file  to
177       use for this GITC client.
178
179
180
181repo gitc-init                    August 2022                          REPO(1)