'\" t .\" Title: mysql_config_editor .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: 03/25/2026 .\" Manual: MySQL Database System .\" Source: MySQL 9.7 .\" Language: English .\" .TH "MYSQL_CONFIG_EDITOR" "1" "03/25/2026" "MySQL 9\&.7" "MySQL 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 * .\" ----------------------------------------------------------------- .SH "نام (NAME)" mysql_config_editor \- پیکربندی اطلاعات احراز هویت برای اتصال به سرور MySQL .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\fBmysql_config_editor\ \fR\fB\fIoptions\ command\fR\fR\ 'u \fBmysql_config_editor \fR\fB\fIoptions command\fR\fR .SH "توضیحات (DESCRIPTION)" .PP ابزار \fBmysql_config_editor\fR به شما امکان می‌دهد اطلاعات اعتباری احراز هویت را در یک فایل مسیر ورود (login path) مبهم‌سازی‌شده به نام \&.mylogin\&.cnf ذخیره کنید\&. مکان این فایل در ویندوز، دایرکتوری %APPDATA%\eMySQL و در سیستم‌های غیرویندوزی، دایرکتوری خانگی کاربر فعلی است\&. این فایل می‌تواند بعداً توسط برنامه‌های کلاینت MySQL خوانده شود تا اطلاعات احراز هویت لازم برای اتصال به MySQL Server را دریافت کنند\&. .PP قالب نامبهم فایل مسیر ورود \&.mylogin\&.cnf همانند سایر فایل‌های گزینه‌ها، از گروه‌های گزینه تشکیل شده است\&. هر گروه گزینه در \&.mylogin\&.cnf یک \(lqمسیر ورود\(rq (login path) نامیده می‌شود؛ گروهی که تنها گزینه‌های خاصی را مجاز می‌داند: \fBhost\fR، \fBuser\fR، \fBpassword\fR، \fBport\fR و \fBsocket\fR\&. یک گروه گزینه مسیر ورود را می‌توان مجموعه‌ای از گزینه‌ها در نظر گرفت که مشخص می‌کنند به کدام سرور MySQL متصل شوید و با کدام حساب کاربری احراز هویت را انجام دهید\&. در اینجا یک نمونه نامبهم آورده شده است: .sp .if n \{\ .RS 4 .\} .nf [client] user = mydefaultname password = mydefaultpass host = 127\&.0\&.0\&.1 [mypath] user = myothername password = myotherpass host = localhost .fi .if n \{\ .RE .\} .PP هنگامی که یک برنامه کلاینت را برای اتصال به سرور اجرا می‌کنید، کلاینت از \&.mylogin\&.cnf در کنار سایر فایل‌های گزینه استفاده می‌کند\&. اولویت این فایل از سایر فایل‌های گزینه بیشتر است، اما اولویت آن از گزینه‌هایی که صریحاً در خط فرمان کلاینت مشخص شده‌اند کمتر است\&. برای کسب اطلاعات درباره ترتیبی که فایل‌های گزینه استفاده می‌شوند، به بخش\ \&6.2.2.2، \(lqاستفاده از فایل‌های گزینه\(rq مراجعه کنید\&. .PP برای مشخص کردن نام فایلی جایگزین برای مسیر ورود، متغیر محیطی MYSQL_TEST_LOGIN_FILE را تنظیم کنید\&. این متغیر توسط \fBmysql_config_editor\fR، کلاینت‌های استاندارد MySQL (\fBmysql\fR، \fBmysqladmin\fR و غیره)، و ابزار آزمایشی \fBmysql\-test\-run\&.pl\fR شناخته می‌شود\&. .PP برنامه‌ها از گروه‌های موجود در فایل مسیر ورود به شکل زیر استفاده می‌کنند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} اگر گزینه \fB\-\-login\-path=\fR\fB\fIname\fR\fR را برای تعیین صریح مسیر ورود مشخص نکنید، \fBmysql_config_editor\fR به‌طور پیش‌فرض بر روی مسیر ورود client عملیات را انجام می‌دهد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} بدون گزینه \fB\-\-login\-path\fR، برنامه‌های کلاینت همان گروه‌های گزینه‌ای را از فایل مسیر ورود می‌خوانند که از سایر فایل‌های گزینه می‌خوانند\&. این دستور را در نظر بگیرید: .sp .if n \{\ .RS 4 .\} .nf mysql .fi .if n \{\ .RE .\} .sp به‌طور پیش‌فرض، کلاینت \fBmysql\fR گروه‌های [client] و [mysql] را از سایر فایل‌های گزینه می‌خواند، بنابراین آن‌ها را از فایل مسیر ورود نیز خواهد خواند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} با استفاده از گزینه \fB\-\-login\-path\fR، برنامه‌های کلاینت علاوه بر آن، مسیر ورود نام‌برده را نیز از فایل مسیر ورود می‌خوانند\&. گروه‌های گزینه‌ای که از سایر فایل‌های گزینه خوانده می‌شوند بدون تغییر می‌مانند\&. این دستور را در نظر بگیرید: .sp .if n \{\ .RS 4 .\} .nf mysql \-\-login\-path=mypath .fi .if n \{\ .RE .\} .sp کلاینت \fBmysql\fR گروه‌های [client] و [mysql] را از سایر فایل‌های گزینه، و گروه‌های [client]، [mysql] و [mypath] را از فایل مسیر ورود می‌خواند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} برنامه‌های کلاینت حتی هنگام استفاده از گزینه \fB\-\-no\-defaults\fR نیز فایل مسیر ورود را می‌خوانند، مگر اینکه \fB\-\-no\-login\-paths\fR تنظیم شده باشد\&. این قابلیت اجازه می‌دهد گذرواژه‌ها به روشی امن‌تر از خط فرمان مشخص شوند، حتی در صورت حضور \fB\-\-no\-defaults\fR\&. .RE .PP دستور \fBmysql_config_editor\fR فایل \&.mylogin\&.cnf را مبهم‌سازی می‌کند تا به صورت متن آشکار (cleartext) قابل خواندن نباشد، و محتویات آن پس از رفع ابهام توسط برنامه‌های کلاینت تنها در حافظه استفاده می‌شوند\&. به این ترتیب، گذرواژه‌ها می‌توانند به صورت غیرمتن آشکار در یک فایل ذخیره شده و بعداً بدون نیاز به نمایش در خط فرمان یا در یک متغیر محیطی مورد استفاده قرار گیرند\&. \fBmysql_config_editor\fR دستور print را برای نمایش محتویات فایل مسیر ورود فراهم می‌کند، اما حتی در این حالت نیز مقادیر گذرواژه ماسک می‌شوند تا به گونه‌ای که سایر کاربران بتوانند آن‌ها را ببینند نمایش داده نشوند\&. .PP مبهم‌سازی استفاده‌شده توسط \fBmysql_config_editor\fR از نمایش گذرواژه‌ها به صورت متن آشکار در \&.mylogin\&.cnf جلوگیری می‌کند و با ممانعت از افشای تصادفی گذرواژه، سطحی از امنیت را فراهم می‌آورد\&. به عنوان مثال، اگر یک فایل گزینه معمولی و نامبهم my\&.cnf را بر روی صفحه نمایش دهید، تمام گذرواژه‌های موجود در آن برای هر کسی قابل مشاهده است\&. در مورد \&.mylogin\&.cnf چنین نیست، اما مبهم‌سازی استفاده‌شده احتمالاً مانع یک مهاجم مصمم نخواهد شد و نباید آن را غیرقابل شکستن در نظر بگیرید\&. کاربری که بتواند به امتیازات مدیریت سیستم در دستگاه شما دست یابد تا به فایل‌هایتان دسترسی پیدا کند، می‌تواند با اندکی تلاش فایل \&.mylogin\&.cnf را رفع ابهام کند\&..PP فایل مسیر ورود (login path) باید برای کاربر جاری قابل خواندن و نوشتن باشد، و برای دیگر کاربران غیرقابل‌دسترس باشد\&. در غیر این صورت، \fBmysql_config_editor\fR آن را نادیده می‌گیرد و برنامه‌های کلاینت نیز از آن استفاده نمی‌کنند\&. .PP دستور \fBmysql_config_editor\fR را به این صورت فراخوانی کنید: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor [\fIprogram_options\fR] \fIcommand\fR [\fIcommand_options\fR] .fi .if n \{\ .RE .\} .PP اگر فایل مسیر ورود وجود نداشته باشد، \fBmysql_config_editor\fR آن را ایجاد می‌کند\&. .PP آرگومان‌های دستور به صورت زیر مشخص می‌شوند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIprogram_options\fR شامل گزینه‌های عمومی \fBmysql_config_editor\fR است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} command مشخص می‌کند که چه عملیاتی باید روی فایل مسیر ورود \&.mylogin\&.cnf انجام شود\&. برای نمونه، set یک مسیر ورود را در فایل می‌نویسد، remove یک مسیر ورود را حذف می‌کند، و print محتویات مسیر ورود را نمایش می‌دهد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIcommand_options\fR هرگونه گزینهٔ اضافی مختص به دستور، مانند نام مسیر ورود و مقادیری که باید در مسیر ورود استفاده شوند را مشخص می‌کند\&. .RE .PP موقعیت نام دستور در میان آرگومان‌های برنامه اهمیت دارد\&. برای نمونه، این خطوط فرمان آرگومان‌های یکسانی دارند، اما نتایج متفاوتی تولید می‌کنند: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor \-\-help set mysql_config_editor set \-\-help .fi .if n \{\ .RE .\} .PP خط فرمان اول یک پیام راهنمای عمومی \fBmysql_config_editor\fR را نمایش می‌دهد و دستور set را نادیده می‌گیرد\&. خط فرمان دوم پیام راهنمای اختصاصی دستور set را نمایش می‌دهد\&. .PP فرض کنید می‌خواهید یک مسیر ورود با نام client ایجاد کنید که پارامترهای اتصال پیش‌فرض شما را تعریف کند، و یک مسیر ورود دیگر با نام remote برای اتصال به سرور MySQL روی میزبان remote\&.example\&.com\&. شما می‌خواهید به شکل زیر وارد شوید: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} به‌طور پیش‌فرض، به سرور محلی با نام کاربری localuser و گذرواژهٔ localpass .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} به سرور راه دور با نام کاربری remoteuser و گذرواژهٔ remotepass .RE .PP برای تنظیم مسیرهای ورود در فایل \&.mylogin\&.cnf دستورهای set زیر را به کار ببرید\&. هر دستور را در یک خط وارد کرده و هنگام درخواست، گذرواژه‌های مربوطه را وارد کنید: .sp .if n \{\ .RS 4 .\} .nf $> \fBmysql_config_editor set \-\-login\-path=client \-\-host=localhost \-\-user=localuser \-\-password\fR Enter password: \fIenter password "localpass" here\fR $> \fBmysql_config_editor set \-\-login\-path=remote \-\-host=remote\&.example\&.com \-\-user=remoteuser \-\-password\fR Enter password: \fIenter password "remotepass" here\fR .fi .if n \{\ .RE .\} .PP \fBmysql_config_editor\fR به‌طور پیش‌فرض از مسیر ورود client استفاده می‌کند، بنابراین گزینهٔ \fB\-\-login\-path=client\fR می‌تواند بدون تغییر در نتیجه، از دستور اول حذف شود\&. .PP برای مشاهدهٔ آنچه \fBmysql_config_editor\fR در فایل \&.mylogin\&.cnf می‌نویسد، از دستور print استفاده کنید: .sp .if n \{\ .RS 4 .\} .nf $> \fBmysql_config_editor print \-\-all\fR [client] user = localuser password = ***** host = localhost [remote] user = remoteuser password = ***** host = remote\&.example\&.com .fi .if n \{\ .RE .\} .PP دستور print هر مسیر ورود را به صورت مجموعه‌ای از خطوط نمایش می‌دهد که با یک سربرگ گروهی حاوی نام مسیر ورود در کروشه آغاز می‌شود و به دنبال آن مقادیر گزینه‌های مربوط به مسیر ورود می‌آیند\&. مقادیر گذرواژه ماسک شده‌اند و به صورت متن آشکار نمایش داده نمی‌شوند\&. .PP اگر گزینهٔ \fB\-\-all\fR را برای نمایش تمام مسیرهای ورود یا \fB\-\-login\-path=\fR\fB\fIname\fR\fR را برای نمایش یک مسیر ورود با نام مشخص تعیین نکنید، دستور print در صورت وجود، به‌طور پیش‌فرض مسیر ورود client را نمایش می‌دهد\&. .PP همان‌طور که در مثال پیشین نشان داده شد، فایل مسیر ورود می‌تواند شامل چندین مسیر ورود باشد\&. به این ترتیب، \fBmysql_config_editor\fR تنظیم چندین \(lqهویت\(rq را برای اتصال به سرورهای مختلف MySQL، یا برای اتصال به یک سرور مشخص با استفاده از حساب‌های کاربری گوناگون آسان می‌کند\&. هر یک از این‌ها را می‌توان بعداً هنگام فراخوانی یک برنامهٔ کلاینت با استفاده از گزینهٔ \fB\-\-login\-path\fR بر اساس نام انتخاب کرد\&. برای نمونه، جهت اتصال به سرور راه دور، از این دستور استفاده کنید: .sp .if n \{\ .RS 4 .\} .nf mysql \-\-login\-path=remote .fi .if n \{\ .RE .\}.PP در اینجا، \fBmysql\fR گروه‌های گزینه‌ی [client] و [mysql] را از سایر فایل‌های گزینه، و گروه‌های [client]، [mysql] و [remote] را از فایل مسیر ورود (login path) می‌خواند\&. .PP برای اتصال به سرور محلی، از این دستور استفاده کنید: .sp .if n \{\ .RS 4 .\} .nf mysql \-\-login\-path=client .fi .if n \{\ .RE .\} .PP از آنجا که \fBmysql\fR به‌طور پیش‌فرض مسیرهای ورود client و mysql را می‌خواند، گزینهٔ \fB\-\-login\-path\fR در این حالت چیزی اضافه نمی‌کند\&. آن دستور معادل این دستور است: .sp .if n \{\ .RS 4 .\} .nf mysql .fi .if n \{\ .RE .\} .PP گزینه‌های خوانده‌شده از فایل مسیر ورود نسبت به گزینه‌های خوانده‌شده از سایر فایل‌های گزینه اولویت دارند\&. گزینه‌های خوانده‌شده از گروه‌های مسیر ورود که دیرتر در فایل مسیر ورود ظاهر می‌شوند، نسبت به گزینه‌های خوانده‌شده از گروه‌هایی که زودتر در فایل قرار دارند اولویت دارند\&. .PP دستور \fBmysql_config_editor\fR مسیرهای ورود را به ترتیبی که آنها را ایجاد می‌کنید به فایل مسیر ورود اضافه می‌کند، بنابراین باید ابتدا مسیرهای ورود عمومی‌تر و سپس مسیرهای خاص‌تر را ایجاد کنید\&. اگر نیاز به جابه‌جایی یک مسیر ورود درون فایل دارید، می‌توانید آن را حذف کرده و سپس مجدداً ایجاد کنید تا به انتهای فایل اضافه شود\&. برای مثال، مسیر ورود client عمومی‌تر است زیرا توسط تمام برنامه‌های کلاینت خوانده می‌شود، در حالی که مسیر ورود mysqldump تنها توسط \fBmysqldump\fR خوانده می‌شود\&. گزینه‌هایی که دیرتر مشخص می‌شوند جایگزین گزینه‌هایی می‌شوند که زودتر مشخص شده‌اند، بنابراین قرار دادن مسیرهای ورود به ترتیب client و mysqldump به گزینه‌های مختص \fBmysqldump\fR اجازه می‌دهد تا گزینه‌های client را بازنویسی کنند\&. .PP هنگامی که از دستور set به همراه \fBmysql_config_editor\fR برای ایجاد یک مسیر ورود استفاده می‌کنید، نیازی نیست تمامی مقادیر گزینه‌های ممکن (نام میزبان، نام کاربری، گذرواژه، پورت، سوکت) را مشخص کنید\&. فقط مقادیر داده‌شده در مسیر نوشته می‌شوند\&. هر مقدار مفقودی که بعداً مورد نیاز باشد را می‌توان هنگام فراخوانی مسیر کلاینت برای اتصال به سرور MySQL، چه در سایر فایل‌های گزینه یا در خط فرمان مشخص کرد\&. هر گزینه‌ای که در خط فرمان مشخص شود، بر گزینه‌های مشخص‌شده در فایل مسیر ورود یا سایر فایل‌های گزینه ارجحیت دارد\&. برای مثال، اگر اطلاعات اعتبارسنجی در مسیر ورود remote برای میزبان remote2\&.example\&.com نیز صدق کند، به این صورت به سرور روی آن میزبان متصل شوید: .sp .if n \{\ .RS 4 .\} .nf mysql \-\-login\-path=remote \-\-host=remote2\&.example\&.com .fi .if n \{\ .RE .\} .sp گزینه‌های عمومی mysql_config_editor .PP دستور \fBmysql_config_editor\fR از گزینه‌های عمومی زیر پشتیبانی می‌کند که می‌توانند پیش از هر دستوری که در خط فرمان مشخص شده استفاده شوند\&. برای توضیحات گزینه‌های مختص دستور، بخش دستورات و گزینه‌های مختص دستور mysql_config_editor را ببینید\&. .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR .TS allbox tab(:); lB l. T{ قالب خط فرمان T}:T{ --help T} .TE .sp 1 نمایش یک پیام راهنمای عمومی و خروج\&. .sp برای دیدن پیام راهنمای مختص به یک دستور، \fBmysql_config_editor\fR را به صورت زیر اجرا کنید، که در آن \fIcommand\fR دستوری غیر از help است: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor \fIcommand\fR \-\-help .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR, \fB\-# \fR\fB\fIdebug_options\fR\fR .TS allbox tab(:); lB l lB l lB l. T{ قالب خط فرمان T}:T{ --debug[=debug_options] T} T{ نوع T}:T{ String T} T{ مقدار پیش‌فرض T}:T{ d:t:o T} .TE .sp 1 نوشتن گزارش اشکال‌زدایی (debugging log)\&. یک رشتهٔ معمولی \fIdebug_options\fR به صورت d:t:o,\fIfile_name\fR است\&. مقدار پیش‌فرض d:t:o,/tmp/mysql_config_editor\&.trace می‌باشد\&. .sp این گزینه تنها در صورتی در دسترس است که MySQL با استفاده از \fBWITH_DEBUG\fR ساخته شده باشد\&. باینری‌های رسمی انتشار MySQL ارائه‌شده توسط Oracle با این گزینه ساخته \fIنشده‌اند\fR\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-verbose\fR, \fB\-v\fR .TS allbox tab(:); lB l. T{ قالب خط فرمان T}:T{ --verbose T} .TE .sp 1 حالت پرگو (verbose)\&. چاپ اطلاعات بیشتر دربارهٔ آنچه برنامه انجام می‌دهد\&. این گزینه ممکن است در عیب‌یابی مشکلات در صورتی که یک عملیات نتیجهٔ مورد انتظار شما را نداشته باشد، مفید باشد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-version\fR, \fB\-V\fR .TS allbox tab(:); lB l. T{ قالب خط فرمان T}:T{ --version T} .TE .sp 1 نمایش اطلاعات نسخه و خروج\&. .RE دستورات و گزینه‌های مختص دستور mysql_config_editor.PP این بخش دستورات مجاز \fBmysql_config_editor\fR و برای هر یک، گزینه‌های مختص آن دستور را که می‌توان پس از نام دستور در خط فرمان آورد، شرح می‌دهد\&. .PP علاوه بر این، \fBmysql_config_editor\fR از گزینه‌های عمومی که می‌توانند پیش از هر دستوری استفاده شوند نیز پشتیبانی می‌کند\&. برای مشاهده توضیحات این گزینه‌ها، به بخش گزینه‌های عمومی mysql_config_editor مراجعه کنید\&. .PP \fBmysql_config_editor\fR از این دستورات پشتیبانی می‌کند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} help .sp نمایش یک پیام راهنمای عمومی و خروج\&. این دستور هیچ گزینه‌ای در ادامه نمی‌پذیرد\&. .sp برای مشاهده پیام راهنمای مختص یک دستور، \fBmysql_config_editor\fR را به صورت زیر اجرا کنید که در آن \fIcommand\fR دستوری غیر از help است: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor \fIcommand\fR \-\-help .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} print [\fIoptions\fR] .sp چاپ محتویات فایل مسیر ورود (login path) به شکل آشکار و غیرمبهم، با این استثنا که گذرواژه‌ها به صورت ***** نمایش داده می‌شوند\&. .sp در صورتی که هیچ مسیر ورودی تعیین نشود، نام پیش‌فرض مسیر ورود client است\&. اگر هر دو گزینه \fB\-\-all\fR و \fB\-\-login\-path\fR داده شوند، \fB\-\-all\fR اولویت خواهد داشت\&. .sp دستور print این گزینه‌ها را در ادامه نام دستور مجاز می‌داند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR .sp نمایش پیام راهنما برای دستور print و خروج\&. .sp برای مشاهده پیام راهنمای عمومی، از \fBmysql_config_editor \-\-help\fR استفاده کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-all\fR .sp چاپ محتویات تمام مسیرهای ورود در فایل مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-login\-path=\fR\fB\fIname\fR\fR, \fB\-G \fR\fB\fIname\fR\fR .sp چاپ محتویات مسیر ورود نام‌برده شده\&. .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} remove [\fIoptions\fR] .sp حذف یک مسیر ورود از فایل مسیر ورود، یا ویرایش یک مسیر ورود از طریق حذف گزینه‌ها از آن\&. .sp این دستور تنها آن دسته از گزینه‌هایی را از مسیر ورود حذف می‌کند که با گزینه‌های \fB\-\-host\fR، \fB\-\-password\fR، \fB\-\-port\fR، \fB\-\-socket\fR و \fB\-\-user\fR مشخص شده باشند\&. اگر هیچ‌یک از این گزینه‌ها مشخص نشوند، remove کل مسیر ورود را حذف می‌کند\&. برای مثال، این دستور تنها گزینه \fBuser\fR را از مسیر ورود mypath حذف می‌کند نه کل مسیر ورود mypath را: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor remove \-\-login\-path=mypath \-\-user .fi .if n \{\ .RE .\} .sp این دستور کل مسیر ورود mypath را حذف می‌کند: .sp .if n \{\ .RS 4 .\} .nf mysql_config_editor remove \-\-login\-path=mypath .fi .if n \{\ .RE .\} .sp دستور remove این گزینه‌ها را در ادامه نام دستور مجاز می‌داند: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR .sp نمایش پیام راهنما برای دستور remove و خروج\&. .sp برای مشاهده پیام راهنمای عمومی، از \fBmysql_config_editor \-\-help\fR استفاده کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-host\fR, \fB\-h\fR .sp حذف نام میزبان (host name) از مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1.IP \(bu 2.3 .\} \fB\-\-login\-path=\fR\fB\fIname\fR\fR, \fB\-G \fR\fB\fIname\fR\fR .sp مسیر ورود (login path) جهت حذف یا تغییر\&. در صورت مشخص نشدن این گزینه، نام مسیر ورود پیش‌فرض client است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-password\fR, \fB\-p\fR .sp حذف گذرواژه از مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-port\fR, \fB\-P\fR .sp حذف شماره درگاه TCP/IP از مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-socket\fR, \fB\-S\fR .sp حذف نام فایل سوکت یونیکس از مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-user\fR, \fB\-u\fR .sp حذف نام کاربری از مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-warn\fR, \fB\-w\fR .sp در صورتی که دستور تلاش کند مسیر ورود پیش‌فرض (client) را حذف کند و \fB\-\-login\-path=client\fR مشخص نشده باشد، هشدار داده و از کاربر تاییدیه می‌گیرد\&. این گزینه به‌طور پیش‌فرض فعال است؛ از \fB\-\-skip\-warn\fR برای غیرفعال کردن آن استفاده کنید\&. .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} reset [\fIoptions\fR] .sp خالی کردن محتویات فایل مسیر ورود\&. .sp دستور reset گزینه‌های زیر را پس از نام دستور می‌پذیرد: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR .sp نمایش پیام راهنما برای دستور reset و خروج\&. .sp برای دیدن پیام راهنمای کلی، از \fBmysql_config_editor \-\-help\fR\& استفاده کنید\&. .RE .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} set [\fIoptions\fR] .sp نوشتن یک مسیر ورود در فایل مسیر ورود\&. .sp این دستور تنها گزینه‌هایی را در مسیر ورود می‌نویسد که با گزینه‌های \fB\-\-host\fR، \fB\-\-password\fR، \fB\-\-port\fR، \fB\-\-socket\fR و \fB\-\-user\fR مشخص شده باشند\&. اگر هیچ‌یک از این گزینه‌ها داده نشوند، \fBmysql_config_editor\fR مسیر ورود را به عنوان یک گروه خالی می‌نویسد\&. .sp دستور set گزینه‌های زیر را پس از نام دستور می‌پذیرد: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-help\fR, \fB\-?\fR .sp نمایش پیام راهنما برای دستور set و خروج\&. .sp برای دیدن پیام راهنمای کلی، از \fBmysql_config_editor \-\-help\fR\& استفاده کنید\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-host=\fR\fB\fIhost_name\fR\fR, \fB\-h \fR\fB\fIhost_name\fR\fR .sp نام میزبان برای نوشتن در مسیر ورود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-login\-path=\fR\fB\fIname\fR\fR, \fB\-G \fR\fB\fIname\fR\fR .sp مسیر ورود برای ایجاد\&. در صورت مشخص نشدن این گزینه، نام مسیر ورود پیش‌فرض client است\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1.IP \(bu 2.3 .\} \fB\-\-password\fR, \fB\-p\fR .sp درخواست یک گذرواژه برای نوشتن در login path\&. پس از اینکه \fBmysql_config_editor\fR اعلان را نمایش داد، گذرواژه را تایپ کرده و کلید Enter را فشار دهید\&. برای جلوگیری از مشاهدهٔ گذرواژه توسط کاربران دیگر، \fBmysql_config_editor\fR آن را بازتاب (echo) نمی‌دهد\&. .sp برای مشخص کردن یک گذرواژهٔ خالی، در اعلان گذرواژه کلید Enter را فشار دهید\&. login path حاصل که در فایل login path نوشته می‌شود، شامل خطی مانند این خواهد بود: .sp .if n \{\ .RS 4 .\} .nf password = .fi .if n \{\ .RE .\} .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-port=\fR\fB\fIport_num\fR\fR, \fB\-P \fR\fB\fIport_num\fR\fR .sp شماره درگاه TCP/IP برای نوشتن در login path\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-socket=\fR\fB\fIfile_name\fR\fR, \fB\-S \fR\fB\fIfile_name\fR\fR .sp نام فایل سوکت Unix برای نوشتن در login path\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-user=\fR\fB\fIuser_name\fR\fR, \fB\-u \fR\fB\fIuser_name\fR\fR .sp نام کاربری برای نوشتن در login path\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fB\-\-warn\fR, \fB\-w\fR .sp در صورتی که دستور قصد بازنویسی یک login path موجود را داشته باشد، هشدار داده و از کاربر تایید می‌خواهد\&. این گزینه به‌طور پیش‌فرض فعال است؛ برای غیرفعال کردن آن از \fB\-\-skip\-warn\fR استفاده کنید\&. .RE .RE .SH "کپی‌رایت و تکثیر (COPYRIGHT)" .br .PP کپی‌رایت \(co 1997, 2026 متعلق به Oracle و/یا شرکت‌های وابسته به آن است\&. .PP این مستندات نرم‌افزار آزاد است؛ شما می‌توانید آن را تنها تحت شرایط مجوز عمومی همگانی گنو (GNU General Public License) همان‌طور که توسط بنیاد نرم‌افزارهای آزاد منتشر شده است، بازتوزیع کرده و/یا تغییر دهید؛ نسخهٔ ۲ مجوز\&. .PP این مستندات با این امید که مفید باشد توزیع شده است، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابل فروش بودن یا مناسب بودن برای یک هدف خاص\&. برای جزئیات بیشتر به مجوز عمومی همگانی گنو مراجعه کنید\&. .PP شما باید به همراه این برنامه نسخه‌ای از مجوز عمومی همگانی گنو را دریافت کرده باشید؛ در غیر این صورت، به بنیاد نرم‌افزارهای آزاد به نشانی 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA بنویسید یا به http://www.gnu.org/licenses مراجعه کنید\&. .sp .SH "همچنین ببینید (SEE ALSO)" برای اطلاعات بیشتر، لطفاً به کتابچه راهنمای مرجع MySQL مراجعه کنید که ممکن است از قبل به‌صورت محلی نصب شده باشد و همچنین به‌صورت آنلاین در http://dev.mysql.com/doc در دسترس است\&. .SH "نویسندگان (AUTHORS)" شرکت Oracle (http://dev.mysql.com)\&.