برگ ۵ · سینی برگشتی‌ها

هر پیام خطا یک مهر دارد

کد خروجی، تنها چیزی است که پوسته از یک فرمان می‌فهمد. پیام ممکن است گمراه‌کننده باشد، اما کد دروغ نمی‌گوید.

هر فرمان یک عدد بین صفر تا ۲۵۵ برمی‌گرداند. صفر یعنی رسید و هر عدد دیگر یعنی برگشت. عددهای بالای ۱۲۵ قاعدهٔ ثابتی دارند: ۱۲۸ به‌اضافهٔ شمارهٔ سیگنال. همین یک قاعده، نصف پیام‌های مبهم را توضیح می‌دهد. عدد ۱۳۷ یعنی ۱۲۸ به‌اضافهٔ ۹، و سیگنال ۹ همان 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 را نمی‌گیرد، اما می‌گوید کجا ایستاده‌اید.

برگ پیشین: ترکیب · برگ پسین: دفتر روش