.\" cf. groff_mdoc
.Dd April 26, 2012
.Os FreeTDS 1.5.19
.Dt OSQL FreeTDS "راهنمای مرجع FreeTDS"
.\"
.Sh "نام (NAME)"
.Nm osql
.Nd ابزاری برای آزمایش اتصالات و پرس‌وجوهای FreeTDS
.\"
.Sh "خلاصه دستور (SYNOPSIS)"
.Pp
.Nm
.Fl S Ar dsn 
.Fl U Ar username
.Fl P Ar password
.Op Fl I Pa ini_directory
.\"
.Sh "توضیحات (DESCRIPTION)"
.Pp
.Nm
یک ابزار عیب‌یابی است که به عنوان بخشی از FreeTDS ارائه می‌شود. این ابزار یک
اسکریپت شل Bourne است که فایل‌های پیکربندی شما را بررسی کرده و درباره آن‌ها گزارش می‌دهد.
اگر همه موارد درست باشند، دستور isql را فراخوانی می‌کند.
.Pp
.Nm
تنها با نسخه‌ای از isql کار می‌کند که همراه با unixODBC ارائه می‌شود.
.\"
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width indent
.It Fl S Ar dsn
نام منبع داده (DSN) برای اتصال، همان‌طور که برای
.Pa odbc.ini
شناخته شده است.
.It Fl U Ar username
نام کاربری برای ورود به پایگاه داده.
.It Fl P Ar password
گذرواژه پایگاه داده.
.It Fl I Ar ini_dir
تعیین دستی مکان فایل
.Pa odbc.ini Ns .
.El
.\"
.Sh "مثال‌ها (EXAMPLES)"
اگر فایلی به نام
.Pa odbc.ini
با بخشی مشابه این دارید:
.Bd -literal -offset indent
.Bq myDSN
servername = myserver
TDS_Version = 5.0
.Ed
.Pp
می‌توانید
.Nm
را به این صورت فراخوانی کنید:
.Pp
.Li osql -S myDSN 
.Op .\|.\|.\&
.\"
.Sh "فایل‌ها (FILES)"
.Pa odbc.ini
.Pa freetds.conf
.\"
.Sh "نکات (NOTES)"
اگر بتوانید با
.Ql osql -S servername -U user -P passwd Ns
متصل شوید، یعنی نصب FreeTDS ODBC شما به درستی کار می‌کند.
.Pp
.Nm
با بررسی فایل باینری حدس می‌زند که unixODBC ممکن است کجا به دنبال
.Pa odbc.ini
خود بگردد. این رویکرد همیشه موثر نیست. اگر کار نکرد،
گزارشی از رشته‌های کاندید دریافت خواهید کرد. لطفاً خروجی را ارسال کنید
تا به بهبود این حدس زدن کمک شود.
.Pp
اگر
.Nm
نتواند دایرکتوری
.Pa odbc.ini
شما را تشخیص دهد، می‌توانید با استفاده از گزینهٔ
.Fl I
مسیر را اجبار کنید. با این حال، در این حالت شما به
.Nm
می‌گویید چه چیزی را آزمایش کند، نه این که unixODBC در نهایت کجا را جستجو خواهد کرد.
بنابراین بازنویسی دستی شما تنها به همان اندازه‌ای مطمئن است که خودتان اطمینان دارید.
پیش از اعمال تغییر دستی، خروجی خطا را با دقت بررسی کنید.
.Pp
اگر پیشنهادهایی دارید تا
.Nm
را به ابزار عیب‌یابی مفیدتری تبدیل کند، لطفاً آن‌ها را به فهرست ایمیل
FreeTDS ارسال فرمایید.
.\"
.Sh "تاریخچه (HISTORY)"
.Nm
نخستین بار در FreeTDS 0.65 ظاهر شد.
.\"
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
توسط
.An James K. Lowden Ns
نوشته شده است.