نام (NAME)

nvidia-persistenced - دیمنی برای حفظ وضعیت پایدار نرم‌افزاری در درایور NVIDIA

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

nvidia-persistenced

توضیحات (DESCRIPTION)

ابزار nvidia-persistenced برای فعال‌سازی وضعیت پایدار نرم‌افزاری در درایور NVIDIA استفاده می‌شود. هنگامی که حالت پایداری (persistence mode) فعال باشد، این دیمن از آزادسازی وضعیت دستگاه توسط درایور در زمانی که دستگاه در حال استفاده نیست جلوگیری می‌کند. این امر می‌تواند زمان راه‌اندازی کلاینت‌های جدید را در چنین شرایطی بهبود بخشد.

گزینه‌ها (OPTIONS)

-v, --version: چاپ نسخه ابزار و خروج.
-h, --help: چاپ اطلاعات استفاده از گزینه‌های خط فرمان و خروج.
-V, --verbose: میزان اطلاعات خروجی را کنترل می‌کند. به‌طور پیش‌فرض، nvidia-persistenced تنها خطاها و هشدارهای مربوط به رویدادهای غیرمنتظره و همچنین اعلان‌های راه‌اندازی و خاموشی را در syslog ثبت می‌کند. تعیین این پرچم باعث می‌شود که nvidia-persistenced اعلان‌های مربوط به تغییر وضعیت، مانند فعال یا غیرفعال شدن حالت پایداری، و پیام‌های اطلاع‌رسانی هنگام راه‌اندازی و خروج را نیز در syslog ثبت کند.
-u USERNAME, --user=USERNAME: اجرای nvidia-persistenced با مجوزهای کاربریِ کاربری که توسط آرگومان USERNAME مشخص شده است. این کاربر باید دسترسی نوشتن در دایرکتوری /var/run/nvidia-persistenced را داشته باشد. اگر این دایرکتوری وجود نداشته باشد، nvidia-persistenced پیش از تغییر شناسه کاربری و شناسه گروه فرآیند تلاش می‌کند آن را ایجاد کند. اگر این گزینه ارائه نشود، nvidia-persistenced تلاشی برای تغییر شناسه کاربری فرآیند نخواهد کرد.
-g GROUPNAME, --group=GROUPNAME: اجرای nvidia-persistenced با مجوزهای گروهیِ گروه مشخص‌شده توسط آرگومان GROUPNAME اگر هم این گزینه و هم گزینه --user ارائه شوند، این گزینه هنگام تعیین شناسه گروه جهت استفاده اولویت خواهد داشت. اگر این گزینه ارائه نشود، nvidia-persistenced از شناسه گروه اصلی کاربری که توسط آرگومان گزینه --user مشخص شده است استفاده خواهد کرد. اگر گزینه --user نیز ارائه نشود، nvidia-persistenced تلاشی برای تغییر شناسه گروه فرآیند نخواهد کرد.
--persistence-mode, --no-persistence-mode: به‌طور پیش‌فرض، nvidia-persistenced با فعال بودن حالت پایداری برای تمامی دستگاه‌ها شروع به کار می‌کند. از '--no-persistence-mode' برای غیرفعال‌سازی اجباری حالت پایداری برای همه دستگاه‌ها در هنگام راه‌اندازی استفاده کنید.
--uvm-persistence-mode, --no-uvm-persistence-mode: به‌طور پیش‌فرض، nvidia-persistenced با غیرفعال بودن حالت پایداری UVM برای تمامی دستگاه‌ها شروع به کار می‌کند. از '--uvm-persistence-mode' برای فعال‌سازی اجباری حالت پایداری UVM برای دستگاه‌های پشتیبانی‌شده در هنگام راه‌اندازی استفاده کنید. هنگامی که حالت پایداری UVM فعال باشد، GPU نمی‌تواند وارد حالت کم‌مصرف PCI-Express Runtime D3 شود. به فصل مربوط به مدیریت توان PCI-Express Runtime D3 (RTD3) در راهنمای NVIDIA Accelerated Linux Graphics Driver README مراجعه کنید. فعال کردن حالت پایداری UVM ممکن است باعث گزارش مصرف حافظه بیشتری از GPU شود، حتی در زمانی که هیچ برنامه‌ای در حال اجرا نیست.
--nvidia-cfg-path=PATH: کتابخانه nvidia-cfg برای برقراری ارتباط با ماژول هسته NVIDIA جهت پرس‌وجو و مدیریت پردازنده‌های گرافیکی (GPU) در سیستم استفاده می‌شود. این کتابخانه برای nvidia-persistenced الزامی است. این گزینه مشخص می‌کند که nvidia-persistenced در کجا باید به دنبال این کتابخانه بگردد (در صورتی که نتواند خودش آن را پیدا کند). در حالت عادی نباید به این گزینه نیازی باشد.

