blob: 75b444badf4ec9ffaf0e0e8277923f7a95b550e9 [file]
= gerrit convert-ref-storage
== 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
[verse]
--
_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
----
GERRIT
------
Part of link:index.html[Gerrit Code Review]
SEARCHBOX
---------