برگ ۵ · سینی برگشتیها
هر پیام خطا یک مهر دارد
کد خروجی، تنها چیزی است که پوسته از یک فرمان میفهمد. پیام ممکن است گمراهکننده باشد، اما کد دروغ نمیگوید.
هر فرمان یک عدد بین صفر تا ۲۵۵ برمیگرداند. صفر یعنی رسید و هر عدد دیگر یعنی برگشت. عددهای بالای ۱۲۵ قاعدهٔ ثابتی دارند: ۱۲۸ بهاضافهٔ شمارهٔ سیگنال. همین یک قاعده، نصف پیامهای مبهم را توضیح میدهد. عدد ۱۳۷ یعنی ۱۲۸ بهاضافهٔ ۹، و سیگنال ۹ همان KILL است که معمولاً از کمبود حافظه میآید.
| کد | نام | معنی |
|---|---|---|
| ۰ | موفق | همهچیز درست تمام شد. تنها کدی که «رسید» میشود. |
| ۱ | خطای عمومی | بیشتر ابزارها وقتی چیزی پیدا نکردند یا شرطی برقرار نشد همین را میدهند. |
| ۲ | کاربرد نادرست | گزینه یا آرگومان اشتباه. پیام استفاده را دوباره بخوانید. |
| ۱۲۶ | اجرا نشدنی | فایل هست اما اجازهٔ اجرا ندارد یا فرمتش اجرایی نیست. |
| ۱۲۷ | پیدا نشد | نام فرمان در PATH نیست. غلط املایی یا نصبنشده. |
| ۱۳۰ | وقفه | Ctrl+C. معادل ۱۲۸ بهاضافهٔ سیگنال ۲. |
| ۱۳۷ | کشتهشده | SIGKILL. معمولاً حافظه پر شده است، ۱۲۸ بهاضافهٔ ۹. |
| ۱۴۳ | پایان نرم | SIGTERM. کانتینر یا سرویسگردان فرمان را بسته است، ۱۲۸ بهاضافهٔ ۱۵. |
| ۱۴۱ | لولهٔ بسته | SIGPIPE. بیشتر وقتی رخ میدهد که خروجی به head برسد و آن تمام شود. |
set -e سه جا خاموش است
set -e وقتی فرمانی صفر برنگرداند اسکریپت را میبندد، اما سه استثنا دارد: داخل شرط if، داخل حلقهٔ while، و سمت چپ && یا ||. این استثناها عمدی هستند، چون در آن جاها خودتان کد را بررسی میکنید. اگر بررسی نکنید، اسکریپت با خیال راحت ادامه میدهد و خرابی را جای دیگری نشان میدهد.
# exits on error, but this line does not stop the script:
if ! grep -q pattern file; then
echo "not found" >&2
fi
# check the status yourself when it matters:
grep -q pattern file || { echo "missing" >&2; exit 1; }شش پیام پرتکرار
command not found
نام فرمان در PATH نیست یا غلط تایپ شده.
آزمونwhich -a name; type name; echo "$PATH"
Permission denied
اجازهٔ اجرا یا خواندن نیست، یا فایل روی دیسک فقطخواندنی است.
آزمونls -l name; chmod +x script.sh
No such file or directory
مسیر غلط است، یا فایل در پوشهٔ دیگری است، یا خط پایان ویندوز دارد.
آزمونls -l ./name; file script.sh
Argument list too long
فهرست ستاره بیش از حد بزرگ شده و از سقف آرگومانها گذشته.
آزمونfind . -name "*.log" -print0 | xargs -0 ...
Too many open files
سقف توصیفگرهای فایل پر شده. در حلقهها شایع است.
آزمونulimit -n; close files inside loops
Text file busy
فایل اجرایی هنوز در حال اجراست و نمیشود بازنویسیاش کرد.
آزمونlsof +D . ; stop the process first
ردیابی، پیش از حدس زدن
پیش از تغییر دادن هر چیز، یک بار اسکریپت را با bash -x script.sh اجرا کنید. هر خط پیش از اجرا چاپ میشود و متغیرها باز میشوند. اگر خروجی زیاد شد، آن را به فایل بدهید و آخرین بیست خط را ببینید. برای دیدن زمان و شمارهٔ خط، سرآغاز PS4 را عوض کنید: PS4='+$LINENO: '. همین یک تغییر، پیدا کردن خط خراب را از چند دقیقه به چند ثانیه میرساند.
برای فرمانهای طولانی، trap بگذارید تا هنگام بسته شدن ناگهانی، پیام را ثبت کند: trap 'echo failed at $LINENO' ERR. این خط جای set -e را نمیگیرد، اما میگوید کجا ایستادهاید.