نام (NAME)

odbcinst.ini - فایل پیکربندی درایورهای ODBC unixODBC

توضیحات (DESCRIPTION)

/etc/odbcinst.ini یک فایل پیکربندی برای درایورهای unixODBC است.

این فایل را می‌توان با استفاده از ابزار odbcinst (روش توصیه‌شده) به‌روزرسانی کرد یا با دست ویرایش نمود.

قالب فایل (FILE FORMAT)

قالب کلی فایل‌های .ini به این صورت است:

[SectionName1]
key1 = value1
key2 = value2
...
[SectionName2]
key1 = value1
key2 = value2
...

هر درایور ODBC بخش مخصوص به خود را دارد و می‌توان در فایل‌هایی مانند odbc.ini با نام آن بخش به آن ارجاع داد. درون هر بخش، unixODBC همچنین کلیدهای پیکربندی زیر را تشخیص می‌دهد:

Description: یک رشته متنی که درایور را به طور خلاصه توصیف می‌کند.
Driver: مسیر سیستم فایل به کتابخانه اصلی درایور.
Setup: مسیر سیستم فایل به کتابخانه راه‌اندازی (setup) درایور.
FileUsage: بخش با نام [ODBC] گزینه‌های عمومی را پیکربندی می‌کند. کلیدهایی که در بخش [ODBC] تشخیص داده می‌شوند عبارتند از:

Trace: خروجی ردگیری (trace) درایور ODBC را فعال می‌کند، که در مسیر فایل مشخص‌شده توسط TraceFile نوشته می‌شود.

برخی از درایورهای ODBC گزینه‌های کنترل ردگیری مخصوص به خود را دارند. برخلاف گزینه Trace، این گزینه‌های مجزا معمولاً در سطح «نام منبع داده» (DSN) مشخص می‌شوند.

در صورتی که مقدار متناظر شامل هر شکلی از حروف کوچک و بزرگ «1»، «y»، «yes» یا «on» باشد، Trace فعال خواهد شد.

TraceFile: مسیر سیستمی یا الگوی مسیری را که خروجی ردگیری درایور ODBC در آن نوشته خواهد شد مشخص می‌کند. این گزینه تا زمانی که Trace فعال نباشد هیچ اثری ندارد. مکان پیش‌فرض فایل برای خروجی ردگیری /tmp/sql.log است.

هشدار: تنظیم کردن TraceFile روی مسیری که توسط چندین کاربر قابل نوشتن باشد ممکن است به درستی کار نکند، چرا که فقط اولین کاربر قادر به ایجاد و باز کردن فایل خواهد بود.

فایل‌های الگو (TEMPLATE FILES)

بسیاری از درایورهای ODBC همراه با الگوهای فایل .ini ارائه می‌شوند که می‌توان آن‌ها را با استفاده از ابزار odbcinst نصب کرد.

فایل‌های الگو از همان قالب odbcinst.ini استفاده می‌کنند.

مثال‌ها (EXAMPLES)

برای نصب درایور PostgreSQL برای unixODBC، پیکربندی زیر را می‌توان در odbcinst.ini وارد کرد:

[PostgreSQL]
Description = PostgreSQL driver for GNU/Linux
Driver      = /usr/lib/psqlodbcw.so
Setup       = /usr/lib/libodbcpsqlS.so
FileUsage   = 1

مسیرهای درایور بسته به سیستم‌عامل شما و اینکه آیا توزیع شما از قابلیت چندمعماری (multi-arch) پشتیبانی می‌کند، می‌تواند متغیر باشد. برخی از درایورها همچنین به ورودی‌های Driver64 و Setup64 نیاز دارند.

بخش بالا می‌تواند در odbc.ini به صورت زیر مورد ارجاع قرار گیرد:

Driver = PostgreSQL

روش توصیه‌شده برای افزودن درایور PostgreSQL به سیستم شما، ایجاد یک فایل الگو شامل موارد زیر است:

[PostgreSQL]
Description = PostgreSQL driver for GNU/Linux
Driver      = /usr/lib/psqlodbcw.so
Setup       = /usr/lib/libodbcpsqlS.so

و فراخوانی odbcinst به صورت زیر:

# odbcinst -i -d -f template.ini

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

unixODBC(7), odbcinst(1), odbc.ini(5)

«راهنمای مدیر سیستم unixODBC (HTML)»

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

نویسندگان unixODBC عبارتند از Peter Harvey <pharvey@codebydesign.com> و Nick Gorham <nick@lurcher.org>.

برای مشاهده فهرست کامل مشارکت‌کنندگان، به فایل AUTHORS مراجعه کنید.

حق نشر (COPYRIGHT)

نرم‌افزار unixODBC تحت مجوز عمومی همگانی کمتر گنو (GNU LGPL) منتشر شده است. برای جزئیات درباره مجوز، به فایل COPYING مراجعه کنید.