نام (NAME)

passt - اتصال شبکه‌ای حالت کاربری بدون امتیاز برای ماشین‌های مجازی
pasta - اتصال شبکه‌ای حالت کاربری بدون امتیاز برای فضاهای نام شبکه

خلاصه دستور (SYNOPSIS)

passt [گزینه]...
pasta [گزینه]... [دستور [آرگومان]...]
pasta [گزینه]... PID
pasta [گزینه]... --netns [مسیر|نام]

توضیحات (DESCRIPTION)

گزینه‌ها (OPTIONS)

مگر در مواردی که در ادامه قید شده باشد، اگر گزینه‌های متناقض یا متعددی داده شوند، آخرین گزینه اعمال می‌شود.

-d, --debug

خروجی با جزئیات کامل، عدم ثبت لاگ در ثبت‌کننده رویدادهای سیستم (system logger).

--trace

خروجی با جزئیات فوق‌العاده بالا، نمایش تک‌تک بسته‌ها. گزینه --debug را نیز فعال می‌کند.

--stats DELAY

نمایش آمار رویدادها با حداقل فاصله زمانی DELAY ثانیه میان به‌روزرسانی‌ها. اگر هیچ رویدادی رخ ندهد، آماری نمایش داده نمی‌شود.

-q, --quiet

پیام‌های اطلاعاتی چاپ نشوند.

-f, --foreground

عدم اجرا در پس‌زمینه. این بدان معناست که فرآیند پس از شروع به یک فضای نام PID مجزا منتقل نمی‌شود، زیرا خود PID نمی‌تواند تغییر کند. حالت پیش‌فرض، انشعاب به پس‌زمینه است.

-e, --stderr (منسوخ‌شده)

این گزینه هیچ تاثیری ندارد و صرفاً برای سازگاری با نسخه‌های پیشین حفظ شده است.

توجه داشته باشید که این گزینه پیکربندی منسوخ شده است و در نسخه‌های آینده حذف خواهد شد.

-l, --log-file PATH

ثبت گزارش‌ها در فایل PATH، و عدم ارسال به ثبات رویدادهای سیستم.

مشخص کردن چندباره این گزینه منجر به ایجاد چندین فایل لاگ نمی‌شود: آخرین گزینه مشخص‌شده اعمال خواهد شد.

--log-size SIZE

محدود کردن اندازه فایل لاگ به SIZE بایت. هنگامی که فایل لاگ پر شود، با حذف ورودی‌های قدیمی در ابتدای فایل، برای ورودی‌های جدید جا باز می‌شود. این محدودیت الزامی است. مقدار پیش‌فرض برابر با ۱۰۴۸۵۷۶ (۱ مگابایت) است.

--runas UID|UID:GID|LOGIN|LOGIN:GROUP

تلاش برای تغییر هویت به UID داده‌شده و گروه متناظر (اگر UID داده شود)، یا به UID و GID داده‌شده در صورت تعیین هر دو. به عنوان جایگزین، می‌توان نام کاربری (login)، یا نام کاربری و نام گروه را ارسال کرد. این کار برای اجرا به امتیازات ویژه (یا UID موثر اولیه 0 یا قابلیت CAP_SETUID) نیاز دارد. در صورت اجرا به عنوان کاربر ریشه، پیش‌فرض تغییر به کاربر nobody است.

-c, --conf-path path (آزمایشی)

مسیر سوکت کنترل و پیکربندی که توسط pesto(1) برای به‌روزرسانی پویای پیکربندی passt یا pasta استفاده می‌شود.

-h, --help

نمایش پیام راهنما و خروج.

--version

نمایش نسخه و خروج.

-p, --pcap file

ضبط بسته‌های شبکه متصل به tap (یعنی سمت ماشین مهمان یا سمت فضای نام) در فایل file با فرمت pcap.

مشخص کردن چندباره این گزینه منجر به ایجاد چندین فایل ضبط بسته نمی‌شود: آخرین گزینه مشخص‌شده اعمال خواهد شد.

-P, --pid file

نوشتن PID خود در فایل file پس از پایان مقداردهی اولیه، قبل از انشعاب به پس‌زمینه (در صورتی که برای چنین کاری تنظیم شده باشد).

-m, --mtu mtu

اختصاص مقدار mtu از طریق DHCP (گزینه 26) و NDP (گزینه نوع 5). مقدار صفر اختصاص MTU را غیرفعال می‌کند. به‌طور پیش‌فرض، MTU اعلان‌شده برابر با ۶۵۵۲۰ بایت است، یعنی حداکثر MTU در 802.3 منهای طول هدر 802.3، گرد شده به ۳۲ بیت (کلمات IPv4).

