نام (NAME)

mariadb-plugin - پیکربندی و مدیریت افزونه‌های سرور MariaDB

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

mariadb-plugin [options] plugin {ENABLE|DISABLE}

توضیحات (DESCRIPTION)

ابزار mariadb-plugin به مدیران MariaDB امکان می‌دهد افزونه‌هایی را که سرور MariaDB بارگذاری می‌کند، مدیریت کنند. این ابزار جایگزینی برای مشخص کردن دستی گزینه --plugin-load هنگام راه‌اندازی سرور یا استفاده از دستورهای INSTALL PLUGIN و UNINSTALL PLUGIN در زمان اجرا فراهم می‌کند.

بسته به اینکه mariadb-plugin برای فعال‌سازی یا غیرفعال‌سازی افزونه‌ها فراخوانی شده باشد، ردیف‌هایی را در جدول mysql.plugin که به عنوان رجیستری افزونه‌ها عمل می‌کند، درج یا حذف می‌نماید. (برای انجام این عملیات، mariadb-plugin سرور MariaDB را در حالت راه‌اندازی اولیه (bootstrap) اجرا می‌کند؛ این بدان معناست که سرور نباید از قبل در حال اجرا باشد.) برای راه‌اندازی‌های معمول سرور، افزونه‌های فهرست‌شده در mysql.plugin به‌طور خودکار بارگذاری و فعال می‌شوند. برای کنترل بیشتر بر فعال‌سازی افزونه‌ها، از گزینه‌های --plugin_name که به نام افزونه‌های خاص نام‌گذاری شده‌اند، استفاده کنید.

هر بار فراخوانی mariadb-plugin یک فایل پیکربندی را می‌خواند تا نحوه پیکربندی افزونه‌های موجود در یک فایل شیء کتابخانه افزونه منفرد را تعیین کند. برای فراخوانی mariadb-plugin، از این ساختار استفاده کنید:

mariadb-plugin [options] plugin {ENABLE|DISABLE}

شناسه plugin نام افزونه‌ای است که باید پیکربندی شود. ENABLE یا DISABLE (حساس به بزرگی یا کوچکی حروف نیستند) مشخص می‌کنند که آیا مولفه‌های کتابخانه افزونه نام‌برده در فایل پیکربندی، فعال یا غیرفعال شوند. ترتیب آرگومان‌های plugin و ENABLE یا DISABLE اهمیتی ندارد.

به‌عنوان مثال، برای پیکربندی مولفه‌های یک فایل کتابخانه افزونه به نام myplugins.so در لینوکس یا myplugins.dll در ویندوز، مقدار plugin را برابر با myplugins قرار دهید. فرض کنید این کتابخانه افزونه شامل سه افزونه به نام‌های plugin1، plugin2 و plugin3 است که همگی باید تحت کنترل mariadb-plugin پیکربندی شوند. بر اساس قرارداد، فایل‌های پیکربندی پسوند .ini داشته و نام پایه آن‌ها مشابه نام کتابخانه افزونه است، بنابراین نام پیش‌فرض فایل پیکربندی برای این کتابخانه افزونه myplugins.ini خواهد بود. محتوای این فایل پیکربندی به این شکل است:

myplugins
plugin1
plugin2
plugin3

خط اول در فایل myplugins.ini نام فایل شیء کتابخانه بدون هیچ‌گونه پسوندی مانند .so یا .dll است. خطوط باقی‌مانده نام مولفه‌هایی هستند که باید فعال یا غیرفعال شوند. هر مقدار در فایل باید در یک خط جداگانه قرار گیرد. خطوطی که اولین نویسه آن‌ها '#' باشد، به‌عنوان توضیح (کامنت) در نظر گرفته شده و نادیده گرفته می‌شوند.

برای فعال‌سازی افزونه‌های فهرست‌شده در فایل پیکربندی، mariadb-plugin را به این صورت فراخوانی کنید:

shell> mariadb-plugin myplugins ENABLE

برای غیرفعال‌سازی افزونه‌ها، به‌جای ENABLE از DISABLE استفاده کنید.

