.TH CHECKBASHISMS 1 "Debian Utilities" "DEBIAN" \" -*- nroff -*-
.SH "نام (NAME)"
checkbashisms \- بررسی اسکریپت‌های پوسته برای سینتکس‌های مختص بش (bashisms)
.SH "خلاصه دستور (SYNOPSIS)"
\fBcheckbashisms\fR \fIscript\fR ...
.br
\fBcheckbashisms \-\-help\fR|\fB\-\-version\fR
.SH "توضیحات (DESCRIPTION)"
دستور
.B checkbashisms
که بر پایه یکی از بررسی‌های سامانه
.B lintian
استوار است، بررسی‌های اولیه‌ای را روی اسکریپت‌های پوسته
.I /bin/sh
برای احتمال وجود «bashism» (سینتکس‌ها و قابلیت‌های مختص بش) انجام می‌دهد. این ابزار نام اسکریپت‌های پوسته را از خط فرمان دریافت کرده و در صورت تشخیص موارد احتمالی bashism، هشدارهایی را صادر می‌کند.
.PP
توجه داشته باشید که تعریف bashism در این زمینه تقریباً معادل «قابلیت‌هایی از پوسته است که الزامی به پشتیبانی از آن‌ها در استاندارد POSIX وجود ندارد»؛ این بدان معناست که ممکن است برخی از موارد مشخص‌شده، تحت بخش‌های اختیاری POSIX مانند XSI یا User Portability مجاز شمرده شوند.
.PP
در مواردی که بین استاندارد POSIX و سیاست‌های دبیان (Debian Policy) اختلاف نظر وجود دارد،
.B checkbashisms
به‌طور پیش‌فرض افزونه‌های مجاز طبق سیاست دبیان را می‌پذیرد، اما گزینه‌هایی را نیز برای بررسی دقیق‌تر و سخت‌گیرانه‌تر ارائه می‌دهد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-\-help ", " \-h
نمایش خلاصه‌ای از گزینه‌ها.
.TP
.BR \-\-newline ", " \-n
بررسی استفاده از "\fBecho \-n\fR" (خارج از استانداردهای POSIX اما الزامی طبق سیاست دبیان ۱۰.۴).
.TP
.BR \-\-posix ", " \-p
بررسی مواردی که خارج از استانداردهای POSIX هستند اما پشتیبانی از آن‌ها طبق سیاست دبیان ۱۰.۴ الزامی است (شامل \fB\-n\fR نیز می‌شود).
.TP
.BR \-\-force ", " \-f
اجبار به بررسی هر اسکریپت، حتی در صورتی که در حالت عادی بررسی نمی‌شد (برای مثال، اگر خط شِبنگ (shebang) حاوی bash یا پوسته‌ای غیر از POSIX باشد، یا به نظر برسد که یک پوشش‌دهنده پوسته است).
.TP
.BR \-\-lint ", " \-l
عملکرد شبیه به یک ابزار لینتر (linter)، جهت یکپارچه‌سازی با ویرایشگرهای متن. موارد احتمالی bashism در خروجی استاندارد (stdout) به صورت زیر چاپ خواهند شد:
.IP
.I {filename}:{lineno}:1: warning: possible bashism; {explanation}
.TP
.BR \-\-extra ", " \-x
برجسته کردن خطوطی که گرچه حاوی bashism نیستند، اما می‌توانند در تعیین اینکه آیا یک مورد خاص یک مثبت کاذب (false positive) قابل چشم‌پوشی است یا خیر، مفید واقع شوند.
برای مثال، پیش از استفاده از "\fB$BASH_ENV\fR" ممکن است بررسی شده باشد که آیا "\fB$BASH\fR" مقداردهی شده است یا خیر.
.TP
.BR \-\-early-fail ", " \-e
خروج بلافاصله پس از مشاهده اولین خطا.
.TP
.BR \-\-version ", " \-v
نمایش اطلاعات نسخه و حق نشر (کپی‌رایت).
.SH "کدهای خروج (EXIT VALUES)"
در صورتی که هیچ bashism احتمالی یا مشکل دیگری یافت نشود، مقدار کد خروج 0 خواهد بود. در غیر این صورت، برابر با مجموع مقادیر خطای زیر خواهد بود:
.TP
1
یک مورد احتمالی bashism تشخیص داده شد.
.TP
2
یک فایل بنا به دلایلی نادیده گرفته شد؛ برای مثال به دلیل غیرقابل خواندن بودن یا پیدا نشدن آن. پیام هشدار جزئیات را ارائه خواهد کرد.
.TP
4
هیچ موردی از bashism در یک اسکریپت bash یافت نشد.
.SH "همچنین ببینید (SEE ALSO)"
.BR lintian (1)
.SH "نویسندگان (AUTHORS)"
برنامه
.B checkbashisms
در ابتدا توسط Yann Dirson <\fIdirson@debian.org\fR> به عنوان یک اسکریپت پوسته نوشته شد و سپس توسط Julian Gilbey <\fIjdg@debian.org\fR> با ویژگی‌های بسیار بیشتر به زبان Perl بازنویسی شد.