-a, --address addr[/prefix_len]

اختصاص addr برای IPv4 از طریق DHCP (yiaddr)، یا addr از طریق DHCPv6 (گزینه 5) و یک پیشوند مبتنی بر addr از طریق اعلان روتر NDP (گزینه نوع 3) برای یک addr در IPv6. یک پیشوند اختیاری /prefix_len (۰-۳۲ برای IPv4، ۰-۱۲۸ برای IPv6) می‌تواند با نمادگذاری CIDR الحاق شود (مثلاً 192.0.2.1/24). این روش جایگزینی برای استفاده از گزینه -n، --netmask است. ترکیب نمادگذاری CIDR با -n منجر به خطا می‌شود. اگر با این روش به یک آدرس IPv6 طول پیشوند اختصاص داده شود، در نسخه فعلی کد با مقدار پیش‌فرض ۶۴ بازنویسی می‌شود. این گزینه می‌تواند از صفر (برای مقادیر پیش‌فرض) تا دو بار (یک‌بار برای IPv4، یک‌بار برای IPv6) مشخص شود. به‌طور پیش‌فرض، آدرس‌های اختصاص‌یافته IPv4 و IPv6 از رابط‌های میزبانی که دارای اولین مسیر پیش‌فرض برای نسخه IP مربوطه هستند گرفته می‌شوند. اگر مسیر پیش‌فرضی موجود نباشد و رابطی با هر مسیری برای نسخه IP مشخص وجود داشته باشد، اولین رابط از میان آن‌ها انتخاب خواهد شد. در صورتی که چنین رابطی برای نسخه IP مشخص وجود نداشته باشد، آدرس محلی پیوند (link-local) به نشانی 169.254.2.1 برای IPv4 اختصاص داده می‌شود و هیچ آدرس دیگری برای IPv6 تخصیص نخواهد یافت.

-n, --netmask mask

اختصاص ماسک شبکه IPv4 با مقدار mask، بیان‌شده به‌صورت دهدهی نقطه‌دار یا تعداد بیت‌ها، از طریق DHCP (گزینه 1). همچنین می‌توان طول پیشوند را با استفاده از نمادگذاری CIDR همراه با گزینه -a، --address مشخص کرد (مثلاً -a 192.0.2.1/24). ترکیب -n با نمادگذاری CIDR منجر به خطا خواهد شد. اگر هیچ آدرسی مشخص نشده باشد، ماسک شبکه مرتبط با آدرس پذیرفته‌شده میزبان، در صورت وجود، استفاده می‌شود. اگر آدرسی مشخص شده باشد ولی بدون طول پیشوند باشد، ماسک شبکه بر اساس کلاس شبکه متناظر تعیین می‌گردد. در تمام موارد دیگر، ماسک شبکه با استفاده از طول پیشوند مشخص‌شده تعیین می‌شود.

-M, --mac-addr addr

استفاده از آدرس MAC مبدأ addr هنگام برقراری ارتباط با ماشین مهمان یا فضای نام هدف. مقدار پیش‌فرض، آدرس MAC مدیریت‌شده محلی 9a:55:9a:55:9a:55 است.

-g, --gateway addr

اختصاص addr برای IPv4 به عنوان دروازه پیش‌فرض (default gateway) از طریق DHCP (گزینه 3)، یا addr برای IPv6 به عنوان مبدأ برای پیام‌های اعلان روتر NDP و DHCPv6. این گزینه می‌تواند از صفر (برای مقادیر پیش‌فرض) تا دو بار (یک‌بار برای IPv4، یک‌بار برای IPv6) مشخص شود. به‌طور پیش‌فرض، دروازه‌های IPv4 و IPv6 از رابط میزبانی که دارای اولین مسیر پیش‌فرض برای نسخه IP مربوطه است گرفته می‌شوند. اگر مسیر پیش‌فرض از نوع چندمسیره (multipath) باشد، دروازه اولین روتر گام‌بعدی (nexthop) بازگردانده‌شده توسط هسته خواهد بود که بیشترین وزن را در مجموعه مسیرها دارد. اگر هیچ مسیر پیش‌فرضی موجود نباشد و تنها یک رابط با هر نوع مسیری وجود داشته باشد، آن رابط انتخاب خواهد شد. در صورتی که چنین رابطی برای نسخه IP مشخص وجود نداشته باشد، آدرس محلی پیوند 169.254.2.2 برای IPv4 و آدرس محلی پیوند fe80::1 برای IPv6 استفاده خواهد شد.