نصب (INSTALLATION)

هنگامی که توسط nvidia-installer نصب شود، اسکریپت‌های نمونه init برای راه‌اندازی دیمن در برخی از سیستم‌های init رایج‌تر به عنوان یک فایل فشرده در مسیر /usr/share/doc/NVIDIA_GLX-1.0/sample/nvidia-persistenced-init.tar.bz2 نصب می‌شوند. این اسکریپت‌های init باید متناسب با توزیع کاربر سفارشی‌سازی شده و در مکان مناسب توسط کاربر نصب شوند تا nvidia-persistenced هنگام راه‌اندازی سیستم اجرا گردد.

هنگامی که اسکریپت init به گونه‌ای نصب شد که دیمن در حال اجرا باشد، کاربران در حالت معمول نیازی به تعامل دستی با nvidia-persistenced ندارند؛ ابزارهای مدیریتی NVIDIA، مانند nvidia-smi می‌توانند در صورت نیاز به‌طور خودکار برای مدیریت حالت پایداری با آن ارتباط برقرار کنند.

برای پیش‌زمینه بیشتر، اطلاعات درباره نصب ابزار nvidia-persistenced جهت اجرا هنگام راه‌اندازی سیستم، و نکات عیب‌یابی به بخش "Using the nvidia-persistenced Utility" در راهنمای NVIDIA Linux Graphics Driver README مراجعه کنید.

دسترسی‌ها (PRIVILEGES)

این دیمن برای اجرا نیازی به دسترسی‌های ریشه (root) ندارد و می‌تواند با خیالی آسوده به عنوان یک کاربر بدون امتیاز اجرا شود، مشروط بر اینکه دایرکتوری زمان اجرای آن، /var/run/nvidia-persistenced، پیش از راه‌اندازی دیمن برای آن کاربر ساخته شده و تحت مالکیت او باشد. همچنین nvidia-persistenced نیاز به دسترسی خواندن و نوشتن روی فایل‌های دستگاه کاراکتری NVIDIA دارد. اگر مجوزهای فایل‌های دستگاه از طریق هر یک از گزینه‌های ماژول هسته NVIDIA شامل NVreg_DeviceFileUID، NVreg_DeviceFile_GID یا NVreg_DeviceFileMode تغییر یافته باشد، nvidia-persistenced باید به عنوان کاربری مناسب اجرا شود.

اگر دیمن با دسترسی ریشه راه‌اندازی شود، می‌توان به جای آن از گزینه --user استفاده کرد تا مشخص شود دیمن پس از آماده‌سازی دایرکتوری زمان اجرای خود باید امتیازاتش را کاهش داده و به عنوان کاربر تعیین‌شده اجرا گردد. استفاده از این گزینه ممکن است باعث شود در صورتی که کاربر تعیین‌شده دسترسی نوشتن در /var/run را نداشته باشد، دیمن پس از خاتمه یافتن نتواند دایرکتوری /var/run/nvidia-persistenced را حذف کند. در این حالت، حذف دایرکتوری باید توسط یک اسکریپت پس از اجرا (post-execution) مدیریت شود. برای نمونه‌هایی از این رفتار، به اسکریپت‌های نمونه init ارائه‌شده در /usr/share/doc/NVIDIA_GLX-1.0/sample/nvidia-persistenced-init.tar.bz2 مراجعه کنید.

دیمن به صورت غیرمستقیم از nvidia-modprobe از طریق کتابخانه nvidia-cfg استفاده می‌کند تا پس از اینکه دیمن امتیازات ریشه خود را رها کرد (در صورتی که در آغاز چنین امتیازی داشت)، ماژول هسته NVIDIA را بارگذاری کرده و فایل‌های دستگاه کاراکتری NVIDIA را ایجاد کند. اگر nvidia-modprobe نصب نشده باشد، در صورتی که دیمن با دسترسی‌های ریشه اجرا نشود ممکن است نتواند به درستی راه‌اندازی شود.

موارد دیگر (OTHER)

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

مثال‌ها (EXAMPLES)

nvidia-persistenced: دیمن پایداری NVIDIA را با فعال بودن حالت پایداری برای تمام دستگاه‌های NVIDIA راه‌اندازی می‌کند.
nvidia-persistenced --no-persistence-mode: دیمن پایداری NVIDIA را با غیرفعال بودن حالت پایداری برای تمام دستگاه‌های NVIDIA راه‌اندازی می‌کند.
nvidia-persistenced --user=foo: دیمن پایداری NVIDIA را به گونه‌ای راه‌اندازی می‌کند که به عنوان کاربر 'foo' اجرا شود.