.\" Copyright 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included in
.\" all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
.\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
.\" SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall not
.\" be used in advertising or otherwise to promote the sale, use or other
.\" dealing in this Software without prior written authorization from the
.\" The Open Group.
.\"
.TH ICEAUTH 1 2025-04-26 "iceauth 1.0.11" "X Version 11"
.SH "نام (NAME)"
iceauth \- ابزار فایل اعتبارسنجی ICE
.SH "خلاصه دستور (SYNOPSIS)"
.B iceauth
[\fB\-f\fP \fIauthfile\fP] [\fB\-vqibuV\fP] [\fIcommand arg ...\fP]
.SH "توضیحات (DESCRIPTION)"
برنامه \fBiceauth\fP برای ویرایش و نمایش اطلاعات اعتبارسنجی مورد استفاده در اتصال با ICE
(پروتکل Inter-Client Exchange در X11) به کار می‌رود.
این برنامه معمولاً برای استخراج رکوردهای اعتبارسنجی از یک رایانه
و ادغام آن‌ها در رایانه‌ای دیگر استفاده می‌شود
(مانند مواردی که از ورود از راه دور استفاده می‌شود یا دسترسی به سایر کاربران اعطا می‌گردد).
دستورها (که در ادامه شرح داده شده‌اند) می‌توانند به صورت تعاملی،
در خط فرمان \fBiceauth\fP یا درون اسکریپت‌ها وارد شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP 16
.BI \-f " authfile"
نام فایل اعتبارسنجی مورد استفاده.
به طور پیش‌فرض روی فایلی قرار می‌گیرد که در حال حاضر توسط نشست (session) استفاده می‌شود.
.TP 16
.B \-v
فعال کردن پیام‌های اضافی (حالت پرگو)
.TP 16
.B \-q
غیرفعال کردن پیام‌های اضافی (حالت بی‌صدا)
.TP 16
.B \-i
نادیده گرفتن قفل‌های روی فایل اعتبارسنجی
.TP 16
.B \-b
شکستن قفل‌های روی فایل اعتبارسنجی
.TP 16
.B \-u
چاپ دستورالعمل‌های پایه‌ای استفاده
.TP 16
.B \--help
چاپ دستورالعمل‌های پایه‌ای استفاده
.TP 16
.B \-V
چاپ نسخه و خروج
.TP 16
.B \-\-version
چاپ نسخه و خروج
.SH "نحوه استفاده (USAGE)"
هنگامی که \fBiceauth\fP اجرا می‌شود، اجازه می‌دهد مجموعه دستورهای زیر
به صورت تعاملی یا درون اسکریپت‌ها وارد شوند.
به یاد داشته باشید آرگومان‌هایی که در خط فرمان شل داده می‌شوند در تاریخچه شل نمایش داده خواهند شد و ممکن است از طریق ابزارهایی مانند
.BR ps (1),
برای سایر کاربران قابل مشاهده باشند؛ در نتیجه مقدار هرگونه کوکی یا سایر اطلاعات محرمانه احراز هویت ارائه‌شده در خط فرمان شل افشا خواهد شد.
.TP
.B ?
فهرست کردن دستورهای موجود.
.TP
.B help
چاپ اطلاعات راهنما.
می‌توانید یک نام دستور را به \fIhelp\fP بدهید
تا اطلاعات مشخص مربوط به آن را دریافت کنید.
.TP
.B info
چاپ اطلاعات درباره ورودی‌های موجود در فایل اعتبارسنجی.
.TP
\fBlist\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
فهرست کردن (چاپ) ورودی‌های فایل اعتبارسنجی.
می‌توانید اصلاح‌کننده‌های اختیاری را برای تعیین این‌که کدام ورودی‌ها فهرست شوند مشخص کنید.
.TP
\fBadd\fP \fIprotocol_name\fP \fIprotocol_data\fP \fInetid\fP \
\fIauthname\fP \fIauthdata\fP
افزودن یک ورودی به فایل اعتبارسنجی.
.TP
\fBremove\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
حذف ورودی‌ها از فایل اعتبارسنجی.
.TP
\fBextract\fP \fIfilename\fP [\fIprotocol_name\fP] [\fIprotocol_data\fP] \
[\fInetid\fP] [\fIauthname\fP]
استخراج ورودی‌ها از فایل اعتبارسنجی به یک فایل مقصد.
شما باید مسیر فایل مقصد را مشخص کنید.
مشخص‌کننده‌های اختیاری به شما امکان می‌دهند ورودی‌های استخراج‌شده را محدود کنید.
.TP
\fBmerge\fP \fIfilename1\fP [\fIfilename2\fP [\fIfilename3\fP]]...
ادغام ورودی‌ها از فایل‌های دیگر در فایل اعتبارسنجی انتخاب‌شده توسط برنامه.
می‌توانید هر تعداد مسیر فایل را به این دستور ارائه دهید.
.TP
.B exit
ذخیره تغییرات و خروج از برنامه.
.TP
.B quit
لغو تغییرات و خروج از برنامه بدون ذخیره‌سازی.
.TP
\fBsource\fP \fIfilename\fP
خواندن و اجرای دستورها از یک فایل.
.SH "نویسندگان (AUTHORS)"
Ralph Mor, X Consortium