.TH PSL "1" "July 2016" "psl 0.13.0" "دستورهای کاربری"
.SH "نام (NAME)"
psl \- کاوش و بررسی فهرست پسوندهای عمومی (Public Suffix List)
.SH "خلاصه دستور (SYNOPSIS)"
.B psl
[\fI\,گزینه‌ها\/\fR] \fI\,<دامنه‌ها\/\fR...\fI\,>\/\fR
.SH "توضیحات (DESCRIPTION)"
دستور \fBpsl\fR «فهرست پسوندهای عمومی» (Public Suffix List) را کاوش و بررسی می‌کند. این دستور فهرستی از دامنه‌ها را از خط فرمان دریافت می‌کند؛ و اگر دامنه‌ای در خط فرمان مشخص نشده باشد، در هر سطر یک دامنه را از ورودی استاندارد می‌خواند. نتایج در خروجی استاندارد چاپ می‌شوند، به گونه‌ای که هر سطر شامل یک دامنه است که پس از آن یک دونقطه (:) و سپس اطلاعات مرتبط با آن دامنه قرار می‌گیرد.
.SH "حالتها (MODES)"
اطلاعات چاپ‌شده برای هر دامنه بر اساس حالت انتخاب‌شده تغییر می‌کند.
.br
حالت‌های موجود عبارتند از:
.TP
\fB\-\-is\-public\-suffix\fR
بررسی اینکه آیا دامنه‌ها پسوند عمومی هستند یا خیر. [پیش‌فرض]
.br
داده‌های بازگردانده‌شده: 1 اگر \fIdomain\fR یک پسوند عمومی باشد، در غیر این صورت 0.
.br
این گزینه می‌تواند با \fB\-\-no\-star\-rule\fR ترکیب شود. استفاده از آن «قاعده ستاره حاکم» (prevailing star rule) در PSL را غیرفعال می‌کند، به طوری که تمام TLDهایی که صراحتاً در PSL فهرست نشده‌اند مقدار 0 (پسوند عمومی نیست) را بازمی‌گردانند.
.TP
\fB\-\-is\-cookie\-domain\-acceptable\fR <cookie\-domain>
بررسی اینکه آیا cookie\-domain برای دامنه‌ها قابل قبول است یا خیر.
.br
داده‌های بازگردانده‌شده: 1 اگر \fIcookie\-domain\fR برای \fIdomain\fR قابل قبول باشد، در غیر این صورت 0.
.TP
\fB\-\-print\-unreg\-domain\fR
داده‌های بازگردانده‌شده: طولانی‌ترین بخش پسوند عمومی برای هر \fIdomain\fR.
.TP
\fB\-\-print\-reg\-domain\fR
داده‌های بازگردانده‌شده: کوتاه‌ترین بخش پسوند خصوصی برای هر \fIdomain\fR.
.SH "اطلاعات نسخه (VERSION INFORMATION)"
به جای آن، \fBpsl\fR می‌تواند برای گزارش اطلاعات درباره نسخه کتابخانه و داده‌های توکار پسوند عمومی استفاده شود:
.TP
\fB\-\-version\fR
نمایش اطلاعات نسخه کتابخانه
.TP
\fB\-\-print\-info\fR
چاپ اطلاعات درباره داده‌های توکار کتابخانه
.SH "داده‌های پسوند عمومی (PUBLIC SUFFIX DATA)"
به‌طور پیش‌فرض، \fBpsl\fR از جدیدترین داده‌های موجود پسوند عمومی استفاده خواهد کرد.
.br
همچنین می‌توانید آن را برای استفاده از یک فایل متفاوت هدایت کنید:
.TP
\fB\-\-use\-latest\-data\fR
استفاده از جدیدترین داده‌های موجود PSL [پیش‌فرض]
.TP
\fB\-\-use\-builtin\-data\fR
استفاده از داده‌های توکار PSL
.TP
\fB\-\-load\-psl\-file\fR <filename>
بارگذاری داده‌های PSL از فایل
.SH "همچنین ببینید (SEE ALSO)"
https://publicsuffix.org
.br
https://github.com/rockdaboot/libpsl
.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2014\-2016 برای libpsl و \fBpsl\fR متعلق به Tim Ruehsen تحت مجوزی از نوع MIT است.
.br
این مستندات توسط Daniel Kahn Gillmor برای پروژه دبیان نوشته شده است، اما دیگران نیز می‌توانند تحت همان مجوز خود libpsl از آن استفاده کنند.