نکته: این آدرس‌ها همچنین به عنوان آدرس مبدأ برای بسته‌های ارسالی به ماشین مهمان یا فضای نام هدف که دارای آدرس مبدأ محلی یا loopback هستند استفاده می‌شوند، تا نگاشت ترافیک محلی به مهمان و فضای نام هدف امکان‌پذیر باشد. برای جزئیات بیشتر درباره این سازوکار، بخش نکات (NOTES) را در ادامه ببینید.

-i, --interface name

استفاده از رابط میزبان name برای استخراج آدرس‌ها و مسیرها. حالت پیش‌فرض استفاده از رابط‌های مشخص‌شده با --outbound-if4 و --outbound-if6، به ترتیب برای آدرس‌ها و مسیرهای IPv4 و IPv6 است.

اگر رابطی مشخص نشود، رابط دارای اولین مسیرهای پیش‌فرض برای هر نسخه IP انتخاب می‌شود. اگر هیچ مسیر پیش‌فرضی موجود نباشد و فقط یک رابط با هر مسیری وجود داشته باشد، آن رابط انتخاب خواهد شد. در صورتی که چنین رابطی وجود نداشته باشد، رابط‌های میزبان برای اهداف تخصیص آدرس‌ها و مسیرها نادیده گرفته شده و در عوض از آدرس‌های محلی پیوند استفاده می‌شود.

-o, --outbound addr

استفاده از یک آدرس IPv4 addr به عنوان آدرس مبدأ برای اتصالات خروجی TCP، جریان‌های UDP و درخواست‌های ICMP در IPv4، یا یک آدرس IPv6 addr برای ارتباطات IPv6، از طریق متصل کردن سوکت‌های خروجی به آن. این گزینه می‌تواند از صفر (برای مقادیر پیش‌فرض) تا دو بار (یک‌بار برای IPv4، یک‌بار برای IPv6) مشخص شود. به‌طور پیش‌فرض، آدرس مبدأ توسط جدول‌های مسیریابی انتخاب می‌شود.

--outbound-if4 name

متصل کردن سوکت‌های خروجی IPv4 به رابط میزبان name، و استفاده از این رابط برای استخراج آدرس‌ها و مسیرهای IPv4 (مگر اینکه رابط دیگری از طریق -i، --interface مشخص شده باشد).

به‌طور پیش‌فرض، رابط تعیین‌شده توسط مسیر پیش‌فرض انتخاب می‌شود. اگر هیچ مسیر پیش‌فرضی موجود نباشد و فقط یک رابط با هر مسیری وجود داشته باشد، آن رابط انتخاب خواهد شد. در صورت عدم وجود چنین رابطی، سوکت‌های خروجی به رابط خاصی متصل نخواهند شد.

--outbound-if6 name

متصل کردن سوکت‌های خروجی IPv6 به رابط میزبان name، و استفاده از این رابط برای استخراج آدرس‌ها و مسیرهای IPv6 (مگر اینکه رابط دیگری از طریق -i، --interface مشخص شده باشد).

به‌طور پیش‌فرض، رابط تعیین‌شده توسط مسیر پیش‌فرض انتخاب می‌شود. اگر هیچ مسیر پیش‌فرضی موجود نباشد و فقط یک رابط با هر مسیری وجود داشته باشد، آن رابط انتخاب خواهد شد. در صورت عدم وجود چنین رابطی، سوکت‌های خروجی به رابط خاصی متصل نخواهند شد.

-D, --dns addr

دستور دادن به ماشین مهمان (از طریق DHCP، DHCPv6 یا NDP) برای استفاده از addr (IPv4 یا IPv6) به عنوان کارساز نام (nameserver)، طبق پیکربندی (گزینه‌های --no-dhcp-dns و --dhcp-dns را ببینید)، به جای خواندن آدرس‌ها از /etc/resolv.conf. این گزینه می‌تواند چندین بار مشخص شود. تعیین -D none استفاده از آدرس‌های DNS را به‌طور کلی غیرفعال می‌کند. برخلاف آدرس‌های برگرفته از /etc/resolv.conf، آدرس addr بدون بازنگاشت به مهمان داده می‌شود. به عنوان مثال --dns 127.0.0.1 به مهمان دستور می‌دهد که از خود به عنوان کارساز نام استفاده کند، نه از میزبان.

--dns-forward addr

