.\" Copyright (C) 2005-2010 NVIDIA Corporation.
.\"
.\" WARNING: THIS FILE IS AUTO-GENERATED!  Edit nvidia-modprobe.1.m4 instead.
.\" Define the .URL macro and then override it with the www.tmac package if it
.\" exists.
.de URL
\\$2 \(la \\$1 \(ra\\$3
..
.if \n[.g] .mso www.tmac
.TH nvidia\-modprobe 1 "2026-07-29" "nvidia\-modprobe 610.57.04"

.SH "نام (NAME)"
nvidia\-modprobe \- بارگذاری ماژول هسته انویدیا و ایجاد فایل‌های دستگاه کاراکتری انویدیا

.SH "خلاصه دستور (SYNOPSIS)"
.BI "nvidia\-modprobe [" "گزینه‌ها" "]"
.br
.BI "nvidia\-modprobe [" "گزینه‌ها" "] \-\-create\-nvidia\-device\-file=" MINOR-NUMBER
.br
.BI "nvidia\-modprobe [" "گزینه‌ها" "] \-\-module\-instance=" MODULE-INSTANCE
.br

.SH "توضیحات (DESCRIPTION)"
ابزار
.B nvidia\-modprobe
توسط مؤلفه‌های درایور انویدیا در فضای کاربری (user-space) استفاده می‌شود تا اطمینان حاصل شود که ماژول هسته انویدیا بارگذاری شده، فایل‌های دستگاه کاراکتری انویدیا موجود هستند و برخی تنظیمات زمان اجرا در هسته پیکربندی شده‌اند. این امکانات معمولاً توسط سیستم‌های پیکربندی توزیع لینوکس مانند udev ارائه می‌شوند. در صورت امکان، توصیه می‌شود از مکانیزم‌های بومی توزیع لینوکس خود برای مدیریت بارگذاری ماژول‌های هسته، ایجاد فایل‌های دستگاه و تنظیمات پیکربندی زمان اجرای هسته استفاده کنید. این ابزار به عنوان یک راهکار جایگزین (fallback) برای کارکرد آماده و مستقل از توزیع ارائه شده است.
.PP
هنگام نصب توسط
.B nvidia\-installer
، ابزار
.B nvidia\-modprobe
به صورت setuid root نصب می‌شود.
.PP
کاربران معمولاً نیازی به اجرای دستی
.B nvidia\-modprobe
ندارند؛ مؤلفه‌های درایور فضای کاربری انویدیا در صورت نیاز آن را از طریق فراخوانی‌های fork(2)/exec(3) اجرا می‌کنند.
.PP
هنگام اجرا بدون هیچ گزینه‌ای،
.B nvidia\-modprobe
ماژول هسته انویدیا را بارگذاری کرده و سپس خارج می‌شود. هنگامی که گزینه
.B \-\-module\-instance
در سیستم‌های دارای چند ماژول هسته انویدیا مشخص شود،
.B nvidia\-modprobe
ماژول هسته متناظر انویدیا را بارگذاری کرده و خارج می‌شود. هنگامی که گزینه
.B \-\-create\-nvidia\-device\-file
مشخص شود،
.B nvidia\-modprobe
فایل دستگاه درخواست‌شده را نیز ایجاد می‌کند.

کد منبع nvidia-modprobe در اینجا در دسترس است:
.URL https://download.nvidia.com/XFree86/nvidia-modprobe

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-v, \-\-version"
چاپ نسخه ابزار و خروج.
.TP
.BI "\-h, \-\-help"
چاپ اطلاعات نحوه استفاده از گزینه‌های خط فرمان و خروج.
.TP
.BI "\-c " "MINOR-NUMBER" ", \-\-create-nvidia-device-file=" "MINOR-NUMBER"
ایجاد فایل دستگاه انویدیا با شماره جزئی (minor number) داده‌شده؛ این گزینه را می‌توان چندین بار برای ایجاد چندین فایل دستگاه انویدیا مشخص کرد.
.SH "گزینه‌های پیشرفته (ADVANCED OPTIONS)"
.TP
.BI "\-u, \-\-unified-memory"
بارگذاری ماژول هسته Unified Memory انویدیا یا ایجاد فایل‌های دستگاه برای آن، به جای ماژول هسته انویدیا.
.TP
.BI "\-m, \-\-modeset"
بارگذاری ماژول هسته modeset انویدیا و ایجاد فایل دستگاه آن.
.TP
.BI "\-s, \-\-nvswitch"
بارگذاری ماژول هسته انویدیا و ایجاد فایل‌های دستگاه NVSwitch برای هر شماره جزئی مشخص‌شده با سوییچ \-c.
.TP
.BI "\-l, \-\-nvlink"
بارگذاری ماژول هسته انویدیا و ایجاد فایل دستگاه کنترل NVLink.
.TP
.BI "\-f " "NVIDIA-CAPABILITY-DEVICE-FILE" ", \-\-nvidia-capability-device-file=" "NVIDIA-CAPABILITY-DEVICE-FILE"
ایجاد فایل‌های دستگاه قابلیت انویدیا با مسیر فایل proc/ مربوط به capability داده‌شده. این گزینه می‌تواند چندین بار برای ایجاد چندین فایل دستگاه قابلیت انویدیا تکرار شود.
.TP
.BI "\-a, \-\-auto-online-movable"
فعال‌سازی تنظیم هسته online_movable برای آنلاین کردن خودکار حافظه در پلتفرم‌هایی (مانند Grace Hopper) که حافظه GPU را به هسته اضافه و آنلاین می‌کنند.

.SH "مثال‌ها (EXAMPLES)"
.TP
.B nvidia\-modprobe
اجرای
`/sbin/modprobe nvidia`
.TP
.B nvidia\-modprobe -c 0 -c 1
اجرای
`/sbin/modprobe nvidia`
و ایجاد
.I
/dev/nvidia0
و
.I
/dev/nvidia1
.TP
.B nvidia\-modprobe -i 0
اجرای
`/sbin/modprobe nvidia0`
.

.SH "نویسنده (AUTHOR)"
Andy Ritger
.br
NVIDIA Corporation

.SH "حق نشر (COPYRIGHT)"
حق نشر \(co 2013 NVIDIA Corporation.