نام (NAME)

mysql_config - نمایش گزینه‌ها برای کامپایل کردن کلاینت‌ها

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

mysql_config options

توضیحات (DESCRIPTION)

mysql_config اطلاعات مفیدی را برای کامپایل کلاینت MySQL شما و اتصال آن به MySQL فراهم می‌کند. این ابزار یک اسکریپت شل است، بنابراین تنها در سیستم‌های یونیکس و شبه‌یونیکس در دسترس است.

نکته

pkg-config می‌تواند به عنوان جایگزینی برای mysql_config جهت دریافت اطلاعاتی مانند فلگ‌های کامپایلر یا کتابخانه‌های پیوند (link) مورد نیاز برای کامپایل برنامه‌های MySQL استفاده شود. برای اطلاعات بیشتر، ببینید: Building C API Client Programs Using pkg-config[1].

mysql_config از گزینه‌های زیر پشتیبانی می‌کند.

•--cflags فلگ‌های کامپایلر C برای یافتن فایل‌های include، فلگ‌های حیاتی کامپایلر و تعاریفی (defines) که هنگام کامپایل کتابخانه libmysqlclient استفاده شده‌اند. گزینه‌های بازگردانده شده وابسته به کامپایلر خاصی هستند که هنگام ایجاد کتابخانه به کار رفته است و ممکن است با تنظیمات کامپایلر شما تداخل داشته باشند. برای گزینه‌های سازگارتر که تنها شامل مسیرهای include هستند از --include استفاده کنید.

•--cxxflags مشابه --cflags، اما برای فلگ‌های کامپایلر C++.

•--include گزینه‌های کامپایلر برای یافتن فایل‌های include مربوط به MySQL.

•--libs کتابخانه‌ها و گزینه‌های مورد نیاز برای پیوند (link) با کتابخانه کلاینت MySQL.

•--libs_r کتابخانه‌ها و گزینه‌های مورد نیاز برای پیوند با کتابخانه کلاینت امن در برابر ریسه‌ها (thread-safe) در MySQL. در MySQL 9.7، تمام کتابخانه‌های کلاینت thread-safe هستند، بنابراین نیازی به استفاده از این گزینه نیست. گزینه --libs می‌تواند در تمام موارد استفاده شود.

•--plugindir نام مسیر پیش‌فرض دایرکتوری افزونه‌ها (plugin)، که هنگام پیکربندی MySQL تعریف شده است.

•--port شماره پورت پیش‌فرض TCP/IP، که هنگام پیکربندی MySQL تعریف شده است.

•--socket فایل سوکت پیش‌فرض یونیکس، که هنگام پیکربندی MySQL تعریف شده است.

•--variable=var_name نمایش مقدار متغیر پیکربندی مشخص‌شده. مقادیر مجاز برای var_name عبارتند از pkgincludedir (دایرکتوری فایل‌های سرآیند)، pkglibdir (دایرکتوری کتابخانه‌ها)، و plugindir (دایرکتوری افزونه‌ها).

•--version شماره نسخه توزیع MySQL.

اگر mysql_config را بدون هیچ گزینه‌ای اجرا کنید، فهرستی از تمامی گزینه‌های پشتیبانی‌شده و مقادیر آن‌ها را نمایش می‌دهد:

$> mysql_config
Usage: ./mysql_config [OPTIONS]
Compiler: GNU 10.4.0
Options:
  --cflags         [-I/usr/local/mysql/include/mysql]
  --cxxflags       [-I/usr/local/mysql/include/mysql]
  --include        [-I/usr/local/mysql/include/mysql]
  --libs           [-L/usr/local/mysql/lib/mysql -lmysqlclient -lpthread -ldl  
                    -lssl  -lcrypto -lresolv -lm -lrt]
  --libs_r         [-L/usr/local/mysql/lib/mysql -lmysqlclient -lpthread -ldl  
                    -lssl  -lcrypto -lresolv -lm -lrt]
  --plugindir      [/usr/local/mysql/lib/plugin]
  --socket         [/tmp/mysql.sock]
  --port           [3306]
  --version        [8.4.0]
  --variable=VAR   VAR is one of:
          pkgincludedir [/usr/local/mysql/include]
          pkglibdir     [/usr/local/mysql/lib]
          plugindir     [/usr/local/mysql/lib/plugin]

می‌توانید از mysql_config در خط فرمان با استفاده از علامت بک‌تیک (`) استفاده کنید تا خروجی تولید شده برای گزینه‌های خاص را در دستور قرار دهید. برای مثال، جهت کامپایل و پیوند دادن یک برنامه کلاینت MySQL، از mysql_config به صورت زیر استفاده کنید:

gcc -c `mysql_config --cflags` progname.c
gcc -o progname progname.o `mysql_config --libs`

کپی‌رایت و تکثیر (COPYRIGHT)

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

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

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

نکات (NOTES)

1.: ساخت برنامه‌های کلاینت C API با استفاده از pkg-config

https://dev.mysql.com/doc/c-api/9.7/en/c-api-building-clients-pkg-config.html

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

برای اطلاعات بیشتر، لطفاً به راهنمای مرجع MySQL مراجعه کنید، که ممکن است هم‌اکنون به صورت محلی نصب شده باشد و همچنین به صورت آنلاین در http://dev.mysql.com/doc در دسترس است.

نویسندگان (AUTHORS)

شرکت اوراکل (http://dev.mysql.com).