| voa-import(1) | General Commands Manual | voa-import(1) |
نام (NAME)
voa-import - وارد کردن یک تصدیق‌کننده منفرد به یک سلسله‌مراتب VOA
خلاصه دستور (SYNOPSIS)
voa import [-c|--context] [-v|--verbose]... [-i|--input] [-q|--quiet]... [-b|--base-path] [-r|--runtime] [-h|--help] <OS> <PURPOSE> <TECHNOLOGY>
توضیحات (DESCRIPTION)
یک تصدیق‌کننده منفرد را به یک سلسله‌مراتب VOA وارد می‌کند.
به‌طور پیش‌فرض انتظار می‌رود یک تصدیق‌کننده منفرد در ورودی استاندارد (stdin) ارائه شود. با استفاده از گزینهٔ «-i»/«--input» می‌توان به جای آن یک دایرکتوری یا فایل مشخص را برای وارد کردن انتخاب کرد.
تصدیق‌کننده در مسیر بارگذاری VOA قابل نوشتن و ماندگار (persistent) کاربر ذخیره می‌شود؛ مانند:
- «~/.config/voa/»: برای
کاربرانی
با شناسهٔ
کاربری uid >= 1000.
توجه داشته
باشید که «voa
import» از
مشخصات
دایرکتوری
پایهٔ XDG و
متغیر
محیطی «XDG_CONFIG_HOME»
پیروی
می‌کند.
مسیر بالا
به عنوان
نمونهٔ
پیش‌فرض
ذکر شده است.
- «/etc/voa/»: برای
کاربرانی
با شناسهٔ
کاربری uid < 1000
هنگام استفاده از گزینهٔ «-r»/«--runtime»، تصدیق‌کننده در عوض در مسیر بارگذاری VOA قابل نوشتن و گذرای (ephemeral) کاربر نوشته می‌شود؛ مانند:
- «/run/user/$(id -u)/voa/»:
برای
کاربرانی
با شناسهٔ
کاربری uid >= 1000.
توجه داشته
باشید که «voa
import» از
مشخصات
دایرکتوری
پایهٔ XDG و
متغیر
محیطی «XDG_RUNTIME_DIR»
پیروی
می‌کند.
مسیر بالا
به عنوان
نمونهٔ
پیش‌فرض
ذکر شده است.
- «/run/voa»: برای
کاربرانی
با شناسهٔ
کاربری uid < 1000
تصدیق‌کننده را می‌توان با استفاده از گزینهٔ «-b»/«--base-path» در یک مسیر پایهٔ VOA مشخص دیگر نوشت.
گزینه‌ها (OPTIONS)
- -c, --context <CONTEXT>
- زمینه‌ای (context)
که
واردسازی
برای آن
انجام
می‌شود.
در صورت عدم تعیین، مقدار پیش‌فرض «default» است.
- -v, --verbose
- افزایش پرگویی گزارش‌گیری (logging)
- -i, --input <INPUT>
- دایرکتوری
یا فایلی که
واردسازی
از آن انجام
می‌شود.
اگر یک دایرکتوری ارائه شود و فناوری انتخاب‌شده «openpgp» باشد، باید شامل یکی از موارد زیر باشد:
- فایل‌های بستهٔ OpenPGP، - یا یک ساختار دایرکتوری با فایل‌های بستهٔ OpenPGP که با قالب «archlinux-keyring» سازگار باشد.
اگر هیچ دایرکتوری یا فایلی ارائه نشود، ورودی استاندارد (stdin) به جای آن به کار می‌رود.
- -q, --quiet
- کاهش پرگویی گزارش‌گیری
- -b, --base-path <BASE_PATH>
- مسیر پایهٔ
VOA برای
نوشتن.
در صورت عدم تعیین، مسیر بارگذاری VOA قابل نوشتن و ماندگار کاربر انتخاب می‌شود؛ مانند:
- «~/.config/voa/»: برای کاربران با شناسهٔ کاربری uid >= 1000 - «/etc/voa/»: برای کاربران با شناسهٔ کاربری uid < 1000
برای استفاده از مسیر بارگذاری VOA قابل نوشتن و گذرای کاربر در صورتی که دایرکتوری تعیین نشود، گزینهٔ «-r»/«--runtime» را به دستور بدهید. در این حالت مسیر بارگذاری VOA قابل نوشتن و گذرا انتخاب می‌شود؛ مانند:
- «/run/user/$(id -u)/voa/»: برای کاربران با شناسهٔ کاربری uid >= 1000 - «/run/voa»: برای کاربران با شناسهٔ کاربری uid < 1000
- -r, --runtime
- تعیین
اینکه آیا
واردسازی
در
دایرکتوری
زمان اجرا
(runtime) انجام
شود یا خیر.
سازوکار واردسازی را هدایت می‌کند تا از مسیر بارگذاری VOA قابل نوشتن و گذرای کاربر استفاده کند؛ مانند:
- «/run/user/$(id -u)/voa/»: برای کاربران با شناسهٔ کاربری uid >= 1000 - «/run/voa»: برای کاربران با شناسهٔ کاربری uid < 1000
به‌طور پیش‌فرض، چنانچه این گزینه و گزینهٔ «-b»/«--base-path» تعیین نشوند، تصدیق‌کننده در مسیر بارگذاری VOA قابل نوشتن و ماندگار کاربر وارد می‌شود؛ مانند:
- «~/.config/voa/»: برای کاربران با شناسهٔ کاربری uid >= 1000 - «/etc/voa/»: برای کاربران با شناسهٔ کاربری uid < 1000
توجه داشته باشید که این گزینه را نمی‌توان هم‌زمان با «-b»/«--base-path» استفاده کرد.
- -h, --help
- چاپ راهنما (مشاهدهٔ خلاصه با '-h')
- <OS>
- سیستم‌عاملی که واردسازی برای آن انجام می‌شود.
- <PURPOSE>
- هدفی (purpose) که واردسازی برای آن صورت می‌گیرد.
- <TECHNOLOGY>
- فناوری‌ای
که
واردسازی
برای آن
انجام
می‌شود.
در حال حاضر تنها «openpgp» پشتیبانی می‌شود.
| voa-import |