.\" cf. groff_mdoc
.Dd March 25, 2015
.Os FreeTDS 1.5.19
.Dt TSQL FreeTDS "FreeTDS Reference Manual"
.Sh "نام (NAME)"
.Nm tsql
.Nd ابزاری برای آزمایش اتصالات و پرس‌وجوهای FreeTDS
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Bro
.Fl S Ar servername
.Op Fl I Ar interface
|
.Fl H Ar hostname
.Op Fl L
.Op Fl p Ar port
.Brc
.Op Fl D Ar dbname
.Op Fl U Ar username
.Op Fl P Ar password
.Op Fl o Ar options
.Nm
.Fl C
.Sh "توضیحات (DESCRIPTION)"
.Nm
یک ابزار عیب‌یابی FreeTDS است. این ابزار از پروتکل TDS برای اتصال به
Sybase یا Microsoft SQL Server استفاده می‌کند و به کاربر اجازه می‌دهد پرس‌وجوها را اجرا نماید.
.Nm
از کتابخانه‌های کلاینت FreeTDS استفاده
نمی‌کند؛ بلکه در عوض، تنها از پایین‌ترین سطح کتابخانه، یعنی libtds، برای آزمایش پیاده‌سازی پروتکل بهره می‌برد.
.Pp
.Nm
می‌تواند به دو روش اجرا شود: روشی که از freetds.conf استفاده می‌کند و روشی که
مستقیماً با استفاده از hostname و port سرور متصل می‌شود.
پارامترهای
.Fl H
و
.Fl p
برای این منظور ارائه شده‌اند که کاربر بتواند بررسی کند آیا سرور روی میزبان و درگاه نام‌برده در حال شنود است یا خیر. این پارامترها بر تمام فایل‌های پیکربندی
و متغیرهای محیطی اولویت دارند.
از پارامتر
.Fl S
می‌توان برای آزمایش پیکربندی محلی استفاده کرد. FreeTDS از
freetds.conf (یا معادل آن) و متغیرهای محیطی به روش معمول برای
تعیین آدرس IP و پورت سرور استفاده خواهد کرد. می‌توانید از
.Fl I
برای مشخص کردن نام فایل استفاده کنید که الگوریتم جستجوی فایل پیکربندی FreeTDS را نادیده می‌گیرد.
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width indent
.It Fl S Ar servername
سرور پایگاه داده برای اتصال.
.It Fl D Ar dbname
پایگاه داده برای استفاده.
.It Fl I Ar interface
فایل freetds.conf یا interfaces که servername را توصیف می‌کند.
.It Fl H Ar hostname
نام میزبان DNS سرور.
.It Fl p Ar port
درگاهی که SQL Server روی آن شنود می‌کند.
.It Fl U Ar username
نام کاربری ورود به پایگاه داده. اگر username ارائه نشود، برای اتصالات TDS 7+ تلاش برای ورود دامنه‌ای (domain login) صورت می‌گیرد.
.It Fl P Ar password
گذرواژه پایگاه داده.
.It Fl L
فهرست کردن نمونه‌های سرور مایکروسافت (همراه با
.Fl H Ns ).
.It Fl C
چاپ برخی از پارامترهای پیکربندی زمان کامپایل.
.It Fl o Ar options
اعمال گزینه‌های مشخص‌شده روی هر دستور.
.Bl -tag -width indent
.It Fl f
بدون پاورقی
.Bq تعداد نتایج
.It Fl h
بدون سرآیند
.Bq عناوین
.It Fl t
چاپ زمان
.It Fl v
چاپ نسخه
.It Fl q
حالت بی‌صدا
.El
.It Fl a Ar appname
نام برنامه.
.It Fl t Ar colterm
پایان‌دهنده ستون.
.It Fl r Ar rowterm
پایان‌دهنده سطر.
.It Fl r Ar rowterm
پایان‌دهنده سطر.
.It Fl J Ar charset
مجموعه نویسه‌ها.
.It Fl v
حالت پرگو (verbose).
.El
.\"
.Sh "نکات (NOTES)"
اگر بتوانید با
.Ql tsql -S servername
متصل شوید، پیکربندی پایه FreeTDS شما کار می‌کند.
.Pp
تایپ کردن
.Ql exit Ns ،
.Ql quit Ns ،
یا
.Ql bye
(یا
.Li ^D Ns )
از
.Nm
خارج می‌شود.
.Pp
تایپ کردن
.Ql version
نسخه پروتکل TDS را نمایش می‌دهد.
.Pp
دسته‌های دستورات را می‌توان با
.Ql go
یا
.Ql GO
از یکدیگر جدا کرد. در صورت استفاده از
.Ql GO Ns ،
رشته نسخه پیش از اجرای دسته گزارش داده می‌شود.
.Pp
پس از درخواست گذرواژه (اگر با
.Fl P
ارائه نشده باشد)،
.Nm
تلاش خواهد کرد به سرور راه دور متصل شود.
.Nm
شمارنده‌ای را نشان می‌دهد که تعداد ثانیه‌های سپری‌شده در طول تلاش برای برقراری اتصال را نمایش می‌دهد. معمولاً،
.Nm
بلافاصله با اعلان
.Ql 1>
پاسخ می‌دهد. اگر شمارنده (1، 2، 3، ...) را مشاهده کردید، به احتمال زیاد
.Nm
قادر به اتصال به سرور مشخص‌شده نیست.
.Pp
.Nm
جایگزینی برای یک isql کامل مانند sqsh (www.sqsh.org) نیست.
اگر پیشنهادهایی برای کاربردی‌تر کردن
.Nm
به عنوان یک ابزار عیب‌یابی دارید، لطفاً آن‌ها را برای بررسی به فهرست پستی FreeTDS ارسال کنید.
.Sh "تاریخچه (HISTORY)"
.Nm
نخستین بار در FreeTDS 0.60 ظاهر شد.
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
توسط
.An Brian Bruns
نوشته شده است.
.Sh "گزارش باگ‌ها (BUGS)"
مسلماً چندین مورد، حال که مستند شده است. :)