نگاشت آدرس addr (IPv4 یا IPv6) آن‌گونه که از سمت مهمان یا فضای نام دیده می‌شود، به کارساز نام (با نسخه IP مربوطه) که توسط گزینه --dns-host تعیین شده است. تنها ترافیک UDP و TCP به پورت ۵۳ یا پورت ۸۵۳ نگاشت می‌شود. پاسخ‌ها با یک نگاشت معکوس بازگردانده می‌شوند. این گزینه می‌تواند از صفر تا دو بار (یک‌بار برای IPv4، یک‌بار برای IPv6) مشخص گردد.

--dns-host addr

پیکربندی کارساز نام میزبان که پرس‌وجوهای ارسالی از مهمان یا فضای نام به آدرس --dns-forward به آن هدایت خواهند شد. این گزینه می‌تواند از صفر تا دو بار (یک‌بار برای IPv4، یک‌بار برای IPv6) مشخص شود. به‌طور پیش‌فرض، اولین کارساز نام برگرفته از /etc/resolv.conf در میزبان است.

-S, --search list

استفاده از فهرست جداشده با فاصله list برای مقاصد DHCP، DHCPv6 و NDP، به جای خواندن ورودی‌ها از /etc/resolv.conf. گزینه‌های --no-dhcp-search و --dhcp-search را ببینید. گزینه --search none فهرست جستجوی دامنه DNS را به‌طور کامل غیرفعال می‌کند (اگر نیاز دارید دامنه‌ای با نام "none" را جستجو کنید می‌توانید از --search none. استفاده کنید).

--no-dhcp-dns

در حالت passt، آدرس‌های IPv4 از طریق DHCP (گزینه 23) یا آدرس‌های IPv6 از طریق اعلان روتر NDP (گزینه نوع 25) و DHCPv6 (گزینه 23) به عنوان تحلیل‌گرهای DNS اختصاص داده نشوند. به‌طور پیش‌فرض، تمام آدرس‌های پیکربندی‌شده ارسال می‌شوند.

--dhcp-dns

در حالت pasta، اختصاص آدرس‌های IPv4 از طریق DHCP (گزینه 23) یا آدرس‌های IPv6 از طریق اعلان روتر NDP (گزینه نوع 25) و DHCPv6 (گزینه 23) به عنوان تحلیل‌گرهای DNS. به‌طور پیش‌فرض، آدرس‌های پیکربندی‌شده، در صورت وجود، ارسال نمی‌شوند.

--no-dhcp-search

در حالت passt، آدرس‌های فهرست جستجوی دامنه DNS از طریق DHCP (گزینه 119)، از طریق اعلان روتر NDP (گزینه نوع 31) و DHCPv6 (گزینه 24) ارسال نشوند. به‌طور پیش‌فرض، فهرست جستجوی دامنه DNS حاصل از پیکربندی ارسال می‌شود.

--dhcp-search

در حالت pasta، ارسال آدرس‌های فهرست جستجوی دامنه DNS از طریق DHCP (گزینه 119)، از طریق اعلان روتر NDP (گزینه نوع 31) و DHCPv6 (گزینه 24). به‌طور پیش‌فرض، فهرست جستجوی دامنه DNS حاصل از پیکربندی ارسال نمی‌شود.

--no-tcp

غیرفعال کردن گرداننده پروتکل TCP. هیچ اتصال TCP در سمت میزبان پذیرفته نخواهد شد و بسته‌های TCP دریافتی از ماشین مهمان یا فضای نام هدف بدون هیچ هشداری دور ریخته می‌شوند.

--no-udp

غیرفعال کردن گرداننده پروتکل UDP. هیچ ترافیک UDP از سمت میزبان هدایت نخواهد شد و بسته‌های UDP دریافتی از ماشین مهمان یا فضای نام هدف بدون هیچ هشداری دور ریخته می‌شوند.

--no-icmp

غیرفعال کردن گرداننده پروتکل ICMP/ICMPv6. درخواست‌های ICMP و ICMPv6 دریافتی از ماشین مهمان یا فضای نام هدف بدون هیچ هشداری دور ریخته می‌شوند. گزینه --no-ndp را نیز در بر می‌گیرد.

--no-dhcp

غیرفعال کردن کارساز DHCP. درخواست‌های کلاینت DHCP دریافتی از ماشین مهمان یا فضای نام هدف نادیده گرفته می‌شوند. در صورتی که هیچ دروازه‌ای روی مسیر پیش‌فرض IPv4 انتخاب‌شده وجود نداشته باشد، این گزینه به صورت ضمنی اعمال می‌شود.

--no-ndp

غیرفعال کردن کشف همسایه (Neighbor Discovery). پیام‌های NDP دریافتی از مهمان یا فضای نام هدف نادیده گرفته می‌شوند. هیچ پیام NDP اولیه‌ای ارسال نخواهد شد.

