'\" t
.\"     Title: git-ls-remote
.\"    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 Manual
.\"    Source: Git 2.55.0
.\"  Language: English
.\"
.TH "GIT\-LS\-REMOTE" "1" "2026\-06\-29" "Git 2\&.55\&.0" "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-ls-remote \- فهرست کردن مراجع موجود در یک مخزن دوردست
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
\fIgit ls\-remote\fR [\-\-branches] [\-\-tags] [\-\-refs] [\-\-upload\-pack=<exec>]
              [\-q | \-\-quiet] [\-\-exit\-code] [\-\-get\-url] [\-\-sort=<key>]
              [\-\-symref] [<repository> [<patterns>\&...]]
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
مراجع موجود در یک مخزن دوردست (remote) را به همراه شناسه‌های کامیت مربوط به آن‌ها نمایش می‌دهد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-b, \-\-branches, \-t, \-\-tags
.RS 4
به ترتیب محدود کردن خروجی تنها به شاخه‌های محلی و تگ‌های محلی\&. این گزینه‌ها با یکدیگر مانعة‌الجمع
\fIنیستند\fR؛
هنگامی که هر دو مشخص شوند، مراجع ذخیره‌شده در refs/heads و refs/tags نمایش داده می‌شوند\&. توجه داشته باشید که
\fB\-\-heads\fR
و
\fB\-h\fR
مترادف‌های منسوخ‌شده برای
\fB\-\-branches\fR
و
\fB\-b\fR
هستند و ممکن است در آینده حذف شوند\&. همچنین توجه داشته باشید که اجرای
\fBgit\fR
\fBls\-remote\fR
\fB\-h\fR
بدون هیچ آرگومان دیگری در خط فرمان، پیام راهنما را نمایش می‌دهد که با سایر زیردستورهای گیت سازگار است\&.
.RE
.PP
\-\-refs
.RS 4
عدم نمایش تگ‌های پوسته‌گیری‌شده (peeled tags) یا شبه‌مراجع مانند
\fBHEAD\fR
در خروجی\&.
.RE
.PP
\-q, \-\-quiet
.RS 4
عدم چاپ نشانی اینترنتی (URL) مخزن دوردست در stderr\&.
.RE
.PP
\-\-upload\-pack=<exec>
.RS 4
تعیین مسیر کامل
\fIgit\-upload\-pack\fR
بر روی میزبان دوردست\&. این ویژگی امکان فهرست کردن مراجع را از مخازنی که از طریق SSH به آن‌ها دسترسی یافته شده و سرویس SSH در آن‌ها از PATH پیکربندی‌شده توسط کاربر استفاده نمی‌کند، فراهم می‌سازد\&.
.RE
.PP
\-\-exit\-code
.RS 4
خروج با وضعیت "2" هنگامی که هیچ مرجع منطبقی در مخزن دوردست یافت نشود\&. معمولاً دستور با وضعیت "0" خارج می‌شود تا نشان دهد ارتباط با مخزن دوردست با موفقیت برقرار شده است، صرف‌نظر از اینکه مرجع منطبقی یافته شده باشد یا خیر\&.
.RE
.PP
\-\-get\-url
.RS 4
گسترش نشانی (URL) مخزن دوردست داده‌شده با در نظر گرفتن هرگونه تنظیم پیکربندی "url\&.<base>\&.insteadOf" (نگاه کنید به
\fBgit-config\fR(1))
و خروج از برنامه بدون برقراری ارتباط با مخزن دوردست\&.
.RE
.PP
\-\-symref
.RS 4
هنگام نمایش یک مرجع نمادین (symbolic ref)، علاوه بر شیء اشاره‌شده توسط آن، مرجع زیربنایی اشاره‌شده را نیز نشان می‌دهد\&. در حال حاضر، upload\-pack تنها مرجع نمادین HEAD را نشان می‌دهد، بنابراین تنها موردی خواهد بود که توسط ls\-remote نمایش داده می‌شود\&.
.RE
.PP
\-\-sort=<key>
.RS 4
مرتب‌سازی بر اساس کلید داده‌شده\&. برای مرتب‌سازی نزولی، پیشوند
\fB\-\fR
را اضافه کنید\&. از "version:refname" یا "v:refname" پشتیبانی می‌کند (با نام‌های تگ به عنوان نسخه رفتار می‌شود)\&. ترتیب مرتب‌سازی "version:refname" همچنین می‌تواند تحت تأثیر متغیر پیکربندی "versionsort\&.suffix" قرار گیرد\&. برای گزینه‌های مرتب‌سازی بیشتر به
\fBgit-for-each-ref\fR(1)
مراجعه کنید، اما توجه داشته باشید که کلیدهایی مانند
\fBcommitterdate\fR
که نیازمند دسترسی به خود اشیاء هستند، برای مراجعی که اشیاء آن‌ها هنوز از مخزن دوردست دریافت نشده‌اند کار نخواهند کرد و خطای
\fBmissing\fR
\fBobject\fR
خواهند داد\&.
.RE
.PP
\-o <option>, \-\-server\-option=<option>
.RS 4
ارسال رشته داده‌شده به کارساز (سرور) هنگام برقراری ارتباط با نسخه ۲ پروتکل\&. رشته داده‌شده نباید حاوی نویسه NUL یا LF باشد\&. هنگامی که چندین
\fB\-\-server\-option=\fR\fI<option>\fR
مشخص شود، همه آن‌ها به ترتیبی که در خط فرمان ذکر شده‌اند به سمت دیگر ارسال می‌شوند\&. اگر هیچ
\fB\-\-server\-option=\fR\fI<option>\fR
در خط فرمان مشخص نشده باشد، به جای آن مقادیر متغیر پیکربندی
\fBremote\&.\fR\fI<name>\fR\fB\&.serverOption\fR
استفاده می‌شود\&.
.RE
.PP
<repository>
.RS 4
مخزن «دوردست» برای پرس‌وجو\&. این پارامتر می‌تواند یک نشانی URL یا نام یک مخزن دوردست باشد (بخش‌های GIT URLS و REMOTES در
\fBgit-fetch\fR(1)
را ببینید)\&.
.RE
.PP
<patterns>\&...
.RS 4
در صورت عدم تعیین، تمامی مراجع، پس از اعمال فیلترهای \-\-heads و \-\-tags نشان داده می‌شوند\&. هنگامی که <patterns>\&... مشخص شوند، تنها مراجعی که با یک یا چند الگوی ارائه‌شده مطابقت دارند نمایش می‌یابند\&. هر الگو به صورت یک glob تفسیر می‌شود (به مدخل
\fBglob\fR
در
\fBgitglossary\fR(7)
نگاه کنید) که با «بخش انتهایی» یک مرجع مطابقت داده می‌شود؛ یا از ابتدای مرجع (بنابراین نام کاملی مانند
\fBrefs/heads/foo\fR
مطابقت دارد) یا از جداکننده اسلش (بنابراین
\fBbar\fR
با
\fBrefs/heads/bar\fR
مطابقت دارد اما با
\fBrefs/heads/foobar\fR
مطابقت ندارد)\&.
.RE
.SH "خروجی (OUTPUT)"
.sp
خروجی در قالب زیر است:
.sp
.if n \{\
.RS 4
.\}
.nf
<oid> TAB <ref> LF
.fi
.if n \{\
.RE
.\}
.sp
.sp
هنگام نمایش یک تگ حاشیه‌نویسی‌شده (annotated tag)، مگر اینکه \fB\-\-refs\fR داده شده باشد، دو خط به این صورت نمایش داده می‌شود: یکی با نام مرجع برای خود تگ به عنوان \fI<ref>\fR، و دیگری با \fI<ref>\fR همراه با پسوند \fB^\fR{}\&. شناسه \fI<oid>\fR در خط دوم، نام شیئی را که تگ به آن اشاره می‌کند نشان می‌دهد\&.
.SH "مثال‌ها (EXAMPLES)"
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرست کردن تمامی مراجع (شامل مراجع نمادین و شبه‌مراجع)، همراه با پوسته‌گیری تگ‌ها:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git ls\-remote
27d43aaaf50ef0ae014b88bba294f93658016a2e        HEAD
950264636c68591989456e3ba0a5442f93152c1a        refs/heads/main
d9ab777d41f92a8c1684c91cfb02053d7dd1046b        refs/heads/next
d4ca2e3147b409459955613c152220f4db848ee1        refs/tags/v2\&.40\&.0
73876f4861cd3d187a4682290ab75c9dccadbc56        refs/tags/v2\&.40\&.0^{}
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
فهرست کردن تمامی مراجع منطبق بر الگوهای داده‌شده:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git ls\-remote http://www\&.kernel\&.org/pub/scm/git/git\&.git master seen rc
5fe978a5381f1fbad26a80e682ddd2a401966740        refs/heads/master
c781a84b5204fb294c9ccc79f8b3baceeb32c061        refs/heads/seen
.fi
.if n \{\
.RE
.\}
.sp
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
تنها فهرست کردن تگ‌های منطبق بر الگوی جانشین (wildcard) داده‌شده:
.sp
.if n \{\
.RS 4
.\}
.nf
$ git ls\-remote \-\-tags http://www\&.kernel\&.org/pub/scm/git/git\&.git v\e*
485a869c64a68cc5795dd99689797c5900f4716d        refs/tags/v2\&.39\&.2
cbf04937d5b9fcf0a76c28f69e6294e9e3ecd7e6        refs/tags/v2\&.39\&.2^{}
d4ca2e3147b409459955613c152220f4db848ee1        refs/tags/v2\&.40\&.0
73876f4861cd3d187a4682290ab75c9dccadbc56        refs/tags/v2\&.40\&.0^{}
.fi
.if n \{\
.RE
.\}
.sp
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgit-check-ref-format\fR(1)\&.
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)