.\" cf. groff_mdoc
.Dd March 25, 2015
.Os FreeTDS 1.5.19
.Dt BSQLODBC FreeTDS "FreeTDS Reference Manual"
.\"
.Sh "نام (NAME)"
.Nm bsqlodbc
.Nd پردازشگر دسته‌ای اسکریپت‌های SQL با استفاده از ODBC
.\"
.Sh "خلاصه دستور (SYNOPSIS)"
.Pp
.Nm
.Op Fl hqv
.Op Fl U Ar username
.Op Fl P Ar password
.Op Fl S Ar server
.Op Fl D Ar database
.Op Fl i Ar input_file
.Op Fl o Ar output_file
.Op Fl e Ar error_file
.Op Fl t Ar field_term
.Op Fl V Ar odbc_version
.\"
.Sh "توضیحات (DESCRIPTION)"
.Pp
.Nm
یک برنامه کاربردی توزیع‌شده همراه با FreeTDS است.
.Pp
.Nm
معادل غیرتعاملی برنامه‌های ابزاری
.Ql isql
توزیع‌شده توسط Sybase و Microsoft است. مانند آن‌ها،
.Nm
از دستور
.Ql go
در یک خط به تنهایی به عنوان جداکننده بین دسته‌ها (batches) استفاده می‌کند. الزامی نیست که پس از آخرین دسته حتماً
.Ql go
بیاید.
.Pp
.Nm
از API مربوط به ODBC ارائه‌شده توسط FreeTDS بهره می‌گیرد. این API طبیعتاً در دسترس توسعه‌دهندگان برنامه‌ها نیز قرار دارد.
.\"
.Sh "گزینه‌ها (OPTIONS)"
.Bl -tag -width indent
.It Fl U Ar username
نام کاربری ورود به سرور پایگاه‌داده.
.It Fl P Ar password
رمز عبور سرور پایگاه‌داده.
.It Fl S Ar server
سرور پایگاه‌داده جهت اتصال به آن.
.It Fl D Ar database
پایگاه‌داده مورد استفاده.
.It Fl i Ar input_file
نام فایل اسکریپت، حاوی دستورات SQL.
.It Fl o Ar output_file
نام فایل خروجی، نگه‌دارنده داده‌های حاصل از نتیجه.
.It Fl e Ar error_file
نام فایل مخصوص خطاها.
.It Fl t Ar field_term
پایان‌دهنده فیلد را مشخص می‌کند. مقدار پیش‌فرض دو فاصله است (
.Ql \ \ 
.Ns ).
توالی‌های گریز شناخته‌شده عبارتند از برگه (tab) (
.Ql \et
.Ns )،
بازگشت به ابتدای سطر (carriage return) (
.Ql \er
.Ns )،
سطر جدید (newline) (
.Ql \en
.Ns )،
و بک‌اسلش (backslash) (
.Ql \e\e
.Ns ).
.It Fl h
چاپ سرستون‌ها به همراه داده‌ها در همان فایل.
.It Fl q 
متاداده‌های ستون، وضعیت بازگشتی، یا تعداد سطرها چاپ نشوند. بر
.Fl h
اولیت دارد و آن را باطل می‌کند.
.It Fl v
حالت پرجزئیات، برای دریافت اطلاعات بیشتر درباره تعاملات ODBC. این گزینه همچنین فراداده‌های مجموعه نتایج، از جمله کدهای بازگشتی را گزارش می‌کند. تمامی داده‌های پرجزئیات در خطای استاندارد (یا
.Fl e Ns )
نوشته می‌شوند تا در جریان داده‌ها تداخلی ایجاد نشود.
.It Fl V Ar odbc_version
مشخص کردن نسخه ODBC (2 یا 3).
.El
.\"
.Sh "نکات (NOTES)"
.Pp
.Nm
یک پالایه (فیلتر) است؛ از ورودی استاندارد می‌خواند، در خروجی استاندارد می‌نویسد، و خطاها را در خطای استاندارد می‌نویسد. گزینه‌های
.Fl i ,
.Fl o ,
و
.Fl e
این مقادیر پیش‌فرض را لغو می‌کنند.
.Sh "وضعیت خروج (EXIT STATUS)"
.Nm
در صورت موفقیت با کد 0 خارج می‌شود، و اگر سرور نتواند پرس‌وجو را پردازش کند با مقدار 0< خارج می‌شود.
.\"
.Sh "تاریخچه (HISTORY)"
.Nm
اولین بار در FreeTDS 0.65 ارائه شد.
.\"
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
توسط
.An James K. Lowden Aq jklowden@freetds.org
نوشته شده است.