--no-dhcpv6

غیرفعال کردن کارساز DHCPv6. درخواست‌های کلاینت DHCPv6 دریافتی از ماشین مهمان یا فضای نام هدف نادیده گرفته می‌شوند.

--no-ra

غیرفعال کردن اعلان‌های روتر (Router Advertisements). تقاضاهای روتر (Router Solicitations) دریافتی از ماشین مهمان یا فضای نام هدف نادیده گرفته می‌شوند.

--freebind

اجازه به مشخص کردن هر آدرس اتصال (binding address) برای گزینه‌های -t و -u. معمولاً آدرس‌های اتصال باید آدرس‌هایی باشند که در حال حاضر روی میزبان پیکربندی شده‌اند. با --freebind، گزینه سوکت IP_FREEBIND یا IPV6_FREEBIND فعال شده و امکان استفاده از هر آدرسی را فراهم می‌کند. این گزینه معمولاً برای پیوند دادن آدرس‌هایی استفاده می‌شود که ممکن است در آینده روی میزبان پیکربندی شوند و در آن لحظه هدایت ترافیک بلافاصله شروع به کار خواهد کرد.

--map-host-loopback addr

ترجمه addr برای ارجاع به میزبان. بسته‌های ارسالی از مهمان به addr به میزبان هدایت خواهند شد. در میزبان، چنین بسته‌هایی طوری به نظر می‌رسند که هم مبدأ و هم مقصد آن‌ها 127.0.0.1 یا ::1 است.

اگر addr برابر با 'none' باشد، هیچ آدرسی نگاشت نمی‌شود (این به معنی --no-map-gw است). تنها یک آدرس IPv4 و یک آدرس IPv6 می‌تواند ترجمه شود؛ اگر این گزینه چند بار مشخص شود، آخرین مورد اعمال می‌گردد.

حالت پیش‌فرض، ترجمه آدرس دروازه پیش‌فرض مهمان است، مگر اینکه --no-map-gw مشخص شده باشد که در این صورت هیچ آدرسی نگاشت نمی‌شود.

--no-map-gw

اتصالات TCP و ترافیک ردیابی‌نشده UDP که مقصد آن‌ها آدرس دروازه است، به میزبان بازنگاشت نشوند. در صورتی که هیچ دروازه‌ای روی مسیر پیش‌فرض انتخاب‌شده وجود نداشته باشد، یا برای هر یک از خانواده‌های آدرس فعال مسیر پیش‌فرضی موجود نباشد، این گزینه به صورت ضمنی اعمال می‌شود.

--chroot-fallback

فعال کردن بازگشت به chroot() در صورتی که pivot_root() (که برای جابجایی به یک فایل‌سیستم خالی به منظور جداسازی دقیق‌تر استفاده می‌شود) با خطا مواجه شود. این گزینه برای یکپارچه‌سازی‌هایی که از tmpfs یا initramfs به عنوان فایل‌سیستم ریشه استفاده می‌کنند و pivot_root() در آن‌ها به دلیل خطای شناسه نامعتبر (EINVAL) قابل استفاده نیست، کاربرد دارد.

به‌طور پیش‌فرض، قابلیت بازگشت غیرفعال است. اگر pivot_root() ناموفق باشد، کل فرآیند ایزوله‌سازی و sandbox با شکست مواجه می‌شود.

--map-guest-addr addr

ترجمه addr در مهمان به آدرسی برابر با آدرس اختصاص‌یافته به مهمان در میزبان. به این معنا که بسته‌های مهمان به addr به آدرس اختصاص‌یافته به مهمان با -a، یا به طور پیش‌فرض به آدرس سراسری (global) میزبان هدایت خواهند شد. این کار به مهمان اجازه می‌دهد به سرویس‌های موجود روی آدرس سراسری میزبان دسترسی داشته باشد، حتی اگر آدرس خود مهمان آدرس میزبان را بپوشاند (shadow کند).

اگر addr برابر با 'none' باشد، هیچ آدرسی نگاشت نمی‌شود. تنها یک آدرس IPv4 و یک آدرس IPv6 قابل ترجمه هستند و اگر این گزینه چند بار مشخص شود، آخرین مورد برای هر نوع آدرس اعمال خواهد شد.

به‌طور پیش‌فرض، نگاشت همان‌طور که برای گزینه --map-host-loopback توضیح داده شد انجام می‌شود.

-4, --ipv4-only

