نام (NAME)

iceauth - ابزار فایل اعتبارسنجی ICE

خلاصه دستور (SYNOPSIS)

iceauth [-f authfile] [-vqibuV] [command arg ...]

توضیحات (DESCRIPTION)

برنامه iceauth برای ویرایش و نمایش اطلاعات اعتبارسنجی مورد استفاده در اتصال با ICE (پروتکل Inter-Client Exchange در X11) به کار می‌رود. این برنامه معمولاً برای استخراج رکوردهای اعتبارسنجی از یک رایانه و ادغام آن‌ها در رایانه‌ای دیگر استفاده می‌شود (مانند مواردی که از ورود از راه دور استفاده می‌شود یا دسترسی به سایر کاربران اعطا می‌گردد). دستورها (که در ادامه شرح داده شده‌اند) می‌توانند به صورت تعاملی، در خط فرمان iceauth یا درون اسکریپت‌ها وارد شوند.

گزینه‌ها (OPTIONS)

-f authfile: نام فایل اعتبارسنجی مورد استفاده. به طور پیش‌فرض روی فایلی قرار می‌گیرد که در حال حاضر توسط نشست (session) استفاده می‌شود.
-v: فعال کردن پیام‌های اضافی (حالت پرگو)
-q: غیرفعال کردن پیام‌های اضافی (حالت بی‌صدا)
-i: نادیده گرفتن قفل‌های روی فایل اعتبارسنجی
-b: شکستن قفل‌های روی فایل اعتبارسنجی
-u: چاپ دستورالعمل‌های پایه‌ای استفاده
--help: چاپ دستورالعمل‌های پایه‌ای استفاده
-V: چاپ نسخه و خروج
--version: چاپ نسخه و خروج

نحوه استفاده (USAGE)

هنگامی که iceauth اجرا می‌شود، اجازه می‌دهد مجموعه دستورهای زیر به صورت تعاملی یا درون اسکریپت‌ها وارد شوند. به یاد داشته باشید آرگومان‌هایی که در خط فرمان شل داده می‌شوند در تاریخچه شل نمایش داده خواهند شد و ممکن است از طریق ابزارهایی مانند ps(1), برای سایر کاربران قابل مشاهده باشند؛ در نتیجه مقدار هرگونه کوکی یا سایر اطلاعات محرمانه احراز هویت ارائه‌شده در خط فرمان شل افشا خواهد شد.

?: فهرست کردن دستورهای موجود.
help: چاپ اطلاعات راهنما. می‌توانید یک نام دستور را به help بدهید تا اطلاعات مشخص مربوط به آن را دریافت کنید.
info: چاپ اطلاعات درباره ورودی‌های موجود در فایل اعتبارسنجی.
list [protocol_name] [protocol_data] [netid] [authname]: فهرست کردن (چاپ) ورودی‌های فایل اعتبارسنجی. می‌توانید اصلاح‌کننده‌های اختیاری را برای تعیین این‌که کدام ورودی‌ها فهرست شوند مشخص کنید.
add protocol_name protocol_data netid authname authdata: افزودن یک ورودی به فایل اعتبارسنجی.
remove [protocol_name] [protocol_data] [netid] [authname]: حذف ورودی‌ها از فایل اعتبارسنجی.
extract filename [protocol_name] [protocol_data] [netid] [authname]: استخراج ورودی‌ها از فایل اعتبارسنجی به یک فایل مقصد. شما باید مسیر فایل مقصد را مشخص کنید. مشخص‌کننده‌های اختیاری به شما امکان می‌دهند ورودی‌های استخراج‌شده را محدود کنید.
merge filename1 [filename2 [filename3]]...: ادغام ورودی‌ها از فایل‌های دیگر در فایل اعتبارسنجی انتخاب‌شده توسط برنامه. می‌توانید هر تعداد مسیر فایل را به این دستور ارائه دهید.
exit: ذخیره تغییرات و خروج از برنامه.
quit: لغو تغییرات و خروج از برنامه بدون ذخیره‌سازی.
source filename: خواندن و اجرای دستورها از یک فایل.

نویسندگان (AUTHORS)

Ralph Mor, X Consortium