SPIPED(1) spiped README SPIPED(1)

spiped - دیمن لولهٔ امن

spiped {-e | -d} -s <source socket> -t <target socket> -k <key file>
[-DFj] [-b <bind address>] [-f | -g] [-n <max # connections>]
[-o <connection timeout>] [-p <pidfile>] [-r <rtime> | -R] [--syslog]
[-u <username> | <:groupname> | <username:groupname>]
spiped -v

اتصال‌های رمزگذاری‌نشده را از source socket گرفته و اتصال‌های رمزگذاری‌شده را به target socket ارسال می‌کند.
اتصال‌های رمزگذاری‌شده را از source socket گرفته و اتصال‌های رمزگذاری‌نشده را به target socket ارسال می‌کند.
نشانی‌ای که spiped باید روی آن برای اتصال‌های ورودی گوش فرا دهد. قالب‌های پذیرفته‌شده مشابه موارد پذیرفته‌شده برای target socket است. توجه داشته باشید که برخلاف target socket، نام‌های میزبان هنگام راه‌اندازی spiped تحلیل می‌شوند و پس از آن مجدداً تحلیل نخواهند شد؛ بنابراین در صورت تغییر ورودی‌های DNS، spiped همچنان به پذیرش اتصال‌ها روی نشانی منقضی‌شده ادامه خواهد داد.
نشانی‌ای که spiped باید به آن متصل شود. باید در یکی از قالب‌های زیر باشد:
  • /absolute/path/to/unix/socket
  • host.name:port
  • [ip.v4.ad.dr]:port
  • [ipv6::addr]:port
نام‌های میزبان هر rtime ثانیه یک‌بار دوباره تحلیل می‌شوند.
از فایل کلید ارائه‌شده برای احراز هویت و رمزگذاری استفاده می‌کند. برای خواندن از ورودی استاندارد مقدار «-» را بدهید.
نشانی خروجی را مقید (bind) می‌کند. اگر این یک نشانی شبکه باشد، شمارهٔ درگاه (port) می‌تواند مشخص شده یا به سیستم‌عامل واگذار شود. اگر شمارهٔ درگاه را تعیین کنید، سیستم‌عامل به شما اجازهٔ برقراری اتصال دوم را تا زمانی که اتصال نخست کاملاً منقضی شود (یعنی وضعیت TCP دیگر در وضعیت TIME-WAIT نباشد) نخواهد داد.
انتظار برای DNS. در حالت عادی هنگامی که spiped راه‌اندازی می‌شود، پیش از بازگشت فرایند والد، نشانی‌ها را تحلیل کرده و به source socket خود مقید می‌شود؛ با این گزینه ابتدا فرایند دیمن شده و جستجوهای ناموفق DNS را تا زمان موفقیت تکرار می‌کند. این امر به spiped اجازه می‌دهد حتی اگر DNS هنوز برپا نشده باشد اجرا شود، اما به قیمت از دست رفتن این تضمین که پس از اتمام راه‌اندازی spiped، برنامه بی‌درنگ آمادهٔ ایجاد لوله‌ها خواهد بود.
استفاده از دست‌تکانی سریع/ضعیف: این گزینه زمان پردازنده (CPU) مصرفی در برپایی اولیهٔ اتصال را با غیرفعال کردن دست‌تکانی Diffie-Hellman کاهش می‌دهد، به بهای از دست دادن رازداری سرآمد کامل (perfect forward secrecy).
الزام به رازداری سرآمد کامل (perfect forward secrecy) از طریق قطع اتصال در صورتی که میزبان مقابل از گزینهٔ -f استفاده کند.
اجرا در پیش‌زمینه (foreground). این گزینه می‌تواند برای سیستم‌هایی مانند daemontools مفید باشد.
غیرفعال کردن پیام‌های زنده‌داری (keep-alives) لایهٔ انتقال. (به‌طور پیش‌فرض فعال هستند.)
محدودیت تعداد اتصال‌های هم‌زمان مجاز. مقدار 0 نشان‌دهندهٔ عدم اعمال محدودیت است؛ این کار ممکن است در برخی شرایط مناسب نباشد، چرا که اگر spiped نتواند برای مدیریت یک اتصال جدید حافظه تخصیص دهد، متوقف خواهد شد. پیش‌فرض 100 اتصال است.
مهلت زمانی (timeout) بر حسب ثانیه که پس از آن، در صورت کامل نشدن تلاش برای اتصال به مقصد یا دست‌تکانی پروتکل، فرایند لغو (و اتصال قطع) خواهد شد. پیش‌فرض 5 ثانیه است.
فایلی که شناسهٔ فرایند (PID) متعلق به spiped باید در آن نوشته شود. پیش‌فرض source socket.pid است (در دایرکتوری فعلی، در صورتی که source socket یک مسیر مطلق نباشد). در صورت استفاده از گزینهٔ -F (اجرا در پیش‌زمینه)، هیچ فایلی نوشته نخواهد شد.
تحلیل مجدد نشانی target socket در هر rtime ثانیه. پیش‌فرض تحلیل مجدد هر 60 ثانیه یک‌بار است.
غیرفعال کردن تحلیل مجدد نشانی مقصد.
پس از دیمن شدن، هشدارها به جای stderr به syslog ارسال شوند. در صورت استفاده از -F (اجرا در پیش‌زمینه)، اثری نخواهد داشت.
پس از مقیدسازی (bind) سوکت، تغییر کاربر به username و/یا گروه به groupname.
چاپ شمارهٔ نسخه.

دستور spiped رفتار ویژه‌ای برای سیگنال‌های زیر در نظر گرفته است:

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

spipe(1).

@DATE@ spiped @VERSION@