.TH IPSEC 8 "2013-10-29" "6.0.4rc1" "strongSwan"
.
.SH "نام (NAME)"
.
ipsec \- فراخوانی ابزارهای IPsec
.
.SH "خلاصه دستور (SYNOPSIS)"
.
.SY ipsec
.I command
.RI [ arguments ]
.RI [ options ]
.YS
.
.SH "توضیحات (DESCRIPTION)"
.
ابزار
.B ipsec
هر یک از چندین ابزار مورد استفاده در کنترل و پایش سامانه رمزنگاری/احراز هویت IPsec را فراخوانی می‌کند، و
\fIcommand\fP
مشخص‌شده را با
\fIarguments\fP
و
\fIoptions\fP
تعیین‌شده به‌گونه‌ای اجرا می‌کند که گویی مستقیماً فراخوانی شده است. این کار تا حد زیادی تداخل نام‌های احتمالی با سایر نرم‌افزارها را از بین برده و همچنین امکان ارائه برخی خدمات متمرکز را فراهم می‌سازد.
.P
تمام دستورات شرح‌داده‌شده در این صفحه راهنما داخلی هستند و برای کنترل و پایش اتصالات IPsec و همچنین دیمن IKE به کار می‌روند.
.P
برای سایر دستورات،
.I ipsec
متغیر محیطی PATH مناسب را برای
.I command
فراخوانی‌شده مهیا می‌سازد و همچنین متغیرهای محیطی فهرست‌شده در بخش
.IR ENVIRONMENT
را فراهم می‌کند.
.
.SS "دستورات کنترلی (CONTROL COMMANDS)"
.
.TP
.BI "start [" "starter options" ]
ابزار
.B "starter"
را فراخوانی می‌کند که به نوبه خود فایل \fIipsec.conf\fR را پردازش کرده و دیمن IKE یعنی \fIcharon\fR را اجرا می‌کند.
.
.TP
.B "update"
یک سیگنال \fIHUP\fR به
.BR "starter"
ارسال می‌کند که هرگونه تغییر در \fIipsec.conf\fR را تشخیص داده و پیکربندی را در دیمن در حال اجرای IKE یعنی \fIcharon\fR به‌روزرسانی می‌کند.
.
.TP
.B "reload"
یک سیگنال \fIUSR1\fR به
.BR "starter"
ارسال می‌کند که تمام پیکربندی دیمن در حال اجرای IKE یعنی \fIcharon\fR را بر اساس فایل واقعی \fIipsec.conf\fR مجدداً بارگذاری می‌کند.
.
.TP
.B "restart"
معادل
.B "stop"
و به دنبال آن
.B "start"
پس از ۲ ثانیه وقفه محافظتی است.
.
.TP
.B "stop"
تمام اتصالات IPsec را پایان داده و با ارسال سیگنال \fITERM\fR به
.BR "starter" ،
دیمن IKE با نام \fIcharon\fR را متوقف می‌کند.
.
.TP
.BI "up " name
به دیمن IKE دستور می‌دهد تا اتصال \fIname\fP را برقرار و راه‌اندازی کند.
.
.TP
.BI "down " name
به دیمن IKE دستور می‌دهد تا اتصال \fIname\fP را قطع کند.
.
.TP
.BI "down " name{n}
نمونه \fIn\fP از IKEv1 Quick Mode و IKEv2 CHILD SA مربوط به اتصال \fIname\fP را قطع می‌کند.
.
.TP
.BI "down " name{*}
تمام نمونه‌های IKEv1 Quick Mode و IKEv2 CHILD SA مربوط به اتصال \fIname\fP را قطع می‌کند.
.
.TP
.BI "down " name[n]
نمونه \fIn\fP از IKE SA مربوط به اتصال \fIname\fP را قطع می‌کند.
.
.TP
.BI "down " name[*]
تمام نمونه‌های IKE SA مربوط به اتصال \fIname\fP را قطع می‌کند.
.
.TP
.BI "down\-srcip <" start "> [<" end ">]"
تمام نمونه‌های IKE SA مربوط به کلاینت‌هایی که دارای IP مجازی در محدوده
.IR start \- end
هستند را قطع می‌کند.
.
.TP
.BI "route " name
به دیمن IKE دستور می‌دهد تا یک سیاست IPsec در هسته برای اتصال \fIname\fP درج کند. نخستین بسته بار داده (payload) منطبق بر این سیاست IPsec به‌طور خودکار راه‌اندازی اتصال IKE را آغاز می‌کند.
.
.TP
.BI "unroute " name
سیاست IPsec را در هسته برای اتصال \fIname\fP حذف می‌کند.
.
.TP
.BI "status [" name ]
اطلاعات مختصر وضعیت را برای اتصال \fIname\fP یا در صورت ذکر نشدن آرگومان، برای تمام اتصالات برمی‌گرداند.
.
.TP
.BI "statusall [" name ]
اطلاعات دقیق و مشروح وضعیت را برای اتصال \fIname\fP یا در صورت ذکر نشدن آرگومان، برای تمام اتصالات برمی‌گرداند.
.
.SS "دستورات فهرست‌گیری (LIST COMMANDS)"
.
.TP
.BI "leases [<" poolname "> [<" address ">]]"
وضعیت تمام یا استخر انتخاب‌شده نشانی‌های IP (یا حتی یک نشانی IP مجازی واحد) را برمی‌گرداند.
.
.TP
.B "listalgs"
فهرستی از الگوریتم‌های رمزنگاری پشتیبانی‌شده و قابل استفاده برای IKE به همراه پلاگین متناظر آن‌ها را برمی‌گرداند.
.
.TP
.BI "listpubkeys [" \-\-utc ]
فهرستی از کلیدهای عمومی RSA را که به‌صورت فرمت کلید خام بارگذاری شده یا از گواهی‌های X.509 یا OpenPGP استخراج شده‌اند، برمی‌گرداند.
.
.TP
.BI "listcerts [" \-\-utc ]
فهرستی از گواهی‌های X.509 یا OpenPGP را که به‌صورت محلی توسط دیمن IKE بارگذاری شده یا از طریق پروتکل IKE دریافت شده‌اند، برمی‌گرداند.
.
.TP
.BI "listcacerts [" \-\-utc ]
فهرستی از گواهی‌های مرجع صدور گواهی (CA) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه \fI/etc/ipsec.d/cacerts/\fP بارگذاری شده یا از طریق پروتکل IKE دریافت شده‌اند، برمی‌گرداند.
.
.TP
.BI "listaacerts [" \-\-utc ]
فهرستی از گواهی‌های مرجع احراز اختیار (AA) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه \fI/etc/ipsec.d/aacerts/\fP بارگذاری شده‌اند، برمی‌گرداند.
.
.TP
.BI "listocspcerts [" \-\-utc ]
فهرستی از گواهی‌های امضاکننده OCSP نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه \fI/etc/ipsec.d/ocspcerts/\fP بارگذاری شده یا توسط یک سرور OCSP ارسال شده‌اند، برمی‌گرداند.
.
.TP
.BI "listacerts [" \-\-utc ]
فهرستی از گواهی‌های صفت (Attribute) نوع X.509 را که به‌صورت محلی توسط دیمن IKE از پوشه \fI/etc/ipsec.d/acerts/\fP بارگذاری شده‌اند، برمی‌گرداند.
.
.TP
.BI "listgroups [" \-\-utc ]
فهرستی از گروه‌هایی را که برای تعریف نمایه‌های مجوز کاربر استفاده می‌شوند، برمی‌گرداند.
.
.TP
.BI "listcainfos [" \-\-utc ]
اطلاعات مرجع صدور گواهی (نقاط توزیع CRL، شناسه‌های OCSP URI، سرورهای LDAP) را که توسط بخش‌های
.BR ca
در \fIipsec.conf\fP تعریف شده‌اند، برمی‌گرداند.
.
.TP
.BI "listcrls [" \-\-utc ]
فهرستی از فهرست‌های ابطال گواهی (CRL) را که توسط دیمن IKE از پوشه \fI/etc/ipsec.d/crls\fP بارگذاری شده یا از یک نقطه توزیع CRL مبتنی بر HTTP یا LDAP واکشی شده‌اند، برمی‌گرداند.
.
.TP
.BI "listocsp [" \-\-utc ]
اطلاعات ابطال واکشی‌شده از سرورهای OCSP را برمی‌گرداند.
.
.TP
.BI "listplugins"
فهرستی از تمام قابلیت‌های پلاگین‌های بارگذاری‌شده را برمی‌گرداند.
.
.TP
.BI "listcounters [" name ]
فهرستی از مقادیر شمارنده‌های IKE سراسری یا مختص به یک اتصال خاص را که از زمان راه‌اندازی دیمن جمع‌آوری شده‌اند، برمی‌گرداند.
.
.TP
.BI "listall [" \-\-utc ]
تمام اطلاعات تولیدشده توسط دستورات فهرست‌گیری بالا را برمی‌گرداند. هر یک از دستورات فهرست‌گیری را می‌توان با گزینه
\fB\-\-utc\fP
فراخوانی کرد که تمام تاریخ‌ها را به جای زمان محلی بر حسب UTC نمایش می‌دهد.
.
.SS "دستورات بازخوانی مجدد (REREAD COMMANDS)"
.
.TP
.B "rereadsecrets"
تمام اطلاعات و کلیدهای محرمانه تعریف‌شده در \fIipsec.secrets\fP را پاکسازی کرده و دوباره می‌خواند.
.
.TP
.B "rereadcacerts"
گواهی‌های CA بارگذاری‌شده قبلی را حذف می‌کند، تمام فایل‌های گواهی موجود در پوشه \fI/etc/ipsec.d/cacerts\fP را می‌خواند و آن‌ها را به فهرست گواهی‌های مرجع صدور گواهی (CA) اضافه می‌کند. این دستور بر گواهی‌هایی که صریحاً در بخش ca در
.BR ipsec.conf (5)
تعریف شده‌اند تاثیری نمی‌گذارد؛ این گواهی‌ها را می‌توان به‌طور جداگانه با دستور \fBupdate\fP به‌روزرسانی کرد.
.
.TP
.B "rereadaacerts"
گواهی‌های AA بارگذاری‌شده قبلی را حذف می‌کند، تمام فایل‌های گواهی موجود در پوشه \fI/etc/ipsec.d/aacerts\fP را می‌خواند و آن‌ها را به فهرست گواهی‌های مرجع احراز اختیار (AA) اضافه می‌کند.
.
.TP
.B "rereadocspcerts"
تمام فایل‌های گواهی موجود در پوشه \fI/etc/ipsec.d/ocspcerts/\fP را می‌خواند و آن‌ها را به فهرست گواهی‌های امضاکننده OCSP اضافه می‌کند.
.
.TP
.B "rereadacerts"
تمام فایل‌های گواهی موجود در پوشه \fI/etc/ipsec.d/acerts/\fP را می‌خواند و آن‌ها را به فهرست گواهی‌های صفت اضافه می‌کند.
.
.TP
.B "rereadcrls"
تمام فهرست‌های ابطال گواهی (CRL) موجود در پوشه \fI/etc/ipsec.d/crls/\fP را می‌خواند و آن‌ها را به فهرست CRLها اضافه می‌کند.
.
.TP
.B "rereadall"
تمام دستورات بازخوانی فهرست‌شده در بالا را اجرا می‌کند.
.
.SS "دستورات بازنشانی (RESET COMMANDS)"
.
.TP
.BI "resetcounters [" name ]
شمارنده‌های سراسری یا مختص به یک اتصال خاص را بازنشانی می‌کند.
.
.SS "دستورات پاکسازی (PURGE COMMANDS)"
.
.TP
.B "purgecerts"
تمام گواهی‌های کش‌شده را پاکسازی می‌کند.
.
.TP
.B "purgecrls"
تمام CRLهای کش‌شده را پاکسازی می‌کند.
.
.TP
.B "purgeike"
نمونه‌های IKE SA را که فاقد Quick Mode یا CHILD SA هستند پاکسازی می‌کند.
.
.TP
.B "purgeocsp"
تمام رکوردهای اطلاعاتی کش‌شده OCSP را پاکسازی می‌کند.
.
.SS "دستورات اطلاعاتی (INFO COMMANDS)"
.
.TP
.B "\-\-help"
اطلاعات نحوه استفاده از دستور
.B ipsec
را برمی‌گرداند.
.
.TP
.B "\-\-version"
نسخه را در قالب
.BR "strongSwan U<strongSwan userland version>/K<kernel version>"
برمی‌گرداند.
.
.TP
.B "\-\-versioncode"
شماره نسخه را در قالب
.BR "U<strongSwan userland version>/K<kernel version>"
برمی‌گرداند.
.
.TP
.B "\-\-copyright"
اطلاعات حق نشر را برمی‌گرداند.
.
.TP
.B "\-\-directory"
مسیر پوشه \fILIBEXECDIR\fP را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند.
.
.TP
.B "\-\-confdir"
مسیر پوشه \fISYSCONFDIR\fP را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند.
.
.TP
.B "\-\-piddir"
مسیر پوشه \fIPIDDIR\fP را مطابق با گزینه‌های پیکربندی زمان کامپایل برمی‌گرداند.
.
.SH "فایل‌ها (FILES)"
.
/usr/libexec/ipsec		پوشه ابزارها
.
.SH "محیط (ENVIRONMENT)"
.
هنگام فراخوانی سایر دستورات، دستور
.B ipsec
متغیرهای محیطی زیر را فراهم می‌کند:
.nf
.na

IPSEC_DIR               پوشه حاوی برنامه‌ها و ابزارهای ipsec
IPSEC_BINDIR            پوشه حاوی دستور \fBpki\fP
IPSEC_SBINDIR           پوشه حاوی دستور \fBipsec\fP
IPSEC_CONFDIR           پوشه حاوی فایل‌های پیکربندی
IPSEC_PIDDIR            پوشه حاوی فایل‌های PID/سوکت
IPSEC_SCRIPT            نام اسکریپت ipsec
IPSEC_NAME              نام توزیع ipsec
IPSEC_VERSION           شماره نسخه فضای کاربر و هسته ipsec
IPSEC_STARTER_PID       فایل PID برای شروع‌کننده ipsec
IPSEC_CHARON_PID        فایل PID برای دیمن کلیدگذاری IKE
.ad
.fi
.
.SH "همچنین ببینید (SEE ALSO)"
.
.BR ipsec.conf (5),
.BR ipsec.secrets (5)
.
.SH "تاریخچه (HISTORY)"
در ابتدا توسط Henry Spencer برای پروژه FreeS/WAN نوشته شد.
توسط Tobias Brunner و Andreas Steffen برای پروژه strongSwan <http://www.strongswan.org> به‌روزرسانی و گسترش یافت.