.\"
.\" Copyright (C) 2004 Red Hat, Inc. All Rights Reserved.
.\" Written by David Howells (dhowells@redhat.com)
.\"
.\" This program is free software; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License
.\" as published by the Free Software Foundation; either version
.\" 2 of the License, or (at your option) any later version.
.\"
.TH "REQUEST-KEY" "8" "مه ۲۰۲۵" "keyutils" "دستورهای مدیریتی و نگهداری"
.SH "نام (NAME)"
request-key \- پردازش درخواستهای فراخوانی مقداردهی کلید از هسته لینوکس
.SH "خلاصه دستور (SYNOPSIS)"
\fBrequest-key\fP \fIعملیات\fP \fIکلید\fP \fIشناسه_کاربر\fP \fIشناسه_گروه\fP \fIحلقه_ریسه\fP \fIحلقه_فرایند\fP \fIحلقه_نشست\fP
.SH "توضیحات (DESCRIPTION)"
برنامه \fBrequest-key\fR توسط هسته لینوکس فراخوانی میشود تا کلیدهای نامشخص یا منقضی را با استفاده از ارائهدهندههای فضای کاربری مقداردهی کند. این برنامه زمانی توسط هسته اجرا می‌شود که هسته نیازمند کلیدی باشد که بلافاصله در دسترس نیست. هسته یک کلید نیمه‌آماده ایجاد کرده و سپس این برنامه را برای مقداردهی و نمونه‌سازی آن فراخوانی می‌کند. این برنامه برای اجرای مستقیم توسط کاربر در نظر گرفته نشده است.
.PP
با این حال، برای مقاصد اشکال‌زدایی (دیباگ)، می‌توان گزینه‌هایی را در خط فرمان به آن ارسال کرد:
.IP \fB\-d\fP
فعال‌سازی حالت اشکال‌زدایی. در این حالت، هیچ تلاشی برای دسترسی به هیچ کلیدی صورت نمی‌گیرد و در صورت انتخاب یک برنامه کارگذار (handler)، آن برنامه اجرا نخواهد شد؛ در عوض، این برنامه پیامی نمایش داده و با وضعیت ۰ خارج می‌شود.
.IP "\fB\-D <توصیف>\fP"
در حالت اشکال‌زدایی، به‌جای توصیف نمونه‌ی تعبیه‌شده در برنامه ("user;0;0;1f0000;debug:1234")، از توصیف کلید پیشنهادی تعیین‌شده با این گزینه استفاده شود.
.IP \fB\-l\fP
استفاده از پیکربندی دایرکتوری جاری. برنامه به‌جای مسیر
.IR /etc ،
از
.IR request-key.d/* " و " request-key.conf
در دایرکتوری جاری استفاده خواهد کرد.
.IP \fB\-n\fP
عدم ثبت وقایع در گزارش سیستم (syslog). در حالت عادی پیام‌های خطا و اشکال‌زدایی در لاگ سیستم ثبت می‌شوند؛ این گزینه مانع از ثبت آن‌ها خواهد شد.
.IP \fB\-v\fP
فعال‌سازی خروجی اشکال‌زدایی با جزئیات بیشتر. این گزینه می‌تواند چندین بار مشخص شود تا سطح جزئیات افزایش یابد.
.IP \fB\-\-version\fP
نمایش نسخه برنامه و خروج.
.SH "خطاها (ERRORS)"
تمام خطاها در سیستم ثبت گزارش (syslog) ثبت خواهند شد.
.SH "فایل‌ها (FILES)"
.ul
/etc/request\-key.d/*.conf
.ul 0
فایل‌های پیکربندی مجزا.
.P
.ul
/etc/request\-key.conf
.ul 0
فایل پیکربندی جایگزین (Fallback).
.SH "همچنین ببینید (SEE ALSO)"
.ad l
.nh
.BR keyctl (1),
.BR request\-key.conf (5),
.BR keyrings (7)