فعال کردن عملکرد فقط IPv4. ترافیک IPv6 نادیده گرفته خواهد شد. به‌طور پیش‌فرض، عملکرد IPv6 تا زمانی که حداقل یک مسیر IPv6 و یک آدرس رابط روی یک رابط میزبان مشخص پیکربندی شده باشد، فعال است.

-6, --ipv6-only

فعال کردن عملکرد فقط IPv6. ترافیک IPv4 نادیده گرفته خواهد شد. به‌طور پیش‌فرض، عملکرد IPv4 تا زمانی که حداقل یک مسیر IPv4 و یک آدرس رابط روی یک رابط میزبان مشخص پیکربندی شده باشد، فعال است.

-H, --hostname name

نام میزبان (hostname) برای پیکربندی روی کلاینت. ارسال name به عنوان گزینه 12 در DHCP (hostname).

--fqdn name

نام کامل دامنه (FQDN) برای پیکربندی روی کلاینت. ارسال name به عنوان Client FQDN: گزینه 81 در DHCP و گزینه 39 در DHCPv6.

-t, --tcp-ports spec

پیکربندی هدایت درگاه TCP به مهمان یا فضای نام. spec می‌تواند یکی از موارد زیر باشد:

ports فهرستی از ورودی‌ها است که با کاما از هم جدا شده‌اند و می‌تواند هر یک از موارد زیر باشد:

first[-last][:[toaddr/]tofirst[-tolast]]

first[-last][:toaddr]

بازه شمول (Include range). هدایت شماره پورت‌های میان first و last (شامل هر دو) به پورت‌های میان tofirst و tolast روی آدرس toaddr. اگر toaddr حذف شود، آدرس مهمان یا فضای نام به‌طور خودکار تعیین می‌شود. اگر tofirst و tolast حذف شوند، برابر با همان مقادیر first و last فرض می‌شوند. اگر last حذف شود، برابر با first در نظر گرفته می‌شود.

~first[-last]

بازه عدم شمول (Exclude range). عدم هدایت شماره پورت‌های بین first و last. این گزینه بر بازه‌های شمول اولویت دارد.

all[:toaddr]

هدایت تمام پورت‌های متصل‌نشده و غیرموقت (non-ephemeral) که تحت پوشش بازه‌های عدم شمول فوق نیستند، بر اساس مجوزها و قابلیت‌های فعلی، به پورت‌های متناظر روی آدرس toaddr. اگر toaddr حذف شود، آدرس مهمان یا فضای نام به‌طور خودکار تعیین می‌شود. برای پورت‌های پایین (کمتر از ۱۰۲۴)، بخش نکات (NOTES) را ببینید. برای پورت‌های غیرقابل‌دسترس هیچ خطایی گزارش نمی‌شود، مگر اینکه هیچ پورتی اصلاً امکان هدایت نداشته باشد.

auto

تنها برای pasta. تنها پورت‌هایی از مجموعه مشخص‌شده را هدایت کن که پورت‌های هدف در فضای نام متصل (bound) شده باشند. فهرست پورت‌ها به صورت دوره‌ای (هر یک ثانیه) از سوکت‌های شنود ارائه‌شده توسط /proc/net/tcp و /proc/net/tcp6 استخراج می‌شود، proc(5) را ببینید.

مشخص کردن بازه‌های عدم شمول به تنهایی به این معناست که تمام پورت‌های غیرموقت دیگر هدایت می‌شوند. تعیین نکردن هیچ بازه‌ای معادل با 'all' است. در این حالت، برای پورت‌های غیرقابل دسترس هیچ خطایی گزارش نمی‌شود، مگر اینکه هیچ پورتی قابل هدایت نباشد.

مثال‌ها:

حالت پیش‌فرض برای passt برابر با none و برای pasta برابر با auto است.

-u, --udp-ports spec

پیکربندی هدایت پورت UDP به ماشین مهمان. پارامتر spec همانند آنچه برای TCP در بالا توضیح داده شد عمل می‌کند.

نکته: مگر در صورتی که بازنویسی شود، پورت‌های UDP با شماره‌های متناظر با پورت‌های هدایت‌شده TCP نیز بدون هیچ‌گونه ترجمه پورتی هدایت می‌شوند. پورت‌های متصل به IPv6 نیز برای IPv4 هدایت خواهند شد.

حالت پیش‌فرض برای passt برابر با none و برای pasta برابر با auto است.

مثال‌ها (EXAMPLES)

$ iperf3 -s -D
$ pasta --config-net
# ip address show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host proto kernel_lo 
       valid_lft forever preferred_lft forever
