.TH Canto-remote 1 "Canto-remote"

.SH "نام (NAME)"
canto-remote \- ابزار کنترل از راه دور پایه برای دیمن canto-daemon

.SH "خلاصه دستور (SYNOPSIS)"
canto-remote (options) [command] (arguments)

.SH "توضیحات (DESCRIPTION)"
این ابزار امکاناتی را برای پیکربندی و پرس‌وجو از canto-daemon بدون نیاز به کلاینت کامل فراهم می‌کند. برای اسکریپت‌نویسی یا برقراری ارتباط با برنامه‌های دیگر مفید است.

.SH "گزینه‌ها (OPTIONS)"

.TP
\-V
چاپ اطلاعات نسخه و خروج.

.TP
\-h/--help
چاپ راهنمای استفاده.

.TP
\-D/--dir [directory]
تغییر پوشه پایه برای canto-daemon (پیش‌فرض: XDG_CONFIG_HOME/canto$).

.TP
\-\-noplugins
غیرفعال کردن تمام افزونه‌ها.

.TP
\-\-enableplugins 'plugin1 plugin2...'
فعال کردن این افزونه‌ها (بر گزینه noplugins-- تقدم دارد).

.TP
\-\-disableplugins 'plugin1 plugin2...'
غیرفعال کردن این افزونه‌ها.

.TP
\-a/--address [IP]
تلاش برای اتصال به آدرس شبکه به جای سوکت یونیکس محلی، پیش‌فرض آدرس محلی (127.0.0.1) است.

.TP
\-p/--port [port]
استفاده از درگاه (پورت) مشخص در هنگام اتصال با گزینه a-.

.SH "دستورات (COMMANDS)"

دستور canto-remote از فرمان‌های گوناگونی برای پیکربندی canto-daemon پشتیبانی می‌کند، هرچند استفاده از یک کلاینت واقعی توصیه می‌شود.

.TP
.B help [command]
دریافت راهنما برای یک دستور خاص.

.TP
.B addfeed [URL] (username=user password=secret) (name="Some name")
مشترک شدن در یک خوراک (فید)، همراه با آرگومان‌های اختیاری. در صورت عدم تعیین نام، عنوان خوراک استفاده می‌شود.

.TP
.B listfeeds
فهرست کردن تمام خوراک‌های مشترک‌شده.

.TP
.B delfeed [name or listfeeds index]
لغو اشتراک از یک خوراک.

.TP
.B status (--tag=tag) (--read|--total|--tags)
چاپ تعداد موارد خوانده‌نشده، با امکان محدود کردن به یک برچسب خاص. گزینه read-- موارد خوانده‌شده را چاپ می‌کند، total-- موارد کل را چاپ می‌کند و tags-- مقدار را برای همه برچسب‌ها چاپ می‌کند.

نکته: این دستور همچنان تابع فیلترهاست، بنابراین اگر همه موارد خوانده‌شده را فیلتر کرده باشید، گزینه read-- همواره 0 برمی‌گرداند.

.TP
.B force-update
دریافت مجدد تمامی خوراک‌ها، صرف‌نظر از برچسب‌های زمانی.

.TP
.B config (="value")
تغییر یک متغیر پیکربندی.
.br
.B (پیشنهاد می‌شود این کار را دستی انجام ندهید و از کلاینت استفاده کنید)

.TP
.B one-config (= value)
تغییر یک متغیر پیکربندی واحد، با فرض اینکه کل خط یک تنظیم است.
.br
.B (پیشنهاد می‌شود این کار را دستی انجام ندهید و از کلاینت استفاده کنید)

.TP
.B export
.br
نوشتن فهرست خوراک‌ها با فرمت OPML در خروجی استاندارد stdout
.br
(مانند: canto-remote export > feedlist.opml)

.TP
.B import
.br
وارد کردن فهرست خوراک‌ها با فرمت OPML از ورودی استاندارد stdin
.br
(مانند: canto-remote import < feedlist.opml)

.TP
.B kill
.br
کشتن و متوقف کردن دیمنی که به آن متصل شده‌اید.

.TP
.B script
.br
اجرای یک اسکریپت (کد آزمایشی).

.TP
نکته: افزونه‌ها نیز می‌توانند دستورات راه دور جدیدی مانند 'sync' اضافه کنند که در فهرست help-- (یا بدون آرگومان) نمایش داده خواهد شد.

.SH "صفحه خانگی (HOMEPAGE)"
http://codezen.org/canto-ng

.SH "نویسنده (AUTHOR)"
Jack Miller <jack@codezen.org>

.SH "همچنین ببینید (SEE ALSO)"
.BR canto-daemon (1)