repo-gitc-init - Man Page

repo gitc-init — manual page for repo gitc-init

Synopsis

repo gitc-init [options] [client name]

Description

Summary

Initialize a GITC Client.

Options

-h,  --help

show this help message and exit

Logging options

-v,  --verbose

show all output

-q,  --quiet

only show errors

Manifest options

-u URL, --manifest-url=URL

manifest repository location

-b REVISION, --manifest-branch=REVISION

manifest branch or revision (use HEAD for default)

-m NAME.xml, --manifest-name=NAME.xml

initial manifest file

-g GROUP, --groups=GROUP

restrict manifest projects to ones with specified group(s) [default|all|G1,G2,G3|G4,-G5,-G6]

-p PLATFORM, --platform=PLATFORM

restrict manifest projects to ones with a specified platform group [auto|all|none|linux|darwin|...]

--submodules

sync any submodules associated with the manifest repo

--standalone-manifest

download the manifest as a static file rather then create a git checkout of the manifest repo

--manifest-depth=DEPTH

create a shallow clone of the manifest repo with given depth (0 for full clone); see git clone (default: 0)

Manifest (only) checkout options

--current-branch

fetch only current manifest branch from server (default)

--no-current-branch

fetch all manifest branches from server

--tags

fetch tags in the manifest

--no-tags

don't fetch tags in the manifest

Checkout modes

--mirror

create a replica of the remote repositories rather than a client working directory

--archive

checkout an archive instead of a git repository for each project. See git archive.

--worktree

use git-worktree to manage projects

Project checkout optimizations

--reference=DIR

location of mirror directory

--dissociate

dissociate from reference mirrors after clone

--depth=DEPTH

create a shallow clone with given depth; see git clone

--partial-clone

perform partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

--no-partial-clone

disable use of partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

--partial-clone-exclude=PARTIAL_CLONE_EXCLUDE

exclude the specified projects (a comma-delimited project names) from partial clone (https://gitscm.com/docs/gitrepositorylayout#_code_partialclone_code)

--clone-filter=CLONE_FILTER

filter for use with --partial-clone [default: blob:none]

--use-superproject

use the manifest superproject to sync projects; implies -c

--no-use-superproject

disable use of manifest superprojects

--clone-bundle

enable use of /clone.bundle on HTTP/HTTPS (default if not --partial-clone)

--no-clone-bundle

disable use of /clone.bundle on HTTP/HTTPS (default if --partial-clone)

--git-lfs

enable Git LFS support

--no-git-lfs

disable Git LFS support

repo Version options

--repo-url=URL

repo repository location ($REPO_URL)

--repo-rev=REV

repo branch or revision ($REPO_REV)

--no-repo-verify

do not verify repo source code

Other options

--config-name

Always prompt for name/e-mail

GITC options

-f MANIFEST_FILE, --manifest-file=MANIFEST_FILE

Optional manifest file to use for this GITC client.

-c GITC_CLIENT, --gitc-client=GITC_CLIENT

Name of the gitc_client instance to create or modify.

Multi-manifest

--outer-manifest

operate starting at the outermost manifest

--no-outer-manifest

do not operate on outer manifests

--this-manifest-only

only operate on this (sub)manifest

--no-this-manifest-only,  --all-manifests

operate on this manifest and its submanifests

Run `repo help gitc-init` to view the detailed manual.

Details

The 'repo gitc-init' command is ran to initialize a new GITC client for use with the GITC file system.

This command will setup the client directory, initialize repo, just like repo init does, and then downloads the manifest collection and installs it in the .repo/directory of the GITC client.

Once this is done, a GITC manifest is generated by pulling the HEAD SHA for each project and generates the properly formatted XML file and installs it as .manifest in the GITC client directory.

The -c argument is required to specify the GITC client name.

The optional -f argument can be used to specify the manifest file to use for this GITC client.

Info

October 2022 repo gitc-init Repo Manual