2: enp9s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 65520 qdisc fq_codel state UNKNOWN group default qlen 1000
    link/ether be:16:49:5a:65:dc brd ff:ff:ff:ff:ff:ff
    inet 88.198.0.164/27 brd 88.198.0.191 scope global noprefixroute enp9s0
       valid_lft forever preferred_lft forever
    inet6 2a01:4f8:222:904::2/64 scope global nodad 
       valid_lft forever preferred_lft forever
    inet6 fe80::bc16:49ff:fe5a:65dc/64 scope link nodad proto kernel_ll 
       valid_lft forever preferred_lft forever
# ip route show
default via 88.198.0.161 dev enp9s0 proto dhcp metric 1002 
88.198.0.160/27 dev enp9s0 proto dhcp scope link metric 1002 
# ip -6 route show
2a01:4f8:222:904::/64 dev enp9s0 proto kernel metric 256 pref medium
fe80::/64 dev enp9s0 proto kernel metric 256 pref medium
default via fe80::1 dev enp9s0 metric 1024 onlink pref medium
# iperf3 -c 127.0.0.1 -t1
Connecting to host 127.0.0.1, port 5201
[  5] local 127.0.0.1 port 59112 connected to 127.0.0.1 port 5201
[ ID] Interval           Transfer     Bitrate         Retr  Cwnd
[  5]   0.00-1.00   sec  3.89 GBytes  33.4 Gbits/sec    0   2.62 MBytes       
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval           Transfer     Bitrate         Retr
[  5]   0.00-1.00   sec  3.89 GBytes  33.4 Gbits/sec    0             sender
[  5]   0.00-1.00   sec  3.89 GBytes  33.4 Gbits/sec                  receiver
iperf Done.
# iperf3 -c ::1 -t1
Connecting to host ::1, port 5201
[  5] local ::1 port 49138 connected to ::1 port 5201
[ ID] Interval           Transfer     Bitrate         Retr  Cwnd
[  5]   0.00-1.00   sec  4.32 GBytes  37.0 Gbits/sec    0   1.06 MBytes       
- - - - - - - - - - - - - - - - - - - - - - - - -
[ ID] Interval           Transfer     Bitrate         Retr
[  5]   0.00-1.00   sec  4.32 GBytes  37.0 Gbits/sec    0             sender
[  5]   0.00-1.00   sec  4.32 GBytes  37.0 Gbits/sec                  receiver
iperf Done.
# ping -nc1 -4 spaghetti.pizza
PING spaghetti.pizza (5.161.47.86) 56(84) bytes of data.
64 bytes from 5.161.47.86: icmp_seq=1 ttl=255 time=99.4 ms
--- spaghetti.pizza ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 99.433/99.433/99.433/0.000 ms
# ping -nc1 -6 spaghetti.pizza
PING spaghetti.pizza (2a01:4f8:1c1e:d6f1::1) 56 data bytes
64 bytes from 2a01:4f8:1c1e:d6f1::1: icmp_seq=1 ttl=255 time=3.11 ms
--- spaghetti.pizza ping statistics ---
1 packets transmitted, 1 received, 0% packet loss, time 0ms
rtt min/avg/max/mdev = 3.110/3.110/3.110/0.000 ms

$ unshare -rUn
# echo $$
1295969

$ pasta --config-net 1295969
Template interface: enp9s0 (IPv4), enp9s0 (IPv6)
Namespace interface: enp9s0
MAC:
    host: 9a:55:9a:55:9a:55
    NAT to host 127.0.0.1: 88.198.0.161
DHCP:
    assign: 88.198.0.164
    mask: 255.255.255.224
    router: 88.198.0.161
DNS:
    185.12.64.1
    185.12.64.2
    NAT to host ::1: fe80::1
NDP/DHCPv6:
    assign: 2a01:4f8:222:904::2
    router: fe80::1
    our link-local: fe80::1
Inbound forwarding rules (HOST):
    TCP [*]:1-32767  =>  1-32767  (best effort) (auto-scan)
    TCP [*]:61000-65535  =>  61000-65535  (best effort) (auto-scan)
    UDP [*]:1-32767  =>  1-32767  (best effort) (auto-scan)
    UDP [*]:61000-65535  =>  61000-65535  (best effort) (auto-scan)
Outbound forwarding rules (SPLICE):
    TCP [*]%lo:1-32767  =>  1-32767  (best effort) (auto-scan)
    TCP [*]%lo:61000-65535  =>  61000-65535  (best effort) (auto-scan)
    UDP [*]%lo:1-32767  =>  1-32767  (best effort) (auto-scan)
    UDP [*]%lo:61000-65535  =>  61000-65535  (best effort) (auto-scan)

# ip address show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host proto kernel_lo 
       valid_lft forever preferred_lft forever
