blob: 79619590b99e4a72afc9c02d3e56276dd2d044f3 [file] [log] [blame]
'\" t
.\" Title: git-unpack-objects
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\" Date: 02/13/2019
.\" Manual: Git Manual
.\" Source: Git 2.21.0.rc1
.\" Language: English
.\"
.TH "GIT\-UNPACK\-OBJECTS" "1" "02/13/2019" "Git 2\&.21\&.0\&.rc1" "Git Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
git-unpack-objects \- Unpack objects from a packed archive
.SH "SYNOPSIS"
.sp
.nf
\fIgit unpack\-objects\fR [\-n] [\-q] [\-r] [\-\-strict]
.fi
.sp
.SH "DESCRIPTION"
.sp
Read a packed archive (\&.pack) from the standard input, expanding the objects contained within and writing them into the repository in "loose" (one object per file) format\&.
.sp
Objects that already exist in the repository will \fBnot\fR be unpacked from the packfile\&. Therefore, nothing will be unpacked if you use this command on a packfile that exists within the target repository\&.
.sp
See \fBgit-repack\fR(1) for options to generate new packs and replace existing ones\&.
.SH "OPTIONS"
.PP
\-n
.RS 4
Dry run\&. Check the pack file without actually unpacking the objects\&.
.RE
.PP
\-q
.RS 4
The command usually shows percentage progress\&. This flag suppresses it\&.
.RE
.PP
\-r
.RS 4
When unpacking a corrupt packfile, the command dies at the first corruption\&. This flag tells it to keep going and make the best effort to recover as many objects as possible\&.
.RE
.PP
\-\-strict
.RS 4
Don\(cqt write objects with broken content or links\&.
.RE
.PP
\-\-max\-input\-size=<size>
.RS 4
Die, if the pack is larger than <size>\&.
.RE
.SH "GIT"
.sp
Part of the \fBgit\fR(1) suite