.\" Copyright (C) 2013 NVIDIA Corporation.
.\"
.\" WARNING: THIS FILE IS AUTO_GENERATED!  Edit nvidia-persistenced.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\-persistenced 1 "2026-07-29" "nvidia\-persistenced 610.57.04"

.SH "نام (NAME)"
nvidia\-persistenced \- دیمنی برای حفظ وضعیت پایدار نرم‌افزاری در درایور NVIDIA

.SH "خلاصه دستور (SYNOPSIS)"
.BI "nvidia\-persistenced"
.br

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

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI "\-v, \-\-version"
چاپ نسخه ابزار و خروج.
.TP
.BI "\-h, \-\-help"
چاپ اطلاعات استفاده از گزینه‌های خط فرمان و خروج.
.TP
.BI "\-V, \-\-verbose"
میزان اطلاعات خروجی را کنترل می‌کند. به‌طور پیش‌فرض، nvidia\-persistenced تنها خطاها و هشدارهای مربوط به رویدادهای غیرمنتظره و همچنین اعلان‌های راه‌اندازی و خاموشی را در syslog ثبت می‌کند. تعیین این پرچم باعث می‌شود که nvidia\-persistenced اعلان‌های مربوط به تغییر وضعیت، مانند فعال یا غیرفعال شدن حالت پایداری، و پیام‌های اطلاع‌رسانی هنگام راه‌اندازی و خروج را نیز در syslog ثبت کند.
.TP
.BI "\-u " "USERNAME" ", \-\-user=" "USERNAME"
اجرای nvidia\-persistenced با مجوزهای کاربریِ کاربری که توسط آرگومان
.I USERNAME
مشخص شده است. این کاربر باید دسترسی نوشتن در دایرکتوری /var/run/nvidia\-persistenced را داشته باشد. اگر این دایرکتوری وجود نداشته باشد، nvidia\-persistenced پیش از تغییر شناسه کاربری و شناسه گروه فرآیند تلاش می‌کند آن را ایجاد کند. اگر این گزینه ارائه نشود، nvidia\-persistenced تلاشی برای تغییر شناسه کاربری فرآیند نخواهد کرد.
.TP
.BI "\-g " "GROUPNAME" ", \-\-group=" "GROUPNAME"
اجرای nvidia\-persistenced با مجوزهای گروهیِ گروه مشخص‌شده توسط آرگومان
.I GROUPNAME
.
اگر هم این گزینه و هم گزینه \-\-user ارائه شوند، این گزینه هنگام تعیین شناسه گروه جهت استفاده اولویت خواهد داشت. اگر این گزینه ارائه نشود، nvidia\-persistenced از شناسه گروه اصلی کاربری که توسط آرگومان گزینه \-\-user مشخص شده است استفاده خواهد کرد. اگر گزینه \-\-user نیز ارائه نشود، nvidia\-persistenced تلاشی برای تغییر شناسه گروه فرآیند نخواهد کرد.
.TP
.BI "\-\-persistence-mode, \-\-no\-persistence-mode"
به‌طور پیش‌فرض، nvidia\-persistenced با فعال بودن حالت پایداری برای تمامی دستگاه‌ها شروع به کار می‌کند. از '\-\-no\-persistence\-mode' برای غیرفعال‌سازی اجباری حالت پایداری برای همه دستگاه‌ها در هنگام راه‌اندازی استفاده کنید.
.TP
.BI "\-\-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 شود، حتی در زمانی که هیچ برنامه‌ای در حال اجرا نیست.
.TP
.BI "\-\-nvidia-cfg-path=" "PATH"
کتابخانه nvidia\-cfg برای برقراری ارتباط با ماژول هسته NVIDIA جهت پرس‌وجو و مدیریت پردازنده‌های گرافیکی (GPU) در سیستم استفاده می‌شود. این کتابخانه برای nvidia\-persistenced الزامی است. این گزینه مشخص می‌کند که nvidia\-persistenced در کجا باید به دنبال این کتابخانه بگردد (در صورتی که نتواند خودش آن را پیدا کند). در حالت عادی نباید به این گزینه نیازی باشد.

