.Dd May 2, 2017
.Os FreeTDS 1.5.19
.Dt FREETDS.CONF "FreeTDS 5" "FreeTDS Reference Manual"
.
.Sh "نام (NAME)"
.Nm freetds.conf
.Nd پرونده پیکربندی برای FreeTDS
.
.Sh "خلاصه دستور (SYNOPSIS)"
پرونده
.Pa freetds.conf
سرورهای پایگاه داده Sybase و Microsoft را برای کتابخانه FreeTDS توصیف می‌کند.
این پرونده شامل بخش‌هایی است که با یک servername (نام سرور) در سربرگ آغاز می‌شوند و با فهرستی از ویژگی‌های اتصال به صورت جفت‌های نام\-مقدار دنبال می‌گردند.
پیش‌فرض‌ها از طریق بخش
.Bq global
تعریف می‌شوند.
این پرونده جایگزین پرونده
.Pa interfaces
می‌شود که Sybase برای همین هدف تعریف کرده است، هرچند پرونده اخیر هنوز پشتیبانی می‌شود.
.
.Sh "توضیحات (DESCRIPTION)"
یک بخش با یک servername \(em نام سرور \(em درون براکت آغاز می‌شود.
نام سرور به صلاحدید کلاینت انتخاب می‌شود.
(یک استثنا: در Sybase ASA، نام سرور باید با نام پایگاه داده مورد استفاده مطابقت داشته باشد.)
.Pp
بخش‌ها شامل ویژگی‌ها هستند، هر کدام در یک سطر، به شکل:
.Pp
.Dl       name = value
.Pp
که در آن
.Ar name
ویژگی اتصالی است که باید توصیف شود.
نام سرورها و ویژگی‌ها به حروف بزرگ و کوچک حساس نیستند.
مقادیر با حفظ حالت حروف نگهداری می‌شوند؛ یعنی دقیقاً کپی می‌شوند.
توضیحات با نقطه\-ویرگول
.Pq So ; Sc
یا علامت هش/پوند
.Pq So # Sc
شروع می‌شوند و تا انتهای سطر ادامه می‌یابند.
سطرهای خالی نادیده گرفته می‌شوند.
فاصله‌های خالی در دو طرف
.So = Sc
نادیده گرفته می‌شوند.
.
.Sh "ویژگی‌ها (PROPERTIES)"
.Bl -tag -width "emulate little endian" -compact
.
.It client charset
کدگذاری داده‌های کلاینت؛ تنظیمات
.Xr locale 1
را بازنویسی می‌کند
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
نام‌های مجموعه نویسه iconv
.It پیش‌فرض:
ISO\-8859\-1
.El
.
.It connect timeout
تعداد ثانیه‌های انتظار برای دریافت پاسخ از درخواست اتصال
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
0 تا MAX_INT
.It پیش‌فرض:
هیچ (none)
.El
.
.It debug flags
میزان جزئیات گزارش وقایع (logging)
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
عدد صحیح ۳۲\-بیتی
.It پیش‌فرض:
0x4fff
.El
.
.It dump file
مکان پرونده گزارش (logfile) را تعیین کرده و ثبت گزارش را فعال می‌کند
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
نام پرونده معتبر
.It پیش‌فرض:
هیچ (none)
.El
.
.It dump file append
داده‌های وقایع به جای بازنویسی در هر اتصال، به انتهای پرونده پیوست می‌شوند
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
yes/no
.It پیش‌فرض:
no
.El
.
.It emulate little endian
دستگاه‌های Big\-Endian را مجبور می‌کند تا مانند Little\-Endian برای ارتباط با سرورهای Microsoft رفتار کنند
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
yes/no
.It پیش‌فرض:
no
.El
.
.It encryption
.Bl -tag -compact
.It Em off
رمزنگاری را غیرفعال می‌کند
.It Em request
در صورت دردسترس بودن استفاده شود (پیش‌فرض هنگام بالاتر بودن نسخه tds از 7.0)
.It Em required
فقط به اتصالات رمزنگاری‌شده اجازه اتصال می‌دهد
.El
.
.It host
نام میزبانی که سرور روی آن در حال اجرا است.
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
نام میزبان یا نشانی IP
.It پیش‌فرض:
SYBASE
.El
.
.It initial block size
حداکثر اندازه یک بلوک پروتکل
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
مضربی از ۵۱۲
.It پیش‌فرض:
512
.El
.
.It instance
نام نمونه (instance) سرور Microsoft SQL Server برای اتصال به آن (جایگزین
.Em port
می‌شود)
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
نام نمونه (instance name)
.It پیش‌فرض:
هیچ (none)
.El
.
.It port
شماره درگاهی (port) که سرور روی آن به درخواست‌ها گوش می‌دهد
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
هر درگاه معتبر
.It پیش‌فرض:
برای TDS 5.0 مقدار 5000؛ برای TDS 7.0 و بالاتر مقدار 1433
.El
.
.It tds version
نسخه پروتکل TDS برای استفاده
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
4.2, 5.0, 7.0, 7.1, 7.2
.It پیش‌فرض:
مقدار
.Fl \-with\-tdsver
(در صورت نامشخص بودن، 5.0)
.El
.
.It text size
مقدار پیش‌فرض TEXTSIZE، بر حسب بایت
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
0 تا 4,294,967,295
.It پیش‌فرض:
4,294,967,295
.El
.
.It timeout
تعداد ثانیه‌های انتظار برای پاسخ به یک پرس‌وجو (query)
.Bl -tag -width "پیش‌فرض:" -compact
.It دامنه:
0 تا MAX_INT
.It پیش‌فرض:
هیچ (none، انتظار نامحدود)
.El
.
.El
.Pp
هرگز هر دو مورد
.Fa port
و
.Fa instance Ns
\& را همزمان تعریف نکنید. یکی مستلزم دیگری است.
.Pp
مقادیر ویژگی‌های بولی می‌توانند به صورت on/off، true/false یا 1/0 مشخص شوند.
.
.Ss "پرچم‌های اشکال‌زدایی (DEBUG FLAGS)"
میزان جزئیات گزارش را می‌توان با ویژگی
.Em debug flags
کنترل کرد.
.Bl -column -offset indent ".Sy 0x8000" ".Sy نمایش اطلاعات سطح سورس (پرونده منبع و خط)"
.It Sy مقدار Ta Sy مفهوم
.It Li \ \ 0x02	خطای وخیم (severe error)
.It Li \ \ 0x04	خطا (error)
.It Li \ \ 0x08	هشدار (warning)
.It Li \ \ 0x10	شبکه (network)
.It Li \ \ 0x20	اطلاعات سطح ۱ (information level 1)
.It Li \ \ 0x40	اطلاعات سطح ۲ (information level 2)
.It Li \ \ 0x80	ردیابی تابع و اطلاعات (function trace and info)
.It Li 0x1000	نمایش شناسه فرآیند (show pid)
.It Li 0x2000	نمایش زمان (show time)
.It Li 0x4000	نمایش اطلاعات سطح سورس (پرونده منبع و شماره خط)
.It Li 0x8000	شناسه ریسه (پیاده‌سازی نشده است).
.El
.
.Sh "نام‌ها و مکان‌ها (NAMES AND LOCATIONS)"
این پرونده معمولاً به نام
.Pa /etc/freetds.conf
یا
.Pa ${HOME}/.freetds.conf
شناخته می‌شود.
این نام را می‌توان با استفاده از متغیر محیطی FREETDSCONF بازنویسی کرد.
.Pp
مجموعه FreeTDS پرونده‌های پیکربندی را برای یافتن نام سرور (servername) به ترتیب زیر جستجو خواهد کرد:
.Bl -enum -offset indent -compact
.It
نام پرونده‌ای که از طریق ()dbsetifile به صورت برنامه‌نویسی‌شده مشخص شده و در قالب conf. باشد
.It
نام پرونده‌ای در متغیر محیطی FREETDSCONF که در قالب conf. باشد
.It
.Pa ${HOME}/.freetds.conf
در صورت وجود
.It
.Pa /etc/freetds/freetds.conf
.El
.Pp
جستجو با اولین پرونده‌ای که شامل نام سرور باشد متوقف می‌شود.
.Pp
اگر هیچ پرونده پیکربندی با پسوند conf پیدا نشود، FreeTDS به دنبال یک پرونده
.Pa interfaces
به ترتیب زیر می‌گردد:
.Bl -enum -offset indent -compact
.It
نام پرونده‌ای که از طریق ()dbsetifile به صورت برنامه‌نویسی‌شده مشخص شده و در قالب
.Pa interfaces
باشد
.It
.Pa ${HOME}/.interfaces
.It
.Pa $SYBASE/interfaces
(که در آن
.Ev $SYBASE
یک متغیر محیطی است)
.El
.Pp
اگر نام سرور درخواستی در هیچ پرونده پیکربندی یافت نشود، سازوکار بازگشتی (fallback) به این ترتیب است:
.Bl -enum -offset indent -compact
.It
تلاش برای تبدیل نام به یک نشانی IP با
.Xr inet_addr 3 ،
در غیر این صورت
.It
تلاش برای تبدیل نام به یک نشانی IP با
.Xr gethostbyname 3 ،
در غیر این صورت
.It
تلاش برای جستجوی نام لفظی
.Dq SYBASE
.El
.
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width "TDSDUMPCONFIG" -compact
.It Ev FREETDSCONF
نام و مکان پرونده پیکربندی سراسری سیستم را بازنویسی می‌کند
.It Ev TDSDUMP
نام و مکان پرونده گزارش FreeTDS را بازنویسی می‌کند
.It Ev TDSDUMPCONFIG
نام و مکان پرونده‌ای را مشخص می‌کند که جستجوی پرونده‌های پیکربندی را ثبت می‌کند
.It Ev TDSHOST
ویژگی host را بازنویسی می‌کند
.It Ev TDSPORT
ویژگی port را بازنویسی می‌کند
.It Ev TDSQUERY
مترادفی برای DSQUERY، نام سرور پیش‌فرض
.It Ev TDSVER
نسخه مشخص‌شده در freetds.conf را بازنویسی می‌کند
.El
.Pp
متغیرهای محیطی
.Ev TDSVER ,
.Ev TDSDUMP ,
.Ev TDSPORT ,
.Ev TDSQUERY
و
.Ev TDSHOST
مقادیر تنظیم‌شده توسط یک پرونده conf. یا
.Pa interfaces
را بازنویسی می‌کنند.
.
.Sh "فایل‌ها (FILES)"
.Pa /etc/freetds/freetds.conf , ${HOME}/.freetds.conf
.
.Sh "همچنین ببینید (SEE ALSO)"
.%B FreeTDS User Guide
.
.Sh "تاریخچه (HISTORY)"
پرونده‌های conf. نخستین بار در نسخه 0.53 از FreeTDS پدیدار شدند.