2: enp9s0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 65520 qdisc fq_codel state UNKNOWN group default qlen 1000
    link/ether 9a:44:5e:54:d3:2c brd ff:ff:ff:ff:ff:ff
    inet 88.198.0.164/27 brd 88.198.0.191 scope global noprefixroute enp9s0
       valid_lft forever preferred_lft forever
    inet6 2a01:4f8:222:904::2/64 scope global nodad 
       valid_lft forever preferred_lft forever
    inet6 fe80::9844:5eff:fe54:d32c/64 scope link nodad proto kernel_ll 
       valid_lft forever preferred_lft forever

$ passt -f -t 2222:22
UNIX domain socket bound at /tmp/passt_1.socket
No IPv6 nameserver available for NDP/DHCPv6
Template interface: enp9s0 (IPv4), enp9s0 (IPv6)
MAC:
    host: 9a:55:9a:55:9a:55
    NAT to host 127.0.0.1: 88.198.0.161
DHCP:
    assign: 88.198.0.164
    mask: 255.255.255.224
    router: 88.198.0.161
DNS:
    185.12.64.1
    185.12.64.2
    NAT to host ::1: fe80::1
NDP/DHCPv6:
    assign: 2a01:4f8:222:904::2
    router: fe80::1
    our link-local: fe80::1
Inbound forwarding rules (HOST):
    TCP [*]:2222  =>  22 
You can now start qemu (>= 7.2, with commit 13c6be96618c):
    kvm ... -device virtio-net-pci,netdev=s -netdev stream,id=s,server=off,addr.type=unix,addr.path=/tmp/passt_1.socket

$ qemu-system-x86_64 -m 128 test.qcow2 -display none -nodefaults -nographic -device virtio-net-pci,netdev=s -netdev stream,id=s,server=off,addr.type=unix,addr.path=/tmp/passt_1.socket

accepted connection from PID 1301736
New guest MAC address observed: 52:54:00:12:34:56
DHCP: offer to discover
    from 52:54:00:12:34:56
DHCP: ack to request
    from 52:54:00:12:34:56
NDP: received RS, sending RA

$ ssh -p 2222 root@localhost
root@localhost's password: 

# ip address show
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN qlen 1000
    link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
    inet 127.0.0.1/8 scope host lo
       valid_lft forever preferred_lft forever
    inet6 ::1/128 scope host 
       valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP qlen 1000
    link/ether 52:54:00:12:34:56 brd ff:ff:ff:ff:ff:ff
    inet 88.198.0.164/27 scope global eth0
       valid_lft forever preferred_lft forever
    inet6 2a01:4f8:222:904:5054:ff:fe12:3456/64 scope global dynamic flags 100 
       valid_lft forever preferred_lft forever
    inet6 fe80::5054:ff:fe12:3456/64 scope link 
       valid_lft forever preferred_lft forever

نکات (NOTES)

محدودیت‌ها (LIMITATIONS)

در حال حاضر، پروکسی IGMP/MLD (بر اساس RFC 4605) و پشتیبانی از SCTP (بر اساس RFC 4960) پیاده‌سازی نشده‌اند.

پروتکل TCP Selective Acknowledgment (بر اساس RFC 2018)، و همچنین حفاظت در برابر دنباله‌های پیچیده (PAWS) و اندازه‌گیری زمان رفت و برگشت (RTTM) که هر دو در RFC 7232 توصیف شده‌اند، در حال حاضر پیاده‌سازی نشده‌اند.

نویسندگان (AUTHORS)

Stefano Brivio <sbrivio@redhat.com>, David Gibson <david@gibson.dropbear.id.au>.

گزارش باگ‌ها (REPORTING BUGS)

لطفاً مشکلات را در سامانه ردیابی باگ در https://passt.top/passt/bugs گزارش دهید، یا پیامی به لیست پستی passt-user@passt.top ارسال نمایید، https://passt.top/passt/lists را ببینید.

حق نشر (COPYRIGHT)

حق نشر (c) 2020-2022 Red Hat GmbH.

ابزارهای passt و pasta نرم‌افزار آزاد هستند: شما می‌توانید آن‌ها را تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) منتشرشده توسط بنیاد نرم‌افزارهای آزاد؛ نسخه ۲ یا (به انتخاب خودتان) هر نسخه بعدی، بازتوزیع کرده و/یا تغییر دهید.

همچنین ببینید (SEE ALSO)

namespaces(7), qemu(1), qrap(1), slirp4netns(1).

مستندات سطح بالا در نشانی https://passt.top/passt/about در دسترس است.