.\" SPDX-License-Identifier: GPL-2.0-or-later .\" Copyright Red Hat .\" Author: David Gibson .TH pesto 1 .SH "نام (NAME)" pesto \- پیکربندی یک نمونه در حال اجرا از \fBpasst\fR(1) یا \fBpasta\fR(1) .SH "خلاصه دستور (SYNOPSIS)" .B pesto [\fIگزینه\fR]... \fIمسیر\fR .SH "توضیحات (DESCRIPTION)" .B pesto یک کلاینت برای مشاهده و به‌روزرسانی پیکربندی فوروارد پورت در یک نمونه در حال اجرا از \fBpasst\fR(1) یا \fBpasta\fR(1) است. \fIمسیر\fR مسیر سوکت دامنه یونیکس (UNIX domain socket) ایجادشده توسط \fBpasst\fR یا \fBpasta\fR را مشخص می‌کند. این مقدار باید با گزینه خط فرمان \fB\-c\fR داده‌شده به آن نمونه مطابقت داشته باشد. .SH "گزینه‌ها (OPTIONS)" .TP .BR \-d ", " \-\-debug پرگویی و نمایش اطلاعات با جزئیات بیشتر. .TP .BR \-h ", " \-\-help نمایش پیام راهنما و خروج. .TP .BR \-s ", " \-\-show نمایش پیکربندی فوروارد قبل و بعد از اعمال تغییرات. .TP .BR \-A ", " \-\-add اضافه کردن مشخص‌کننده‌های فوروارد پورت پس از این گزینه به جدول فوروارد فعلی، به‌جای جایگزینی آن. این گزینه می‌تواند چندین بار تکرار شود، زیرا ممکن است پس از حذف‌های قبلی قرار گیرد (گزینه \fB\-\-delete\fR را در زیر ببینید)، و بدین معناست که تمام مشخص‌کننده‌های پس از آن، پیش از رسیدن به گزینه بعدی \fB\-\-delete\fR، به عنوان عمل افزودن تلقی خواهند شد. برای جزئیات بیشتر، بخش \fBافزودن، حذف و پاک‌سازی قوانین\fR را در \fBنکات\fR ببینید. .TP .BR \-D ", " \-\-delete حذف مشخص‌کننده‌های فوروارد پورت پس از این گزینه از جدول فوروارد فعلی، به‌جای افزودن آن‌ها به جدول. این گزینه می‌تواند چندین بار تکرار شود، زیرا ممکن است پس از افزودن‌های قبلی قرار گیرد (گزینه \fB\-\-add\fR را در بالا ببینید)، و بدین معناست که تمام مشخص‌کننده‌های پس از آن، پیش از رسیدن به گزینه بعدی \fB\-\-add\fR، به عنوان عمل حذف تلقی خواهند شد. برای جزئیات بیشتر، بخش \fBافزودن، حذف و پاک‌سازی قوانین\fR را در \fBنکات\fR ببینید. .TP .BR \-C ", " \-\-clear " " \fIpif پاک‌سازی جدول فوروارد مرتبط با یک \fIpif\fR مشخص، یعنی یک نوع مفهومی از رابط در \fBpasst\fR(1) یا \fBpasta\fR(1) که نشان‌دهنده یک مسیر داده و جهت خاص است. نام‌های دردسترس \fIpif\fR را می‌توان با استعلام پیکربندی فوروارد فعلی دریافت کرد، که این کار با فراخوانی \fBpesto\fR(1) بدون هیچ گزینه‌ای قابل انجام است. برای جزئیات بیشتر، بخش \fBافزودن، حذف و پاک‌سازی قوانین\fR را در \fBنکات\fR ببینید. .TP .BR \-t ", " \-\-tcp-ports " " \fIspec پیکربندی فوروارد پورت TCP به مهمان یا فضای‌نام. مقدار \fIspec\fR می‌تواند یکی از موارد زیر باشد: .RS .TP .BR none عدم فوروارد هیچ پورتی .TP [\fIآدرس\fR[\fB%\fR\fIرابط\fR]\fB/\fR]\fIپورت‌ها\fR ... پورت‌های خاص برای فوروارد. به صورت اختیاری، یک آدرس شنود خاص و نام رابط (از لینوکس 5.7 به بعد) می‌تواند مشخص شود. \fIپورت‌ها\fR می‌تواند یکی از موارد زیر باشد: .RS .TP \fBall\fR فوروارد تمام پورت‌های آزاد و غیرموقت (non-ephemeral)، طبق اختیارات و دسترسی‌های فعلی. هیچ خطایی برای پورت‌های دردسترس‌نبوده گزارش نمی‌شود، مگر آنکه اصلاً هیچ پورتی قابل فوروارد نباشد. .RE .RS یا فهرستی جداشده با کاما از مدخل‌هایی که می‌توانند هر یک از موارد زیر باشند: .TP \fIآغاز\fR[\fB\-\fR\fIپایان\fR][\fB:\fR\fIآغاز_مقصد\fR[\fB\-\fR\fIپایان_مقصد\fR]] محدوده شامل‌شونده. فوروارد شماره پورت‌های بین \fIآغاز\fR و \fIپایان\fR (شامل خود آن‌ها) به پورت‌های بین \fIآغاز_مقصد\fR و \fIپایان_مقصد\fR. اگر \fIآغاز_مقصد\fR و \fIپایان_مقصد\fR حذف شوند، همانند \fIآغاز\fR و \fIپایان\fR در نظر گرفته می‌شوند. اگر \fIپایان\fR حذف شود، برابر با \fIآغاز\fR فرض خواهد شد. .TP \fB~\fR\fIآغاز\fR[\fB\-\fR\fIپایان\fR] محدوده استثنا. شماره پورت‌های بین \fIآغاز\fR و \fIپایان\fR را فوروارد نمی‌کند. این حالت بر محدوده‌های شامل‌شونده اولویت دارد. .TP .BR auto تنها در \fBpasta\fR. تنها در صورتی پورت‌های مجموعه مشخص‌شده فوروارد می‌شوند که پورت‌های هدف در فضای‌نام bind شده باشند. فهرست پورت‌ها به صورت دوره‌ای (هر ثانیه یک‌بار) از سوکت‌های شنود ارائه‌شده توسط \fI/proc/net/tcp\fR و \fI/proc/net/tcp6\fR استخراج می‌شود؛ به \fBproc\fR(5) مراجعه کنید. .RE مشخص کردن محدوده‌های استثنا به تنهایی بدین معناست که تمام پورت‌های غیرموقت دیگر فوروارد شوند. مشخص نکردن هیچ محدوده‌ای نیز به معنای فوروارد کردن تمام پورت‌های غیرموقت مجاز تحت دسترسی‌های فعلی است. در این حالت، هیچ خطایی برای پورت‌های دردسترس‌نبوده گزارش نمی‌شود، مگر آنکه اصلاً هیچ پورتی قابل فوروارد نباشد. مثال‌ها: .RS .TP -t all فوروارد تمام پورت‌های آزاد و غیرموقت مجاز تحت اختیارات فعلی به پورت متناظر در مهمان یا فضای‌نام .TP -t ::1/all برای آدرس محلی ::1، فوروارد تمام پورت‌های آزاد و غیرموقت مجاز تحت دسترسی‌های فعلی .TP -t 22 فوروارد پورت محلی 22 به پورت 22 در مهمان یا فضای‌نام .TP -t 22:23 فوروارد پورت محلی 22 به پورت 23 در مهمان یا فضای‌نام .TP -t 22,25 فوروارد پورت‌های محلی 22 و 25 به پورت‌های 22 و 25 در مهمان یا فضای‌نام .TP -t 22-80 فوروارد پورت‌های محلی بین 22 و 80 به پورت‌های متناظر در مهمان یا فضای‌نام .TP -t 22-80:32-90 فوروارد پورت‌های محلی بین 22 و 80 به پورت‌های بین 32 و 90 در مهمان یا فضای‌نام .TP -t 192.0.2.1/22 فوروارد پورت محلی 22، متصل به 192.0.2.1، به پورت 22 در مهمان یا فضای‌نام .TP -t 192.0.2.1%eth0/22 فوروارد پورت محلی 22، متصل به 192.0.2.1 و رابط eth0، به پورت 22 .TP -t %eth0/22 فوروارد پورت محلی 22، متصل به هر آدرسی روی رابط eth0، به پورت 22 .TP -t 2000-5000,~3000-3010 فوروارد پورت‌های محلی بین 2000 و 5000، به‌جز پورت‌های بین 3000 و 3010 .TP -t 192.0.2.1/20-30,~25 برای آدرس محلی 192.0.2.1، فوروارد پورت‌های بین 20 تا 24 و بین 26 تا 30 .TP -t ~20000-20010 فوروارد تمام پورت‌ها به مهمان، به‌جز محدوده 20000 تا 20010 .TP -t auto فوروارد خودکار هر پورتی که در فضای‌نام متصل (bound) شده است .TP -t ::1/auto فوروارد خودکار هر پورتی که در فضای‌نام متصل شده است، تنها با شنود روی آدرس محلی ::1 .TP -t 8000-8010,auto فوروارد پورت‌های محدوده 8000-8010 تنها در صورتی که در فضای‌نام متصل شده باشند .RE .RE .TP .BR \-u ", " \-\-udp-ports " " \fIspec پیکربندی فوروارد پورت UDP به مهمان. مقدار \fIspec\fR همانند توضیحات بالا برای TCP است. .TP .BR \-T ", " \-\-tcp-ns " " \fIspec پیکربندی فوروارد پورت TCP از فضای‌نام هدف به فضای‌نام init. مقدار \fIspec\fR همانند توضیحات بالا است. .TP .BR \-U ", " \-\-udp-ns " " \fIspec پیکربندی فوروارد پورت UDP از فضای‌نام هدف به فضای‌نام init. مقدار \fIspec\fR همانند توضیحات بالا است. .TP .BR \-\-version نمایش نسخه و خروج. .SH "نکات (NOTES)" .SS "افزودن، حذف و پاک‌سازی قوانین (Adding, deleting, clearing rules)" گزینه‌های \fB\-\-add\fR، \fB\-\-delete\fR و \fB\-\-clear\fR به عنوان دستورات ترتیبی برای دستکاری جدول‌های فوروارد فعلی پردازش می‌شوند. اگر هیچ‌یک از آن‌ها مشخص نشود، مشخص‌کننده‌های فوروارد برای یک جدول معین به عنوان جایگزینی برای جدول متناظر در نظر گرفته می‌شوند. به این معنا که: .nf pesto -t 1024 -U 1025 .fi جدول فعلی فوروارد پورت ورودی TCP را با یک قانون واحد، یعنی فوروارد پورت 1024، \fBجایگزین\fR خواهد کرد، و به همین ترتیب جدول فوروارد خروجی UDP را با یک قانون فوروارد واحد برای پورت 1025 جایگزین می‌کند. این شیوه نگارش شکل کوتاه‌شده دستور زیر است: .nf pesto -C HOST -t 1024 -C SPLICE -U 1025 .fi گزینه‌های \fB\-\-add\fR و \fB\-\-delete\fR برای \fBافزودن قوانین خاص جدید یا حذف قوانین موجود\fR به‌جای جایگزینی جدول‌ها به کار می‌روند. به عنوان مثال: .nf pesto -A -t 2000 -D -t 3000 -U 5000 .fi یک قانون فوروارد برای پورت ورودی TCP شماره 2000 اضافه می‌کند، و پورت ورودی TCP شماره 3000 و همچنین پورت خروجی UDP شماره 5000 را از مجموعه قوانین فعلی حذف خواهد کرد. همه این گزینه‌ها به عنوان دستورات ترتیبی تفسیر می‌شوند و می‌توان آن‌ها را به دلخواه ترکیب کرد. برای مثال: .nf pesto -A -t 2000 -C HOST -A -T 3000 -t 2001 -D -u 5000 .fi به ترتیب زیر عمل خواهد کرد: .RS .IP \(bu 2 افزودن پورت ورودی TCP شماره 2000 .IP \(bu 2 پاک‌سازی پورت‌های ورودی، و لغو افزودن انجام‌شده در بالا .IP \(bu 2 افزودن پورت خروجی TCP شماره 3000 .IP \(bu 2 افزودن پورت ورودی TCP شماره 2001 .IP \(bu 2 حذف پورت ورودی UDP شماره 5000 .RE .SH "نویسندگان (AUTHORS)" Stefano Brivio , David Gibson . .SH "گزارش باگ‌ها (REPORTING BUGS)" لطفاً مشکلات را در سامانه ردیابی باگ در https://bugs.passt.top گزارش دهید، یا پیامی به فهرست پستی passt-user@passt.top ارسال کنید؛ https://lists.passt.top را ببینید. .SH "حق نشر (COPYRIGHT)" حق نشر Red Hat \fBpesto\fR نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه 2 یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید. .SH "همچنین ببینید (SEE ALSO)" \fBpasst\fR(1), \fBpasta\fR(1), \fBunix\fR(7).