.\" Generated by scdoc 1.11.3
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "MODPROBE" "8" "2025-03-28" "kmod" "modprobe"
.PP
.SH "نام (NAME)"
.PP
modprobe \- افزودن و حذف ماژول‌ها از هسته لینوکس
.PP
.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBmodprobe\fR [\fB-v\fR] [\fB-V\fR] [\fB-C\fR \fIconfig-file\fR] [\fB-n\fR] [\fB-i\fR] [\fB-q\fR] [\fB-b\fR] [\fImodulename\fR]
         [\fImodule parameters\fR.\&.\&.\&]
.PP
\fBmodprobe\fR [\fB-r\fR] [\fB-v\fR] [\fB-n\fR] [\fB-i\fR] [\fImodulename\fR.\&.\&.\&]
.PP
\fBmodprobe\fR [\fB-c\fR]
.PP
\fBmodprobe\fR [\fB--dump-modversions\fR] [\fIfilename\fR]
.PP
.SH "توضیحات (DESCRIPTION)"
.PP
دستور \fBmodprobe\fR به شکلی هوشمندانه ماژولی را به هسته لینوکس اضافه یا از آن حذف می‌کند: توجه داشته باشید که جهت راحتی، هیچ تفاوتی میان _ و - در نام ماژول‌ها وجود ندارد (تبدیل خودکار خط تیره به زیرخط انجام می‌شود).\& دستور \fBmodprobe\fR در دایرکتوری ماژول‌ها یعنی /usr/lib/`uname -r` به دنبال تمام ماژول‌ها و فایل‌های دیگر می‌گردد، به جز فایل‌های پیکربندی اختیاری (به \fBmodprobe.\&d\fR(5) مراجعه کنید).\& همچنین \fBmodprobe\fR از گزینه‌های ماژول که در خط فرمان هسته به صورت <module>.\&<option> مشخص شده‌اند و فهرست‌های سیاه (blacklists) به صورت modprobe.\&blacklist=<module> استفاده خواهد کرد.\&
.PP
توجه داشته باشید که برخلاف سری هسته‌های لینوکس 2.\&4 (که توسط این ابزار پشتیبانی نمی‌شوند)، این نسخه از \fBmodprobe\fR هیچ کاری روی خود ماژول انجام نمی‌دهد: وظیفه تفکیک نمادها (resolving symbols) و درک پارامترها در داخل هسته انجام می‌گیرد.\& بنابراین خرابی یا شکست ماژول گاهی با پیامی از سمت هسته همراه است: به \fBdmesg\fR(8) مراجعه کنید.\&
.PP
دستور \fBmodprobe\fR انتظار دارد یک فایل به‌روز modules.\&dep.\&bin وجود داشته باشد که توسط ابزار متناظر \fBdepmod\fR همراه با \fBmodprobe\fR تولید شده است (به \fBdepmod\fR(8) مراجعه کنید).\& این فایل ماژول‌های دیگری را که هر ماژول به آن‌ها نیاز دارد (در صورت وجود) فهرست می‌کند و \fBmodprobe\fR از آن برای اضافه یا حذف خودکار این وابستگی‌ها استفاده می‌نماید.\&
.PP
اگر هرگونه آرگومانی پس از \fImodulename\fR داده شود، به هسته ارسال خواهد شد (علاوه بر هر گزینه‌ای که در فایل پیکربندی ذکر شده است).\&
.PP
هنگام بارگذاری ماژول‌ها، \fImodulename\fR می‌تواند یک مسیر به ماژول نیز باشد.\& اگر مسیر نسبی باشد، باید صریحاً با ".\&/" آغاز شود.\& توجه داشته باشید که این کار در صورت استفاده از مسیر ماژولی با وابستگی‌هایی که با پایگاه داده نصب‌شده \fBdepmod\fR مطابقت ندارند، ممکن است با شکست مواجه شود.\&
.PP
.SH "گزینه‌ها (OPTIONS)"
.PP
\fB-a\fR, \fB--all\fR
.RS 4
درج تمام نام‌های ماژول مشخص‌شده در خط فرمان.\&
.PP
.RE
\fB-b\fR, \fB--use-blacklist\fR
.RS 4
این گزینه موجب می‌شود که \fBmodprobe\fR دستورات \fBblacklist\fR موجود در فایل‌های پیکربندی (در صورت وجود) را برای نام‌های ماژول نیز اعمال کند.\& این گزینه معمولاً توسط \fBudev\fR(7) استفاده می‌شود.\&
.PP
.RE
\fB-C\fR \fIdirectory\fR, \fB--config\fR=\fIdirectory\fR
.RS 4
این گزینه دایرکتوری پیکربندی پیش‌فرض را بازنویسی (override) می‌کند.\& به \fBmodprobe.\&d\fR(5) مراجعه کنید.\&
.PP
این گزینه از طریق دستورات \fBinstall\fR یا \fBremove\fR به سایر دستورات \fBmodprobe\fR در متغیر محیطی MODPROBE_OPTIONS منتقل می‌شود.\&
.PP
.RE
\fB-c\fR, \fB--showconfig\fR
.RS 4
تخلیه و نمایش پیکربندی مؤثر از دایرکتوری پیکربندی و خروج.\&
.PP
.RE
\fB--dump-modversions\fR
.RS 4
چاپ فهرستی از اطلاعات نسخه‌بندی ماژول که توسط یک ماژول مورد نیاز است.\& این گزینه معمولاً توسط توزیع‌ها برای بسته‌بندی ماژول‌های هسته لینوکس با استفاده از وابستگی‌های نسخه‌بندی ماژول به کار می‌رود.\&
.PP
.RE
\fB-d\fR, \fB--dirname\fR
.RS 4
دایرکتوری ریشه برای ماژول‌ها، به‌طور پیش‌فرض /.\&
.PP
.RE
\fB--first-time\fR
.RS 4
به‌طور معمول، \fBmodprobe\fR در صورتی که دستور درج ماژولی که از قبل وجود دارد یا حذف ماژولی که وجود ندارد به آن داده شود، موفقیت‌آمیز عمل می‌کند (و هیچ کاری انجام نمی‌دهد).\& این رفتار برای اسکریپت‌های ساده ایده‌آل است؛ با این حال، اسکریپت‌های پیچیده‌تر اغلب می‌خواهند بدانند که آیا \fBmodprobe\fR واقعاً کاری انجام داده است یا خیر: این گزینه باعث می‌شود که اگر \fBmodprobe\fR عملاً کاری انجام نداد، با شکست مواجه شود (خطا بازگرداند).\&
.PP
.RE
\fB--force-vermagic\fR
.RS 4
هر ماژول شامل یک رشته کوچک حاوی اطلاعات مهم مانند نسخه‌های هسته و کامپایلر است.\& اگر بارگذاری ماژولی ناموفق باشد و هسته گزارش دهد که "version magic" مطابقت ندارد، می‌توانید از این گزینه برای حذف آن بررسی استفاده کنید.\& طبیعتاً این بررسی جهت محافظت از سیستم شما قرار داده شده است، بنابراین استفاده از این گزینه خطرناک است مگر اینکه بدانید دقیقاً چه کاری انجام می‌دهید.\&
.PP
این گزینه برای تمامی ماژول‌های درج‌شده اعمال می‌شود: هم ماژول (یا نام مستعار) مشخص‌شده در خط فرمان و هم هر ماژولی که به آن وابسته است.\&
.PP
.RE
\fB--force-modversion\fR
.RS 4
هنگامی که ماژول‌ها با تنظیم CONFIG_MODVERSIONS کامپایل می‌شوند، بخشی ایجاد می‌شود که نسخه‌های تمام رابط‌های استفاده‌شده توسط (یا ارائه‌شده توسط) ماژول را با جزئیات شرح می‌دهد.\& اگر بارگذاری ماژولی ناموفق باشد و هسته گزارش دهد که ماژول درباره نسخه برخی رابط‌ها ناسازگار است، می‌توانید از \fB--force-modversion\fR برای حذف کامل اطلاعات نسخه استفاده کنید.\& طبیعتاً این بررسی جهت محافظت از سیستم شما قرار داده شده است، بنابراین استفاده از این گزینه خطرناک است مگر اینکه بدانید دقیقاً چه کاری انجام می‌دهید.\&
.PP
این گزینه برای تمامی ماژول‌های درج‌شده اعمال می‌شود: هم ماژول (یا نام مستعار) مشخص‌شده در خط فرمان و هم هر ماژولی که به آن وابسته است.\&
.PP
.RE
\fB-f\fR, \fB--force\fR
.RS 4
تلاش برای حذف هرگونه اطلاعات نسخه‌بندی از ماژول که ممکن است در غیر این صورت مانع از بارگذاری آن شود: این عمل معادل استفاده هم‌زمان از هر دو گزینه \fB--force-vermagic\fR و \fB--force-modversion\fR است.\& طبیعتاً این بررسی‌ها جهت محافظت از سیستم شما قرار داده شده‌اند، بنابراین استفاده از این گزینه خطرناک است مگر اینکه بدانید دقیقاً چه کاری انجام می‌دهید.\&
.PP
این گزینه برای تمامی ماژول‌های درج‌شده اعمال می‌شود: هم ماژول (یا نام مستعار) مشخص‌شده در خط فرمان و هم هر ماژولی که به آن وابسته است.\&
.PP
.RE
\fB-i\fR, \fB--ignore-install\fR, \fB--ignore-remove\fR
.RS 4
این گزینه باعث می‌شود \fBmodprobe\fR دستورات \fBinstall\fR و \fBremove\fR موجود در فایل پیکربندی (در صورت وجود) را برای ماژول مشخص‌شده در خط فرمان نادیده بگیرد (هر ماژول وابسته همچنان مشمول دستوراتی است که در فایل پیکربندی برای آن‌ها تنظیم شده است).\& در صورت استفاده از این گزینه، در حال حاضر هر دو دستور \fBinstall\fR و \fBremove\fR نادیده گرفته می‌شوند، صرف‌نظر از اینکه درخواست مشخصاً فقط با یکی از گزینه‌های \fB--ignore-install\fR یا \fB--ignore-remove\fR (و نه هر دو) داده شده باشد.\& به \fBmodprobe.\&d\fR(5) مراجعه کنید.\&
.PP
.RE
\fB-n\fR, \fB--dry-run\fR, \fB--show\fR
.RS 4
این گزینه همه کارها را انجام می‌دهد به جز درج یا حذف واقعی ماژول‌ها (یا اجرای دستورات install یا remove).\& ترکیب این گزینه با \fB-v\fR برای اشکال‌زدایی مشکلات بسیار مفید است.\& به دلایل تاریخی، هر دو گزینه \fB--dry-run\fR و \fB--show\fR عملاً معنای یکسانی دارند و قابل جایگزینی با یکدیگرند.\&
.PP
.RE
\fB-q\fR, \fB--quiet\fR
.RS 4
با این پرچم، \fBmodprobe\fR در صورتی که بخواهید ماژولی را درج یا حذف کنید که نتواند پیدا کند (و نام مستعار یا دستور \fBinstall\fR/\fBremove\fR نباشد)، پیام خطایی چاپ نخواهد کرد.\& با این حال، همچنان با وضعیت خروج غیرصفر بازمی‌گردد.\& هسته از این سازوکار برای کاوش فرصت‌طلبانه ماژول‌هایی که ممکن است با استفاده از request_module وجود داشته باشند استفاده می‌کند.\&
.PP
.RE
\fB-R\fR, \fB--resolve-alias\fR
.RS 4
چاپ تمام نام‌های ماژولی که با یک نام مستعار (alias) مطابقت دارند.\& این گزینه می‌تواند برای اشکال‌زدایی مشکلات نام مستعار ماژول مفید باشد.\&
.PP
.RE
\fB-r\fR, \fB--remove\fR
.RS 4
این گزینه باعث می‌شود \fBmodprobe\fR ماژول را به جای درج، حذف کند.\& اگر ماژول‌هایی که این ماژول به آن‌ها وابسته است نیز بدون استفاده باشند، \fBmodprobe\fR تلاش خواهد کرد آن‌ها را نیز حذف کند.\& برخلاف درج ماژول، می‌توان بیش از یک ماژول را در خط فرمان مشخص کرد (مشخص کردن پارامترهای ماژول هنگام حذف ماژول‌ها معنایی ندارد).\&
.PP
معمولاً دلیلی برای حذف ماژول‌ها وجود ندارد، اما برخی ماژول‌های دارای اشکال به آن نیاز دارند.\& همچنین هسته توزیع شما ممکن است به گونه‌ای ساخته نشده باشد که اصلاً از حذف ماژول‌ها پشتیبانی کند.\&
.PP
.RE
\fB-w\fR \fITIMEOUT_MSEC\fR, \fB--wait\fR=\fITIMEOUT_MSEC\fR
.RS 4
این گزینه موجب می‌شود در صورتی که حذف ماژول به دلیل مشغول بودن آن ناموفق باشد (یعنی مقدار refcount آن در زمان فراخوانی صفر نباشد)، \fBmodprobe -r\fR به تلاش برای حذف ادامه دهد.\& دستور Modprobe با یک زمان خواب افزایشی میان هر تلاش، تا رسیدن به حداکثر زمان انتظار بر حسب میلی‌ثانیه که در این گزینه تعیین شده است، سعی در حذف ماژول می‌کند.\&
.PP
.RE
\fB-S\fR \fIversion\fR, \fB--set-version\fR=\fIversion\fR
.RS 4
تعیین نسخه هسته، به جای استفاده از \fBuname\fR(2) برای تصمیم‌گیری درباره نسخه هسته (که محل یافتن ماژول‌ها را مشخص می‌کند).\&
.PP
.RE
\fB--show-depends\fR
.RS 4
فهرست کردن وابستگی‌های یک ماژول (یا نام مستعار)، از جمله خود ماژول.\& این کار مجموعه‌ای (احتمالاً خالی) از نام فایل‌های ماژول را سطر به سطر تولید می‌کند که هر کدام با "insmod" آغاز می‌شوند و معمولاً توسط توزیع‌ها برای تعیین ماژول‌هایی که باید هنگام تولید تصویرهای initrd/initramfs گنجانده شوند، به کار می‌رود.\& دستورات \fBInstall\fR قابل اعمال، با پیشوند "install" نمایش داده می‌شوند.\& این گزینه هیچ‌یک از دستورات نصب را اجرا نمی‌کند.\& توجه داشته باشید که می‌توان از \fBmodinfo\fR(8) برای استخراج وابستگی‌های یک ماژول از خود آن ماژول استفاده کرد، اما این ابزار چیزی درباره نام‌های مستعار یا دستورات install نمی‌داند.\&
.PP
.RE
\fB-s\fR, \fB--syslog\fR
.RS 4
این گزینه موجب می‌شود که تمام پیام‌های خطا به جای ارسال به خروجی استاندارد خطا، از طریق سازوکار syslog (به عنوان LOG_DAEMON با سطح LOG_NOTICE) فرستاده شوند.\& این قابلیت در صورت در دسترس نبودن stderr نیز به صورت خودکار فعال می‌شود.\&
.PP
این گزینه از طریق دستورات \fBinstall\fR یا \fBremove\fR به سایر دستورات \fBmodprobe\fR در متغیر محیطی MODPROBE_OPTIONS منتقل می‌شود.\&
.PP
.RE
\fB-V\fR, \fB--version\fR
.RS 4
نمایش نسخه برنامه و خروج.\&
.PP
.RE
\fB-v\fR, \fB--verbose\fR
.RS 4
چاپ پیام‌ها درباره فعالیت‌های در حال انجام برنامه.\& معمولاً \fBmodprobe\fR فقط زمانی پیام چاپ می‌کند که مشکلی رخ داده باشد.\&
.PP
این گزینه از طریق دستورات \fBinstall\fR یا \fBremove\fR به سایر دستورات \fBmodprobe\fR در متغیر محیطی MODPROBE_OPTIONS منتقل می‌شود.\&
.PP
.RE
.SH "محیط (ENVIRONMENT)"
.PP
متغیر محیطی MODPROBE_OPTIONS نیز می‌تواند برای ارسال آرگومان‌های خط فرمان به \fBmodprobe\fR استفاده شود.\& قالب آن عمداً مستندسازی نشده است، زیرا استفاده از آن توسط ابزارها و اسکریپت‌های شخص ثالث توصیه نمی‌شود.\&
.PP
این متغیر محیطی همراه با پیاده‌سازی قوانین نصب ایجاد شده است.\&
.PP
.SH "کپی‌رایت (COPYRIGHT)"
.PP
حق نشر اصلی این صفحه راهنما متعلق به 2002، Rusty Russell، شرکت IBM Corporation است.\&
.PP
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBmodprobe.\&d\fR(5), \fBinsmod\fR(8), \fBrmmod\fR(8), \fBlsmod\fR(8), \fBmodinfo\fR(8), \fBdepmod\fR(8)
.PP
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.PP
لطفاً هرگونه گزارش باگ را به سامانه پیگیری مشکلات kmod در:
.br
<https://github.com/kmod-project/kmod/issues>
همراه با نسخه استفاده‌شده، مراحل بازتولید مشکل و نتیجه مورد انتظار ارسال کنید.\&
.PP
.SH "نویسندگان (AUTHORS)"
.PP
مشارکت‌های فراوانی از سوی فهرست پستی linux-modules به نشانی
<linux-modules@vger.kernel.org>
و گیت‌هاب صورت گرفته است.\& چنانچه یک نسخه از مخزن خود kmod.\&git در اختیار دارید، خروجی دستورات \fBgit-shortlog\fR(1) و \fBgit-blame\fR(1) می‌تواند نویسندگان بخش‌های خاص پروژه را به شما نشان دهد.\&
.PP
\fBLucas De Marchi\fR <lucas.de.marchi@gmail.com> نگه‌دارنده فعلی این پروژه است.\&