اگر mariadb-plugin نتواند فایل پیکربندی یا فایل کتابخانه افزونه را پیدا کند، یا اگر mariadb-plugin نتواند سرور MariaDB را راه‌اندازی نماید، خطا رخ می‌دهد.

ابزار mariadb-plugin از گزینه‌های زیر پشتیبانی می‌کند که می‌توان آن‌ها را در خط فرمان یا در گروه [mariadbd] از هر فایل گزینه‌ای مشخص کرد. برای گزینه‌های مشخص‌شده در یک گروه [mariadbd]، ابزار mariadb-plugin گزینه‌های --basedir، --datadir و --plugin-dir را شناسایی کرده و سایر گزینه‌ها را نادیده می‌گیرد.

گزینه‌های mariadb-plugin

•--help, -?

نمایش پیام راهنما و خروج.

•--basedir=path, -b path

دایرکتوری پایه سرور.

•--datadir=path, -d path

دایرکتوری داده‌های سرور.

•--my-print-defaults=path, -b path

مسیر برنامه my_print_defaults.

•--mariadbd=path, -b path

مسیر سرور mariadbd.

•--no-defaults, -p

مقادیر را از فایل پیکربندی نخوان. این گزینه به مدیر سیستم امکان می‌دهد از خواندن مقادیر پیش‌فرض از فایل پیکربندی صرف‌نظر کند.

در mariadb-plugin، برخلاف بیشتر برنامه‌های دیگر MariaDB که از --no-defaults پشتیبانی می‌کنند، نیازی نیست این گزینه حتماً در ابتدای خط فرمان آورده شود.

•--plugin-dir=path, -p path

دایرکتوری افزونه‌های سرور.

•--plugin-ini=file_name, -i file_name

فایل پیکربندی mariadb-plugin. مسیرهای نسبی نسبت به دایرکتوری جاری تفسیر می‌شوند. اگر این گزینه مشخص نشود، مقدار پیش‌فرض برابر با plugin.ini در دایرکتوری افزونه‌ها خواهد بود، که در آن plugin همان آرگومان plugin مشخص‌شده در خط فرمان است.

•--print-defaults, -P

نمایش مقادیر پیش‌فرض از فایل پیکربندی. این گزینه باعث می‌شود mariadb-plugin مقادیر پیش‌فرض برای --basedir، --datadir و --plugin-dir را در صورت وجود در فایل پیکربندی چاپ کند. اگر مقداری برای یک متغیر یافت نشود، چیزی نمایش داده نمی‌شود.

در mariadb-plugin، برخلاف بیشتر برنامه‌های دیگر MariaDB که از --print-defaults پشتیبانی می‌کنند، نیازی نیست این گزینه حتماً در ابتدای خط فرمان آورده شود.

•--verbose, -v

حالت پرگو (Verbose). چاپ اطلاعات بیشتر در مورد عملکرد برنامه. این گزینه می‌تواند چندین بار تکرار شود تا حجم اطلاعات افزایش یابد.

•--version, -V

نمایش اطلاعات نسخه و خروج.

حق نشر (COPYRIGHT)

این مستندات یک نرم‌افزار آزاد است؛ شما می‌توانید آن را تحت شرایط «مجوز عمومی همگانی گنو» (GNU General Public License) منتشر شده توسط «بنیاد نرم‌افزارهای آزاد» (نسخه ۲ مجوز) بازتوزیع کرده یا تغییر دهید.

این مستندات به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص. برای جزئیات بیشتر به «مجوز عمومی همگانی گنو» مراجعه کنید.

شما باید همراه با این برنامه یک نسخه از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به آدرس زیر بنویسید: Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA یا به پیوند http://www.gnu.org/licenses مراجعه کنید.

همچنین ببینید (SEE ALSO)

برای اطلاعات بیشتر، لطفاً به مستندات MariaDB به نشانی اینترنتی https://mariadb.com/docs مراجعه فرمایید.

نویسنده (AUTHOR)

بنیاد MariaDB (http://www.mariadb.org).