'\" t
.\"
.TH "\fBMARIADB-CLIENT-TEST\fR" "1" "5 March 2025" "MariaDB 11.8" "MariaDB Database System"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.\" mariadb-client-test
.\" mariadb-client-test-embedded
.SH "نام (NAME)"
mariadb-client-test \- ابزار آزمون رابط برنامه‌نویسی سمت کلاینت MariaDB
.br
mariadb-client-test-embedded \- ابزار آزمون رابط برنامه‌نویسی سمت کلاینت برای سرور تعبیه‌شده MariaDB
.br
mysql_client_test \- ابزار آزمون رابط برنامه‌نویسی سمت کلاینت MariaDB
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBmariadb-client-test\ [\fR\fB\fIگزینه‌ها\fR\fR\fB]\ [\fR\fB\fIنام_آزمون\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmariadb-client-test [\fR\fB\fIگزینه‌ها\fR\fR\fB] [\fR\fB\fIنام_آزمون\fR\fR\fB] \&.\&.\&.\fR
.HP \w'\fBmariadb-client-test-embedded\ [\fR\fB\fIگزینه‌ها\fR\fR\fB]\ [\fR\fB\fIنام_آزمون\fR\fR\fB]\ \&.\&.\&.\fR\ 'u
\fBmariadb-client-test-embedded [\fR\fB\fIگزینه‌ها\fR\fR\fB] [\fR\fB\fIنام_آزمون\fR\fR\fB] \&.\&.\&.\fR
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBmariadb-client-test\fR
برای آزمودن جنبه‌هایی از رابط برنامه‌نویسی کلاینت (Client API) پایگاه داده MariaDB به کار می‌رود که نمی‌توان آن‌ها را با استفاده از
\fBmariadb-test\fR
و زبان آزمون آن ارزیابی کرد\&. برنامه
\fBmariadb-client-test-embedded\fR
مشابه است اما برای آزمودن سرور تعبیه‌شده (Embedded Server) استفاده می‌شود\&. هر دو برنامه به عنوان بخشی از مجموعه آزمون‌های سیستمی اجرا می‌شوند\&.
.PP
کد منبع این برنامه‌ها را می‌توان در مسیر
tests/mariadb-client-test\&.c
در توزیع کد منبع یافت\&. این برنامه به عنوان یک منبع عالی از مثال‌ها جهت نشان دادن نحوه استفاده از ویژگی‌های مختلف رابط برنامه‌نویسی کلاینت عمل می‌کند\&.
.PP
برنامه
\fBmariadb-client-test\fR
در آزمونی با همین نام در مجموعه آزمون‌های اصلی
\fBmariadb\-test\-run\&.pl\fR
استفاده می‌شود، اما می‌توان آن را به صورت مستقیم نیز اجرا کرد\&. برخلاف دیگر برنامه‌های ذکرشده در اینجا، این ابزار توصیف خارجی از اینکه چه آزمون‌هایی باید اجرا شوند را نمی‌خواند\&. در عوض، تمام آزمون‌ها درون خود برنامه کدنویسی شده‌اند که برای پوشش دادن تمام جنبه‌های رابط برنامه‌نویسی زبان C نوشته شده است\&.
.PP
\fBmariadb-client-test\fR
از گزینه‌های زیر پشتیبانی می‌کند:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: help option
.\" help option: mariadb-client-test
\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
.\}
\fB\-\-basedir=\fR\fB\fIنام_پوشه\fR\fR,
.\" mariadb-client-test: basedir option
.\" basedir option: mariadb-client-test
\fB\-b \fR\fB\fIنام_پوشه\fR\fR
.sp
پوشه پایه برای آزمون‌ها\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-count=\fR\fB\fIتعداد\fR\fR,
.\" mariadb-client-test: count option
.\" count option: mariadb-client-test
\fB\-t \fR\fB\fIتعداد\fR\fR
.sp
تعداد دفعات اجرای آزمون‌ها\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: database option
.\" database option: mariadb-client-test
\fB\-\-database=\fR\fB\fIنام_دیتابیس\fR\fR,
\fB\-D \fR\fB\fIنام_دیتابیس\fR\fR
.sp
پایگاه داده‌ای که برای آزمون استفاده می‌شود\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: debug option
.\" debug option: mariadb-client-test
\fB\-\-debug[=\fR\fB\fIگزینه‌های_اشکال‌زدایی\fR\fR\fB]\fR,
\fB\-#[\fR\fB\fIگزینه‌های_اشکال‌زدایی\fR\fR\fB]\fR
.sp
در صورتی که MariaDB با پشتیبانی از اشکال‌زدایی ساخته شده باشد، لاگ اشکال‌زدایی را می‌نویسد\&. مقدار پیش‌فرض
\fIگزینه‌های_اشکال‌زدایی\fR
برابر با \(aqd:t:o,/tmp/mariadb-client-test.trace\(aq است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-getopt\-ll\-test=\fR\fB\fIگزینه\fR\fR,
.\" mariadb-client-test: getopt-ll-test option
.\" getopt-ll-test option: mariadb-client-test
\fB\-g \fR\fB\fIگزینه\fR\fR
.sp
گزینه‌ای برای آزمودن اشکالات در کتابخانه
getopt\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: host option
.\" host option: mariadb-client-test
\fB\-\-host=\fR\fB\fIنام_میزبان\fR\fR,
\fB\-h \fR\fB\fIنام_میزبان\fR\fR
.sp
اتصال به سرور MariaDB روی میزبان مشخص‌شده\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: password option
.\" password option: mariadb-client-test
\fB\-\-password[=\fR\fB\fIگذرواژه\fR\fR\fB]\fR,
\fB\-p[\fR\fB\fIگذرواژه\fR\fR\fB]\fR
.sp
گذرواژه‌ای که هنگام اتصال به سرور استفاده می‌شود\&. اگر از فرم کوتاه گزینه (\fB\-p\fR) استفاده می‌کنید،
\fIنباید\fR
بین گزینه و گذرواژه فاصله وجود داشته باشد\&. اگر مقدار
\fIگذرواژه\fR
را پس از گزینه
.\" mariadb-client-test: password option
.\" password option: mariadb-client-test
\fB\-\-password\fR
یا
\fB\-p\fR
در خط فرمان وارد نکنید، از شما خواسته می‌شود آن را وارد کنید\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: port option
.\" port option: mariadb-client-test
\fB\-\-port=\fR\fB\fIشماره_درگاه\fR\fR,
\fB\-P \fR\fB\fIشماره_درگاه\fR\fR
.sp
شماره درگاه TCP/IP برای برقراری اتصال\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-server\-arg=\fR\fB\fIآرگومان\fR\fR,
.\" mariadb-client-test: server-arg option
.\" server-arg option: mariadb-client-test
\fB\-A \fR\fB\fIآرگومان\fR\fR
.sp
آرگومانی برای ارسال به سرور تعبیه‌شده (Embedded Server)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-show\-tests\fR,
\fB\-T\fR
.sp
نمایش نام تمام آزمون‌ها\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: silent option
.\" silent option: mariadb-client-test
\fB\-\-silent\fR,
\fB\-s\fR
.sp
اجرا در حالت کم‌صدا (سکوت بیشتر و خروجی کمتر)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: socket option
.\" socket option: mariadb-client-test
\fB\-\-socket=\fR\fB\fIمسیر\fR\fR,
\fB\-S \fR\fB\fIمسیر\fR\fR
.sp
فایل سوکت مورد استفاده برای اتصال به
localhost
(که میزبان پیش‌فرض است)\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-\-testcase\fR,
\fB\-c\fR
.sp
این گزینه زمانی که از طریق
\fBmariadb\-test\-run\&.pl\fR
فراخوانی می‌شود به کار می‌رود، تا
\fBmariadb-client-test\fR
بتواند به صورت اختیاری رفتاری متفاوت از اجرای دستی داشته باشد، برای مثال با نادیده گرفتن برخی آزمون‌ها\&. در حال حاضر تفاوتی در رفتار وجود ندارد اما این گزینه برای امکان‌پذیر ساختن چنین قابلیتی گنجانده شده است\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
.\" mariadb-client-test: user option
.\" user option: mariadb-client-test
\fB\-\-user=\fR\fB\fIنام_کاربر\fR\fR,
\fB\-u \fR\fB\fIنام_کاربر\fR\fR
.sp
نام کاربری MariaDB برای استفاده هنگام اتصال به سرور\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fB\-v \fR\fB\fIنام_پوشه\fR\fR,
.\" mariadb-client-test: vardir option
.\" vardir option: mariadb-client-test
\fB\-\-vardir=\fR\fB\fIنام_پوشه\fR\fR
.sp
پوشه داده‌ها برای آزمون‌ها\&. پیش‌فرض
mariadb\-test/var
است\&.
.RE
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
.br
.PP
کپی‌رایت \(co 2007, 2010 متعلق به Oracle و/یا وابستگان آن، 2010-2025 متعلق به بنیاد MariaDB
.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 "نویسندگان (AUTHORS)"
بنیاد MariaDB (http://www.mariadb.org)\&.