'\" t
.\"
.TH "\fBMARIADB-PLUGIN\fR" "1" "5 March 2025" "MariaDB 11.8" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mariadb-plugin
.SH "نام (NAME)"
mariadb-plugin \- پیکربندی و مدیریت افزونه‌های سرور MariaDB
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmariadb-plugin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIplugin\fR\fR\fB\ {ENABLE|DISABLE}\fR\ 'u
\fBmariadb-plugin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIplugin\fR\fR\fB {ENABLE|DISABLE}\fR
.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fBmariadb-plugin\fR
به مدیران MariaDB امکان می‌دهد افزونه‌هایی را که سرور MariaDB بارگذاری می‌کند، مدیریت کنند\&. این ابزار جایگزینی برای مشخص کردن دستی گزینه
\fB\-\-plugin\-load\fR
هنگام راه‌اندازی سرور یا استفاده از دستورهای
INSTALL PLUGIN
و
UNINSTALL PLUGIN
در زمان اجرا فراهم می‌کند\&.
.PP
بسته به اینکه
\fBmariadb-plugin\fR
برای فعال‌سازی یا غیرفعال‌سازی افزونه‌ها فراخوانی شده باشد، ردیف‌هایی را در جدول
mysql\&.plugin
که به عنوان رجیستری افزونه‌ها عمل می‌کند، درج یا حذف می‌نماید\&. (برای انجام این عملیات،
\fBmariadb-plugin\fR
سرور MariaDB را در حالت راه‌اندازی اولیه (bootstrap) اجرا می‌کند؛ این بدان معناست که سرور نباید از قبل در حال اجرا باشد\&.) برای راه‌اندازی‌های معمول سرور، افزونه‌های فهرست‌شده در
mysql\&.plugin
به‌طور خودکار بارگذاری و فعال می‌شوند\&. برای کنترل بیشتر بر فعال‌سازی افزونه‌ها، از گزینه‌های
\fB\-\-\fR\fB\fIplugin_name\fR\fR
که به نام افزونه‌های خاص نام‌گذاری شده‌اند، استفاده کنید\&.
.PP
هر بار فراخوانی
\fBmariadb-plugin\fR
یک فایل پیکربندی را می‌خواند تا نحوه پیکربندی افزونه‌های موجود در یک فایل شیء کتابخانه افزونه منفرد را تعیین کند\&. برای فراخوانی
\fBmariadb-plugin\fR،
از این ساختار استفاده کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
mariadb-plugin [\fIoptions\fR] \fIplugin\fR {ENABLE|DISABLE}
.fi
.if n \{\
.RE
.\}
.PP
شناسه
\fIplugin\fR
نام افزونه‌ای است که باید پیکربندی شود\&.
ENABLE
یا
DISABLE
(حساس به بزرگی یا کوچکی حروف نیستند) مشخص می‌کنند که آیا مولفه‌های کتابخانه افزونه نام‌برده در فایل پیکربندی، فعال یا غیرفعال شوند\&. ترتیب آرگومان‌های
\fIplugin\fR
و
ENABLE
یا
DISABLE
اهمیتی ندارد\&.
.PP
به‌عنوان مثال، برای پیکربندی مولفه‌های یک فایل کتابخانه افزونه به نام
myplugins\&.so
در لینوکس یا
myplugins\&.dll
در ویندوز، مقدار
\fIplugin\fR
را برابر با
myplugins
قرار دهید\&. فرض کنید این کتابخانه افزونه شامل سه افزونه به نام‌های
plugin1،
plugin2 و
plugin3
است که همگی باید تحت کنترل
\fBmariadb-plugin\fR
پیکربندی شوند\&. بر اساس قرارداد، فایل‌های پیکربندی پسوند
\&.ini
داشته و نام پایه آن‌ها مشابه نام کتابخانه افزونه است، بنابراین نام پیش‌فرض فایل پیکربندی برای این کتابخانه افزونه
myplugins\&.ini
خواهد بود\&. محتوای این فایل پیکربندی به این شکل است:
.sp
.if n \{\
.RS 4
.\}
.nf
myplugins
plugin1
plugin2
plugin3
.fi
.if n \{\
.RE
.\}
.PP
خط اول در فایل
myplugins\&.ini
نام فایل شیء کتابخانه بدون هیچ‌گونه پسوندی مانند
\&.so
یا
\&.dll
است\&. خطوط باقی‌مانده نام مولفه‌هایی هستند که باید فعال یا غیرفعال شوند\&. هر مقدار در فایل باید در یک خط جداگانه قرار گیرد\&. خطوطی که اولین نویسه آن‌ها
\*(Aq#\*(Aq
باشد، به‌عنوان توضیح (کامنت) در نظر گرفته شده و نادیده گرفته می‌شوند\&.
.PP
برای فعال‌سازی افزونه‌های فهرست‌شده در فایل پیکربندی،
\fBmariadb-plugin\fR
را به این صورت فراخوانی کنید:
.sp
.if n \{\
.RS 4
.\}
.nf
shell> \fBmariadb-plugin myplugins ENABLE\fR
.fi
.if n \{\
.RE
.\}
.PP
برای غیرفعال‌سازی افزونه‌ها، به‌جای
ENABLE
از
DISABLE
استفاده کنید\&.
.PP
اگر
\fBmariadb-plugin\fR
نتواند فایل پیکربندی یا فایل کتابخانه افزونه را پیدا کند، یا اگر
\fBmariadb-plugin\fR
نتواند سرور MariaDB را راه‌اندازی نماید، خطا رخ می‌دهد\&.
.PP
ابزار
\fBmariadb-plugin\fR
از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در گروه
[mariadbd]
از هر فایل گزینه‌ای مشخص کرد\&. برای گزینه‌های مشخص‌شده در یک گروه
[mariadbd]،
ابزار
\fBmariadb-plugin\fR
گزینه‌های
\fB\-\-basedir\fR،
\fB\-\-datadir\fR و
\fB\-\-plugin\-dir\fR
را شناسایی کرده و سایر گزینه‌ها را نادیده می‌گیرد\&.
.PP
گزینه‌های mariadb-plugin
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: help option
.\" help option: mariadb-plugin
\fB\-\-help\fR,
\fB\-?\fR
.sp
نمایش پیام راهنما و خروج\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: basedir option
.\" basedir option: mariadb-plugin
\fB\-\-basedir=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
دایرکتوری پایه سرور\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: datadir option
.\" datadir option: mariadb-plugin
\fB\-\-datadir=\fR\fB\fIpath\fR\fR,
\fB\-d \fR\fB\fIpath\fR\fR
.sp
دایرکتوری داده‌های سرور\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: my-print-defaults option
.\" my-print-defaults option: mariadb-plugin
\fB\-\-my\-print\-defaults=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
مسیر برنامه
\fBmy_print_defaults\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: mariadbd option
.\" mariadbd option: mariadb-plugin
\fB\-\-mariadbd=\fR\fB\fIpath\fR\fR,
\fB\-b \fR\fB\fIpath\fR\fR
.sp
مسیر سرور
\fBmariadbd\fR\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: no-defaults option
.\" no-defaults option: mariadb-plugin
\fB\-\-no\-defaults\fR,
\fB\-p\fR
.sp
مقادیر را از فایل پیکربندی نخوان\&. این گزینه به مدیر سیستم امکان می‌دهد از خواندن مقادیر پیش‌فرض از فایل پیکربندی صرف‌نظر کند\&.
.sp
در
\fBmariadb-plugin\fR،
برخلاف بیشتر برنامه‌های دیگر MariaDB که از
\fB\-\-no\-defaults\fR
پشتیبانی می‌کنند، نیازی نیست این گزینه حتماً در ابتدای خط فرمان آورده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: plugin-dir option
.\" plugin-dir option: mariadb-plugin
\fB\-\-plugin\-dir=\fR\fB\fIpath\fR\fR,
\fB\-p \fR\fB\fIpath\fR\fR
.sp
دایرکتوری افزونه‌های سرور\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: plugin-ini option
.\" plugin-ini option: mariadb-plugin
\fB\-\-plugin\-ini=\fR\fB\fIfile_name\fR\fR,
\fB\-i \fR\fB\fIfile_name\fR\fR
.sp
فایل پیکربندی
\fBmariadb-plugin\fR\&.
مسیرهای نسبی نسبت به دایرکتوری جاری تفسیر می‌شوند\&. اگر این گزینه مشخص نشود، مقدار پیش‌فرض برابر با
\fIplugin\fR\&.ini
در دایرکتوری افزونه‌ها خواهد بود، که در آن
\fIplugin\fR
همان آرگومان
\fIplugin\fR
مشخص‌شده در خط فرمان است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: print-defaults option
.\" print-defaults option: mariadb-plugin
\fB\-\-print\-defaults\fR,
\fB\-P\fR
.sp
نمایش مقادیر پیش‌فرض از فایل پیکربندی\&. این گزینه باعث می‌شود
\fBmariadb-plugin\fR
مقادیر پیش‌فرض برای
\fB\-\-basedir\fR،
\fB\-\-datadir\fR و
\fB\-\-plugin\-dir\fR
را در صورت وجود در فایل پیکربندی چاپ کند\&. اگر مقداری برای یک متغیر یافت نشود، چیزی نمایش داده نمی‌شود\&.
.sp
در
\fBmariadb-plugin\fR،
برخلاف بیشتر برنامه‌های دیگر MariaDB که از
\fB\-\-print\-defaults\fR
پشتیبانی می‌کنند، نیازی نیست این گزینه حتماً در ابتدای خط فرمان آورده شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: verbose option
.\" verbose option: mariadb-plugin
\fB\-\-verbose\fR,
\fB\-v\fR
.sp
حالت پرگو (Verbose)\&. چاپ اطلاعات بیشتر در مورد عملکرد برنامه\&. این گزینه می‌تواند چندین بار تکرار شود تا حجم اطلاعات افزایش یابد\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-plugin: version option
.\" version option: mariadb-plugin
\fB\-\-version\fR,
\fB\-V\fR
.sp
نمایش اطلاعات نسخه و خروج\&.
.RE
.SH "حق نشر (COPYRIGHT)"
.br
.PP
Copyright \(co 1997, 2013, Oracle and/or its affiliates. All rights reserved., 2013-2025 MariaDB Foundation
.PP
این مستندات یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط «بنیاد نرم‌افزارهای آزاد» (نسخه ۲ مجوز) بازتوزیع کرده یا تغییر دهید\&.
.PP
این مستندات به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص\&. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید\&.
.PP
شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید:
Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA
یا به پیوند
http://www.gnu.org/licenses
مراجعه کنید\&.
.sp
.SH "همچنین ببینید (SEE ALSO)"
برای اطلاعات بیشتر، لطفاً به مستندات MariaDB به نشانی اینترنتی
https://mariadb.com/docs
مراجعه فرمایید\&.
.SH "نویسنده (AUTHOR)"
بنیاد MariaDB
(http://www.mariadb.org)\&.