'\" t
.\"     Title: git-remote-ext
.\"    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: راهنمای گیت
.\"    Source: Git 2.55.0
.\"  Language: Persian
.\"
.TH "GIT\-REMOTE\-EXT" "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-remote-ext \- اتصال و پل ارتباطی انتقال هوشمند داده به دستور خارجی
.SH "خلاصه دستور (SYNOPSIS)"
.sp
.nf
git remote add <nick> "ext::<command>[ <arguments>\&...]"
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
این ابزار کمکی راه دور از \fI<command>\fR مشخص‌شده برای اتصال به یک سرور راه دور گیت استفاده می‌کند\&.
.sp
داده‌های نوشته‌شده در ورودی استاندارد (stdin) دستور \fI<command>\fR مشخص‌شده به عنوان داده‌های ارسالی به یک سرور git://، git\-upload\-pack، git\-receive\-pack یا git\-upload\-archive (بسته به موقعیت) در نظر گرفته می‌شوند، و داده‌های خوانده‌شده از خروجی استاندارد (stdout) دستور <command> به عنوان داده‌های دریافتی از همان سرویس فرض می‌شوند\&.
.sp
دستور و آرگومان‌های آن با فاصله غیراسکیپ‌شده از یکدیگر جدا می‌شوند\&.
.sp
توالی‌های زیر دارای معانی ویژه‌ای هستند:
.PP
\*(Aq% \*(Aq
.RS 4
فاصله تحت‌اللفظی در دستور یا آرگومان\&.
.RE
.PP
\fI%%\fR
.RS 4
علامت درصد تحت‌اللفظی\&.
.RE
.PP
\fI%s\fR
.RS 4
با نام سرویسی که گیت می‌خواهد فراخوانی کند (receive\-pack، upload\-pack، یا upload\-archive) جایگزین می‌شود\&.
.RE
.PP
\fI%S\fR
.RS 4
با نام کامل سرویسی که گیت می‌خواهد فراخوانی کند (git\-receive\-pack، git\-upload\-pack، یا git\-upload\-archive) جایگزین می‌شود\&.
.RE
.PP
\fI%G\fR (باید نخستین نویسه‌ها در یک آرگومان باشد)
.RS 4
این آرگومان به
\fI<command>\fR
ارسال نخواهد شد\&. در عوض، باعث می‌شود که برنامه کمکی با ارسال درخواست‌های سرویس git:// به سمت راه دور شروع به کار کند، به طوری که فیلد service روی مقدار مناسب و فیلد repository روی بقیه آرگومان تنظیم می‌شود\&. حالت پیش‌فرض، عدم ارسال چنین درخواستی است\&.
.sp
این گزینه زمانی مفید است که طرف راه دور، یک سرور git:// باشد که از طریق یک تونل قابل دسترسی است\&.
.RE
.PP
\fI%V\fR (باید نخستین نویسه‌ها در آرگومان باشد)
.RS 4
این آرگومان به
\fI<command>\fR
ارسال نخواهد شد\&. در عوض، فیلد vhost را در درخواست سرویس git:// (روی بقیه آرگومان) تنظیم می‌کند\&. حالت پیش‌فرض، عدم ارسال vhost در چنین درخواستی است (در صورت ارسال درخواست)\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
GIT_TRANSLOOP_DEBUG
.RS 4
در صورت تنظیم، اطلاعات اشکال‌زدایی درباره عملیات گوناگون خواندن/نوشتن را چاپ می‌کند\&.
.RE
.SH "متغیرهای محیطی ارسالی به دستور (ENVIRONMENT VARIABLES PASSED TO COMMAND)"
.PP
GIT_EXT_SERVICE
.RS 4
روی نام کامل سرویسی که ابزار کمکی باید فراخوانی کند (مانند git\-upload\-pack و غیره) تنظیم می‌شود\&.
.RE
.PP
GIT_EXT_SERVICE_NOPREFIX
.RS 4
روی نام کوتاه سرویسی که ابزار کمکی باید فراخوانی کند (مانند upload\-pack و غیره) تنظیم می‌شود\&.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
این ابزار کمکی راه دور به صورت نامحسوس توسط گیت استفاده می‌شود، هنگامی که از دستوراتی مانند "git fetch <URL>"، "git clone <URL>"، "git push <URL>" یا "git remote add <nick> <URL>" استفاده می‌کنید که در آن‌ها <URL> با \fBext::\fR آغاز می‌شود\&. مثال‌ها:
.PP
"ext::ssh \-i /home/foo/\&.ssh/somekey user@host\&.example %S \fIfoo/repo\fR"
.RS 4
مشابه host\&.example:foo/repo است، اما از /home/foo/\&.ssh/somekey به عنوان جفت‌کلید و از user به عنوان کاربر در سمت راه دور استفاده می‌کند\&. این کار نیاز به ویرایش \&.ssh/config را برطرف می‌سازد\&.
.RE
.PP
"ext::socat \-t3600 \- ABSTRACT\-CONNECT:/git\-server %G/somerepo"
.RS 4
نشان‌دهنده مخزنی با مسیر /somerepo است که از طریق پروتکل git در نشانی فضای نام انتزاعی /git\-server قابل دسترسی است\&.
.RE
.PP
"ext::git\-server\-alias foo %G/repo"
.RS 4
نشان‌دهنده مخزنی با مسیر /repo است که با استفاده از برنامه کمکی "git\-server\-alias foo" مورد دسترسی قرار می‌گیرد\&. مسیر مخزن و نوع درخواست در خط فرمان ارسال نمی‌شوند، بلکه طبق معمولِ پروتکل git:// بخشی از جریان پروتکل هستند\&.
.RE
.PP
"ext::git\-server\-alias foo %G/repo %Vfoo"
.RS 4
نشان‌دهنده مخزنی با مسیر /repo است که با استفاده از برنامه کمکی "git\-server\-alias foo" مورد دسترسی قرار می‌گیرد\&. نام میزبان سرور راه دور که در جریان پروتکل ارسال می‌شود "foo" خواهد بود (این کار امکان اشتراک‌گذاری یک آدرس سطح پیوند را میان چندین سرور مجازی گیت فراهم می‌کند)\&.
.RE
.PP
"ext::git\-server\-alias foo %G/repo% with% spaces %Vfoo"
.RS 4
نشان‌دهنده مخزنی با مسیر
\fB/repo\fR
\fBwith\fR
\fBspaces\fR
است که با استفاده از برنامه کمکی "git\-server\-alias foo" مورد دسترسی قرار می‌گیرد\&. نام میزبان سرور راه دور که در جریان پروتکل ارسال می‌شود "foo" خواهد بود (این کار امکان اشتراک‌گذاری یک آدرس سطح پیوند را میان چندین سرور مجازی گیت فراهم می‌کند)\&.
.RE
.PP
"ext::git\-ssl foo\&.example /bar"
.RS 4
نشان‌دهنده مخزنی است که با استفاده از برنامه کمکی "git\-ssl foo\&.example /bar" مورد دسترسی قرار می‌گیرد\&. نوع درخواست می‌تواند توسط ابزار کمکی و با استفاده از متغیرهای محیطی تعیین شود (به بخش بالا نگاه کنید)\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgitremote-helpers\fR(7)
.SH "گیت (GIT)"
.sp
بخشی از مجموعه \fBgit\fR(1)