.TH "ODBC.INI" "5" "مه ۲۰۲۵" "unixodbc" "فایلهای پیکربندی"

.SH "نام (NAME)"
odbc.ini \- پرونده پیکربندی منابع داده ODBC (DSN)

.SH "توضیحات (DESCRIPTION)"
پروندههای \fI/etc/odbc.ini\fR و \fI~/.odbc.ini\fR منابع داده (Data Source Names - DSN) و پارامترهای اتصال درایورهای ODBC را تعریف میکنند.

.PP
.B /etc/odbc.ini
یک پرونده پیکربندی سراسری در سطح سیستم برای نام‌های منابع داده (DSN) در ODBC است.

.PP
.B $HOME/.odbc.ini
یک پرونده پیکربندی مختص هر کاربر برای نام‌های منابع داده (DSN) در ODBC است.

.PP
مسیرهای هر دو پرونده پیکربندی می‌توانند با گزینه‌های زمان ساخت \fIunixODBC\fR بازنویسی شوند. برای تعیین مسیرهای پیش‌فرض پرونده‌های پیکربندی در سیستم خود، دستور \fBodbcinst \-j\fR را اجرا کنید.

.SH "نکات (NOTES)"

.SS "قالب‌ها (Templates)"

بسیاری از درایورهای ODBC به همراه قالب‌های پرونده .ini ارائه می‌شوند. استفاده از \fBodbcinst\fR برای نصب این قالب‌ها توصیه می‌شود.

.SS "قالب پرونده (FILE FORMAT)"

پرونده \fBodbc.ini\fR از شیوه مرسوم شبه‌استاندارد \fIپرونده‌های ini\fR پیروی می‌کند که شامل یک یا چند \fB[سربرگ بخش]\fR است و در پی هر کدام صفر یا چند ویژگی به‌صورت \fBkey = value\fR (کلید = مقدار) قرار می‌گیرد.

.IP "بخش \fB[ODBC Data Sources]\fR" 4
این بخش اجباری، هر نام منبع داده (\fIDSN\fR) را به‌صورت یک کلید فهرست می‌کند. مقادیر متناظر با آن‌ها به عنوان توضیحات عمل می‌کنند. هر ورودی باید با یک \fB[بخش]\fR متناظر در پرونده ini که آن منبع داده را توصیف می‌کند همخوانی داشته باشد.

.IP "\fB[بخش]\fR نام منبع داده (Data Source Name)" 4
هر منبع داده با یک \fB[سربرگ بخش]\fR شناسایی می‌شود که همان نام DSN مورد استفاده توسط برنامه‌ها است. هر بخش تعریف DSN می‌تواند حاوی مقادیری برای کلیدهای زیر باشد:

.RS 4
.IP "\(bu Driver (\fBاجباری\fR)" 8
نام درایور ODBC جهت استفاده برای این DSN. این نام باید دقیقاً با \fB[نام بخش]\fR تعریف درایور که در \fBodbcinst.ini\fR ذخیره شده (و توسط \fBodbcinst \-q \-d\fR فهرست می‌شود) مطابقت داشته باشد.

.IP "\(bu Description" 8
توضیحات خوانا برای انسان درباره منبع داده.

.IP "\(bu Database" 8
نام یا شناسه پایگاه داده. معنای آن وابسته به درایور است و می‌تواند مسیر یک پرونده، مسیر سوکت یونیکس، شناسه‌ای مرتبط با نام سرور و غیره را مشخص کند.

.IP "\(bu Servername" 8
نام کارساز (سرور). معنای آن وابسته به درایور است اما معمولاً یک نام DNS، آدرس شبکه IP یا شناسه اکتشاف ویژه درایور را مشخص می‌کند.

.RE
برای مشاهده فهرست کامل پارامترهای پشتیبانی‌شده، به راهنمای مدیر سیستم با قالب HTML ارائه شده با \fIunixODBC\fR، مستندات درایور ODBC خود و هر قالب منبع داده ارائه‌شده توسط درایور مراجعه کنید.

.SH "مثال‌ها (EXAMPLES)"
یک نمونه پرونده پیکربندی \fBodbc.ini\fR در "Administrator Manual" همراه با \fIunixODBC\fR نشان داده شده است.

.SH "همچنین ببینید (SEE ALSO)"
.BR unixODBC (7),
.BR odbcinst (1),
.BR isql (1),
.BR iusql (1),
.BR odbcinst.ini (5)
.PP
"The \fIunixODBC\fB Administrator Manual (HTML)\fR"

.SH "نویسندگان (AUTHORS)"
نویسندگان unixODBC عبارتند از: Peter Harvey <\fIpharvey@codebydesign.com\fR> و Nick Gorham <\fInick@lurcher.org\fR>.

برای مشاهده فهرست کامل مشارکت‌کنندگان، به پرونده \fIAUTHORS\fR مراجعه کنید.

.SH "حق نشر (COPYRIGHT)"
پروژه unixODBC تحت مجوز GNU Lesser General Public License منتشر شده است. برای جزئیات مربوط به مجوز، به پرونده \fICOPYING\fR مراجعه فرمایید.