| pesto(1) | General Commands Manual | pesto(1) |
نام (NAME)
pesto - پیکربندی یک نمونه در حال اجرا از passt(1) یا pasta(1)
خلاصه دستور (SYNOPSIS)
pesto [گزینه]... مسیر
توضیحات (DESCRIPTION)
pesto یک کلاینت برای مشاهده و به‌روزرسانی پیکربندی فوروارد پورت در یک نمونه در حال اجرا از passt(1) یا pasta(1) است.
مسیر مسیر سوکت دامنه یونیکس (UNIX domain socket) ایجادشده توسط passt یا pasta را مشخص می‌کند. این مقدار باید با گزینه خط فرمان -c داده‌شده به آن نمونه مطابقت داشته باشد.
گزینه‌ها (OPTIONS)
- -d, --debug
- پرگویی و نمایش اطلاعات با جزئیات بیشتر.
- -h, --help
- نمایش پیام راهنما و خروج.
- -s, --show
- نمایش پیکربندی فوروارد قبل و بعد از اعمال تغییرات.
- -A, --add
- اضافه کردن
مشخص‌کننده‌های
فوروارد
پورت پس از
این گزینه
به جدول
فوروارد
فعلی،
به‌جای
جایگزینی
آن.
این گزینه می‌تواند چندین بار تکرار شود، زیرا ممکن است پس از حذف‌های قبلی قرار گیرد (گزینه --delete را در زیر ببینید)، و بدین معناست که تمام مشخص‌کننده‌های پس از آن، پیش از رسیدن به گزینه بعدی --delete، به عنوان عمل افزودن تلقی خواهند شد.
برای جزئیات بیشتر، بخش افزودن، حذف و پاک‌سازی قوانین را در نکات ببینید.
- -D, --delete
- حذف
مشخص‌کننده‌های
فوروارد
پورت پس از
این گزینه
از جدول
فوروارد
فعلی،
به‌جای
افزودن
آن‌ها به
جدول.
این گزینه می‌تواند چندین بار تکرار شود، زیرا ممکن است پس از افزودن‌های قبلی قرار گیرد (گزینه --add را در بالا ببینید)، و بدین معناست که تمام مشخص‌کننده‌های پس از آن، پیش از رسیدن به گزینه بعدی --add، به عنوان عمل حذف تلقی خواهند شد.
برای جزئیات بیشتر، بخش افزودن، حذف و پاک‌سازی قوانین را در نکات ببینید.
- -C, --clear pif
- پاک‌سازی
جدول
فوروارد
مرتبط با یک
pif مشخص،
یعنی یک نوع
مفهومی از
رابط در passt(1)
یا pasta(1) که
نشان‌دهنده
یک مسیر
داده و جهت
خاص است.
نام‌های دردسترس pif را می‌توان با استعلام پیکربندی فوروارد فعلی دریافت کرد، که این کار با فراخوانی pesto(1) بدون هیچ گزینه‌ای قابل انجام است.
برای جزئیات بیشتر، بخش افزودن، حذف و پاک‌سازی قوانین را در نکات ببینید.
- -t, --tcp-ports spec
- پیکربندی فوروارد پورت TCP به مهمان یا فضای‌نام. مقدار spec می‌تواند یکی از موارد زیر باشد:
- none
- عدم فوروارد هیچ پورتی
- [آدرس[%رابط]/]پورت‌ها ...
- پورت‌های خاص برای فوروارد. به صورت اختیاری، یک آدرس شنود خاص و نام رابط (از لینوکس 5.7 به بعد) می‌تواند مشخص شود. پورت‌ها می‌تواند یکی از موارد زیر باشد:
- all
- فوروارد تمام پورت‌های آزاد و غیرموقت (non-ephemeral)، طبق اختیارات و دسترسی‌های فعلی. هیچ خطایی برای پورت‌های دردسترس‌نبوده گزارش نمی‌شود، مگر آنکه اصلاً هیچ پورتی قابل فوروارد نباشد.
- آغاز[-پایان][:آغاز_مقصد[-پایان_مقصد]]
- محدوده شامل‌شونده. فوروارد شماره پورت‌های بین آغاز و پایان (شامل خود آن‌ها) به پورت‌های بین آغاز_مقصد و پایان_مقصد. اگر آغاز_مقصد و پایان_مقصد حذف شوند، همانند آغاز و پایان در نظر گرفته می‌شوند. اگر پایان حذف شود، برابر با آغاز فرض خواهد شد.
- ~آغاز[-پایان]
- محدوده استثنا. شماره پورت‌های بین آغاز و پایان را فوروارد نمی‌کند. این حالت بر محدوده‌های شامل‌شونده اولویت دارد.
- auto
- تنها در pasta. تنها در صورتی پورت‌های مجموعه مشخص‌شده فوروارد می‌شوند که پورت‌های هدف در فضای‌نام bind شده باشند. فهرست پورت‌ها به صورت دوره‌ای (هر ثانیه یک‌بار) از سوکت‌های شنود ارائه‌شده توسط /proc/net/tcp و /proc/net/tcp6 استخراج می‌شود؛ به proc(5) مراجعه کنید.
مشخص کردن محدوده‌های استثنا به تنهایی بدین معناست که تمام پورت‌های غیرموقت دیگر فوروارد شوند. مشخص نکردن هیچ محدوده‌ای نیز به معنای فوروارد کردن تمام پورت‌های غیرموقت مجاز تحت دسترسی‌های فعلی است. در این حالت، هیچ خطایی برای پورت‌های دردسترس‌نبوده گزارش نمی‌شود، مگر آنکه اصلاً هیچ پورتی قابل فوروارد نباشد.
مثال‌ها:
- -t all
- فوروارد تمام پورت‌های آزاد و غیرموقت مجاز تحت اختیارات فعلی به پورت متناظر در مهمان یا فضای‌نام
- -t ::1/all
- برای آدرس محلی ::1، فوروارد تمام پورت‌های آزاد و غیرموقت مجاز تحت دسترسی‌های فعلی
- -t 22
- فوروارد پورت محلی 22 به پورت 22 در مهمان یا فضای‌نام
- -t 22:23
- فوروارد پورت محلی 22 به پورت 23 در مهمان یا فضای‌نام
- -t 22,25
- فوروارد پورت‌های محلی 22 و 25 به پورت‌های 22 و 25 در مهمان یا فضای‌نام
- -t 22-80
- فوروارد پورت‌های محلی بین 22 و 80 به پورت‌های متناظر در مهمان یا فضای‌نام
- -t 22-80:32-90
- فوروارد پورت‌های محلی بین 22 و 80 به پورت‌های بین 32 و 90 در مهمان یا فضای‌نام
- -t 192.0.2.1/22
- فوروارد پورت محلی 22، متصل به 192.0.2.1، به پورت 22 در مهمان یا فضای‌نام
- -t 192.0.2.1%eth0/22
- فوروارد پورت محلی 22، متصل به 192.0.2.1 و رابط eth0، به پورت 22
- -t %eth0/22
- فوروارد پورت محلی 22، متصل به هر آدرسی روی رابط eth0، به پورت 22
- -t 2000-5000,~3000-3010
- فوروارد پورت‌های محلی بین 2000 و 5000، به‌جز پورت‌های بین 3000 و 3010
- -t 192.0.2.1/20-30,~25
- برای آدرس محلی 192.0.2.1، فوروارد پورت‌های بین 20 تا 24 و بین 26 تا 30
- -t ~20000-20010
- فوروارد تمام پورت‌ها به مهمان، به‌جز محدوده 20000 تا 20010
- -t auto
- فوروارد خودکار هر پورتی که در فضای‌نام متصل (bound) شده است
- -t ::1/auto
- فوروارد خودکار هر پورتی که در فضای‌نام متصل شده است، تنها با شنود روی آدرس محلی ::1
- -t 8000-8010,auto
- فوروارد پورت‌های محدوده 8000-8010 تنها در صورتی که در فضای‌نام متصل شده باشند
- -u, --udp-ports spec
- پیکربندی فوروارد پورت UDP به مهمان. مقدار spec همانند توضیحات بالا برای TCP است.
- -T, --tcp-ns spec
- پیکربندی فوروارد پورت TCP از فضای‌نام هدف به فضای‌نام init. مقدار spec همانند توضیحات بالا است.
- -U, --udp-ns spec
- پیکربندی فوروارد پورت UDP از فضای‌نام هدف به فضای‌نام init. مقدار spec همانند توضیحات بالا است.
- --version
- نمایش نسخه و خروج.
نکات (NOTES)
افزودن، حذف و پاک‌سازی قوانین (Adding, deleting, clearing rules)
گزینه‌های --add، --delete و --clear به عنوان دستورات ترتیبی برای دستکاری جدول‌های فوروارد فعلی پردازش می‌شوند. اگر هیچ‌یک از آن‌ها مشخص نشود، مشخص‌کننده‌های فوروارد برای یک جدول معین به عنوان جایگزینی برای جدول متناظر در نظر گرفته می‌شوند. به این معنا که:
pesto -t 1024 -U 1025
جدول فعلی فوروارد پورت ورودی TCP را با یک قانون واحد، یعنی فوروارد پورت 1024، جایگزین خواهد کرد، و به همین ترتیب جدول فوروارد خروجی UDP را با یک قانون فوروارد واحد برای پورت 1025 جایگزین می‌کند. این شیوه نگارش شکل کوتاه‌شده دستور زیر است:
pesto -C HOST -t 1024 -C SPLICE -U 1025
گزینه‌های --add و --delete برای افزودن قوانین خاص جدید یا حذف قوانین موجود به‌جای جایگزینی جدول‌ها به کار می‌روند. به عنوان مثال:
pesto -A -t 2000 -D -t 3000 -U 5000
یک قانون فوروارد برای پورت ورودی TCP شماره 2000 اضافه می‌کند، و پورت ورودی TCP شماره 3000 و همچنین پورت خروجی UDP شماره 5000 را از مجموعه قوانین فعلی حذف خواهد کرد.
همه این گزینه‌ها به عنوان دستورات ترتیبی تفسیر می‌شوند و می‌توان آن‌ها را به دلخواه ترکیب کرد. برای مثال:
pesto -A -t 2000 -C HOST -A -T 3000 -t 2001 -D -u 5000
به ترتیب زیر عمل خواهد کرد:
- افزودن پورت ورودی TCP شماره 2000
- پاک‌سازی پورت‌های ورودی، و لغو افزودن انجام‌شده در بالا
- افزودن پورت خروجی TCP شماره 3000
- افزودن پورت ورودی TCP شماره 2001
- حذف پورت ورودی UDP شماره 5000
نویسندگان (AUTHORS)
Stefano Brivio <sbrivio@redhat.com>, David Gibson <david@gibson.dropbear.id.au>.
گزارش باگ‌ها (REPORTING BUGS)
لطفاً مشکلات را در سامانه ردیابی باگ در https://bugs.passt.top گزارش دهید، یا پیامی به فهرست پستی passt-user@passt.top ارسال کنید؛ https://lists.passt.top را ببینید.
حق نشر (COPYRIGHT)
حق نشر Red Hat
pesto نرم‌افزار آزاد است: شما می‌توانید آن را تحت شرایط «اجازه‌نامه عمومی همگانی گنو» (GNU General Public License) منتشرشده توسط بنیاد نرم‌افزارهای آزاد، چه نسخه 2 یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده یا تغییر دهید.