.TH xkcdpass 1
.SH "نام (NAME)"
xkcdpass \- تولید عبارت‌های عبور چندکلمه‌ای، به‌یادماندنی و امن
.SH "خلاصه دستور (SYNOPSIS)"
.PP
.B xkcdpass
[ options ]
.br
.B xkcdpass
--help
.SH "توضیحات (DESCRIPTION)"
.PP
یک تولیدکننده گذرواژه منعطف و اسکریپت‌پذیر که عبارت‌های عبور قوی تولید می‌کند؛ الهام‌گرفته از کمیک XKCD 936:
.IP
.nf
\f[C]
$\ xkcdpass
>\ correct\ horse\ battery\ staple
\f[]
.fi
.SH "گزینه‌ها (OPTIONS)"
.PP
\f[B]\-\-help\f[]
.RS
.PP
نحوه استفاده از این دستور را شرح می‌دهد.
.RE
.PP
\f[B]\-\-wordfile\f[] WORDFILE, \f[B]\-w\f[] WORDFILE
.RS
.PP
مشخص می‌کند که فایل WORDFILE حاوی فهرست واژگان معتبری است که عبارت‌های عبور باید از آن‌ها تولید شوند.
.RE
.PP
\f[B]\-\-min\f[] MIN_LENGTH
.RS
.PP
حداقل تعداد حروف لازم برای کلمات مورد استفاده در ساخت گذرواژه.
(پیش‌فرض: 5)
.RE
.PP
\f[B]\-\-max\f[] MAX_LENGTH
.RS
.PP
حداکثر تعداد حروف مجاز برای کلمات مورد استفاده در ساخت گذرواژه.
(پیش‌فرض: 9)
.RE
.PP
\f[B]\-\-numwords\f[] NUM_WORDS, \f[B]\-n\f[] NUM_WORDS
.RS
.PP
عبارت‌های عبوری شامل دقیقاً NUM_WORDS کلمه تولید می‌کند.
(پیش‌فرض: 6)
.RE
.PP
\f[B]\-\-interactive\f[], \f[B]\-i\f[]
.RS
.PP
یک عبارت عبور تولید کرده و در خروجی نمایش می‌دهد، از کاربر برای پذیرش آن سؤال می‌پرسد و تا زمانی که یکی پذیرفته شود در یک حلقه تکرار می‌کند.
.RE
.PP
\f[B]\-\-valid_chars\f[] VALID_CHARS, \f[B]\-v\f[] VALID_CHARS
.RS
.PP
عبارت‌های عبور را تنها به کلماتی محدود می‌کند که با الگوی regex مربوط به VALID_CHARS مطابقت داشته باشند (مانند
\f[C]\[aq][a\-z]\[aq]\f[]).
.RE
.PP
\f[B]\-\-verbose\f[], \f[B]\-V\f[]
.RS
.PP
معیارهای گوناگون را برای گزینه‌های داده‌شده گزارش می‌کند.
.RE
.PP
\f[B]\-\-acrostic\f[] ACROSTIC, \f[B]\-a\f[] ACROSTIC
.RS
.PP
عبارت‌های عبوری با سرواژه (آکروستیک) منطبق بر ACROSTIC تولید می‌کند.
.RE
.PP
\f[B]\-\-count\f[] COUNT, \f[B]\-c\f[] COUNT
.RS
.PP
تعداد COUNT عبارت عبور تولید می‌کند.
(پیش‌فرض: 1)
.RE
.PP
\f[B]\-\-delimiter\f[] DELIM, \f[B]\-d\f[] DELIM
.RS
.PP
کلمات درون یک عبارت عبور را با DELIM جدا می‌کند.
(پیش‌فرض: \[aq] \[aq])
.RE
.PP
\f[B]\-\-separator\f[] SEP, \f[B]\-s\f[] SEP
.RS
.PP
عبارت‌های عبور تولیدشده را با SEP جدا می‌کند.
(پیش‌فرض: \[aq] \[aq])
.RE
.SS "مثال‌ها (EXAMPLES)"
.IP \[bu] 2
\f[B]xkcdpass\f[]
.RS 2
.PP
یک عبارت عبور با گزینه‌های پیش‌فرض تولید می‌کند.
نمونه خروجی:
.IP
.nf
\f[C]
pinball\ previous\ deprive\ militancy\ bereaved\ numeric
\f[]
.fi
.RE
.IP \[bu] 2
\f[B]xkcdpass\f[] \-\-count=5 \-\-acrostic=\[aq]chaos\[aq]
\-\-delimiter=\[aq]|\[aq] \-\-min=5 \-\-max=6
\-\-valid_chars=\[aq][a\-z]\[aq]
.RS 2
.PP
۵ عبارت عبور تولید می‌کند که همگی از کلمات با حروف کوچک بوده، با سرواژه "chaos" مطابقت دارند و با نویسه "|" جدا شده‌اند.
نمونه خروجی:
.IP
.nf
\f[C]
collar|highly|asset|ovoid|sultan
caper|hangup|addle|oboist|scroll
couple|honcho|abbot|obtain|simple
cutler|hotly|aortae|outset|stool
cradle|helot|axial|ordure|shale
\f[]
.fi
.RE
.SH "تاریخچه (HISTORY)"
.PP
دستور \f[B]xkcdpass\f[] برنامه پایتون \f[C]xkcd_password.py\f[] را فراخوانی می‌کند.
.PP
الهام‌بخش هدف این برنامه، کمیک شماره ۹۳۶ XKCD با عنوان "Password Strength" است.
.PP