GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
GIT-REFS(1) Git Manual GIT-REFS(1)

git-refs - Low-level access to refs

git refs migrate --ref-format=<format> [--no-reflog] [--dry-run]
git refs verify [--strict] [--verbose]

This command provides low-level access to refs.

migrate

Migrate ref store between different formats.

verify

Verify reference database consistency.

The following options are specific to git refs migrate:

--ref-format=<format>

The ref format to migrate the ref store to. Can be one of:

files for loose files with packed-refs. This is the default.

reftable for the reftable format. This format is experimental and its internals are subject to change.

--dry-run

Perform the migration, but do not modify the repository. The migrated refs will be written into a separate directory that can be inspected separately. The name of the directory will be reported on stdout. This can be used to double check that the migration works as expected before performing the actual migration.

--reflog, --no-reflog

Choose between migrating the reflog data to the new backend, and discarding them. The default is "--reflog", to migrate.

The following options are specific to git refs verify:

--strict

Enable stricter error checking. This will cause warnings to be reported as errors. See git-fsck(1).

--verbose

When verifying the reference database consistency, be chatty.

The ref format migration has several known limitations in its current form:

•It is not possible to migrate repositories that have worktrees.

•There is no way to block concurrent writes to the repository during an ongoing migration. Concurrent writes can lead to an inconsistent migrated state. Users are expected to block writes on a higher level. If your repository is registered for scheduled maintenance, it is recommended to unregister it first with git-maintenance(1).

These limitations may eventually be lifted.

Part of the git(1) suite

2025-06-15 Git 2.50.1

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.