.\" Automatically generated from an mdoc input file.  Do not edit.
.\"
.\" SPDX-License-Identifier: ISC
.\"
.\" Copyright (c) 2019-2023 Todd C. Miller <Todd.Miller@sudo.ws>
.\"
.\" 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.
.\"
.TH "SUDO_SENDLOG" "8" "مه ۲۰۲۵" "sudo" "دستورات مدیریت سیستم"
.nh
.if n .ad l
.SH "نام (NAME)"
sudo_sendlog \- ارسال گزارشهای ورودی/خروجی sudo به سرور ثبت وقایع
.SH "خلاصه دستور (SYNOPSIS)"
.HP 13n
\fBsudo_sendlog\fR
[\fB\-AnV\fR]
[\fB\-b\fR\ \fIca_bundle\fR]
[\fB\-c\fR\ \fIcert_file\fR]
[\fB\-h\fR\ \fIhost\fR]
[\fB\-i\fR\ \fIiolog\-id\fR]
[\fB\-k\fR\ \fIkey_file\fR]
[\fB\-p\fR\ \fIport\fR]
[\fB\-r\fR\ \fIrestart\-point\fR]
[\fB\-R\fR\ \fIreject\-reason\fR]
[\fB\-s\fR\ \fIstop\-point\fR]
[\fB\-t\fR\ \fInumber\fR]
\fIpath\fR
.SH "توضیحات (DESCRIPTION)"
ابزار \fBsudo_sendlog\fR گزارشهای ثبتشده نشستهای ورودی و خروجی ابزار sudo را به یک سرور متمرکز ارسال میکند.
می‌توان از این ابزار برای ارسال گزارش‌های ورودی/خروجی موجود \fBsudoers\fR در \fIpath\fR به یک سرور راه‌دور ثبت وقایع مانند
sudo_logsrvd(8)
جهت ذخیره‌سازی متمرکز استفاده کرد.
.PP
گزینه‌ها به شرح زیر هستند:
.TP 8n
\fB\-A\fR, \fB\-\-accept\-only\fR
تنها رویداد پذیرش (accept) را ارسال می‌کند، نه داده‌های ورودی/خروجی مرتبط با گزارش را.
این گزینه می‌تواند برای آزمایش ثبت رویدادهای پذیرش بدون هیچ‌گونه ورودی/خروجی مرتبط به کار رود.
.TP 8n
\fB\-b\fR, \fB\-\-ca\-bundle\fR
مسیر فایل دسته گواهی مرجع صدور گواهی (CA bundle) با قالب PEM برای استفاده به جای پایگاه داده پیش‌فرض مرجع صدور گواهی سیستم در هنگام احراز هویت سرور ثبت وقایع.
حالت پیش‌فرض استفاده از پایگاه داده مرجع صدور گواهی سیستم است.
.TP 8n
\fB\-c\fR, \fB\-\-cert\fR
مسیر فایل گواهی کلاینت با قالب PEM.
در صورتی که اتصال به سرور راه‌دور ثبت وقایع با TLS ایمن شده باشد، این تنظیم الزامی است.
.TP 8n
\fB\-\-help\fR
.br
نمایش پیام راهنمای کوتاه در خروجی استاندارد و خروج.
.TP 8n
\fB\-h\fR, \fB\-\-host\fR
اتصال به
\fIhost\fR
مشخص‌شده به جای میزبان محلی (localhost).
.TP 8n
\fB\-i\fR, \fB\-\-iolog\-id\fR
استفاده از
\fIiolog\-id\fR
مشخص‌شده هنگام شروع مجدد انتقال گزارش.
شناسه
\fIiolog\-id\fR
توسط سرور هنگام ایجاد گزارش ورودی/خروجی راه‌دور گزارش می‌شود.
این گزینه تنها می‌تواند همراه با گزینه
\fB\-r\fR
استفاده شود.
.TP 8n
\fB\-k\fR, \fB\-\-key\fR
مسیر فایل کلید خصوصی کلاینت با قالب PEM.
در صورتی که اتصال به سرور راه‌دور ثبت وقایع با TLS ایمن شده باشد، این تنظیم الزامی است.
.TP 8n
\fB\-n\fR, \fB\-\-no\-verify\fR
در صورت تعیین، گواهی سرور در طول تبادل اولیه (handshake) پروتکل TLS اعتبارسنجی نخواهد شد.
به طور پیش‌فرض،
\fBsudo_sendlog\fR
معتبر بودن گواهی سرور و شامل بودن نام میزبان یا نشانی IP سرور در آن را بررسی می‌کند.
این تنظیم تنها زمانی پشتیبانی می‌شود که اتصال به سرور راه‌دور ثبت وقایع با TLS ایمن شده باشد.
.TP 8n
\fB\-p\fR, \fB\-\-port\fR
استفاده از درگاه شبکه
\fIport\fR
مشخص‌شده هنگام اتصال به سرور ثبت وقایع به جای درگاه پیش‌فرض ۳۰۳۴۴.
.TP 8n
\fB\-r\fR, \fB\-\-restart\fR
شروع مجدد یک اتصال قطع‌شده به سرور ثبت وقایع.
نقطه شروع مجدد
\fIrestart\-point\fR
مشخص‌شده برای اعلام نقطه‌ای از زمان به سرور که باید ادامه گزارش از آن ارسال شود، به کار می‌رود.
مقدار
\fIrestart\-point\fR
در قالب
\(lqseconds,nanoseconds\(rq
تعیین می‌شود و معمولاً آخرین نقطه ثبت‌شده (commit point) دریافت شده از سرور است.
هنگام شروع مجدد انتقال، گزینه
\fB\-i\fR
نیز باید تعیین شده باشد.
.TP 8n
\fB\-R\fR, \fB\-\-reject\fR
ارسال یک رویداد رد (reject) برای دستور با استفاده از علت رد
\fIreject\-reason\fR
تعیین‌شده، حتی اگر در واقع به صورت محلی پذیرفته شده باشد.
از این گزینه می‌توان برای آزمایش ثبت رویدادهای رد استفاده کرد؛ هیچ داده ورودی/خروجی ارسال نخواهد شد.
.TP 8n
\fB\-s\fR, \fB\-\-stop\-after\fR
توقف ارسال رکوردهای گزارش و بستن اتصال هنگام رسیدن به
\fIstop\-point\fR.
این گزینه می‌تواند برای اهداف آزمایشی جهت ارسال گزارش ورودی/خروجی ناقص به سرور به کار رود.
گزارش‌های ناقص را می‌توان با استفاده از گزینه
\fB\-r\fR
مجدداً از سر گرفت.
نقطه توقف
\fIstop\-point\fR
یک زمان سپری‌شده است که در قالب
\(lqseconds,nanoseconds\(rq
مشخص می‌شود.
.TP 8n
\fB\-t\fR, \fB\-\-test\fR
باز کردن
\fInumber\fR
اتصال هم‌زمان به سرور ثبت وقایع و ارسال فایل گزارش ورودی/خروجی مشخص‌شده روی هر یک از آن‌ها.
این گزینه برای آزمایش عملکرد و کارایی سودمند است.
.TP 8n
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه
\fBsudo_sendlog\fR
و خروج.
.SS "اشکال‌زدایی sendlog"
ابزار
\fBsudo_sendlog\fR
از یک سازوکار اشکال‌زدایی انعطاف‌پذیر پشتیبانی می‌کند که از طریق خطوط
\fIDebug\fR
در فایل
sudo.conf(5)
پیکربندی می‌شود.
.PP
برای اطلاعات بیشتر در مورد پیکربندی
sudo.conf(5)،
به راهنمای آن مراجعه کنید.
.SH "فایل‌ها (FILES)"
.TP 26n
\fI/etc/sudo.conf\fR
پیکربندی پیشانه Sudo
.SH "همچنین ببینید (SEE ALSO)"
sudo.conf(5),
sudo(8),
sudo_logsrvd(8)
.SH "نویسندگان (AUTHORS)"
افراد زیادی در طول سال‌ها روی
\fBsudo\fR
کار کرده‌اند؛ این نسخه عمدتاً شامل کدهایی است که توسط شخص زیر نوشته شده است:
.sp
.RS 6n
Todd C. Miller
.RE
.PP
برای مشاهده فهرست جامعی از افرادی که در توسعه
\fBsudo\fR
مشارکت داشته‌اند، فایل CONTRIBUTORS.md را در توزیع
\fBsudo\fR
(https://www.sudo.ws/about/contributors)
ببینید.
.SH "گزارش اشکالات (BUGS)"
اگر فکر می‌کنید اشکالی در
\fBsudo_sendlog\fR
یافته‌اید، می‌توانید گزارش اشکال را در https://bugzilla.sudo.ws ثبت کنید.
.SH "پشتیبانی (SUPPORT)"
پشتیبانی رایگان محدود از طریق فهرست پستی کاربران sudo در دسترس است؛ برای عضویت یا جستجو در آرشیو،
https://www.sudo.ws/mailman/listinfo/sudo-users
را مشاهده کنید.
.SH "سلب مسئولیت (DISCLAIMER)"
ابزار
\fBsudo_sendlog\fR
به صورت
\(lqهمان‌گونه که هست\(rq
(\(lqAS IS\(rq)
ارائه می‌شود و هرگونه ضمانت صریح یا ضمنی، از جمله ضمانت‌های ضمنی خریدوفروش و تناسب برای یک هدف خاص، سلب می‌شود.
برای جزئیات کامل، فایل LICENSE.md توزیع‌شده با
\fBsudo\fR
یا https://www.sudo.ws/about/license را ببینید.