.\"
.\"  This file Copyright © Deanna Phillips <deanna@sdf.lonestar.org>
.\"
.\"  Permission to use, copy, modify, and distribute this software for any
.\"  purpose with or without fee is hereby granted, provided that the above
.\"  copyright notice and this permission notice appear in all copies.
.\"
.\"  THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\"  WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\"  MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\"  ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\"  WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\"  ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\"  OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd July 21, 2008
.Dt TRANSMISSION-CLI 1
.Os
.Sh "نام (NAME)"
.Nm transmission-cli
.Nd یک کلاینت بیت‌تورنت
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm transmission-cli
.Bk -words
.Fl h
.Nm
.Op Fl b | B
.Op Fl d Ar number | Fl D
.Op Fl er | ep | et
.Op Fl f Ar script
.Op Fl g Ar directory
.Op Fl h
.Op Fl m | M
.Op Fl p Ar port
.Op Fl -tos Ar tos
.Op Fl u Ar number | Fl U
.Op Fl v
.Op Fl w Ar directory
.Ar torrent-file
.Ek
.Sh "توضیحات (DESCRIPTION)"
برنامه
.Nm
یک کلاینت سبک و خط‌فرمانی بیت‌تورنت (BitTorrent) با قابلیت اسکریپت‌نویسی است.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width Ds
.It Fl b Fl -blocklist
فعال‌سازی لیست‌های مسدودسازی همتا (peer blocklists). نرم‌افزار Transmission قالب فایل لیست مسدودسازی bluetack را تشخیص می‌دهد.
لیست‌های مسدودسازی جدید را می‌توان با کپی کردن آن‌ها در زیرپوشه "blocklists" از پوشه پیکربندی (config-dir) اضافه کرد.
.It Fl B Fl -no-blocklist
غیرفعال‌سازی لیست‌های مسدودسازی.
.It Fl d -downlimit Ar number
تنظیم بیشینه سرعت دانلود بر حسب KB/s
.It Fl D -no-downlimit
عدم محدودسازی سرعت دانلود
.It Fl er Fl -encryption-required
رمزنگاری اجباری تمام اتصالات با همتایان.
.It Fl ep Fl -encryption-preferred
ترجیح اتصالات رمزنگاری‌شده با همتایان.
.It Fl et Fl -encryption-tolerated
ترجیح اتصالات رمزنگاری‌نشده با همتایان.
.It Fl f -finish Ar script
تنظیم یک اسکریپت برای اجرا در هنگام اتمام تورنت
.It Fl g Fl -config-dir Ar directory
محل جستجوی فایل‌های پیکربندی. این گزینه می‌تواند برای جابه‌جایی میان کلاینت‌های cli، daemon، gtk و qt استفاده شود.
برای اطلاعات بیشتر https://github.com/transmission/transmission/blob/main/docs/Configuration-Files.md را ببینید.
.It Fl h Fl -help
نمایش خلاصه‌ای کوتاه از نحوه استفاده.
.It Fl m Fl -portmap
فعال‌سازی نگاشت درگاه از طریق NAT-PMP یا UPnP
.It Fl M Fl -no-portmap
غیرفعال‌سازی نگاشت درگاه
.It Fl p -port Ar port
تنظیم درگاه برای گوش دادن به همتایان ورودی. (پیش‌فرض: 51413)
.It Fl -tos Ar tos
.nf
استفاده از نام ToS یا DSCP برای تنظیم نوع سرویس سوکت همتا جهت
شکل‌دهی ترافیک بر پایه روتر محلی. مقادیر معتبر یک مقدار ده‌دهی
بین 0-255، یا هر یک از این رشته‌های DSCP هستند:
.fi
.Pp
.Dq af11 ,
.Dq af12 ,
.Dq af13 ,
.Dq af21 ,
.Dq af22 ,
.Dq af23 ,
.Dq af31 ,
.Dq af32 ,
.Dq af33 ,
.Dq af41 ,
.Dq af42 ,
.Dq af43 ,
.Dq cs0 ,
.Dq cs1 ,
.Dq cs2 ,
.Dq cs3 ,
.Dq cs4 ,
.Dq cs5 ,
.Dq cs6 ,
.Dq cs7 ,
.Dq ef ,
.Dq le
این کلیدهای ToS منسوخ شده‌اند و در آینده حذف خواهند شد:
.Dq default ,
.Dq lowcost ,
.Dq lowdelay,
.Dq reliability ,
.Dq throughput
.Pp
.It Fl u -uplimit Ar number
تنظیم بیشینه سرعت آپلود بر حسب KB/s
.It Fl U -no-uplimit
عدم محدودسازی سرعت آپلود
.It Fl v Fl -verify
اعتبارسنجی داده‌های دانلودشده تورنت.
.It Fl w Fl -download-dir Ar directory
محل ذخیره داده‌های دانلودشده.
.El
.Sh "سیگنال‌ها (SIGNALS)"
علاوه بر این گزینه‌ها، ارسال سیگنال SIGHUP به
.Nm
باعث ارتباط با ترکر برای درخواست همتایان بیشتر می‌شود.
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width Fl
.It Ev TRANSMISSION_HOME
پوشه پیکربندی پیش‌فرض (config-dir) را تنظیم می‌کند.
.It Ev http_proxy
کتابخانه libcurl هنگام اعلام وضعیت به ترکرها از این متغیر محیطی استفاده می‌کند.
.El
.Sh "فایل‌ها (FILES)"
.Bl -tag -width Ds -compact
.It ~/.config/transmission
دایرکتوری که در آن
.Nm
اطلاعات تورنت را برای عملیات اشتراک‌گذاری (seeding) و ادامه‌دهی در آینده نگهداری می‌کند.
.El
.Sh "نویسندگان (AUTHORS)"
برنامه
.Nm
توسط افراد زیر نوشته شده است:
.An -nosplit
.An Eric Petit ,
.An Josh Elsasser ,
.An Charles Kerr ,
.An Mitchell Livingston ,
و
.An Mike Gelfand .
.Sh "همچنین ببینید (SEE ALSO)"
.Xr transmission-create 1 ,
.Xr transmission-daemon 1 ,
.Xr transmission-edit 1 ,
.Xr transmission-gtk 1 ,
.Xr transmission-qt 1 ,
.Xr transmission-remote 1 ,
.Xr transmission-show 1
.Pp
https://transmissionbt.com