'\" t
.\"     Title: gitformat-loose
.\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2026-06-29
.\"    Manual: راهنمای Git
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GITFORMAT\-LOOSE" "5" "2026\-06\-29" "Git 2\&.55\&.0" "راهنمای Git"
.\" -----------------------------------------------------------------
.\" * 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)"
gitformat-loose \- ساختار و قالب اشیاء منفرد (loose objects) در گیت
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
$GIT_DIR/objects/[0\-9a\-f][0\-9a\-f]/*
$GIT_DIR/objects/object\-map/map\-*\&.map
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
اشیاء منفرد (Loose objects) روشی هستند که گیت برای ذخیره‌سازی اشیاء مستقل استفاده می‌کند، به‌طوری که هر شیء به عنوان یک فایل مجزا نوشته می‌شود\&.
.sp
در طول چرخه حیات یک مخزن، اشیاء معمولاً در ابتدا به عنوان اشیاء منفرد نوشته می‌شوند\&. در نهایت، این اشیاء منفرد از طریق عملیات نگهداری مخزن (maintenance) در فایل‌های بسته (packfiles) فشرده و جمع‌آوری می‌شوند تا استفاده از فضای دیسک بهینه شده و جستجوی این اشیاء سرعت یابد\&.
.SH "اشیاء منفرد (LOOSE OBJECTS)"
.sp
هر شیء منفرد شامل یک پیشوند (prefix) است که بلافاصله پس از آن داده‌های شیء قرار می‌گیرند\&. پیشوند شامل \fI<type>\fR \fI<size>\fR\fB\e0\fR است\&. مقدار \fI<type>\fR یکی از مقادیر \fBblob\fR، \fBtree\fR، \fBcommit\fR یا \fBtag\fR است و \fBsize\fR اندازه داده‌ها (بدون احتساب پیشوند) به عنوان یک عدد صحیح ده‌دهی در قالب اَسکی (ASCII) می‌باشد\&.
.sp
سپس کل محتوا (پیشوند به همراه داده‌ها) با الگوریتم zlib فشرده شده و داده‌های فشرده درون فایل ذخیره می‌شوند\&. شناسه شیء (object ID) درهم‌سازی (هش) SHA\-1 یا SHA\-256 (بسته به پیکربندی) از داده‌های غیرفشرده است\&.
.sp
فایل مربوط به شیء منفرد در پوشه \fBobjects\fR ذخیره می‌شود، به این صورت که دو نویسه هگزادسیمال نخست شناسه شیء نام پوشه را تشکیل می‌دهند و نویسه‌های باقی‌مانده نام فایل خواهند بود\&. این کار برای قطعه‌بندی (sharding) داده‌ها و جلوگیری از قرارگیری فایل‌های بیش از حد در یک پوشه واحد انجام می‌شود، زیرا برخی از سیستم‌های فایل در صورت وجود تعداد بسیار زیادی فایل در یک پوشه دچار افت کارایی می‌شوند\&.
.sp
به عنوان نمونه، یک درخت تهی (empty tree) حاوی داده‌های فشرده‌نشده \fBtree\fR \fB0\e0\fR است و در یک مخزن SHA\-256، شناسه شیء آن \fB6ef19b41225c5369f1c104d45d8d85efa9b057b53b14b4b9b939dd74decc5321\fR خواهد بود و در مسیر \fB$GIT_DIR/objects/6e/f19b41225c5369f1c104d45d8d85efa9b057b53b14b4b9b939dd74decc5321\fR ذخیره می‌گردد\&.
.sp
به طور مشابه، یک شیء blob که محتوای آن \fBabc\fR است، دارای داده‌های غیرفشرده \fBblob\fR \fB3\e0abc\fR خواهد بود\&.
.SH "نگاشت اشیاء منفرد (LOOSE OBJECT MAPPING)"
.sp
هنگامی که گزینه \fBcompatObjectFormat\fR استفاده می‌شود، گیت باید یک نگاشت میان الگوریتم اصلی مخزن و الگوریتم سازگاری برای اشیاء منفرد و همچنین برخی اطلاعات کمکی ذخیره کند\&.
.sp
این نگاشت شامل مجموعه‌ای از فایل‌ها در مسیر \fB$GIT_DIR/objects/object\-map\fR با پسوند \fB\&.map\fR است\&. بخش نام فایل پیش از پسوند، همان چکسام هش اصلی (یعنی همان که در \fBextensions\&.objectformat\fR مشخص شده) در قالب هگزادسیمال است\&.
.sp
دستور \fBgit\fR \fBgc\fR ورودی‌های موجود را مجدداً در یک فایل بسته‌بندی می‌کند و اشیاء غیرضروری مانند ورودی‌های کم‌عمق (shallow) منسوخ‌شده یا اشیاء منفردی که بسته‌بندی شده‌اند را حذف می‌نماید\&.
.sp
قالب فایل به شرح زیر است\&. تمام مقادیر در ترتیب بایت شبکه (network byte order) هستند و تمام مقادیر ۴ بایتی و ۸ بایتی باید در فایل هم‌تراز ۴ بایت (4\-byte aligned) باشند؛ بنابراین ممکن است در برخی موارد به پدینگ NUL نیاز باشد\&. گیت همیشه از کمترین تعداد بایت NUL (شامل صفر) که برای پدینگ لازم است استفاده می‌کند تا نوشتن فایل‌ها قطعی و معین (deterministic) باشد\&.
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
سرایند در ابتدای فایل قرار دارد و شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
امضای ۴ بایتی نگاشت:
\fBLMAP\fR
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شماره نسخه ۴ بایتی: 1
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
طول ۴ بایتی بخش سرایند (شامل ورودی‌های رزروشده اما بدون احتساب پدینگ NUL)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد ۴ بایتی اشیاء تعریف‌شده در این فایل نگاشت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تعداد ۴ بایتی قالب‌های شیء تعریف‌شده در این فایل نگاشت\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
برای هر قالب شیء:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
شناسه ۴ بایتی قالب (برای نمونه
\fBsha1\fR
برای SHA\-1)
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
طول ۴ بایتی (بر حسب بایت) برای نام‌های کوتاه شده اشیاء (یعنی پیشوندهای نام‌های کامل اشیاء)\&. این کوتاه‌ترین طول ممکن است که برای رفع ابهام نام‌ها در جدول نام‌های کوتاه شده اشیاء لازم است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
عدد صحیح ۸ بایتی، که مشخص می‌کند جدول‌های مربوط به این قالب در کجای این فایل نمایه ذخیره شده‌اند، به صورت آفست از ابتدای فایل\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
آفست ۸ بایتی به بخش انتهایی (trailer) از ابتدای این فایل\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
باقی‌مانده بخش سرایند برای استفاده‌های آتی رزرو شده است\&. خوانندگان باید داده‌های ناشناخته در اینجا را نادیده بگیرند\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفر یا چند بایت NUL\&. این بایت‌ها برای بهبود هم‌ترازی مقادیر ۴ بایتی زیر استفاده می‌شوند\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جدول‌های مربوط به نخستین قالب شیء:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک جدول مرتب‌شده از نام‌های کوتاه شده اشیاء\&. این‌ها پیشوندهای نام‌های همه اشیاء موجود در این فایل هستند که در کنار هم بسته‌بندی شده‌اند تا اثر حافظه کش در جستجوی دودویی برای یک نام شیء خاص کاهش یابد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک جدول مرتب‌شده از نام‌های کامل اشیاء\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جدولی از مقادیر فراداده ۴ بایتی\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفر یا چند بایت NUL\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جدول‌های مربوط به قالب‌های بعدی شیء:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
یک جدول مرتب‌شده از نام‌های کوتاه شده اشیاء\&. این‌ها پیشوندهای نام‌های همه اشیاء موجود در این فایل هستند که بدون مقادیر آفست در کنار هم بسته‌بندی شده‌اند تا اثر حافظه کش در جستجوی دودویی برای یک نام شیء خاص کاهش یابد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جدولی از نام‌های کامل اشیاء به ترتیبی که توسط نخستین قالب شیء مشخص شده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
جدولی از مقادیر ۴ بایتی که ترتیب نام‌های شیء را به ترتیب نخستین قالب شیء نگاشت می‌کند\&. برای یک شیء در جدول نام‌های کوتاه شده مرتب، مقدار در شاخص متناظر در این جدول، همان شاخص در جدول پیشین برای همان شیء است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
صفر یا چند بایت NUL\&.
.RE
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
بخش انتهایی (trailer) شامل موارد زیر است:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
چکسام درهم‌سازی تمام موارد فوق با استفاده از هش اصلی\&.
.RE
.RE
.sp
شش بیت پایین هر جدول فراداده شامل یک فیلد نوع است که دلیل ذخیره‌سازی این شیء را نشان می‌دهد:
.PP
0
.RS 4
رزرو شده\&.
.RE
.PP
1
.RS 4
این شیء به عنوان یک شیء منفرد در مخزن ذخیره شده است\&.
.RE
.PP
2
.RS 4
این شیء یک ورودی کم‌عمق (shallow entry) است\&. نگاشت به مقدار کم‌عمقی اشاره دارد که توسط یک سرور راه دور برگردانده شده است\&.
.RE
.PP
3
.RS 4
این شیء یک ورودی زیرماژول (submodule entry) است\&. نگاشت به کامیت ذخیره‌شده اشاره دارد که نمایانگر یک زیرماژول است\&.
.RE
.sp
ممکن است در آینده داده‌های دیگری در این فیلد ذخیره شود\&. بیت‌هایی که استفاده نمی‌شوند باید صفر باشند\&.
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)