|  | = gerrit convert-ref-storage | 
|  |  | 
|  | == NAME | 
|  | gerrit convert-ref-storage - Convert ref storage to reftable (experimental). | 
|  |  | 
|  | 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. | 
|  |  | 
|  | == 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-format -p core | 
|  | ---- | 
|  |  | 
|  | GERRIT | 
|  | ------ | 
|  | Part of link:index.html[Gerrit Code Review] | 
|  |  | 
|  | SEARCHBOX | 
|  | --------- |