.SH "نصب (INSTALLATION)"
هنگامی که توسط
.B nvidia\-installer
نصب شود، اسکریپت‌های نمونه init برای راه‌اندازی دیمن در برخی از سیستم‌های init رایج‌تر به عنوان یک فایل فشرده در مسیر /usr/share/doc/NVIDIA_GLX-1.0/sample/nvidia-persistenced-init.tar.bz2 نصب می‌شوند.
این اسکریپت‌های init باید متناسب با توزیع کاربر سفارشی‌سازی شده و در مکان مناسب توسط کاربر نصب شوند تا
.B nvidia\-persistenced
هنگام راه‌اندازی سیستم اجرا گردد.
.PP
هنگامی که اسکریپت init به گونه‌ای نصب شد که دیمن در حال اجرا باشد، کاربران در حالت معمول نیازی به تعامل دستی با
.B nvidia\-persistenced
ندارند؛ ابزارهای مدیریتی NVIDIA، مانند
.B nvidia\-smi
می‌توانند در صورت نیاز به‌طور خودکار برای مدیریت حالت پایداری با آن ارتباط برقرار کنند.
.PP
برای پیش‌زمینه بیشتر، اطلاعات درباره نصب ابزار
.B nvidia\-persistenced
جهت اجرا هنگام راه‌اندازی سیستم، و نکات عیب‌یابی به بخش "Using the nvidia-persistenced Utility" در راهنمای NVIDIA Linux Graphics Driver README مراجعه کنید.
.PP

.SH "دسترسی‌ها (PRIVILEGES)"
این دیمن برای اجرا نیازی به دسترسی‌های ریشه (root) ندارد و می‌تواند با خیالی آسوده به عنوان یک کاربر بدون امتیاز اجرا شود، مشروط بر اینکه دایرکتوری زمان اجرای آن، /var/run/nvidia-persistenced، پیش از راه‌اندازی دیمن برای آن کاربر ساخته شده و تحت مالکیت او باشد.
همچنین
.B nvidia\-persistenced
نیاز به دسترسی خواندن و نوشتن روی فایل‌های دستگاه کاراکتری NVIDIA دارد.
اگر مجوزهای فایل‌های دستگاه از طریق هر یک از گزینه‌های ماژول هسته NVIDIA شامل NVreg_DeviceFileUID، NVreg_DeviceFile_GID یا NVreg_DeviceFileMode تغییر یافته باشد،
.B nvidia\-persistenced
باید به عنوان کاربری مناسب اجرا شود.
.PP
اگر دیمن با دسترسی ریشه راه‌اندازی شود، می‌توان به جای آن از گزینه
.B \-\-user
استفاده کرد تا مشخص شود دیمن پس از آماده‌سازی دایرکتوری زمان اجرای خود باید امتیازاتش را کاهش داده و به عنوان کاربر تعیین‌شده اجرا گردد.
استفاده از این گزینه ممکن است باعث شود در صورتی که کاربر تعیین‌شده دسترسی نوشتن در /var/run را نداشته باشد، دیمن پس از خاتمه یافتن نتواند دایرکتوری /var/run/nvidia-persistenced را حذف کند.
در این حالت، حذف دایرکتوری باید توسط یک اسکریپت پس از اجرا (post-execution) مدیریت شود.
برای نمونه‌هایی از این رفتار، به اسکریپت‌های نمونه init ارائه‌شده در /usr/share/doc/NVIDIA_GLX-1.0/sample/nvidia-persistenced-init.tar.bz2 مراجعه کنید.
.PP
دیمن به صورت غیرمستقیم از
.B nvidia\-modprobe
از طریق کتابخانه nvidia-cfg استفاده می‌کند تا پس از اینکه دیمن امتیازات ریشه خود را رها کرد (در صورتی که در آغاز چنین امتیازی داشت)، ماژول هسته NVIDIA را بارگذاری کرده و فایل‌های دستگاه کاراکتری NVIDIA را ایجاد کند.
اگر
.B nvidia\-modprobe
نصب نشده باشد، در صورتی که دیمن با دسترسی‌های ریشه اجرا نشود ممکن است نتواند به درستی راه‌اندازی شود.
.PP

.SH "موارد دیگر (OTHER)"
کد منبع
.B nvidia\-persistenced
در اینجا در دسترس است:
.URL https://download.nvidia.com/XFree86/nvidia-persistenced
.PP

.SH "مثال‌ها (EXAMPLES)"
.TP
.B nvidia\-persistenced
دیمن پایداری NVIDIA را با فعال بودن حالت پایداری برای تمام دستگاه‌های NVIDIA راه‌اندازی می‌کند.
.TP
.B nvidia\-persistenced \-\-no\-persistence\-mode
دیمن پایداری NVIDIA را با غیرفعال بودن حالت پایداری برای تمام دستگاه‌های NVIDIA راه‌اندازی می‌کند.
.TP
.B nvidia\-persistenced \-\-user=foo
دیمن پایداری NVIDIA را به گونه‌ای راه‌اندازی می‌کند که به عنوان کاربر 'foo' اجرا شود.

.SH "نویسندگان (AUTHORS)"
Will Davis
.br
NVIDIA Corporation

.SH "همچنین ببینید (SEE ALSO)"
.BR nvidia\-smi (1),
.BR nvidia\-modprobe (1)

.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
Copyright \(co 2013-2016 NVIDIA Corporation.