NAME

gerrit convert-ref-storage - Convert ref storage to reftable.

A reftable file is a portable binary file format customized for reference storage. References are sorted, enabling linear scans, binary search lookup, and range scans.

See also link:https://www.git-scm.com/docs/reftable for more details[reftable,role=external,window=_blank]

SYNOPSIS

ssh -p <port> <host> gerrit convert-ref-storage
  [--format <format>]
  [--backup | -b]
  [--reflogs | -r]
  [--project <PROJECT> | -p <PROJECT>]

DESCRIPTION

Convert ref storage to reftable.

Note
 The conversion does not lock the repository. Concurrent writes during the conversion can leave the ref storage in an inconsistent state, so ensure the repository is quiescent. The REST convert-ref-storage endpoint and git’s own git refs migrate have the same limitation.

ACCESS

Administrators

OPTIONS

--project
-p

Required; Name of the project for which the ref format should be changed.

--format

Format to convert to: reftable or refdir. Default: reftable.

--backup
-b

Create backup of old ref storage format. Default: true.

--reflogs
-r

Write reflogs to reftable. Default: true.

EXAMPLES

Convert ref format for project "core" to reftable:

$ ssh -p 29418 review.example.com gerrit convert-ref-storage -p core

Part of Gerrit Code Review