.\" $OpenBSD: doas.1,v 1.25 2021/01/16 09:18:41 martijn Exp $
.\"
.\"Copyright (c) 2015 Ted Unangst <tedu@openbsd.org>
.\"
.\"Permission to use, copy, modify, and distribute this software for any
.\"purpose with or without fee is hereby granted, provided that the above
.\"copyright notice and this permission notice appear in all copies.
.\"
.\"THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\"WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\"MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\"ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\"WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\"ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\"OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.Dd $Mdocdate: January 16 2021 $
.Dt DOAS 1
.Os
.Sh "نام (NAME)"
.Nm doas
.Nd اجرای دستورات به عنوان کاربری دیگر
.Sh "خلاصه دستور (SYNOPSIS)"
.Nm doas
.Op Fl Lns
.Op Fl C Ar config
.Op Fl u Ar user
.Ar command
.Op Ar args
.Sh "توضیحات (DESCRIPTION)"
ابزار
.Nm
دستور داده‌شده را به عنوان کاربری دیگر اجرا می‌کند.
آرگومان
.Ar command
الزامی است مگر اینکه
.Fl C ،
.Fl L
یا
.Fl s
مشخص شده باشد.
.Pp
از کاربر خواسته می‌شود تا با وارد کردن گذرواژه خود احراز هویت کند، مگر اینکه به شکل دیگری پیکربندی شده باشد.
.Pp
به‌طور پیش‌فرض، یک محیط جدید ایجاد می‌شود.
متغیرهای
.Ev HOME ،
.Ev LOGNAME ،
.Ev PATH ،
.Ev SHELL
و
.Ev USER
و همچنین
.Xr umask 2
به مقادیر مناسب برای کاربر هدف تنظیم می‌شوند.
متغیر
.Ev DOAS_USER
به نام کاربری که
.Nm
را اجرا می‌کند تنظیم می‌شود.
متغیرهای
.Ev DISPLAY
و
.Ev TERM
از محیط فعلی به ارث برده می‌شوند.
این رفتار ممکن است توسط فایل پیکربندی تغییر یابد.
دایرکتوری کاری تغییر نمی‌کند.
.Pp
گزینه‌ها به شرح زیر هستند:
.Bl -tag -width tenletters
.It Fl C Ar config
فایل پیکربندی
.Ar config
را تجزیه و بررسی کرده و سپس خارج می‌شود.
اگر
.Ar command
مشخص شده باشد،
.Nm
تطبیق دستور را نیز انجام می‌دهد.
در حالت دوم، بسته به نتایج تطبیق دستور، یکی از مقادیر
.Sq permit ،
.Sq permit nopass
یا
.Sq deny
در خروجی استاندارد چاپ خواهد شد.
هیچ دستوری اجرا نمی‌شود.
.It Fl L
هرگونه احراز هویت باقی‌مانده از دفعات پیشین را پاک کرده و بلافاصله خارج می‌شود.
هیچ دستوری اجرا نمی‌شود.
.It Fl n
حالت غیرتعاملی؛ در صورتی که قاعده منطبق دارای گزینه
.Ic nopass
نباشد، با شکست مواجه می‌شود.
.It Fl s
شل را از
.Ev SHELL
یا
.Pa /etc/passwd
اجرا می‌کند.
.It Fl u Ar user
دستور را به عنوان
.Ar user
اجرا می‌کند.
پیش‌فرض root است.
.El
.Sh "وضعیت خروج (EXIT STATUS)"
.Ex -std doas
ممکن است به یکی از دلایل زیر با شکست مواجه شود:
.Pp
.Bl -bullet -compact
.It
فایل پیکربندی
.Pa /etc/doas.conf
قابل تجزیه نبود.
.It
کاربر تلاش کرده است دستوری را اجرا کند که مجاز نیست.
.It
گذرواژه نادرست بود.
.It
دستور مشخص‌شده یافت نشد یا قابل اجرا نیست.
.El
.Sh "همچنین ببینید (SEE ALSO)"
.Xr su 1 ,
.Xr doas.conf 5
.Sh "تاریخچه (HISTORY)"
دستور
.Nm
نخستین بار در
.Ox 5.8
ظاهر شد.
.Sh "نویسندگان (AUTHORS)"
.An Ted Unangst Aq Mt tedu@openbsd.org