.\" Copyright © 2016 Andy Chu. All rights reserved.
.\"
.\" Licensed under the Apache License, Version 2.0 (the "License");
.\" You may not use this file except in compliance with the License.
.\"
.\" You may obtain a copy of the License at:
.\" http://www.apache.org/licenses/LICENSE-2.0
.Dd June 28, 2019
.Dt OSH 1
.Os
.Sh "نام (NAME)"
.Nm osh
.Nd مفسر زبان دستور
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm
.Op Ar options
.Ar script
.Op Ar args
.Nm
.Op Ar options
.Fl c
.Op command_string
.Op args
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
یک مفسر زبان دستور سازگار با
.Xr bash 1
است:
این ابزار دستورها را از ورودی استاندارد، یک فایل
.Ar script
یا آرگومان‌های خط فرمان خوانده و آن‌ها را اجرا می‌کند.
.Pp
.Nm
آرگومان‌های
.Xr sh 1
استاندارد POSIX را با تفاوت‌های زیر می‌پذیرد:
.Bl -tag -width Ds
.It Fl n
تنها درستی نحو را اعتبارسنجی می‌کند.
همچنین AST را چاپ می‌کند.
.It Fl -ast-format
قالبی که AST باید داشته باشد را تعیین می‌کند.
.El
.Sh "محیط (ENVIRONMENT)"
.Bl -tag -width "OILS_CRASH_DUMP_DIR"
.It Ev OILS_HIJACK_SHEBANG
.It Ev OILS_CRASH_DUMP_DIR
.El
.Sh "فایل‌ها (FILES)"
پوستهٔ تعاملی در هنگام راه‌اندازی فقط
.Pa ~/.config/oils/oshrc
را بارگذاری (source) می‌کند.
.Sh "وضعیت خروج (EXIT STATUS)"
ابزار
.Nm
با یکی از مقادیر زیر خارج می‌شود:
.Bl -tag -width 3n
.It 1
یک یا چند خطای زمان اجرا رخ داده است.
.It 2
یک یا چند خطای تجزیه رخ داده است،
خواه به دلیل نحو نادرست اسکریپت یا فراخوانی نامناسب یک دستور توکار پوسته.
.It 126
مجوز دسترسی هنگام اجرای یک دستور رد شده است.
.It 127
دستور یا اسکریپت مورد ارجاع یافت نشد.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr bash 1 ,
.Xr busybox 1 ,
.Xr sh 1
.Pp
.Lk https://oils.pub/release/0.37.0/doc مستندات
.Sh "نویسندگان (AUTHORS)"
ابزار
.Nm
توسط
.An Andy Chu Aq Mt andy@oils.pub
نوشته شده است.