نام (NAME)

nvidia-modprobe - بارگذاری ماژول هسته انویدیا و ایجاد فایل‌های دستگاه کاراکتری انویدیا

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

nvidia-modprobe [گزینه‌ها]
nvidia-modprobe [گزینه‌ها] --create-nvidia-device-file=MINOR-NUMBER
nvidia-modprobe [گزینه‌ها] --module-instance=MODULE-INSTANCE

توضیحات (DESCRIPTION)

ابزار nvidia-modprobe توسط مؤلفه‌های درایور انویدیا در فضای کاربری (user-space) استفاده می‌شود تا اطمینان حاصل شود که ماژول هسته انویدیا بارگذاری شده، فایل‌های دستگاه کاراکتری انویدیا موجود هستند و برخی تنظیمات زمان اجرا در هسته پیکربندی شده‌اند. این امکانات معمولاً توسط سیستم‌های پیکربندی توزیع لینوکس مانند udev ارائه می‌شوند. در صورت امکان، توصیه می‌شود از مکانیزم‌های بومی توزیع لینوکس خود برای مدیریت بارگذاری ماژول‌های هسته، ایجاد فایل‌های دستگاه و تنظیمات پیکربندی زمان اجرای هسته استفاده کنید. این ابزار به عنوان یک راهکار جایگزین (fallback) برای کارکرد آماده و مستقل از توزیع ارائه شده است.

هنگام نصب توسط nvidia-installer ، ابزار nvidia-modprobe به صورت setuid root نصب می‌شود.

کاربران معمولاً نیازی به اجرای دستی nvidia-modprobe ندارند؛ مؤلفه‌های درایور فضای کاربری انویدیا در صورت نیاز آن را از طریق فراخوانی‌های fork(2)/exec(3) اجرا می‌کنند.

هنگام اجرا بدون هیچ گزینه‌ای، nvidia-modprobe ماژول هسته انویدیا را بارگذاری کرده و سپس خارج می‌شود. هنگامی که گزینه --module-instance در سیستم‌های دارای چند ماژول هسته انویدیا مشخص شود، nvidia-modprobe ماژول هسته متناظر انویدیا را بارگذاری کرده و خارج می‌شود. هنگامی که گزینه --create-nvidia-device-file مشخص شود، nvidia-modprobe فایل دستگاه درخواست‌شده را نیز ایجاد می‌کند.

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

گزینه‌ها (OPTIONS)

-v, --version: چاپ نسخه ابزار و خروج.
-h, --help: چاپ اطلاعات نحوه استفاده از گزینه‌های خط فرمان و خروج.
-c MINOR-NUMBER, --create-nvidia-device-file=MINOR-NUMBER: ایجاد فایل دستگاه انویدیا با شماره جزئی (minor number) داده‌شده؛ این گزینه را می‌توان چندین بار برای ایجاد چندین فایل دستگاه انویدیا مشخص کرد.

گزینه‌های پیشرفته (ADVANCED OPTIONS)

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

مثال‌ها (EXAMPLES)

nvidia-modprobe: اجرای `/sbin/modprobe nvidia`
nvidia-modprobe -c 0 -c 1: اجرای `/sbin/modprobe nvidia` و ایجاد /dev/nvidia0 و /dev/nvidia1
nvidia-modprobe -i 0: اجرای `/sbin/modprobe nvidia0`

نویسنده (AUTHOR)

Andy Ritger
NVIDIA Corporation