.Dd July 21, 2008
.Dt TRANSMISSION-REMOTE 1
.Os
.Sh "نام (NAME)"
.Nm transmission-remote
.Nd ابزار کنترل از راه دور برای
.Xr transmission-daemon 1
و
.Xr transmission 1
.Sh "خلاصه دستور (SYNOPSIS)"
.Bk -words
.Nm
.Op Ar host:port | host | port
.Op Fl a Ar filenames-or-URLs
.Op Fl as
.Op Fl AS
.Op Fl asd Ar number
.Op Fl asu Ar number
.Op Fl asc
.Op Fl ASC
.Op Fl b
.Op Fl c Ar path | Fl C
.Op Fl d Ar number | Fl D
.Op Fl e Ar size
.Op Fl er | ep | et
.Op Fl -exit
.Op Fl f
.Op Fl F Ar filter
.Op Fl g Ar files
.Op Fl G Ar files
.Op Fl gisl Ar number
.Op Fl GISL Ar number
.Op Fl gsr Ar ratio
.Op Fl GSR
.Op Fl h
.Op Fl i
.Op Fl ic
.Op Fl ids
.Op Fl if
.Op Fl ip
.Op Fl isl Ar number
.Op Fl ISL Ar number
.Op Fl isld
.Op Fl it
.Op Fl j
.Op Fl l
.Op Fl m | M
.Op Fl n Ar user:pass
.Op Fl ne
.Op Fl N Ar netrc
.Op Fl o | O
.Op Fl p Ar port
.Op Fl Bh
.Op Fl Bn
.Op Fl \&Bl
.Op Fl ph Ar files
.Op Fl pl Ar files
.Op Fl pn Ar files
.Op Fl pr Ar peers
.Op Fl r
.Op Fl rad
.Op Fl s | S
.Op Fl sr Ar ratio
.Op Fl SR
.Op Fl srd
.Op Fl si
.Op Fl st
.Op Fl t Ar all | active | Ar id | Ar hash
.Op Fl hl
.Op Fl HL
.Op Fl u Ar number | Fl U
.Op Fl utp | no-utp
.Op Fl v
.Op Fl V
.Op Fl w Ar download-dir
.Op Fl x | X
.Op Fl y | Y
.Op Fl pi
.Ek
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک ابزار کنترل از راه دور برای
.Xr transmission 1
و
.Xr transmission-daemon 1
است.
.Pp
به‌طور پیش‌فرض،
.Nm
به نشست transmission در localhost:9091 متصل می‌شود.
سایر نشست‌ها را می‌توان با مشخص کردن یک میزبان و/یا درگاه متفاوت کنترل کرد..Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width Ds
.It Fl a Fl -add Ar filenames-or-URLs
افزودن تورنت‌ها به transmission.
.It Fl b Fl -debug
فعال‌سازی حالت اشکال‌زدایی.
.It Fl as Fl -alt-speed
استفاده از محدودیت‌های جایگزین.
.It Fl AS Fl -no-alt-speed
عدم استفاده از محدودیت‌های جایگزین.
.It Fl asd Fl -alt-speed-downlimit Ar limit
محدود کردن سرعت بارگیری جایگزین به
.Ar limit
کیلوبایت بر ثانیه.
.It Fl asu Fl -alt-speed-uplimit Ar limit
محدود کردن سرعت بارگذاری جایگزین به
.Ar limit
کیلوبایت بر ثانیه.
.It Fl asc Fl -alt-speed-scheduler
استفاده از زمان‌های روشن/خاموش زمان‌بندی‌شده.
.It Fl ASC Fl -no-alt-speed-scheduler
عدم استفاده از روزها و زمان‌های روشن/خاموش زمان‌بندی‌شده.
.It Fl -alt-speed-time-begin Ar time
.Ar time
برای شروع استفاده از محدودیت‌های سرعت جایگزین (به قالب hhmm).
.It Fl -alt-speed-time-end Ar time
.Ar time
برای پایان استفاده از محدودیت‌های سرعت جایگزین (به قالب hhmm).
.It Fl -alt-speed-days Ar days
تنظیم تعداد
.Ar days
(روزها) که زمان‌بند سرعت در آن‌ها فعال باشد، با استفاده از فهرستی مانند \(lq2,4-6\(rq.
.It Fl -torrent-done-script Ar filename
مشخص کردن یک
.Ar file
برای اجرا در زمان اتمام هر تورنت.
.It Fl -no-torrent-done-script
عدم اجرای هیچ اسکریپتی پس از اتمام تورنت.
.It Fl c Fl -incomplete-dir Ar dir
هنگام افزودن تورنت‌های جدید، ذخیره کردن محتوای آن‌ها در
.Ar directory
تا زمانی که تورنت به اتمام برسد.
.It Fl C Fl -no-incomplete-dir
عدم ذخیرهٔ تورنت‌های ناقص در دایرکتوری جداگانه.
.It Fl d Fl -downlimit Ar limit
محدود کردن بیشینهٔ سرعت بارگیری به
.Ar limit
کیلوبایت بر ثانیه (kB/s).
اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
.It Fl D Fl -no-downlimit
غیرفعال‌سازی محدودیت‌های سرعت بارگیری.
اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
.It Fl e Fl -cache Ar size
تنظیم بیشینهٔ اندازهٔ حافظهٔ نهان نشست بر حسب مبی‌بایت (MiB). این حافظهٔ نهان برای کاهش ورودی/خروجی دیسک استفاده می‌شود.
.It Fl er Fl -encryption-required
رمزنگاری تمام اتصالات با همتاها.
.It Fl ep Fl -encryption-preferred
ترجیح دادن اتصالات رمزنگاری‌شده با همتاها.
.It Fl et Fl -encryption-tolerated
ترجیح دادن اتصالات رمزنگاری‌نشده با همتاها.
.It Fl -exit
درخواست از Transmission برای بستن و خروج از برنامه.
.It Fl f Fl -files
دریافت فهرست فایل‌ها برای تورنت(های) فعلی.
.It Fl g Fl -get Ar all | file-index | files
علامت‌گذاری فایل(ها) برای بارگیری.
.Ar all
تمام فایل‌های تورنت را برای بارگیری علامت می‌زند،
.Ar file-index
یک فایل تکی را به فهرست بارگیری اضافه می‌کند، و
.Ar files
چندین فایل را به فهرست بارگیری می‌افزاید،
مانند \(lq\-g1,3-5\(rq برای افزودن فایل‌های شمارهٔ ۱، ۳، ۴ و ۵ به فهرست بارگیری.
.It Fl F Fl -filter Ar filter
فیلتر کردن تورنت‌های انتخاب‌شده. دستورهای بعدی تنها از تورنت‌هایی استفاده خواهند کرد که شرایط فیلتر را برآورده کنند.
.D1 i \- هم‌اکنون بیکار
.D1 u \- هم‌اکنون در حال بارگذاری
.D1 d \- هم‌اکنون در حال بارگیری
.D1 n:str \- نام تورنت شامل str باشد
.D1 l:label \- دارای برچسب label باشد
.D1 r:ratio \- حداقل نسبت بارگذاری
.D1 w \- دارای برخی فایل‌های ناخواسته باشد
قرار دادن پیشوند \(lq~\(rq قبل از فیلتر، آن را نفی می‌کند.
گزینهٔ \-F می‌تواند بیش از یک بار مشخص شود و ممکن است پیش از آن \-t بیاید. تنها تورنت‌هایی انتخاب می‌شوند که تمام شرایط را برآورده کنند.
.It Fl G Fl -no-get Ar all | file-index | files
علامت‌گذاری فایل(ها) برای بارگیری نشدن.
.It Fl gsr Fl -global-seedratio Ar ratio
تمام تورنت‌ها، مگر اینکه با تنظیم اختصاصی هر تورنت لغو شود، باید تا یک
.Ar ratio
(نسبت) مشخص اشتراک‌گذاری شوند.
.It Fl GSR Fl -no-global-seedratio
تمام تورنت‌ها، مگر اینکه با تنظیم اختصاصی هر تورنت لغو شود، باید بدون در نظر گرفتن نسبت اشتراک‌گذاری شوند.
.It Fl isl Fl -idle-seeding-limit Ar minutes
اجازه به اشتراک‌گذاری تورنت(های) انتخاب‌شده تا رسیدن به زمان مشخصی از بیکاری.
.It Fl isld Fl -default-idle-seeding-limit
استفاده از حد پیش‌فرض idle-seeding-limit برای تورنت انتخاب‌شده.
.It Fl ISL Fl -no-idle-seeding-limit
اجازه به اشتراک‌گذاری تورنت(های) انتخاب‌شده بدون در نظر گرفتن زمان بیکاری.
.It Fl gisl Fl -global-idle-seeding-limit Ar minutes
تمام تورنت‌ها، مگر اینکه برای هر تورنت بازنویسی شده باشد، پس از سپری کردن زمان مشخص‌شده در حالت بیکاری باید اشتراک‌گذاری را متوقف کنند.
.It Fl GISL Fl -no-global-idle-seeding-limit
تمام تورنت‌ها، مگر اینکه برای هر تورنت بازنویسی شده باشد، بدون در نظر گرفتن زمان سپری‌شده در حالت بیکاری باید اشتراک‌گذاری شوند.
اجازه به تورنت(های) انتخاب‌شده برای اشتراک‌گذاری بدون در نظر گرفتن مدت بیکاری.
.It Fl h Fl -help
چاپ توضیحات گزینه‌های خط فرمان.
.It Fl i Fl -info
نمایش جزئیات تورنت(های) فعلی.
.It Fl if Fl -info-files
فهرست کردن فایل‌های تورنت مشخص‌شده.
.It Fl ip Fl -info-peers
فهرست کردن همتاهای تورنت مشخص‌شده.
.It Fl ic Fl -info-pieces
فهرست کردن قطعه‌های تورنت مشخص‌شده.
.It Fl it Fl -info-trackers
فهرست کردن ردیاب‌های تورنت مشخص‌شده.
.It Fl j Fl -json
بازگرداندن پاسخ RPC در قالب JSON.
.It Fl si Fl -session-info
فهرست کردن اطلاعات نشست از کارساز.
.It Fl st Fl -session-stats
فهرست کردن اطلاعات آماری از کارساز.
.It Fl l Fl -list
فهرست کردن تمام تورنت‌ها.
.It Fl ids Fl -print-ids
چاپ فهرستی از شناسه(ID)های تورنت مشخص‌شده در قالبی مناسب به عنوان پارامتر برای
.Ar -t .
.It Fl L Fl -labels Ar label1[,label2[,...]]
تنظیم برچسب‌های تورنت مشخص‌شده.
.It Fl m Fl -portmap
فعال‌سازی نگاشت درگاه از طریق NAT-PMP یا UPnP.
.It Fl M Fl -no-portmap
غیرفعال‌سازی نگاشت درگاه.
.It Fl n Fl -auth Ar username:password
تنظیم
.Ar username
و
.Ar password
برای احراز هویت.
.It Fl ne Fl -authenv
تنظیم اطلاعات احراز هویت از متغیر محیطی
.Ar TR_AUTH
که باید در قالب
.Ar username:password
باشد.
.It Fl N Fl -netrc Ar filename
تنظیم اطلاعات احراز هویت از یک
.Ar netrc file .
برای اطلاعات بیشتر netrc(5) را ببینید.
.It Fl o Fl -dht
فعال‌سازی جدول درهم‌سازی توزیع‌شده (DHT).
.It Fl O Fl -no-dht
غیرفعال‌سازی جدول درهم‌سازی توزیع‌شده (DHT).
.It Fl p Fl -port Ar port
تنظیم
.Ar port
برای استفاده هنگام گوش دادن به اتصالات ورودی همتاها.
.It Fl Bh Fl -bandwidth-high
دادن بالاترین اولویت به این تورنت برای استفاده از پهنای باند موجود.
.It Fl Bn Fl -bandwidth-normal
اختصاص پهنای باند باقی‌مانده از تورنت‌های با اولویت بالا به این تورنت.
.It Fl \&Bl Fl -bandwidth-low
اختصاص پهنای باند باقی‌مانده از تورنت‌های با اولویت بالا و عادی به این تورنت.
.It Fl ph Fl -priority-high Ar all | file-index | files
تلاش برای بارگیری فایل(های) مشخص‌شده در اولویت اول.
.Ar all
تمام فایل‌های تورنت را با اولویت عادی علامت‌گذاری می‌کند،
.Ar file-index
اولویت یک فایل تکی را روی عادی تنظیم می‌کند، و
.Ar files
اولویت چندین فایل را روی عادی تنظیم می‌کند،
مانند \(lq\-pn1,3-5\(rq برای تنظیم اولویت فایل‌های شمارهٔ ۱، ۳، ۴ و ۵ به عادی.
.It Fl pn Fl -priority-normal Ar all | file-index | files
تلاش برای بارگیری فایل‌های مشخص‌شده به صورت عادی.
.It Fl pl Fl -priority-low Ar all | file-index | files
تلاش برای بارگیری فایل‌های مشخص‌شده در آخرین مرحله.
.It Fl pr Fl -peers Ar number
تنظیم بیشینهٔ تعداد همتاها.
اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها عمل می‌کند؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
.It Fl r Fl -remove
حذف تورنت(های) فعلی. این کار داده‌های بارگیری‌شده را پاک نمی‌کند.
.It Fl rad Fl -remove-and-delete
حذف تورنت(های) فعلی و پاک کردن داده‌های بارگیری‌شدهٔ آن‌ها.
.It Fl -reannounce
اعلان دوبارهٔ تورنت(های) فعلی به ردیاب. این کار معادل دکمهٔ \(lqدرخواست همتاهای بیشتر از ردیاب\(rq در واسط گرافیکی است.
.It Fl -move
انتقال داده‌های تورنت‌های فعلی از مکان فعلی‌شان به دایرکتوری مشخص‌شده.
.It Fl -rename Ar newname
تغییر نام فایل‌ها یا پوشهٔ ریشهٔ یک تورنت.
.It Fl -path Ar oldname
ارائهٔ مسیر اصلی برای دستور تغییر نام.
.It Fl -unix-socket
اتصال با استفاده از سوکت دامنه یونیکس (Unix domain socket).
.It Fl -find
مشخص کردن محل جستجوی داده‌های تورنت‌های فعلی برای Transmission.
.It Fl sr Fl -seedratio Ar ratio
اجازه به اشتراک‌گذاری تورنت(های) فعلی تا یک
.Ar ratio
(نسبت) مشخص.
.It Fl SR Fl -no-seedratio
اجازه به اشتراک‌گذاری تورنت(های) فعلی بدون در نظر گرفتن نسبت.
.It Fl srd Fl -seedratio-default
اجازه به تورنت(های) فعلی برای استفاده از تنظیمات سراسری seedratio.
.It Fl td Fl -tracker-add Ar tracker
افزودن یک ردیاب به تورنت.
.It Fl tr Fl -tracker-remove Ar trackerId
حذف یک ردیاب از تورنت.
.It Fl s Fl -start
شروع تورنت(های) فعلی.
.It Fl S Fl -stop
متوقف کردن بارگیری یا اشتراک‌گذاری تورنت(های) فعلی.
.It Fl -start-paused
شروع تورنت‌های اضافه‌شده در حالت مکث.
.It Fl -no-start-paused
شروع تورنت‌های اضافه‌شده در حالت فعال (بدون مکث).
.It Fl t Fl -torrent Ar all | active | id | torrent-hash
تنظیم تورنت(های) فعلی برای استفاده توسط گزینه‌های بعدی. عبارت صریح
.Ar all
درخواست‌های بعدی را روی تمام تورنت‌ها اعمال می‌کند؛ عبارت صریح
.Ar active
درخواست‌های بعدی را روی تورنت‌هایی که اخیراً فعال بوده‌اند اعمال می‌کند؛ و تورنت‌های مشخص می‌توانند بر اساس
.Ar id
یا
.Ar hash
انتخاب شوند.
برای تنظیم بیش از یک تورنت فعلی، شناسه‌های آن‌ها را در یک فهرست به هم متصل کنید، مانند
\(lq\-t2,4,6-8\(rq برای اعمال عملیات روی تورنت‌هایی که شناسهٔ آن‌ها ۲، ۴، ۶، ۷ و ۸ است.
.It Fl -trash-torrent
حذف فایل‌های تورنت پس از افزودن.
.It Fl -no-trash-torrent
عدم حذف فایل‌های تورنت پس از افزودن.
.It Fl hl Fl -honor-session
وادار کردن تورنت(های) فعلی به رعایت محدودیت‌های نشست.
.It Fl HL Fl -no-honor-session
وادار کردن تورنت(های) فعلی به عدم رعایت محدودیت‌های نشست.
.It Fl u Fl -uplimit Ar limit
محدود کردن بیشینهٔ سرعت بارگذاری به
.Ar limit
کیلوبایت بر ثانیه (kB/s).
اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
.It Fl U Fl -no-uplimit
غیرفعال‌سازی محدودیت‌های سرعت بارگذاری.
.It Fl -utp
فعال‌سازی uTP برای اتصالات همتاها.
.It Fl -no-utp
غیرفعال‌سازی uTP برای اتصالات همتاها.
اگر تورنت(های) فعلی انتخاب شده باشند، روی آن‌ها اثر می‌گذارد؛ در غیر این صورت، تنظیمات سراسری را تغییر می‌دهد.
.It Fl v Fl -verify
بررسی صحت تورنت(های) فعلی.
.It Fl V Fl -version
نمایش شمارهٔ نسخه و خروج.
.It Fl w Fl -download-dir Ar directory
در صورت استفاده به همراه --add، پوشهٔ بارگیری تورنت جدید را تنظیم می‌کند؛ در غیر این صورت، پوشهٔ بارگیری پیش‌فرض را تعیین می‌کند..It Fl x Fl -pex
فعال‌سازی تبادل همتا (PEX).
.It Fl X Fl -no-pex
غیرفعال‌سازی تبادل همتا (PEX).
.It Fl y Fl -lds
فعال‌سازی کشف محلی همتا (LPD).
.It Fl Y Fl -no-lds
غیرفعال‌سازی کشف محلی همتا (LPD).
.It Fl pi Fl -peer-info
فهرست کردن همتاهای متصل به تورنت فعلی.
در بخش `status` فهرست، علائم اختصاری زیر به کار می‌روند:
.D1 D: در حال بارگیری (دانلود) از این همتا
.D1 d: در صورت اجازه همتا، از آن بارگیری خواهد شد
.D1 E: اتصال رمزنگاری‌شده
.D1 H: همتا از طریق DHT پیدا شد
.D1 I: همتا یک اتصال ورودی است
.D1 K: همتا انسداد ما را برداشته، اما ما تمایلی نداریم
.D1 O: رفع انسداد خوش‌بینانه (Optimistic unchoke)
.D1 T: همتا از طریق uTP متصل است
.D1 U: در حال بارگذاری (آپلود) به همتا
.D1 u: در صورت درخواست همتا، به آن بارگذاری خواهد شد
.D1 X: همتا از طریق تبادل همتا (PEX) کشف شد
.D1 ?: ما انسداد این همتا را برداشتیم، اما تمایلی ندارد
.It Fl -blocklist-update
به‌روزرسانی فهرست مسدودی از نشانی مشخص‌شده در تنظیمات کلاینت دوردست با کلید
.Va "blocklist-url"
\&.
.El
.Sh "مثال‌ها (EXAMPLES)"
فهرست کردن تمام تورنت‌ها:
.Bd -literal -offset indent
$ transmission-remote \-l
.Ed
فهرست کردن تمام تورنت‌های فعال:
.Bd -literal -offset indent
$ transmission-remote \-tactive \-l
.Ed
فهرست کردن تمام تورنت‌های دارای برچسب "abc":
.Bd -literal -offset indent
$ transmission-remote \-F l:abc \-l
.Ed
فهرست کردن تمام تورنت‌های شامل "def" در نام، یا دارای برچسب "abc":
.Bd -literal -offset indent
$ transmission-remote -t $(\ transmission-remote \-F n:def \-ids )$(\ transmission-remote \-F l:abc \-ids ) \-l
.Ed
تغییر نام پوشه ریشه تورنت از "test1/examplefile.txt" به "test2/examplefile.txt":
.Bd -literal -offset indent
$ transmission-remote -t1 --path test1 --rename test2
.Ed
تنظیم محدودیت‌های دانلود و آپلود روی 400 kB/s و 60 kB/s:
.Bd -literal -offset indent
$ transmission-remote \-d400 \-u60
$ transmission-remote \-\-downlimit=400 \-\-uplimit=60
.Ed
تنظیم محدودیت‌های متناوب دانلود و آپلود روی 100 kB/s و 20 kB/s:
.Bd -literal -offset indent
$ transmission-remote \-asd100 \-asu20
$ transmission-remote \-\-alt-speed-downlimit=100 \-\-alt-speed-uplimit=20
.Ed
تنظیم زمان‌بند برای استفاده از محدودیت‌های سرعت متناوب در روزهای کاری هفته بین ساعت ۱۰ صبح تا ۱۱ شب:
.Bd -literal -offset indent
$ transmission-remote \-\-alt-speed-time-begin=1000
$ transmission-remote \-\-alt-speed-time-end=2300
$ transmission-remote \-\-alt-speed-days=1-5
$ transmission-remote \-\-alt-speed-scheduler
.Ed
فهرست کردن شناسه‌ها و وضعیت تمام تورنت‌ها:
.Bd -literal -offset indent
$ transmission-remote \-l
.Ed
فهرست کردن تمام تورنت‌ها از یک نشست دوردست نیازمند احراز هویت:
.Bd -literal -offset indent
$ transmission-remote host:9091 \-\-auth=username:password \-l
.Ed
شروع تمام تورنت‌ها:
.Bd -literal -offset indent
$ transmission-remote \-tall \-\-start
.Ed
افزودن دو تورنت:
.Bd -literal -offset indent
$ transmission-remote \-a one.torrent two.torrent
.Ed
افزودن تمام تورنت‌های موجود در ~/Desktop:
.Bd -literal -offset indent
$ transmission-remote \-a ~/Desktop/*torrent
.Ed
دریافت اطلاعات تفصیلی درباره تورنتی با شناسه '1':
.Bd -literal -offset indent
$ transmission-remote \-t1 \-i
.Ed
دریافت فهرست فایل‌های یک تورنت:
.Bd -literal -offset indent
$ transmission-remote \-t1 \-f
.Ed
دانلود تنها فایل‌های دوم و چهارم آن:
.Bd -literal -offset indent
$ transmission-remote \-t1 \-Gall \-g2,4
.Ed
تنظیم اولویت دو فایل اول تمام تورنت‌ها روی بالا (high):
.Bd -literal -offset indent
$ transmission-remote \-tall \-ph1,2
.Ed
تنظیم اولویت فایل‌های تمام تورنت‌ها روی عادی (normal):
.Bd -literal -offset indent
$ transmission-remote \-tall \-pnall
.Ed.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width Fl
.It Ev http_proxy
پروکسی مورد استفاده برای اعلان‌های ترکر http را تنظیم می‌کند.
.El
.Sh "نویسندگان (AUTHORS)"
.An -nosplit
.An Charles Kerr ,
.An Josh Elsasser ,
.An Eric Petit ,
.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