.TH "socat" "1" "" "" ""

.PP 
.SH "نام (NAME)"
socat \- بازپخشکننده همهمنظوره (سوکت کت)
.PP 
.SH "خلاصه دستور (SYNOPSIS)"
\f(CWsocat [گزینه‌ها] <آدرس> <آدرس>\fP
.br 
\f(CWsocat \-V\fP
.br 
\f(CWsocat \-h[h[h]] | \-?[?[?]]\fP
.br 
\f(CWfilan\fP
.br 
\f(CWprocan\fP
.PP 
.SH "توضیحات (DESCRIPTION)"

.PP 
ابزار \fBSocat\fP یک ابزار مبتنی بر خط فرمان است که دو جریان بایت دوطرفه برقرار کرده و داده‌ها را میان آن‌ها منتقل می‌کند\&. از آنجا که این جریان‌ها می‌توانند از مجموعه بزرگی از انواع مختلف گیرنده‌ها و منابع داده (به انواع آدرس مراجعه کنید) ساخته شوند، و از آنجا که گزینه‌های آدرس متعددی را می‌توان روی این جریان‌ها اعمال کرد، socat می‌تواند برای اهداف بسیار گوناگونی به کار گرفته شود\&.
.PP 
ابزار \fBFilan\fP ابزاری است که اطلاعات مربوط به توصیف‌کننده‌های فایل فعال خود را در خروجی استاندارد (stdout) چاپ می‌کند\&. این ابزار برای اشکال‌زدایی \fBsocat\fP نوشته شده است، اما ممکن است برای مقاصد دیگر نیز سودمند باشد\&. برای یافتن اطلاعات بیشتر از گزینه \-h استفاده کنید\&.
.PP 
ابزار \fBProcan\fP ابزاری است که اطلاعات مربوط به پارامترهای فرایند را در خروجی استاندارد چاپ می‌کند\&. این ابزار برای درک بهتر برخی از ویژگی‌های فرایند یونیکس و اشکال‌زدایی \fBsocat\fP نوشته شده است، اما برای اهداف دیگر نیز ممکن است مفید واقع شود\&.
.PP 
چرخه حیات یک نمونه \fBsocat\fP معمولاً از چهار مرحله تشکیل شده است\&.
.PP 
در مرحله مقداردهی اولیه (\fIinit\fP)، گزینه‌های خط فرمان تجزیه شده و ثبت وقایع (logging) آغاز می‌شود\&. 
.PP 
در طول مرحله باز کردن (\fIopen\fP)، \fBsocat\fP ابتدا آدرس نخست و سپس آدرس دوم را باز می‌کند\&. این مراحل معمولاً مسدودکننده (blocking) هستند؛ از این رو، به‌ویژه برای انواع آدرس‌های پیچیده مانند socks، درخواست‌های اتصال یا گفتگوهای احراز هویت باید پیش از آغاز مرحله بعدی تکمیل شوند\&.
.PP 
در مرحله انتقال (\fItransfer\fP)، \fBsocat\fP توصیف‌کننده‌های فایل خواندن و نوشتن هر دو جریان را از طریق
\f(CWselect()\fP
زیر نظر می‌گیرد و هنگامی که داده در یک طرف آماده باشد \fIو\fP
بتوان آن را در طرف دیگر نوشت، socat آن را می‌خواند، در صورت نیاز تبدیل نویسه خط جدید (newline) را انجام می‌دهد، داده را در توصیف‌کننده فایل نوشتن جریان دیگر می‌نویسد، و سپس به انتظار برای داده‌های بیشتر در هر دو جهت ادامه می‌دهد\&.
.PP 
هنگامی که یکی از جریان‌ها عملاً به انتهای فایل (EOF) می‌رسد، مرحله بستن (\fIclosing\fP)
آغاز می‌گردد\&. \fBSocat\fP وضعیت EOF را به جریان دیگر منتقل می‌کند،
یعنی تلاش می‌کند تنها جریان نوشتن آن را ببندد (shutdown)، و به آن فرصت می‌دهد تا به آرامی و به درستی خاتمه یابد\&. برای مدتی مشخص، \fBsocat\fP به انتقال داده در جهت دیگر ادامه می‌دهد، اما پس از آن تمام کانال‌های باقی‌مانده را بسته و خاتمه می‌یابد\&.
.PP 
.SH "گزینهها (OPTIONS)"

.PP 
ابزار \fBSocat\fP چند گزینه خط فرمان ارائه می‌دهد که رفتار برنامه را تغییر می‌دهند\&. آن‌ها هیچ ارتباطی با به‌اصطلاح گزینه‌های آدرس که به عنوان بخشی از مشخصات آدرس استفاده می‌شوند، ندارند\&.
.PP 
.IP "\fB\f(CW\-V\fP\fP"
اطلاعات نسخه و قابلیت‌های در دسترس را در خروجی استاندارد چاپ کرده و خارج می‌شود\&.
.IP "\fB\f(CW\-h | \-?\fP\fP"
یک متن راهنما شامل شرح گزینه‌های خط فرمان و انواع آدرس‌های در دسترس را در خروجی استاندارد چاپ کرده و خارج می‌شود\&.
.IP "\fB\f(CW\-hh | \-??\fP\fP"
مشابه \-h، به همراه فهرستی از نام‌های کوتاه تمام گزینه‌های آدرس در دسترس\&. برخی گزینه‌ها وابسته به پلتفرم هستند، از این رو این خروجی برای بررسی پیاده‌سازی مربوطه سودمند است\&. 
.IP "\fB\f(CW\-hhh | \-???\fP\fP"
مشابه \-hh، به همراه فهرستی از تمام نام‌های گزینه‌های آدرس در دسترس\&.
.IP "\fB\f(CW\-d\fP\fP"
بدون این گزینه، تنها پیام‌های مهلک (fatal)، خطا (error) و هشدار (warning) چاپ می‌شوند؛ با اعمال این گزینه، پیام‌های اطلاع‌رسانی (notice) نیز چاپ خواهند شد\&. برای اطلاعات بیشتر به بخش DIAGNOSTICS مراجعه کنید\&.
.IP "\fB\f(CW\-d0\fP\fP"
با این گزینه، تنها پیام‌های مهلک و خطا چاپ می‌شوند؛ این گزینه رفتار \fBsocat\fP را تا نسخه 1\&.7\&.4 بازمی‌گرداند\&.
.IP "\fB\f(CW\-d \-d | \-dd | \-d2\fP\fP"
پیام‌های مهلک، خطا، هشدار و اطلاع‌رسانی را چاپ می‌کند\&.
.IP "\fB\f(CW\-d \-d \-d | \-ddd | \-d3\fP\fP"
پیام‌های مهلک، خطا، هشدار، اطلاع‌رسانی و اطلاعاتی (info) را چاپ می‌کند\&.
.IP "\fB\f(CW\-d \-d \-d \-d | \-dddd | \-d4\fP\fP"
پیام‌های مهلک، خطا، هشدار، اطلاع‌رسانی، اطلاعاتی و اشکال‌زدایی (debug) را چاپ می‌کند\&. 
.IP "\fB\f(CW\-D\fP\fP"
پیش از آغاز مرحله انتقال، اطلاعات مربوط به توصیف‌کننده‌های فایل را در لاگ ثبت می‌کند\&.
.IP "\fB\f(CW\-\-experimental\fP\fP"
قابلیت‌های جدیدی که به خوبی آزمایش نشده‌اند یا در آینده دستخوش تغییر می‌شوند باید صریحاً با این گزینه فعال شوند\&.
.IP "\fB\f(CW\-ly[<facility>]\fP\fP"
پیام‌ها را به جای stderr در syslog می‌نویسد؛ سطح اهمیت همان‌طور که با گزینه \-d تعیین شده اعمال می‌شود\&. با مشخصه اختیاری <facility>، نوع syslog را می‌توان انتخاب کرد، مقدار پیش‌فرض \(dq\&daemon\(dq\& است\&. ممکن است کتابخانه‌های شخص ثالث از این گزینه پیروی نکنند\&.
.IP "\fB\f(CW\-lf<logfile>\fP"
پیام‌ها را به جای stderr در پرونده لاگ <logfile> [نام فایل] می‌نویسد\&. برخی کتابخانه‌های شخص ثالث، به‌ویژه libwrap، ممکن است از این گزینه پیروی نکنند\&.
.IP "\fB\f(CW\-ls\fP\fP"
پیام‌ها را در stderr می‌نویسد (این حالت پیش‌فرض است)\&. ممکن است برخی کتابخانه‌های شخص ثالث از این گزینه پیروی نکنند، به‌ویژه به نظر می‌رسد libwrap تنها وقایع را در syslog ثبت می‌کند\&. 
.IP "\fB\f(CW\-lp\fP\fP\f(CW<progname>\fP"
نام برنامه چاپ‌شده در پیام‌های خطا را که برای ساختن نام متغیرهای محیطی نیز به کار می‌رود، بازنویسی (override) می‌کند\&.
.IP "\fB\f(CW\-lu\fP\fP"
دقت برچسب زمان (timestamp) پیام‌های خطا را به میکروثانیه افزایش می‌دهد\&. هنگام ثبت وقایع در syslog کار نمی‌کند\&.
.IP "\fB\f(CW\-lm[<facility>]\fP\fP"
حالت لاگ ترکیبی\&. در حین راه‌اندازی، پیام‌ها در stderr چاپ می‌شوند؛ هنگامی که \fBsocat\fP حلقه مرحله انتقال یا حالت دیمن (daemon) را آغاز می‌کند (یعنی پس از باز کردن تمام جریان‌ها و پیش از آغاز انتقال داده، یا در سوکت‌های شنونده با گزینه fork، پیش از نخستین فراخوانی accept)، ثبت وقایع را به syslog تغییر می‌دهد\&. با مشخصه اختیاری <facility>، نوع syslog را می‌توان انتخاب کرد، مقدار پیش‌فرض \(dq\&daemon\(dq\& است\&. 
.IP "\fB\f(CW\-lh\fP\fP"
نام میزبان (hostname) را به پیام‌های لاگ اضافه می‌کند\&. از مقدار متغیر محیطی HOSTNAME یا در صورت تنظیم نبودن HOSTNAME از مقدار دریافت‌شده با فراخوانی \f(CWuname()\fP استفاده می‌کند\&.
.IP "\fB\f(CW\-v\fP\fP"
داده‌های منتقل‌شده را علاوه بر جریان‌های مقصد، در stderr نیز می‌نویسد\&. قالب خروجی متنی همراه با برخی تبدیل‌ها برای خوانایی بهتر است، و با \(dq\&> \(dq\& یا \(dq\&< \(dq\& برای نشان دادن جهت جریان داده پیشوندگذاری می‌شود\&.
.IP "\fB\f(CW\-x\fP\fP"
داده‌های منتقل‌شده را علاوه بر جریان‌های مقصد، در stderr نیز می‌نویسد\&. قالب خروجی به صورت هگزادسیمال است و با \(dq\&> \(dq\& یا \(dq\&< \(dq\& برای نشان دادن جهت جریان داده پیشوندگذاری می‌شود\&. می‌تواند با
\f(CW\-v\fP
ترکیب شود\&.
.IP "\fB\f(CW\-r <file>\fP\fP"
داده‌های خام (باینری) جاری از آدرس چپ به راست را در فایل داده‌شده ذخیره (dump) می‌کند\&. نام فایل ممکن است شامل ارجاع به متغیرهای محیطی و
\f(CW$$\fP
(شناسه فرایند یا pid)، 
\f(CW$PROGNAME\fP
(گزینه \-lp را ببینید)،
\f(CW$TIMESTAMP\fP
(از قالب %Y%m%dT%H%M%S استفاده می‌کند)، و 
\f(CWMICROS\fP
(میکروثانیه‌های زمان روز) باشد\&. البته این ارجاعات باید در برابر بسط پوسته (shell expansion) محافظت شوند\&.
.IP "\fB\f(CW\-R <file>\fP\fP"
داده‌های خام (باینری) جاری از آدرس راست به چپ را در فایل داده‌شده ذخیره (dump) می‌کند\&. برای سفارشی‌سازی نام فایل گزینه \-r را ببینید\&.
.IP "\fB\f(CW\-b\fP\fP\f(CW<size>\fP"
اندازه بلوک انتقال داده <size> [size_t] را تنظیم می‌کند\&.
در هر مرحله حداکثر <size> بایت منتقل می‌شود\&. مقدار پیش‌فرض 8192 بایت است\&. 
.IP "\fB\f(CW\-s\fP\fP"
به طور پیش‌فرض، هنگامی که خطایی رخ دهد \fBsocat\fP خاتمه می‌یابد تا از اجرای فرایند در زمانی که گزینه‌ای نتواند اعمال شود جلوگیری کند\&. با این گزینه، \fBsocat\fP با خطاها با مسامحه برخورد کرده و تلاش می‌کند ادامه دهد\&. حتی با این گزینه، socat در خطاهای مهلک خارج می‌شود، و در صورت شکست بررسی‌های امنیتی، تلاش‌های اتصال را لغو خواهد کرد\&.
.IP "\fB\f(CW\-S\fP\fP\f(CW<signals\-bitmap>\fP"
مجموعه سیگنال‌هایی را که توسط \fBsocat\fP صرفاً برای چاپ یک پیام لاگ دریافت (catch) می‌شوند تغییر می‌دهد\&. دریافت این سیگنال‌ها برای وارد کردن اطلاعات سیگنال در لاگ \fBsocat\fP مفید است، اما از تولید core dump یا سایر کنش‌های استاندارد جلوگیری می‌کند\&. مجموعه پیش‌فرض این سیگنال‌ها عبارت است از SIGHUP، SIGINT، SIGQUIT، SIGILL، SIGABRT، SIGBUS، SIGFPE، SIGSEGV و SIGTERM؛ این مجموعه (0x89de در لینوکس) را با یک نگاشت بیتی (bitmap) جایگزین کنید (برای نمونه SIGFPE دارای مقدار 8 است و بیت آن 0x0080 می‌باشد)\&.
.br 
نکته: سیگنال‌های SIGHUP، SIGINT، SIGQUIT، SIGUSR1، SIGPIPE، SIGALRM، SIGTERM و SIGCHLD در هر صورت ممکن است به طور ویژه مدیریت شوند\&.
.IP "\fB\f(CW\-t\fP\fP\f(CW<timeout>\fP"
هنگامی که یک کانال به EOF می‌رسد، بخش نوشتن کانال دیگر بسته (shutdown) می‌شود\&. سپس \fBsocat\fP پیش از خاتمه یافتن، به مدت <timeout> [timeval] ثانیه منتظر می‌ماند\&. مقدار پیش‌فرض 0\&.5 ثانیه است\&. این مهلت زمانی تنها برای آدرس‌هایی اعمال می‌شود که بخش نوشتن و خواندن آن‌ها می‌تواند مستقل از هم بسته شود\&. زمانی که در طول بازه مهلت زمانی، بخش خواندن EOF دهد، socat بدون منتظر ماندن برای مهلت، خاتمه می‌یابد\&.
.IP "\fB\f(CW\-T\fP\fP\f(CW<timeout>\fP"
مهلت زمانی کل عدم فعالیت: زمانی که \fBsocat\fP در حلقه انتقال قرار دارد و برای مدت <timeout> [timeval] ثانیه هیچ رویدادی رخ ندهد (هیچ داده‌ای نرسد، هیچ وقفه‌ای رخ ندهد و غیره)، خاتمه می‌یابد\&. تا نسخه 1\&.8\&.0\&.0 مقدار \(dq\&0\(dq\& به معنای \(dq\&بی‌نهایت\(dq\& بود؛ از نسخه 1\&.8\&.0\&.1 مقدار \(dq\&0\(dq\& به معنای 0 است و مقادیر کمتر از صفر (<0) به معنای بی‌نهایت هستند\&.
.br 
برای پروتکل‌هایی مانند UDP که نمی‌توانند EOF را منتقل کنند سودمند است\&.
.IP "\fB\f(CW\-u\fP\fP"
از حالت یک‌طرفه (unidirectional) استفاده می‌کند\&. آدرس اول تنها برای خواندن، و آدرس دوم تنها برای نوشتن استفاده می‌شود (مثال)\&. 
.IP "\fB\f(CW\-U\fP\fP"
از حالت یک‌طرفه در جهت معکوس استفاده می‌کند\&. آدرس اول تنها برای نوشتن، و آدرس دوم تنها برای خواندن استفاده می‌شود\&. 
.IP "\fB\f(CW\-g\fP\fP"
در طول تجزیه گزینه آدرس، بررسی نکن که آیا این گزینه در محیط آدرس داده‌شده مفید به شمار می‌رود یا خیر\&. اگر می‌خواهید برای نمونه اعمال یک گزینه سوکت به یک دستگاه سریال را اجبار کنید، از آن استفاده نمایید\&.
.IP "\fB\f(CW\-L\fP\fP\f(CW<lockfile>\fP"
اگر فایل قفل (lockfile) وجود داشته باشد، با خطا خارج می‌شود\&. اگر فایل قفل وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و در هنگام خروج فایل قفل را حذف (unlink) می‌کند\&.
.IP "\fB\f(CW\-W\fP\fP\f(CW<lockfile>\fP"
اگر فایل قفل وجود داشته باشد، تا زمان ناپدید شدن آن منتظر می‌ماند\&. زمانی که فایل قفل وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و در هنگام خروج فایل قفل را حذف می‌کند\&.
.IP "\fB\f(CW\-4\fP\fP"
در صورتی که آدرس‌ها نسخه را به طور ضمنی یا صریح مشخص نکنند، از IP نسخه 4 استفاده می‌کند\&. از نسخه 1\&.8\&.0\&.1 این حالت پیش‌فرض است\&.
.IP "\fB\f(CW\-6\fP\fP"
در صورتی که آدرس‌ها نسخه را به طور ضمنی یا صریح مشخص نکنند، از IP نسخه 6 استفاده می‌کند\&.
.IP "\fB\f(CW\-0\fP\fP"
نسخه خاصی از IP را ترجیح نده؛ این به آدرس‌های انفعالی (LISTEN، RECV و غیره) امکان می‌دهد در برخی پلتفرم‌ها (به جز BSD) به هر دو نسخه سرویس دهند\&.
.IP "\fB\f(CW\-\-statistics\fP\fP"
.IP "\fB\f(CW\-S\fP\fP"
پیش از خاتمه یافتن \fBsocat\fP، آمار انتقال (شمارنده‌های بایت‌ها و بلوک‌ها برای هر دو جهت) را در لاگ ثبت می‌کند\&.
.br 
همچنین سیگنال USR1 را ببینید\&.
.br 
این قابلیت آزمایشی است و ممکن است در نسخه‌های بعدی تغییر کند\&.

.PP 
.SH "مشخصات آدرسها (ADDRESS SPECIFICATIONS)"

.PP 
با استفاده از آرگومان‌های آدرس در خط فرمان، کاربر دستورالعمل‌ها و اطلاعات لازم را برای برقراری جریان‌های بایت به \fBsocat\fP ارائه می‌دهد\&. 
.PP 
یک مشخصه آدرس معمولاً شامل یک کلمه کلیدی نوع آدرس، صفر یا چند پارامتر آدرس الزامی که با \(cq\&:\(cq\& از کلمه کلیدی و از یکدیگر جدا می‌شوند، و صفر یا چند گزینه آدرس جداشده با \(cq\&,\(cq\& است\&. 
.PP 
کلمه کلیدی نوع آدرس را مشخص می‌کند (مانند TCP4، OPEN، EXEC)\&. برای برخی کلمات کلیدی، مترادف‌هایی وجود دارد (\(cq\&\-\(cq\& برای STDIO، و TCP برای TCP4)\&. کلمات کلیدی به حروف بزرگ و کوچک حساس نیستند\&.
برای تعداد اندکی از انواع آدرس‌های خاص، کلمه کلیدی ممکن است حذف شود:
مشخصات آدرسی که با یک عدد آغاز می‌شوند، آدرس‌های FD (توصیف‌کننده فایل خام) فرض می‌شوند؛ 
اگر پیش از نخستین \(cq\&:\(cq\& یا \(cq\&,\(cq\& یک \(cq\&/\(cq\& یافت شود، GOPEN (باز کردن فایل عمومی) فرض می‌گردد\&. 
.PP 
تعداد و نوع پارامترهای آدرس مورد نیاز به نوع آدرس بستگی دارد\&. برای نمونه، TCP4 به یک مشخصه سرور (نام یا آدرس)، و یک مشخصه درگاه (شماره پورت یا نام سرویس) نیاز دارد\&. 
.PP 
صفر یا چند گزینه آدرس ممکن است با هر آدرس داده شود\&. آن‌ها به روش‌هایی بر آدرس تأثیر می‌گذارند\&. 
گزینه‌ها شامل یک کلمه کلیدی گزینه یا یک کلمه کلیدی گزینه و یک مقدار هستند که با \(cq\&=\(cq\& از یکدیگر جدا می‌شوند\&. کلمات کلیدی گزینه‌ها به حروف بزرگ و کوچک حساس نیستند\&.
برای پالایش گزینه‌هایی که با یک نوع آدرس سودمند هستند، هر گزینه عضو یک گروه گزینه است\&. برای هر نوع آدرس مجموعه‌ای از گروه‌های گزینه مجاز تعیین شده است\&. تنها گزینه‌های متعلق به یکی از این گروه‌های آدرس ممکن است استفاده شوند (مگر با گزینه \-g)\&. 
.PP 
مشخصات آدرسی که از طرح فوق پیروی می‌کنند، مشخصات آدرس \fIتکی\fP (single) نیز نامیده می‌شوند\&.
دو آدرس تکی را می‌توان با \(dq\&!!\(dq\& ترکیب کرد تا یک آدرس از نوع \fIدوگانه\fP (dual) برای یک کانال تشکیل شود\&. در اینجا، آدرس نخست توسط \fBsocat\fP برای خواندن داده‌ها و آدرس دوم برای نوشتن داده‌ها استفاده می‌شود\&. هیچ راهی برای تعیین یک گزینه تنها برای یک بار وجود ندارد تا بر هر دو آدرس تکی اعمال شود\&.
.PP 
معمولاً آدرس‌ها در حالت خواندن/نوشتن باز می‌شوند\&. هنگامی که یک آدرس بخشی از یک مشخصه آدرس دوگانه است، یا زمانی که گزینه \-u یا \-U استفاده می‌شود، ممکن است یک آدرس تنها برای خواندن یا برای نوشتن استفاده شود\&. در نظر گرفتن این نکته در برخی انواع آدرس‌ها حائز اهمیت است\&.
.PP 
با نسخه 1\&.5\&.0 و بالاتر socat، تحلیل لغوی تلاش می‌کند نقل‌قول‌ها و پرانتزها را به طور معناداری مدیریت کرده و اجازه گریز دادن نویسه‌های خاص را می‌دهد\&. 
اگر یکی از نویسه‌های ( { [ \(cq\& یافت شود، نویسه بسته متناظر آن \- ) } ] \(cq\& \- جستجو می‌شود؛ آن‌ها ممکن است تودرتو نیز باشند\&. در داخل این ساختارها، نویسه‌ها و رشته‌های خاص socat مانند : ، , ، !! به طور ویژه پردازش نمی‌شوند\&. تمام آن نویسه‌ها و رشته‌ها را می‌توان با \e یا در درون \(dq\&\(dq\& گریز (escape) داد\&.
.PP

.SH "انواع آدرسها (ADDRESS TYPES)"

.PP 
این بخش انواع آدرس‌های موجود را همراه با کلیدواژه‌ها،
پارامترها و مفاهیم آن‌ها شرح می‌دهد\&.
.PP 
.IP "\fB\f(CWCREATE:<filename>\fP\fP"
فایل <filename> را با 
\f(CWcreat()\fP
باز کرده و از توصیف‌گر فایل
برای نوشتن استفاده می‌کند\&. 
این یک آدرس فقط‌نوشتنی (write\-only) است زیرا فایلی که با 
\f(CWcreat\fP
باز شده باشد قابل
خواندن نیست\&. به گزینه‌های \-u و
\-U و آدرس‌های دوگانه مراجعه کنید\&.
.br 
فلگ‌هایی مانند O_LARGEFILE را نمی‌توان اعمال کرد\&. اگر به آن‌ها نیاز دارید از
OPEN همراه با گزینه‌های
create,create استفاده کنید\&. 
.br 
<filename> باید یک مسیر معتبر موجود یا ناموجود باشد\&.
اگر <filename> یک لوله نام‌گذاری‌شده (named pipe) باشد، ممکن است 
\f(CWcreat()\fP
مسدود شود؛
اگر <filename> به یک سوکت اشاره کند، این یک خطا است\&.
.br 
گروههای گزینه: FD,REG,NAMED 
.br 
گزینههای کاربردی:
mode,
mode,
user,
group,
unlink\-early,
unlink\-late,
append
.br 
همچنین ببینید: OPEN, GOPEN
.IP 
.IP "\fB\f(CWDCCP\-CONNECT:<host>:<port>\fP\fP (\fB\f(CWDCCP:<host>:<port>\fP\fP)"
یک اتصال DCCP به <host> [آدرس
IP] و <port> [سرویس DCCP] مشخص‌شده
با استفاده از نسخه ۴ یا ۶ پروتکل IP بسته به مشخصات آدرس، تحلیل
نام، یا گزینه pf برقرار می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,SCTP,CHILD,RETRY 
.br 
گزینههای کاربردی:
bind,
connect\-timeout,
tos,
dccp\-set\-ccid,
nonblock,
sourceport,
retry,
readbytes
.br 
همچنین ببینید:
DCCP4\-CONNECT,
DCCP6\-CONNECT,
DCCP\-LISTEN,
TCP\-CONNECT
SCTP\-CONNECT
.IP "\fB\f(CWDCCP4\-CONNECT:<host>:<port>\fP\fP (\fB\f(CWDCCP4:<host>:<port>\fP\fP)"
مشابه DCCP\-CONNECT، اما فقط از پروتکل IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,DCCP,CHILD,RETRY 
.br 
.IP "\fB\f(CWDCCP6\-CONNECT:<host>:<port>\fP\fP (\fB\f(CWDCCP6:<host>:<port>\fP\fP)"
مشابه DCCP\-CONNECT، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,DCCP,CHILD,RETRY 
.br 

.IP 
.IP "\fB\f(CWDCCP\-LISTEN:<port>\fP\fP (\fB\f(CWDCCP\-L:<port>\fP\fP)"
روی <port> [سرویس DCCP] گوش فرا می‌دهد و یک
اتصال DCCP را می‌پذیرد\&. نسخه IP برابر با ۴ یا نسخه مشخص‌شده با
گزینه آدرس pf، گزینه socat
(\-4, \-6)، یا متغیر محیطی SOCAT_DEFAULT_LISTEN_IP است\&.
توجه داشته باشید که باز کردن
این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6,DCCP,RETRY 
.br 
گزینههای کاربردی:
fork,
bind,
range,
max\-children,
backlog,
accept\-timeout,
dccp\-set\-sid,
su,
reuseaddr,
retry
.br 
همچنین ببینید:
DCCP4\-LISTEN,
DCCP6\-LISTEN,
TCP\-LISTEN,
SCTP\-LISTEN,
DCCP\-CONNECT
.IP "\fB\f(CWDCCP4\-LISTEN:<port>\fP\fP (\fB\f(CWDCCP4\-L:<port>\fP\fP)"
مشابه DCCP\-LISTEN، اما فقط از پروتکل
IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,DCCP,RETRY 
.br 
.IP "\fB\f(CWDCCP6\-LISTEN:<port>\fP\fP (\fB\f(CWDCCP6\-L:<port>\fP\fP)"
مشابه DCCP\-LISTEN، اما فقط از پروتکل
IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP6,DCCP,RETRY 
.br 

.IP 
.IP "\fB\f(CWEXEC:<command\-line>\fP\fP"
یک زیرفرآیند منشعب می‌کند که با فرآیند والد خود ارتباط برقرار کرده
و برنامه مشخص‌شده را با 
\f(CWexecvp()\fP
فراخوانی می‌نماید\&.
<command\-line> یک دستور ساده
با آرگومان‌هایی است که با تک‌فاصله از هم جدا شده‌اند\&. اگر نام برنامه
شامل \(cq\&/\(cq\& باشد، بخش پس از آخرین \(cq\&/\(cq\& به عنوان ARGV[0] در نظر گرفته می‌شود\&. اگر
نام برنامه یک مسیر نسبی 
باشد، قواعد 
\f(CWexecvp()\fP
برای یافتن برنامه از طریق 
\f(CW$PATH\fP
اعمال می‌شود\&. پس از شروع موفقیت‌آمیز برنامه، \fBsocat\fP داده‌ها را به stdin
فرآیند نوشته و از stdout آن به صورت پیشفرض با استفاده از یک سوکت دامنه یونیکس ایجادشده توسط
\f(CWsocketpair()\fP
می‌خواند\&. (مثال) 
.br 
گروههای گزینه: FD,SOCKET,EXEC,FORK,TERMIOS 
.br 
گزینههای کاربردی:
path,
fdin,
fdout,
chroot,
su,
su\-d,
nofork,
socktype,
pty,
stderr,
ctty,
setsid,
pipes,
umask,
login,
sigint,
sigquit,
netns
.br 
همچنین ببینید: SYSTEM,SHELL
.IP "\fB\f(CWFD:<fdnum>\fP\fP"
از توصیف‌گر فایل <fdnum> استفاده می‌کند\&. این توصیف‌گر باید از قبل به عنوان
یک توصیف‌گر فایل معتبر در یونیکس (UN*X) وجود داشته باشد\&.
.br 
گروههای گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
همچنین ببینید:
STDIO,
STDIN,
STDOUT,
STDERR 
.IP "\fB\f(CWGOPEN:<filename>\fP\fP"
(باز کردن عمومی یا Generic open) این نوع آدرس تلاش می‌کند با هر ورودی فایل‌سیستم
به جز دایرکتوری‌ها به شکلی سودمند رفتار کند\&. <filename> می‌تواند یک
مسیر نسبی یا مطلق باشد\&. اگر از قبل وجود داشته باشد، نوع آن بررسی می‌شود\&. 
در صورت وجود سوکت دامنه یونیکس، \fBsocat\fP متصل می‌شود؛ اگر اتصال ناموفق باشد،
\fBsocat\fP سوکت را از نوع دیتاگرام فرض کرده و از فراخوانی‌های 
\f(CWsendto()\fP
استفاده می‌کند\&.
اگر ورودی سوکت نباشد، \fBsocat\fP آن را با اعمال فلگ 
\f(CWO_APPEND\fP
باز می‌کند\&. 
اگر وجود نداشته باشد، با فلگ
\f(CWO_CREAT\fP
به عنوان یک فایل معمولی باز می‌شود (مثال)\&.
.br 
گروههای گزینه: FD,REG,SOCKET,NAMED,OPEN 
.br 
همچنین ببینید:
OPEN,
CREATE,
UNIX\-CONNECT
.IP 
.IP "\fB\f(CWIP\-SENDTO:<host>:<protocol>\fP\fP"
یک سوکت خام IP باز می‌کند\&. بسته به مشخصات میزبان یا گزینه pf، از پروتکل IP نسخه
۴ یا ۶ استفاده می‌شود\&. این آدرس از <protocol> برای ارسال بسته‌ها
به <host> [آدرس IP] استفاده کرده و بسته‌ها را از
میزبان دریافت می‌کند و بسته‌های دریافتی از سایر میزبان‌ها را نادیده می‌گیرد\&. 
پروتکل ۲۵۵ از سوکت خام به گونه‌ای استفاده می‌کند که سربرگ IP بخشی از
داده‌ها باشد\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6 
.br 
گزینههای کاربردی:
pf,
ttl 
.br 
همچنین ببینید:
IP4\-SENDTO,
IP6\-SENDTO,
IP\-RECVFROM,
IP\-RECV,
UDP\-SENDTO,
UNIX\-SENDTO
.IP "\fB\f(CWINTERFACE:<interface>\fP\fP"
با استفاده از بسته‌های خام حاوی داده‌های لایه پیوند (link level)، با یک شبکه متصل به یک رابط ارتباط
برقرار می‌کند\&. <interface> نام
رابط شبکه است\&. در حال حاضر فقط روی لینوکس در دسترس است\&.
.br 
گروههای گزینه: FD,SOCKET 
.br 
گزینههای کاربردی:
pf,
type
.br 
همچنین ببینید: ip\-recv
.IP "\fB\f(CWIP4\-SENDTO:<host>:<protocol>\fP\fP"
مشابه IP\-SENDTO، اما همیشه از IPv4 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4 
.br 
.IP "\fB\f(CWIP6\-SENDTO:<host>:<protocol>\fP\fP"
مشابه IP\-SENDTO، اما همیشه از IPv6 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6 
.br 

.IP 
.IP "\fB\f(CWIP\-DATAGRAM:<address>:<protocol>\fP\fP"
داده‌های خروجی را به آدرس مشخص‌شده ارسال می‌کند که به‌ویژه می‌تواند یک
آدرس پخش همگانی (broadcast) یا چندپخشی (multicast) باشد\&. بسته‌های ورودی به سوکت محلی
بررسی می‌شوند تا مشخص شود آیا آدرس مبدأ آن‌ها با گزینه‌های
RANGE یا TCPWRAP
تطابق دارد یا خیر\&. این نوع آدرس می‌تواند برای مثال برای پیاده‌سازی ارتباطات
متقارن یا نامتقارن پخش همگانی یا چندپخشی استفاده شود\&.
.br 
گروههای گزینه: FD, SOCKET,
IP4, IP6, RANGE 
.br 
گزینههای کاربردی:
bind,
range,
tcpwrap,
broadcast,
ip\-multicast\-loop,
ip\-multicast\-ttl,
ip\-multicast\-if,
ip\-add\-membership,
ip\-add\-source\-membership,
ipv6\-join\-group,
ipv6\-join\-source\-group,
ttl,
tos,
pf
.br 
همچنین ببینید:
IP4\-DATAGRAM,
IP6\-DATAGRAM,
IP\-SENDTO,
IP\-RECVFROM,
IP\-RECV,
UDP\-DATAGRAM
.IP "\fB\f(CWIP4\-DATAGRAM:<host>:<protocol>\fP\fP"
مشابه IP\-DATAGRAM، اما همیشه از IPv4 استفاده می‌کند\&.
(مثال)
.br 
گروههای گزینه: FD,SOCKET,IP4,RANGE 
.br 
.IP "\fB\f(CWIP6\-DATAGRAM:<host>:<protocol>\fP\fP"
مشابه IP\-DATAGRAM، اما همیشه از IPv6 استفاده می‌کند\&. لطفاً
توجه داشته باشید که IPv6 پخش همگانی (broadcast) ندارد\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,RANGE 
.br 

.IP 
.IP "\fB\f(CWIP\-RECVFROM:<protocol>\fP\fP"
یک سوکت خام IP از <protocol> باز می‌کند\&. بسته به گزینه pf، از پروتکل IP نسخه
۴ یا ۶ استفاده می‌شود\&. یک بسته را از یک همتای نامشخص دریافت کرده و ممکن است یک یا چند بسته پاسخ به آن همتا ارسال نماید\&.
این حالت به‌ویژه با گزینه fork سودمند است که در آن هر بسته دریافتی \- از همتاهای دلخواه \- توسط زیرفرآیند خودش مدیریت می‌شود\&.
این امر رفتاری مشابه با سرورهای متداول مبتنی بر UDP مانند ntpd یا
named را فراهم می‌سازد\&.
.br 
لطفاً توجه داشته باشید که در صورت یکسان بودن آدرس IP فرستنده و گیرنده، بسته‌های پاسخ ممکن است به عنوان ترافیک ورودی دریافت شوند زیرا شماره پورتی
برای تمایز سوکت‌ها وجود ندارد\&.
.br 
این آدرس به خوبی با همتاهای آدرس IP\-SENDTO کار می‌کند (به بالا مراجعه کنید)\&.
پروتکل ۲۵۵ از سوکت خام با قرار گرفتن سربرگ IP به عنوان بخشی از
داده‌ها استفاده می‌کند\&.
.br 
یادداشت مربوط به آدرس‌های RECVFROM را ببینید\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,CHILD,RANGE 
.br 
گزینههای کاربردی:
pf,
fork,
range,
ttl,
broadcast
.br 
همچنین ببینید:
IP4\-RECVFROM,
IP6\-RECVFROM,
IP\-SENDTO,
IP\-RECV,
UDP\-RECVFROM,
UNIX\-RECVFROM 
.IP "\fB\f(CWIP4\-RECVFROM:<protocol>\fP\fP"
مشابه IP\-RECVFROM، اما همیشه از IPv4 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,CHILD,RANGE 
.br 
.IP "\fB\f(CWIP6\-RECVFROM:<protocol>\fP\fP"
مشابه IP\-RECVFROM، اما همیشه از IPv6 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,CHILD,RANGE 
.br 

.IP 
.IP "\fB\f(CWIP\-RECV:<protocol>\fP\fP"
یک سوکت خام IP از <protocol> باز می‌کند\&. بسته به گزینه pf، از پروتکل IP نسخه
۴ یا ۶ استفاده می‌شود\&. بسته‌ها را از چندین همتای نامشخص دریافت کرده و داده‌ها را ادغام می‌کند\&.
هیچ پاسخی امکان‌پذیر نیست، این یک آدرس فقط‌خواندنی است، به گزینه‌های \-u و
\-U و آدرس‌های دوگانه مراجعه کنید\&.
این آدرس می‌تواند مثلاً توسط همتاهای آدرس socat IP\-SENDTO مخاطب قرار گیرد\&.
پروتکل ۲۵۵ از سوکت خام با قرار گرفتن سربرگ IP به عنوان بخشی از
داده‌ها استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,RANGE 
.br 
گزینههای کاربردی:
pf,
range
.br 
همچنین ببینید:
IP4\-RECV,
IP6\-RECV,
IP\-SENDTO,
IP\-RECVFROM,
UDP\-RECV,
UNIX\-RECV 
.IP "\fB\f(CWIP4\-RECV:<protocol>\fP\fP"
مشابه IP\-RECV، اما همیشه از IPv4 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,RANGE 
.br 
.IP "\fB\f(CWIP6\-RECV:<protocol>\fP\fP"
مشابه IP\-RECV، اما همیشه از IPv6 استفاده می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,RANGE 
.br 

.IP 
.IP "\fB\f(CWOPEN:<filename>\fP\fP"
با استفاده از فراخوانی سیستمی 
\f(CWopen()\fP
فایل <filename> را باز می‌کند
(مثال)\&.
این عملیات روی سوکت‌های دامنه یونیکس با شکست مواجه می‌شود\&. 
.br 
توجه: این نوع آدرس در حالت دوطرفه به‌ندرت کاربرد دارد\&.
.br 
گروههای گزینه: FD,REG,NAMED,OPEN 
.br 
گزینههای کاربردی:
creat,
excl,
noatime,
nofollow,
append,
rdonly,
wronly,
lock,
readbytes,
ignoreeof
.br 
همچنین ببینید:
CREATE,
GOPEN,
UNIX\-CONNECT
.IP 
.IP "\fB\f(CWOPENSSL:<host>:<port>\fP\fP"
تلاش می‌کند یک اتصال SSL به <port> [سرویس
TCP] روی  
<host> [آدرس IP] با استفاده از TCP/IP نسخه ۴ یا ۶
بسته به مشخصات آدرس، تحلیل نام، یا گزینه
pf برقرار نماید\&.
.br 
توجه: تا نسخه 1\&.7\&.2\&.4
گواهی سرور فقط از نظر اعتبار در برابر مخزن گواهی سیستم یا cafile یا
capath بررسی می‌شد،
اما با نام سرور یا آدرس IP آن تطبیق داده نمی‌شد\&.
از نسخه 1\&.7\&.3\&.0 به بعد socat گواهی همتا را برای تطابق با
پارامتر <host> یا مقدار گزینه 
openssl\-commonname بررسی می‌کند\&.
دستور Socat تلاش می‌کند آن را با commonName در subject گواهی،
و نام‌های DNS در افزونه subjectAltName گواهی تطبیق دهد\&. کاراکترهای عام (Wildcard) در
گواهی پشتیبانی می‌شوند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,OPENSSL,RETRY 
.br 
گزینههای کاربردی:
min\-proto\-version,
cipher,
verify,
commonname,
cafile,
capath,
certificate,
key,
compress,
bind,
pf,
connect\-timeout,
sourceport,
retry
.br 
همچنین ببینید:
OPENSSL\-LISTEN,
TCP
.IP 
.IP "\fB\f(CWOPENSSL\-LISTEN:<port>\fP\fP"
روی <port> در tcp [سرویس TCP] گوش فرا می‌دهد\&.
نسخه IP برابر با ۴ یا نسخه مشخص‌شده با
pf است\&. هنگامی که یک
اتصال پذیرفته شود، این آدرس مانند سرور SSL عمل می‌کند\&.
.br 
توجه: احتمالاً می‌خواهید از گزینه certificate با این آدرس استفاده کنید\&.
.br 
نکته: گواهی کلاینت فقط از نظر اعتبار در برابر
cafile یا capath بررسی می‌شود،
اما برای تطابق با نام کلاینت یا آدرس IP آن بررسی نمی‌گردد!
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,LISTEN,OPENSSL,CHILD,RANGE,RETRY 
.br 
گزینههای کاربردی:
pf,
min\-proto\-version,
cipher,
verify,
commonname,
cafile,
capath,
certificate,
key,
compress,
fork,
bind,
range,
tcpwrap,
su,
reuseaddr,
retry
.br 
همچنین ببینید:
OPENSSL,
TCP\-LISTEN
.IP 
.IP "\fB\f(CWOPENSSL\-DTLS\-CLIENT:<host>:<port>\fP\fP"
تلاش می‌کند یک اتصال DTLS به <port> [سرویس
UDP] روی
<host> [آدرس IP] با استفاده از UDP/IP نسخه ۴ یا ۶
بسته به مشخصات آدرس، تحلیل نام، یا گزینه
pf برقرار کند\&.
.br 
دستور \fBSocat\fP فیلدهای subjectAltName یا commonName در گواهی همتا را با گزینه
openssl\-commonname آدرس‌ها یا نام میزبان تطبیق می‌دهد\&.
کاراکترهای عام (Wildcard) در گواهی پشتیبانی می‌شوند\&.
.br 
از گزینه \-b در \fBsocat\fP استفاده کنید تا دیتاگرام‌ها به اندازه کافی کوچک باشند تا با احتساب سربار
در شبکه جا شوند\&. از گزینه \-T برای جلوگیری از معلق ماندن نامحدود در صورت قطع خاموش و بی‌صدای همتا استفاده کنید\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,OPENSSL,RETRY 
.br 
گزینههای کاربردی:
min\-proto\-version,
cipher,
verify,
commonname,
cafile,
capath,
certificate,
key,
compress,
bind,
pf,
sourceport,
retry,
rcvtimeo
.br 
همچنین ببینید:
OPENSSL\-DTLS\-SERVER,
OPENSSL\-CONNECT,
UDP\-CONNECT
.IP 
.IP "\fB\f(CWOPENSSL\-DTLS\-SERVER:<port>\fP\fP"
روی <port> در UDP [سرویس UDP] گوش فرا می‌دهد\&.
نسخه IP برابر با ۴ یا نسخه مشخص‌شده با
pf است\&. هنگامی که یک
اتصال پذیرفته شود، این آدرس مانند سرور DTLS عمل می‌کند\&.
.br 
توجه: احتمالاً می‌خواهید از گزینه certificate با این آدرس استفاده کنید\&.
.br 
نکته: گواهی کلاینت فقط از نظر اعتبار در برابر
cafile یا capath بررسی می‌شود،
اما برای تطابق با نام کلاینت یا آدرس IP آن بررسی نمی‌گردد!
از گزینه \-b در \fBsocat\fP استفاده کنید تا دیتاگرام‌ها به همراه سربار به اندازه کافی کوچک باشند تا در شبکه جا شوند\&.
از گزینه \-T برای جلوگیری از معلق ماندن نامحدود در صورت قطع خاموش و بی‌صدای همتا استفاده کنید\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,LISTEN,OPENSSL,CHILD,RANGE,RETRY 
.br 
گزینههای کاربردی:
pf,
min\-proto\-version,
cipher,
verify,
commonname,
cafile,
capath,
certificate,
key,
compress,
fork,
bind,
range,
tcpwrap,
su,
reuseaddr,
retry
.br 
rcvtimeo
.br 
همچنین ببینید:
OPENSSL\-DTLS\-CLIENT,
OPENSSL\-LISTEN,
UDP\-LISTEN
.IP 
.IP "\fB\f(CWPIPE:<filename>\fP\fP"
اگر <filename> از قبل موجود باشد، باز می‌شود\&.
اگر وجود نداشته باشد، یک لوله نام‌گذاری‌شده ایجاد و باز می‌گردد\&. از
نسخه 1\&.4\&.3 در socat به بعد، لوله نام‌گذاری‌شده هنگام بسته شدن آدرس حذف می‌شود
(اما به گزینه unlink\-close مراجعه کنید)\&.
.br 
توجه: هنگامی که یک لوله هم برای خواندن و هم برای نوشتن استفاده شود، مانند
یک سرویس اکو (پژواک) عمل می‌کند\&.
.br 
توجه: هنگامی که یک لوله برای هر دوی خواندن و نوشتن استفاده شود، و socat سعی کند
بایت‌های بیشتری از ظرفیت بافر لوله بنویسد (در لینوکس 2\&.4: ۲۰۴۸ بایت)، ممکن است socat
مسدود شود\&. استفاده از گزینه socat، به عنوان مثال 
\f(CW\-b 2048\fP
را مد نظر قرار دهید\&.
.br 
گروههای گزینه: FD,NAMED,OPEN 
.br 
گزینههای کاربردی:
rdonly,
nonblock,
group,
user,
mode,
unlink\-early
.br 
همچنین ببینید: unnamed pipe
.IP "\fB\f(CWPIPE\fP\fP"
یک لوله بی‌نام (unnamed pipe) ایجاد کرده و از آن برای خواندن و نوشتن استفاده می‌کند\&. این آدرس مانند یک
اکو عمل می‌کند، زیرا هر آنچه در آن نوشته شود بلافاصله به عنوان داده خوانده‌شده
ظاهر می‌گردد\&.
.br 
توجه: هنگامی که socat سعی کند بایت‌های بیشتری از ظرفیت صف لوله بنویسد (در لینوکس
2\&.4: ۲۰۴۸ بایت)، ممکن است socat مسدود شود\&. به عنوان مثال، استفاده از
گزینه 
\f(CW\-b 2048\fP
را در نظر داشته باشید\&.
.br 
گروههای گزینه: FD 
.br 
همچنین ببینید: named pipe, SOCKETPAIR
.IP "\fB\f(CWSOCKETPAIR\fP\fP"
یک جفت‌سوکت (socketpair) ایجاد کرده و از آن برای خواندن و نوشتن استفاده می‌کند\&. این آدرس مانند یک
اکو عمل می‌کند، زیرا هر آنچه در آن نوشته شود بلافاصله به عنوان داده خوانده‌شده
ظاهر می‌گردد\&. نوع سوکت پیشفرض دیتاگرام است، بنابراین مرزهای بسته‌ها حفظ می‌شود\&.
.br 
گروههای گزینه: FD 
.br 
گزینههای کاربردی:
socktype
.br 
همچنین ببینید: unnamed pipe
.IP 
.IP "\fB\f(CWPOSIXMQ\-READ:/<mqueue>\fP\fP"
صف پیام POSIX مشخص‌شده را باز کرده یا ایجاد می‌کند و پیام‌ها
(بسته‌ها) را می‌خواند\&. این آدرس مرزهای بسته‌ها را حفظ می‌نماید\&.
.br 
این یک آدرس فقط‌خواندنی است، به گزینه‌های \-u و
\-U و آدرس‌های دوگانه مراجعه کنید\&.
.br 
دستور \fBSocat\fP این نوع آدرس را تنها روی لینوکس ارائه می‌دهد زیرا در آنجا POSIX MQ مبتنی بر
توصیف‌گرهای فایل یونیکس است\&.
.br 
گزینههای کاربردی:
posixmq\-priority,
unlink\-early,
unlink\-close,
o\-nonblock,
o\-creat,
o\-excl,
umask
.IP 
.IP "\fB\f(CWPOSIXMQ\-RECEIVE:/<mqueue>\fP\fP"
.IP "\fB\f(CWPOSIXMQ\-RECV:/<mqueue>\fP\fP"
صف پیام POSIX مشخص‌شده را باز کرده یا ایجاد می‌کند و یک پیام
(بسته) را می‌خواند\&.
.br 
این یک آدرس فقط‌خواندنی است\&. برای اطلاعات بیشتر
POSIXMQ\-READ را ببینید\&.
.br 
مثال: POSIX MQ recv with fork
.br 
گزینههای کاربردی:
posixmq\-priority,
fork,
max\-children,
unlink\-early,
unlink\-close,
o\-creat,
o\-excl,
umask
.IP 
.IP "\fB\f(CWPOSIXMQ\-SEND:/<mqueue>\fP\fP"
صف پیام POSIX مشخص‌شده را باز کرده یا ایجاد می‌کند و پیام‌ها
(بسته‌ها) را می‌نویسد\&.
.br 
این یک آدرس فقط‌نوشتنی است\&. برای اطلاعات بیشتر
POSIXMQ\-READ را ببینید\&.
.br 
(مثال)
.br 
گزینههای کاربردی:
posixmq\-priority,
posixmq\-flush,
fork,
max\-children,
unlink\-early,
unlink\-close,
o\-creat,
o\-excl,
umask
.IP 
.IP "\fB\f(CWPOSIXMQ\-WRITE:/<mqueue>\fP\fP"
همان کار POSIXMQ\-SEND را انجام می‌دهد\&.
.IP 
.IP "\fB\f(CWPOSIXMQ\-BIDIRECTIONAL:/mqueue\fP\fP"
.IP "\fB\f(CWPOSIXMQ:/mqueue\fP\fP"
صف پیام POSIX مشخص‌شده را بسته به زمینه در حالت خواندن و/یا نوشتن
باز کرده یا ایجاد می‌نماید، سپس پیام‌ها (بسته‌ها) را می‌خواند و/یا می‌نویسد\&.
در حالت دوطرفه این فقط یک سرویس اکوی دیگر است\&.
.br 
برای اطلاعات بیشتر POSIXMQ\-READ و
POSIXMQ\-SEND را ببینید\&.
.IP 
.IP "\fB\f(CWPROXY:<proxy>:<hostname>:<port>\fP\fP"
با استفاده از TCP/IP نسخه ۴ یا ۶ بسته به مشخصات آدرس، تحلیل نام، یا گزینه
pf به یک سرور پروکسی HTTP روی پورت ۸۰۸۰ متصل می‌شود و یک درخواست CONNECT
برای hostname:port ارسال می‌کند\&. اگر پروکسی اجازه دسترسی داده و اتصال به
مقصد با موفقیت برقرار شود، انتقال داده بین socat و مقصد می‌تواند
آغاز شود (مثال)\&.
توجه داشته باشید که ترافیک لزوماً نباید HTTP باشد بلکه می‌تواند هر پروتکل دلخواهی باشد\&. 
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,HTTP,RETRY 
.br 
گزینههای کاربردی:
proxyport,
ignorecr,
proxyauth,
resolve,
crnl,
bind,
connect\-timeout,
mss,
sourceport,
retry 
.br 
همچنین ببینید: SOCKS, TCP
.IP "\fB\f(CWPTY\fP\fP"
یک شبه‌ترمینال (pty) ایجاد کرده و از سمت master (اصلی) آن استفاده می‌کند\&. فرآیند دیگر
می‌تواند سمت slave (فرعی) pty را باز کرده و همانند یک خط سریال یا ترمینال از آن استفاده کند\&.
(مثال)\&. اگر
هر دو سازوکار ptmx و openpty در دسترس باشند، از ptmx استفاده می‌شود
(POSIX)\&.
.br 
گروههای گزینه: FD,NAMED,PTY,TERMIOS 
.br 
گزینههای کاربردی:
link,
openpty,
wait\-slave,
mode,
user,
group
.br 
همچنین ببینید:
UNIX\-LISTEN,
PIPE,
EXEC, SYSTEM, SHELL
.IP "\fB\f(CWREADLINE\fP\fP"
خطوط (مثال)\&.
.br
می‌توانید به جای آن از STDIO استفاده کنید\&.
.IP "\fB\f(CWSCTP\-CONNECT:<host>:<port>\fP\fP"
یک اتصال جریانی (stream) با پروتکل SCTP به <host> [آدرس
IP] و <port> [سرویس TCP] مشخص‌شده
با استفاده از IP نسخه ۴ یا ۶ بسته به مشخصات آدرس، تحلیل
نام، یا گزینه pf برقرار می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,SCTP,CHILD,RETRY 
.br 
گزینههای کاربردی:
bind,
pf,
connect\-timeout,
tos,
mtudiscover,
sctp\-maxseg,
sctp\-nodelay,
nonblock,
sourceport,
retry,
readbytes
.br 
همچنین ببینید:
SCTP4\-CONNECT,
SCTP6\-CONNECT,
SCTP\-LISTEN,
TCP\-CONNECT
.IP "\fB\f(CWSCTP4\-CONNECT:<host>:<port>\fP\fP"
مشابه SCTP\-CONNECT، اما فقط از پروتکل IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,SCTP,CHILD,RETRY 
.br 
.IP "\fB\f(CWSCTP6\-CONNECT:<host>:<port>\fP\fP"
مشابه SCTP\-CONNECT، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,SCTP,CHILD,RETRY 
.br 
.IP "\fB\f(CWSCTP\-LISTEN:<port>\fP\fP"
روی <port> [سرویس TCP] گوش فرا می‌دهد و یک
اتصال SCTP را می‌پذیرد\&. نسخه IP برابر با ۴ یا نسخه مشخص‌شده با
گزینه آدرس pf، گزینه socat
(\-4, \-6)، یا متغیر محیطی SOCAT_DEFAULT_LISTEN_IP است\&.
توجه داشته باشید که باز کردن
این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6,SCTP,RETRY 
.br 
گزینههای کاربردی:
crnl,
fork,
bind,
range,
tcpwrap,
pf,
max\-children,
backlog,
accept\-timeout,
sctp\-maxseg,
sctp\-nodelay,
su,
reuseaddr,
retry
.br 
همچنین ببینید:
SCTP4\-LISTEN,
SCTP6\-LISTEN,
TCP\-LISTEN,
SCTP\-CONNECT
.IP "\fB\f(CWSCTP4\-LISTEN:<port>\fP\fP"
مشابه SCTP\-LISTEN، اما فقط از پروتکل IPv4
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,SCTP,RETRY 
.br 
.IP "\fB\f(CWSCTP6\-LISTEN:<port>\fP\fP"
مشابه SCTP\-LISTEN، اما فقط از پروتکل IPv6
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP6,SCTP,RETRY 
.br 

.IP 
.IP "\fB\f(CWSOCKET\-CONNECT:<domain>:<protocol>:<remote\-address>\fP\fP"
با استفاده از پارامتر اول و دوم ارائه‌شده برای سوکت
و \f(CWSOCK_STREAM\fP (راهنمای man صفحه socket(2) را ببینید) یک سوکت جریانی ایجاد کرده و به remote\-address متصل می‌شود\&.
دو پارامتر سوکت باید به وسیله اعداد
صحیح (int) مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات و فایل‌های هدر سیستم‌عامل خود
مراجعه کنید\&. مقدار remote\-address باید نمایش داده‌ای
از ساختار sockaddr بدون مؤلفه‌های sa_family و sa_len (در BSD) باشد\&.
.br 
لطفاً توجه داشته باشید که علاوه بر گزینه‌های گروه‌های مشخص‌شده، هنگامی که گزینه
\-g در socat را اعمال می‌کنید می‌توانید از گزینه‌های پروتکل‌های سطح بالاتر نیز
استفاده نمایید\&.
.br 
گروههای گزینه: FD,SOCKET,CHILD,RETRY
.br 
گزینههای کاربردی:
bind,
setsockopt,
.br 
همچنین ببینید:
TCP,
UDP\-CONNECT,
UNIX\-CONNECT,
SOCKET\-LISTEN,
SOCKET\-SENDTO
.IP "\fB\f(CWSOCKET\-DATAGRAM:<domain>:<type>:<protocol>:<remote\-address>\fP\fP"
با استفاده از سه پارامتر اول ارائه‌شده برای سوکت (راهنمای
man صفحه socket(2) را ببینید) یک سوکت دیتاگرام ایجاد کرده و داده‌های خروجی را به remote\-address ارسال می‌کند\&. این سه
پارامتر سوکت باید با اعداد
صحیح (int) مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات و فایل‌های هدر سیستم‌عامل خود مراجعه کنید\&. مقدار remote\-address باید نمایش داده‌ای
از ساختار sockaddr بدون مؤلفه‌های sa_family و sa_len (در BSD) باشد\&.
.br 
لطفاً توجه داشته باشید که علاوه بر گزینه‌های گروه‌های مشخص‌شده، هنگامی که گزینه
\-g در socat را اعمال می‌کنید می‌توانید از گزینه‌های پروتکل‌های سطح بالاتر نیز
استفاده نمایید\&.
.br 
گروههای گزینه: FD,SOCKET,RANGE
.br 
گزینههای کاربردی:
bind,
range,
setsockopt,
.br 
همچنین ببینید:
UDP\-DATAGRAM,
IP\-DATAGRAM,
SOCKET\-SENDTO,
SOCKET\-RECV,
SOCKET\-RECVFROM

.IP "\fB\f(CWSOCKET\-LISTEN:<domain>:<protocol>:<local\-address>\fP\fP"
یک سوکت استریم با استفاده از پارامترهای اول و دوم ارائه‌شده برای سوکت و \f(CWSOCK_STREAM\fP (به socket(2) مراجعه کنید) ایجاد کرده و برای اتصالات ورودی روی local\-address منتظر می‌ماند\&. دو پارامتر سوکت باید با اعداد int مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های include خود مراجعه کنید\&. مقدار local\-address باید نمایش داده‌ای از یک ساختار sockaddr بدون مولفه‌های sa_family و (در BSD) sa_len باشد\&.
.br 
لطفاً توجه داشته باشید که علاوه بر گزینه‌های گروه‌های مشخص‌شده، در صورت استفاده از گزینه
.B \-g
در socat، می‌توانید از گزینه‌های پروتکل‌های سطح بالاتر نیز استفاده کنید\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,RANGE,CHILD,RETRY
.br 
گزینههای کاربردی:
setsockopt,
setsockopt\-listen,
.br 
همچنین ببینید:
TCP,
UDP\-CONNECT,
UNIX\-CONNECT,
SOCKET\-LISTEN,
SOCKET\-SENDTO,
SOCKET\-SENDTO
.IP "\fB\f(CWSOCKET\-RECV:<domain>:<type>:<protocol>:<local\-address>\fP\fP"
یک سوکت با استفاده از سه پارامتر ارائه‌شده برای سوکت (به socket(2) مراجعه کنید) ایجاد کرده و آن را به <local\-address> متصل (bind) می‌کند\&. داده‌های ورودی را دریافت می‌کند\&. این سه پارامتر باید با اعداد int مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های include مراجعه کنید\&. مقدار local\-address باید نمایش داده‌ای از یک ساختار sockaddr بدون مولفه‌های sa_family و (در BSD) sa_len باشد\&.
.br 
گروههای گزینه: FD,SOCKET,RANGE
.br 
گزینههای کاربردی:
range,
setsockopt,
setsockopt\-listen
.br 
همچنین ببینید:
UDP\-RECV,
IP\-RECV,
UNIX\-RECV,
SOCKET\-DATAGRAM,
SOCKET\-SENDTO,
SOCKET\-RECVFROM
.IP "\fB\f(CWSOCKET\-RECVFROM:<domain>:<type>:<protocol>:<local\-address>\fP\fP"
یک سوکت با استفاده از سه پارامتر ارائه‌شده برای سوکت (به socket(2) مراجعه کنید) ایجاد کرده و آن را به <local\-address> متصل می‌کند\&. داده‌های دریافتی را تحویل گرفته و پاسخ‌ها را برای فرستنده ارسال می‌کند\&. سه پارامتر اول باید به صورت اعداد int مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های include مراجعه کنید\&. مقدار local\-address باید نمایش داده‌ای از ساختار sockaddr بدون مولفه‌های sa_family و (در BSD) sa_len باشد\&.
.br 
یادداشت مربوط به آدرس‌های RECVFROM را ببینید\&.
.br 
گروههای گزینه: FD,SOCKET,CHILD,RANGE
.br 
گزینههای کاربردی:
fork,
range,
setsockopt,
setsockopt\-listen
.br 
همچنین ببینید:
UDP\-RECVFROM,
IP\-RECVFROM,
UNIX\-RECVFROM,
SOCKET\-DATAGRAM,
SOCKET\-SENDTO,
SOCKET\-RECV
.IP "\fB\f(CWSOCKET\-SENDTO:<domain>:<type>:<protocol>:<remote\-address>\fP\fP"
یک سوکت با استفاده از سه پارامتر ارائه‌شده برای سوکت (به socket(2) مراجعه کنید) ایجاد می‌کند\&. داده‌های خروجی را به آدرس ارائه‌شده ارسال کرده و پاسخ‌ها را دریافت می‌نماید\&. این سه پارامتر باید به صورت اعداد int مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های include مراجعه کنید\&. مقدار remote\-address باید نمایش داده‌ای از ساختار sockaddr بدون مولفه‌های sa_family و (در BSD) sa_len باشد\&.
.br 
گروههای گزینه: FD,SOCKET
.br 
گزینههای کاربردی:
bind,
setsockopt,
setsockopt\-listen
.br 
همچنین ببینید:
UDP\-SENDTO,
IP\-SENDTO,
UNIX\-SENDTO,
SOCKET\-DATAGRAM,
SOCKET\-RECV
SOCKET\-RECVFROM
.IP "\fB\f(CWACCEPT\-FD:<fdnum>\fP\fP"
انتظار یک سوکت در حال شنود را در <fdnum> دارد و یک یا (با گزینه fork) چند اتصال را می‌پذیرد\&. این نوع آدرس تحت کنترل systemd با \(dq\&حالت inetd\(dq مفید است\&.
.br 
مثال: (example)
.br 
گروههای گزینه: FD, SOCKET, TCP, CHILD, RETRY
.br 
گزینههای کاربردی:
fork,
range,
sourceport,
lowport,
tcpwrap
.IP "\fB\f(CWSOCKS4:<socks\-server>:<host>:<port>\fP\fP"
از طریق <socks\-server> [آدرس IP]
به <host> [آدرس IPv4]
روی <port> [سرویس TCP]،
با استفاده از پروتکل socks نسخه ۴ روی IP نسخه ۴ یا ۶ بسته به مشخصات آدرس، تحلیل نام یا گزینه
pf متصل می‌شود (مثال)\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,SOCKS4,RETRY 
.br 
گزینههای کاربردی:
socksuser,
socksport,
sourceport,
pf,
retry
.br 
همچنین ببینید:
SOCKS5,
SOCKS4A,
PROXY,
TCP
.IP 
.IP "\fB\f(CWSOCKS4A:<socks\-server>:<host>:<port>\fP\fP"
مانند SOCKS4 است، اما از پروتکل socks نسخه 4a استفاده می‌کند و بدین ترتیب تحلیل نام میزبان را به سرور socks واگذار می‌نماید\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,SOCKS4,RETRY 
.br 

.IP 
.IP "\fB\f(CWSOCKS5\-CONNECT:<socks\-server>:<socks\-port>:<target\-host>:<target\-port>\fP\fP"
.IP "\fB\f(CWSOCKS5\-CONNECT:<socks\-server>:<target\-host>:<target\-port>\fP\fP"
از طریق <socks\-server> [آدرس IP]
به <target\-host> [آدرس IPv4]
روی <target\-port> [سرویس TCP]،
با استفاده از پروتکل socks نسخه ۵ بر روی TCP متصل می‌شود\&. در حال حاضر هیچ سازوکار احراز هویتی ارائه نشده است\&.
.br 
گروههای گزینه: FD, SOCKET, IP4, IP6, TCP, CHILD, RETRY
.br 
گزینههای کاربردی:
socksport,
sourceport,
pf,
retry
.br 
همچنین ببینید:
SOCKS5\-LISTEN,
SOCKS4,
SOCKS4A,
PROXY,
TCP
.IP 
.IP "\fB\f(CWSOCKS5\-LISTEN:<socks\-server>:<socks\-port>:<listen\-host>:<listen\-port>\fP\fP"
.IP "\fB\f(CWSOCKS5\-LISTEN:<socks\-server>:<listen\-host>:<listen\-port>\fP\fP"
به <socks\-server> [آدرس IP]
با استفاده از پروتکل socks نسخه ۵ بر روی TCP متصل می‌شود
و آن را وادار به شنود برای اتصالات ورودی روی <listen\-port> [سرویس TCP] و متصل شدن به <\-listen\-host> [آدرس IPv4] می‌کند\&.
در حال حاضر هیچ سازوکار احراز هویتی ارائه نشده است\&.
.br 
گروههای گزینه: FD, SOCKET, IP4, IP6, TCP, CHILD, RETRY
.br 
گزینههای کاربردی:
sourceport,
pf,
retry
.br 
همچنین ببینید:
SOCKS5\-CONNECT,
.IP 
.IP "\fB\f(CWSTDERR\fP\fP"
از توصیف‌کننده فایل ۲ استفاده می‌کند\&.
.br 
این یک آدرس فقط‌نوشتنی است؛ به گزینه‌های
.B \-u
و
.B \-U
و آدرس‌های دوگانه مراجعه کنید\&.
.br 
گروههای گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSTDIN\fP\fP"
از توصیف‌کننده فایل ۰ استفاده می‌کند\&.
.br 
این یک آدرس فقط‌خواندنی است؛ به گزینه‌های
.B \-u
و
.B \-U
و آدرس‌های دوگانه مراجعه کنید\&.
.br 
گروههای گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
گزینههای کاربردی:
readbytes
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSTDIO\fP\fP"
از توصیف‌کننده فایل ۰ برای خواندن و ۱ برای نوشتن استفاده می‌کند\&.
.br 
گروههای گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
گزینههای کاربردی:
readbytes
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSTDOUT\fP\fP"
از توصیف‌کننده فایل ۱ استفاده می‌کند\&.
.br 
این یک آدرس فقط‌نوشتنی است؛ به گزینه‌های
.B \-u
و
.B \-U
و آدرس‌های دوگانه مراجعه کنید\&.
.br 
گروههای گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSHELL:<shell\-command>\fP\fP"
یک زیرپردازه منشعب می‌کند که ارتباط با پردازه والد خود را برقرار ساخته
و برنامه مشخص‌شده را با پوسته پیکربندی‌شده ($SHELL) فراخوانی می‌کند\&.
توجه داشته باشید که <shell\-command> [رشته] نباید
شامل \(cq\&,\(cq\& یا \(dq\&!!\(dq\& باشد، و ممکن است لازم باشد کاراکترهای متای پوسته
محافظت شوند\&.
پس از شروع موفقیت‌آمیز برنامه، \fBsocat\fP داده‌ها را در stdin پردازه می‌نویسد
و از stdout آن می‌خواند\&.
.br 
گروههای گزینه: FD,SOCKET,EXEC,FORK,TERMIOS 
.br 
گزینههای کاربردی:
path,
fdin,
fdout,
chroot,
su,
su\-d,
nofork,
socktype,
pty,
stderr,
ctty,
setsid,
pipes,
umask,
sigint,
sigquit
.br 
همچنین ببینید: EXEC, SYSTEM
.IP "\fB\f(CWSYSTEM:<shell\-command>\fP\fP"
یک زیرپردازه منشعب می‌کند که ارتباط با پردازه والد خود را برقرار ساخته
و برنامه مشخص‌شده را با 
\f(CWsystem()\fP
فراخوانی می‌کند\&. لطفاً توجه داشته باشید که
<shell\-command> [رشته] نباید
شامل \(cq\&,\(cq\& یا \(dq\&!!\(dq\& باشد، و ممکن است لازم باشد کاراکترهای متای پوسته
محافظت شوند\&.
پس از اجرای موفق برنامه، \fBsocat\fP داده‌ها را در stdin پردازه می‌نویسد
و از stdout آن می‌خواند\&.
.br 
گروههای گزینه: FD,SOCKET,EXEC,FORK,TERMIOS 
.br 
گزینههای کاربردی:
path,
fdin,
fdout,
chroot,
su,
su\-d,
nofork,
socktype,
pty,
stderr,
ctty,
setsid,
pipes,
umask,
sigint,
sigquit,
netns
.br 
همچنین ببینید: EXEC, SHELL
.IP "\fB\f(CWTCP:<host>:<port>\fP\fP"
به <port> [سرویس TCP] در
<host> [آدرس IP] با استفاده از TCP/IP نسخه ۴ یا ۶
بسته به مشخصات آدرس، تحلیل نام یا گزینه
pf متصل می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,TCP,RETRY 
.br 
گزینههای کاربردی:
connect\-timeout,
retry,
sourceport,
netns,
crnl,
bind,
pf,
tos,
mtudiscover,
mss,
nodelay,
nonblock,
readbytes
.br 
همچنین ببینید:
TCP4,
TCP6,
TCP\-LISTEN,
UDP,
SCTP\-CONNECT,
UNIX\-CONNECT
.IP "\fB\f(CWTCP4:<host>:<port>\fP\fP"
مانند TCP است، اما فقط از پروتکل IPv4 پشتیبانی می‌کند (مثال)\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,TCP,RETRY 
.br 
.IP "\fB\f(CWTCP6:<host>:<port>\fP\fP"
مانند TCP است، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,TCP,RETRY 
.br 
.IP "\fB\f(CWTCP\-LISTEN:<port>\fP\fP"
روی <port> [سرویس TCP] شنود می‌کند و یک
اتصال TCP/IP را می‌پذیرد\&. نسخه IP برابر ۴ یا نسخه‌ای است که با
گزینه آدرس pf، گزینه socat
(\-4, \-6) یا متغیر محیطی SOCAT_DEFAULT_LISTEN_IP مشخص شده است\&.
توجه داشته باشید که باز کردن
این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6,TCP,RETRY 
.br 
گزینههای کاربردی:
crnl,
fork,
bind,
range,
tcpwrap,
pf,
max\-children,
backlog,
accept\-timeout,
mss,
su,
reuseaddr,
retry,
cool\-write
.br 
همچنین ببینید:
TCP4\-LISTEN,
TCP6\-LISTEN,
UDP\-LISTEN,
SCTP\-LISTEN,
UNIX\-LISTEN,
OPENSSL\-LISTEN,
TCP\-CONNECT
.IP "\fB\f(CWTCP4\-LISTEN:<port>\fP\fP"
مانند TCP\-LISTEN است، اما فقط از پروتکل IPv4
پشتیبانی می‌کند (مثال)\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,TCP,RETRY 
.br 
.IP "\fB\f(CWTCP6\-LISTEN:<port>\fP\fP"
مانند TCP\-LISTEN است، اما فقط از پروتکل IPv6
پشتیبانی می‌کند\&.
.br 
گزینههای کاربردی افزوده:
ipv6only
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP6,TCP,RETRY 
.br 
.IP "\fB\f(CWTUN[:<if\-addr>/<bits>]\fP\fP"
یک دستگاه TUN/TAP لینوکس ایجاد کرده و به صورت اختیاری آدرس و
نت‌ماسک تعیین‌شده توسط پارامترها را به آن اختصاص می‌دهد\&. رابط شبکه حاصل تقریباً
برای استفاده توسط سایر پردازه‌ها آماده است؛ socat به بخش سیم آن (\(dq\&wire side\(dq\&) خدمت‌رسانی می‌کند\&. این آدرس
نیاز به دسترسی خواندن و نوشتن در دستگاه تکثیر تونل، معمولاً
\f(CW/dev/net/tun\fP
دارد، و همچنین نیازمند مجوز برای تنظیم برخی فراخوانی‌های \f(CWioctl()\fP است\&.
\fBگزینه iff\-up برای فعال‌سازی فوری رابط لازم است!\fP
.br 
نکته: اگر قصد انتقال بسته‌ها بین دو بخش سیم (\(dq\&wire sides\(dq\&) در Socat را دارید،
به پروتکلی نیاز دارید که مرزهای بسته را حفظ کند، مانند UDP؛ ممکن است TCP با
گزینه nodelay کار کند\&.
.br 
گروههای گزینه: FD,NAMED,OPEN,TUN 
.br 
گزینههای کاربردی:
iff\-up,
tun\-device,
tun\-name,
tun\-type,
iff\-no\-pi,
netns
.br 
همچنین ببینید:
ip\-recv
.IP 
.IP "\fB\f(CWUDP:<host>:<port>\fP\fP"
به <port> [سرویس UDP] در
<host> [آدرس IP] با استفاده از UDP/IP نسخه ۴ یا ۶
بسته به مشخصات آدرس، تحلیل نام یا گزینه
pf متصل می‌شود\&.
.br 
لطفاً توجه داشته باشید که
به دلیل ویژگی‌های پروتکل UDP، اتصال واقعی برقرار نمی‌شود؛ داده‌ها باید برای
`اتصال\(cq\& به سرور ارسال شوند، و هیچ وضعیت پایان فایلی (end\-of\-file) قابل
انتقال نیست\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6 
.br 
گزینههای کاربردی:
ttl,
tos,
bind,
sourceport,
pf
.br 
همچنین ببینید:
UDP4,
UDP6,
UDP\-LISTEN,
TCP,
IP
.IP "\fB\f(CWUDP4:<host>:<port>\fP\fP"
مانند UDP است، اما فقط از پروتکل IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4 
.br 
.IP "\fB\f(CWUDP6:<host>:<port>\fP\fP"
مانند UDP است، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6 
.br 
.IP "\fB\f(CWUDP\-DATAGRAM:<address>:<port>\fP\fP"
داده‌های خروجی را به آدرس مشخص‌شده ارسال می‌کند که ممکن است به‌ویژه یک
آدرس همگانی (broadcast) یا چندپخشی (multicast) باشد\&. بسته‌های ورودی به سوکت محلی
فقط زمانی برای پورت دوردستِ صحیح بررسی می‌شوند که از گزینه sourceport استفاده شده باشد (این یک تغییر در نگارش 1\&.7\&.4\&.0 از \fBSocat\fP است) و در صورتی که آدرس‌های مبدأ آن‌ها با گزینه‌های
RANGE یا TCPWRAP
مطابقت داشته باشد\&. این نوع آدرس می‌تواند برای نمونه برای پیاده‌سازی
ارتباطات متقارن یا نامتقارن همگانی یا چندپخشی استفاده شود\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,RANGE 
.br 
گزینههای کاربردی:
bind,
range,
tcpwrap,
broadcast,
ip\-multicast\-loop,
ip\-multicast\-ttl,
ip\-multicast\-if,
ip\-add\-membership,
ip\-add\-source\-membership,
ipv6\-join\-group,
ipv6\-join\-source\-group,
ttl,
tos,
sourceport,
pf
.br 
همچنین ببینید:
UDP4\-DATAGRAM,
UDP6\-DATAGRAM,
UDP\-SENDTO,
UDP\-RECVFROM,
UDP\-RECV,
UDP\-CONNECT,
UDP\-LISTEN,
IP\-DATAGRAM
.IP "\fB\f(CWUDP4\-DATAGRAM:<address>:<port>\fP\fP"
مانند UDP\-DATAGRAM است، اما فقط از پروتکل IPv4
پشتیبانی می‌کند (مثال ۱،
مثال ۲)\&.
.br 
گروههای گزینه: FD,SOCKET,IP4, RANGE
.IP "\fB\f(CWUDP6\-DATAGRAM:<address>:<port>\fP\fP"
مانند UDP\-DATAGRAM است، اما فقط از پروتکل IPv6
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,RANGE
.IP "\fB\f(CWUDP\-LISTEN:<port>\fP\fP"
منتظر یک بسته UDP/IP ورودی روی <port>
[سرویس UDP] می‌ماند و مجدداً به فرستنده `متصل می‌شود\(cq\&.
نسخه IP پذیرفته‌شده ۴ یا نسخه‌ای است که با گزینه
pf مشخص شده است\&.
لطفاً توجه داشته باشید که
به دلیل ویژگی‌های پروتکل UDP، هیچ اتصال واقعی برقرار نمی‌شود؛ داده‌ها باید
ابتدا از سمت طرف مقابل برسند، و هیچ وضعیت پایان فایلی قابل
انتقال نیست\&. توجه داشته باشید که باز کردن  
این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4,IP6 
.br 
گزینههای کاربردی:
fork,
bind,
range,
pf 
.br 
همچنین ببینید:
UDP,
UDP4\-LISTEN,
UDP6\-LISTEN,
TCP\-LISTEN
.IP "\fB\f(CWUDP4\-LISTEN:<port>\fP\fP"
مانند UDP\-LISTEN است، اما فقط از پروتکل IPv4
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP4 
.br 
.IP "\fB\f(CWUDP6\-LISTEN:<port>\fP\fP"
مانند UDP\-LISTEN است، اما فقط از پروتکل IPv6
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RANGE,IP6 
.br 
.IP "\fB\f(CWUDP\-SENDTO:<host>:<port>\fP\fP"
با سوکت همتای مشخص‌شده که توسط <port> [سرویس
UDP] روی
<host> [آدرس IP] تعیین شده است، با استفاده از UDP/IP نسخه ۴ یا ۶
بسته به مشخصات آدرس، تحلیل نام یا گزینه
pf ارتباط برقرار می‌کند\&. این آدرس بسته‌ها را فقط به آن سوکت همتا ارسال کرده
و از آن بسته دریافت می‌کند\&.  
این آدرس عملاً یک کلاینت دیتاگرام را پیاده‌سازی می‌کند\&.
با همتاهای آدرس UDP\-RECVFROM و UDP\-RECV در socat به خوبی کار می‌کند\&.
زمانی که ممکن است همتا ابتدا داده ارسال کند، UDP\-DATAGRAM ارجح است\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6 
.br 
گزینههای کاربردی:
ttl,
tos,
bind,
sourceport,
pf
.br 
همچنین ببینید:
UDP4\-SENDTO,
UDP6\-SENDTO,
UDP\-RECVFROM,
UDP\-RECV,
UDP\-CONNECT,
UDP\-LISTEN,
IP\-SENDTO
.IP "\fB\f(CWUDP4\-SENDTO:<host>:<port>\fP\fP"
مانند UDP\-SENDTO است، اما فقط از پروتکل IPv4
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4
.IP "\fB\f(CWUDP6\-SENDTO:<host>:<port>\fP\fP"
مانند UDP\-SENDTO است، اما فقط از پروتکل IPv6
پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6
.IP 
.IP "\fB\f(CWUDP\-RECVFROM:<port>\fP\fP"
یک سوکت UDP روی <port> [سرویس UDP] با استفاده از
UDP/IP نسخه ۴ یا ۶ 
بسته به گزینه pf ایجاد می‌کند\&.
یک بسته را از یک همتای نامشخص دریافت کرده و ممکن است یک یا چند
بسته پاسخ به آن همتا بفرستد\&. این حالت به‌ویژه با
گزینه fork سودمند است 
که در آن هر بسته دریافتی \- از همتاهای دلخواه \- توسط زیرپردازه خودش
مدیریت می‌شود\&. این ویژگی رفتاری شبیه به سرورهای معمول مبتنی بر UDP مانند ntpd
یا named را فراهم می‌کند\&. این آدرس با همتاهای آدرس UDP\-SENDTO در socat به خوبی کار می‌کند\&.
.br 
نکته: هنگامی که آدرس دوم قبل از ورود به حلقه انتقال با شکست مواجه شود،
بسته دور انداخته می‌شود\&. از گزینه retry یا
forever روی آدرس دوم برای جلوگیری از دست رفتن داده‌ها استفاده کنید\&.
هنگامی که آدرس همتا را می‌دانید، UDP\-DATAGRAM
ارجح است\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,CHILD,RANGE 
.br 
گزینههای کاربردی:
fork,
ttl,
tos,
bind,
sourceport,
pf
.br 
همچنین ببینید:
UDP4\-RECVFROM,
UDP6\-RECVFROM,
UDP\-SENDTO,
UDP\-RECV,
UDP\-CONNECT,
UDP\-LISTEN,
IP\-RECVFROM,
UNIX\-RECVFROM
.IP "\fB\f(CWUDP4\-RECVFROM:<port>\fP\fP"
مانند UDP\-RECVFROM است، اما فقط از پروتکل IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,CHILD,RANGE
.IP "\fB\f(CWUDP6\-RECVFROM:<port>\fP\fP"
مانند UDP\-RECVFROM است، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,CHILD,RANGE
.IP 
.IP "\fB\f(CWUDP\-RECV:<port>\fP\fP"
یک سوکت UDP روی <port> [سرویس UDP] با استفاده از UDP/IP نسخه ۴ یا ۶
بسته به گزینه pf ایجاد می‌کند\&.
بسته‌ها را از چندین همتای نامشخص دریافت کرده و داده‌ها را ادغام می‌کند\&.
هیچ پاسخی امکان‌پذیر نیست\&. این آدرس برای مثال با همتاهای
آدرس UDP\-SENDTO در socat به خوبی کار می‌کند؛ رفتاری شبیه به یک
سرور syslog دارد\&.
.br 
این یک آدرس فقط‌خواندنی است؛ به گزینه‌های
.B \-u
و
.B \-U
و آدرس‌های دوگانه مراجعه کنید\&.
.br 
نکته: اگر به گزینه fork نیاز دارید، به جای آن از UDP\-RECVFROM در حالت یک‌طرفه (با گزینه \-u) استفاده کنید\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,IP6,RANGE 
.br 
گزینههای کاربردی:
pf,
bind,
sourceport,
ttl,
tos
.br 
همچنین ببینید:
UDP4\-RECV,
UDP6\-RECV,
UDP\-SENDTO,
UDP\-RECVFROM,
UDP\-CONNECT,
UDP\-LISTEN,
IP\-RECV,
UNIX\-RECV
.IP "\fB\f(CWUDP4\-RECV:<port>\fP\fP"
مانند UDP\-RECV است، اما فقط از پروتکل IPv4 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP4,RANGE
.IP "\fB\f(CWUDP6\-RECV:<port>\fP\fP"
مانند UDP\-RECV است، اما فقط از پروتکل IPv6 پشتیبانی می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,IP6,RANGE
.IP 
.IP "\fB\f(CWUDPLITE\-CONNECT:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-CONNECT:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-CONNECT:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE\-DATAGRAM:<address>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-DATAGRAM:<address>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-DATAGRAM:<address>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE\-LISTEN:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-LISTEN:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-LISTEN:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE\-SENDTO:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-SENDTO:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-SENDTO:<host>:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE\-RECVFROM:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-RECVFROM:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-RECVFROM:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE\-RECV:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE4\-RECV:<port>\fP\fP"
.IP "\fB\f(CWUDPLITE6\-RECV:<port>\fP\fP"
آدرس‌های UDPLITE تقریباً مشابه آدرس‌های مرتبط UDP هستند
اما از پروتکل UDP\-Lite استفاده می‌کنند و دارای گروه گزینه اضافی UDPLITE
می‌باشند\&.
.br 

.IP 
.IP "\fB\f(CWUNIX\-CONNECT:<filename>\fP\fP"
با این فرض که <filename> یک سوکت دامنه
یونیکس است، به آن متصل می‌شود\&.
اگر <filename> وجود نداشته باشد، این یک خطا است؛
اگر <filename> یک سوکت دامنه یونیکس نباشد، این یک خطا است؛
اگر <filename> یک سوکت دامنه یونیکس باشد اما هیچ پردازه‌ای در حال شنود نباشد، این
یک خطا است\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,RETRY,UNIX 
.br 
گزینههای کاربردی:
bind
.br 
همچنین ببینید:
UNIX\-LISTEN,
UNIX\-SENDTO,
TCP
.IP 
.IP "\fB\f(CWUNIX\-LISTEN:<filename>\fP\fP"
با استفاده از یک سوکت استریم دامنه یونیکس روی <filename> شنود
کرده و یک اتصال را می‌پذیرد\&.
اگر <filename> وجود داشته باشد و یک سوکت نباشد، این یک خطا است\&.
اگر <filename> وجود داشته باشد و یک سوکت دامنه یونیکس باشد، متصل شدن (bind) به این آدرس
شکست می‌خورد (از گزینه unlink\-early استفاده کنید!)\&.
توجه داشته باشید که باز کردن این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
از نسخه 1\&.4\&.3 در socat به بعد، با بسته شدن این آدرس مدخل فایل‌سیستم
حذف می‌شود (اما گزینه unlink\-close را ببینید) (مثال)\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,LISTEN,CHILD,RETRY,UNIX 
.br 
گزینههای کاربردی:
fork,
umask,
mode,
user,
group,
unlink\-early
.br 
همچنین ببینید:
UNIX\-CONNECT,
UNIX\-RECVFROM,
UNIX\-RECV,
TCP\-LISTEN
.IP 
.IP "\fB\f(CWUNIX\-SENDTO:<filename>\fP\fP"
با سوکت همتای مشخص‌شده که توسط [<filename>] تعریف شده، با این فرض که یک سوکت دیتاگرام دامنه یونیکس است، ارتباط برقرار می‌کند\&.
بسته‌ها را فقط به آن سوکت همتا ارسال کرده و فقط از آن بسته دریافت می‌کند\&.
لطفاً توجه داشته باشید که ممکن است لازم باشد سوکت
محلی را به یک آدرس متصل (bind) کنید (مانند \f(CW/tmp/sock1\fP که نباید از
قبل وجود داشته باشد)\&.
این نوع آدرس با همتاهای آدرس UNIX\-RECVFROM و UNIX\-RECV در socat
به خوبی کار می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,UNIX
.br 
گزینههای کاربردی:
bind
.br 
همچنین ببینید:
UNIX\-RECVFROM,
UNIX\-RECV,
UNIX\-CONNECT,
UDP\-SENDTO,
IP\-SENDTO
.IP 
.IP "\fB\f(CWUNIX\-RECVFROM:<filename>\fP\fP"
یک سوکت دیتاگرام دامنه یونیکس [<filename>] ایجاد می‌کند\&.
یک بسته را دریافت کرده و ممکن است یک یا چند بسته پاسخ به آن همتا ارسال نماید\&.
این حالت به‌ویژه با گزینه fork سودمند است که در آن هر بسته دریافتی \- از همتاهای دلخواه \- توسط زیرپردازه خودش مدیریت می‌شود\&.
این آدرس با همتاهای آدرس UNIX\-SENDTO در socat به خوبی کار می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,CHILD,UNIX 
.br 
یادداشت مربوط به آدرس‌های RECVFROM را ببینید\&.
.br 
گزینههای کاربردی:
fork
.br 
umask
.br 
همچنین ببینید:
UNIX\-SENDTO,
UNIX\-RECV,
UNIX\-LISTEN,
UDP\-RECVFROM,
IP\-RECVFROM
.IP 
.IP "\fB\f(CWUNIX\-RECV:<filename>\fP\fP"
یک سوکت دیتاگرام دامنه یونیکس [<filename>] ایجاد می‌کند\&.
بسته‌ها را از چندین همتای نامشخص دریافت کرده و داده‌ها را ادغام می‌نماید\&.
هیچ پاسخی امکان‌پذیر نیست، این یک آدرس فقط‌خواندنی است؛ به گزینه‌های
.B \-u
و
.B \-U
و آدرس‌های دوگانه مراجعه کنید\&.
برای مثال می‌تواند توسط همتاهای آدرس UNIX\-SENDTO در socat آدرس‌دهی شود\&.
رفتاری شبیه به یک سرور syslog دارد\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,UNIX 
.br 
گزینههای کاربردی:
umask
.br 
همچنین ببینید:
UNIX\-SENDTO,
UNIX\-RECVFROM,
UNIX\-LISTEN,
UDP\-RECV,
IP\-RECV
.IP 
.IP "\fB\f(CWUNIX\-CLIENT:<filename>\fP\fP"
با سوکت همتای مشخص‌شده که توسط
[<filename>] تعریف شده است، با این فرض که یک سوکت دامنه یونیکس است ارتباط برقرار می‌کند\&.
ابتدا برای اتصال تلاش می‌کند و در صورت شکست، فرض می‌کند که یک سوکت
دیتاگرام است؛ بنابراین از هر دو نوع پشتیبانی می‌نماید\&.
.br 
گروههای گزینه: FD,SOCKET,NAMED,UNIX 
.br 
گزینههای کاربردی:
bind
.br 
همچنین ببینید:
UNIX\-CONNECT,
UNIX\-SENDTO,
GOPEN
.IP 
.IP "\fB\f(CWVSOCK\-CONNECT:<cid>:<port>\fP\fP"
یک اتصال استریم VSOCK به <cid> [VSOCK
cid] و <port> [VSOCK port] مشخص‌شده برقرار می‌کند\&.
.br 
گروههای گزینه: FD,SOCKET,CHILD,RETRY 
.br 
گزینههای کاربردی:
bind,
connect\-timeout,
retry,
readbytes
.br 
همچنین ببینید:
VSOCK\-LISTEN,
.IP 
.IP "\fB\f(CWVSOCK\-LISTEN:<port>\fP\fP"
روی <port> [VSOCK port] شنود کرده و یک
اتصال VSOCK را می‌پذیرد\&.
توجه داشته باشید که باز کردن این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&.
.br 
گروههای گزینه: FD,SOCKET,LISTEN,CHILD,RETRY 
.br 
گزینههای کاربردی:
fork,
bind,
max\-children,
backlog,
su,
reuseaddr,
retry
.br 
همچنین ببینید:
VSOCK\-CONNECT
.IP 
.IP "\fB\f(CWABSTRACT\-CONNECT:<string>\fP\fP"
.IP "\fB\f(CWABSTRACT\-LISTEN:<string>\fP\fP"
.IP "\fB\f(CWABSTRACT\-SENDTO:<string>\fP\fP"
.IP "\fB\f(CWABSTRACT\-RECVFROM:<string>\fP\fP"
.IP "\fB\f(CWABSTRACT\-RECV:<string>\fP\fP"
.IP "\fB\f(CWABSTRACT\-CLIENT:<string>\fP\fP"
آدرس‌های ABSTRACT تقریباً با آدرس‌های مرتبط UNIX یکسان هستند،
به جز اینکه سوکت‌های مبتنی بر فایل‌سیستم را آدرس‌دهی نمی‌کنند، بلکه یک فضای آدرس دامنه
یونیکس جایگزین را مخاطب قرار می‌دهند\&. برای دستیابی به این منظور، رشته‌های آدرس سوکت
در داخل با \(dq\&\e0\(dq\& پیشوندگذاری می‌شوند\&. این ویژگی (فقط؟) در لینوکس موجود است\&.
گروه‌های گزینه مانند آدرس‌های مرتبط UNIX هستند، به جز اینکه
آدرس‌های ABSTRACT عضو گروه NAMED نیستند\&.
.br 
گزینههای کاربردی:
netns

.PP

.SH "گزینههای آدرس (ADDRESS OPTIONS)"

.PP 
گزینه‌های آدرس را می‌توان روی مشخصات آدرس اعمال کرد تا بر فرآیند باز کردن آدرس‌ها و ویژگی‌های کانال‌های داده حاصل تأثیر بگذارند\&. 
.PP 
به دلایل فنی، نمی‌توان هر گزینه‌ای را روی هر نوع آدرسی اعمال کرد؛ به عنوان مثال، اعمال یک گزینه سوکت روی یک فایل معمولی با شکست مواجه خواهد شد\&. برای تشخیص زودهنگام اکثر ترکیب‌های بی‌استفاده در همان مرحله باز کردن، مفهوم \fIگروه‌های گزینه (option groups)\fP معرفی شد\&. هر گزینه به یک یا چند گروه گزینه تعلق دارد\&. گزینه‌ها تنها با انواع آدرسی قابل استفاده هستند که دست‌کم از یکی از گروه‌های گزینه آن‌ها پشتیبانی کنند (البته گزینه \-g را نیز ببینید)\&.
.PP 
گزینه‌های آدرس دارای انواع داده‌ای هستند که مقادیرشان باید با آن‌ها مطابقت داشته باشد\&. 
هر گزینه آدرس تنها از یک کلمه کلیدی یا یک کلمه کلیدی به همراه \(dq\&=value\(dq\& تشکیل شده است، که در آن value باید با نوع داده گزینه مطابقت داشته باشد\&.
برخی گزینه‌های آدرس پارامترهای فراخوانی‌های سیستمی را دستکاری می‌کنند؛
به عنوان مثال، گزینه sync فلگ 
\f(CWO_SYNC\fP
را در فراخوانی 
\f(CWopen()\fP
تنظیم می‌کند\&. 
گزینه‌های دیگر موجب یک فراخوانی سیستمی یا کتابخانه‌ای می‌شوند؛ به عنوان مثال، با گزینه `ttl=value\(cq\& فراخوانی 
\f(CWsetsockopt(fd, SOL_IP, IP_TTL, value, sizeof(int))\fP
اعمال می‌شود\&.
گزینه‌های دیگر متغیرهای داخلی \fBsocat\fP را تنظیم می‌کنند که در حین انتقال داده استفاده می‌شوند؛ به عنوان مثال، `crnl\(cq\& تبدیل‌های صریح نویسه‌ها را اعمال می‌کند\&. 
تعداد کمی از گزینه‌ها پیاده‌سازی‌های پیچیده‌تری دارند؛ به عنوان مثال، su\-d (مخفف substuser\-delayed) برخی اطلاعات کاربر و گروه را استعلام و ذخیره کرده، و بعداً پس از فراخوانی احتمالی 
\f(CWchroot()\fP
اعمال می‌کند\&.
.PP 
اگر چندین گزینه برای یک آدرس مشخص شود، ترتیب آن‌ها در مشخصات آدرس (تقریباً) هیچ تأثیری بر ترتیب اجرا یا اعمال آن‌ها ندارد\&. در عوض، \fBsocat\fP یک مدل داخلی \fIفاز گزینه‌ها (option phase)\fP دارد که تلاش می‌کند گزینه‌ها را در یک ترتیب مفید قرار دهد\&. برخی گزینه‌ها در قالب‌های متفاوتی وجود دارند (مانند unlink، unlink\-early، unlink\-late) تا زمان اجرای آن‌ها را کنترل کنند\&.
.PP 
اگر یک گزینه بیش از یک بار با مقادیر یکسان یا متفاوت در مشخصات یک آدرس تعیین شود، اثر آن به نوع گزینه بستگی دارد\&. گزینه‌هایی که منجر به فراخوانی توابعی مانند 
\f(CWsetsockopt()\fP
می‌شوند، فراخوانی‌های متعددی را در پی دارند\&. در مورد گزینه‌هایی که پارامترهایی را برای یک فراخوانی الزامی مانند 
\f(CWopen()\fP
تنظیم می‌کنند یا فلگ‌های داخلی را مقداردهی می‌کنند، مقدار آخرین گزینه اعمال‌شده مؤثر خواهد بود\&.
.PP 
وجود یا معنای بسیاری از گزینه‌ها وابسته به سیستم است\&. معمولاً \fBSocat\fP تلاشی برای شبیه‌سازی قابلیت‌های غایب libc یا هسته انجام نمی‌دهد، بلکه صرفاً یک رابط برای سیستم زیربنایی فراهم می‌کند\&. بنابراین، اگر یک سیستم‌عامل فاقد قابلیتی باشد، گزینه مربوطه به سادگی روی این پلتفرم در دسترس نخواهد بود\&.
.PP 
پاراگراف‌های زیر فقط گزینه‌های آدرس متداول‌تر را معرفی می‌کنند\&. برای یک مرجع جامع‌تر و یافتن اطلاعات درباره نام‌های متعارف گزینه‌ها، نام‌های مستعار، فازهای گزینه‌ها، و پلتفرم‌ها به فایل \fBxio\&.help\fP مراجعه کنید\&. 
.br 
.br 

.PP 
.br 

.PP 
\fI\fBگروه گزینه FD\fP\fP
.PP 
این گروه گزینه شامل گزینه‌هایی است که بر روی توصیف‌کننده فایل (file descriptor) به سبک یونیکس (UN*X) اعمال می‌شوند، صرف‌نظر از اینکه چگونه ایجاد شده باشد\&.
از آنجا که تمام انواع آدرس‌های فعلی در \fBsocat\fP مبتنی بر توصیف‌کننده فایل هستند، این گزینه‌ها را می‌توان روی هر آدرسی اعمال کرد\&. 
.br 
نکته: برخی از این گزینه‌ها عضو گروه گزینه دیگری نیز هستند که سازوکار دیگری به جز توصیف‌کننده فایل فراهم می‌کند\&.
برای این گزینه‌ها، بسته به نوع آدرس واقعی و گروه‌های گزینه آن مشخص می‌شود که کدام سازوکار استفاده خواهد شد\&. سازوکار دوم (غیر مبتنی بر توصیف‌کننده فایل) اولویت دارد\&.
.IP "\fB\f(CWcloexec[=<bool>]\fP\fP"
فلگ 
\f(CWFD_CLOEXEC\fP
را با فراخوانی سیستمی 
\f(CWfcntl()\fP
به مقدار <bool> تنظیم می‌کند\&. در صورت تنظیم، توصیف‌کننده فایل در فراخوانی‌های خانواده توابع 
\f(CWexec()\fP
بسته می‌شود\&. \fBSocat\fP
به‌طور داخلی این فلگ را برای توصیف‌کننده‌های فایلی که کنترل می‌کند مدیریت می‌کند، بنابراین در بیشتر موارد نیازی به اعمال این گزینه نخواهد بود\&. 
.IP "\fB\f(CWsetlk[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWfcntl(fd,
F_SETLK, \&.\&.\&.)\fP
یک قفل نوشتن اختیاری (discretionary) بر روی کل فایل تنظیم کند\&. اگر فایل از قبل قفل شده باشد، این فراخوانی منجر به خطا می‌شود\&. 
در لینوکس، زمانی که مجوزهای گروهی فایل برابر با \(dq\&S\(dq\& باشد (g\-x,g+s)، و سیستم فایل به‌صورت محلی با گزینه \(dq\&mand\(dq\& مانت شده باشد، قفل اجباری (mandatory) خواهد بود، یعنی از باز کردن فایل توسط سایر فرایندها جلوگیری می‌کند\&.
.IP "\fB\f(CWsetlkw[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWfcntl(fd, F_SETLKW, \&.\&.\&.)\fP
یک قفل نوشتن اختیاریِ منتظرشونده بر روی کل فایل تنظیم کند\&. اگر فایل از قبل قفل شده باشد، این فراخوانی مسدود می‌شود\&. 
برای اطلاعات درباره اجباری کردن این قفل، گزینه setlk را ببینید\&. 
.IP "\fB\f(CWsetlk\-rd[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWfcntl(fd,
F_SETLK, \&.\&.\&.)\fP
یک قفل خواندن اختیاری بر روی کل فایل تنظیم کند\&. اگر فایل از قبل دارای قفل نوشتن باشد، این فراخوانی منجر به خطا می‌شود\&. 
برای اطلاعات درباره اجباری کردن این قفل، گزینه setlk را ببینید\&. 
.IP "\fB\f(CWsetlkw\-rd[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWfcntl(fd, F_SETLKW, \&.\&.\&.)\fP
یک قفل خواندن اختیاریِ منتظرشونده بر روی کل فایل تنظیم کند\&. اگر فایل از قبل دارای قفل نوشتن باشد، این فراخوانی مسدود می‌شود\&. 
برای اطلاعات درباره اجباری کردن این قفل، گزینه setlk را ببینید\&. 
.IP "\fB\f(CWflock\-ex[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWflock(fd, LOCK_EX)\fP
یک قفل مشورتی (advisory) انحصاری مسدودکننده بر روی فایل تنظیم کند\&. اگر فایل توسط فرایند دیگری قفل شده باشد، \fBSocat\fP در این فراخوانی معلق می‌ماند\&.
.IP "\fB\f(CWflock\-ex\-nb[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWflock(fd, LOCK_EX|LOCK_NB)\fP
یک قفل مشورتی انحصاری غیرمسدودکننده بر روی فایل تنظیم کند\&. اگر فایل از قبل قفل شده باشد، این گزینه منجر به خطا می‌شود\&.
.IP "\fB\f(CWflock\-sh[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWflock(fd, LOCK_SH)\fP
یک قفل مشورتی اشتراکی مسدودکننده بر روی فایل تنظیم کند\&. اگر فایل توسط فرایند دیگری قفل شده باشد، \fBSocat\fP در این فراخوانی معلق می‌ماند\&.
.IP "\fB\f(CWflock\-sh\-nb[=<bool>]\fP\fP"
تلاش می‌کند تا با استفاده از فراخوانی سیستمی 
\f(CWflock(fd, LOCK_SH|LOCK_NB)\fP
یک قفل مشورتی اشتراکی غیرمسدودکننده بر روی فایل تنظیم کند\&. اگر فایل از قبل قفل شده باشد، این گزینه منجر به خطا می‌شود\&.
.IP "\fB\f(CWlock[=<bool>]\fP\fP"
یک قفل مسدودکننده بر روی فایل تنظیم می‌کند\&. بسته به در دسترس بودن در پلتفرم مربوطه، از سازوکار setlk یا flock استفاده می‌کند\&. در صورتی که هر دو در دسترس باشند، نوع POSIX یعنی setlkw استفاده می‌شود\&.
.IP "\fB\f(CWuser=<user>\fP\fP"
کاربر <user> (مالک) جریان را تعیین می‌کند\&.
اگر آدرس عضو گروه گزینه NAMED باشد، \fBsocat\fP از فراخوانی سیستمی 
\f(CWchown()\fP
پس از باز کردن فایل یا بایند کردن به سوکت دامین یونیکس استفاده می‌کند (شرایط رقابتی!)\&.
در صورت عدم وجود ورودی سیستم فایل، \fBsocat\fP کاربر جریان را با استفاده از فراخوانی سیستمی 
\f(CWfchown()\fP
تنظیم می‌کند\&.
این فراخوانی‌ها ممکن است به دسترسی کاربر ارشد (root) نیاز داشته باشند\&. 
.IP "\fB\f(CWuser\-late=<user>\fP\fP"
مالک توصیف‌کننده فایل را پس از باز کردن یا اتصال کانال، با فراخوانی سیستمی 
\f(CWfchown()\fP
به <user> تنظیم می‌کند\&.
این گزینه فقط روی ورودی‌های سیستم فایل مفید است\&.
.IP "\fB\f(CWgroup=<group>\fP\fP"
گروه <group> جریان را تعیین می‌کند\&.
اگر آدرس عضو گروه گزینه NAMED باشد، \fBsocat\fP از فراخوانی سیستمی 
\f(CWchown()\fP
پس از باز کردن فایل یا بایند کردن به سوکت دامین یونیکس استفاده می‌کند (شرایط رقابتی!)\&.
در صورت عدم وجود ورودی سیستم فایل، \fBsocat\fP گروه جریان را با فراخوانی سیستمی 
\f(CWfchown()\fP
تنظیم می‌کند\&. 
این فراخوانی‌ها ممکن است به عضویت در گروه یا دسترسی ریشه (root) نیاز داشته باشند\&. 
.IP "\fB\f(CWgroup\-late=<group>\fP\fP"
گروه توصیف‌کننده فایل را پس از باز کردن یا اتصال کانال، با فراخوانی سیستمی 
\f(CWfchown()\fP
به <group> تنظیم می‌کند\&.
این گزینه فقط روی ورودی‌های سیستم فایل مفید است\&. 
.IP "\fB\f(CWmode=<mode>\fP\fP"
حالت <mode> [mode_t] (مجوزهای دسترسی) جریان را تعیین می‌کند\&.
اگر آدرس عضو گروه گزینه NAMED باشد و از فراخوانی 
\f(CWopen()\fP
یا 
\f(CWcreat()\fP
استفاده کند، حالت همراه با این فراخوانی‌ها اعمال می‌شود\&.
اگر آدرس عضو گروه گزینه NAMED باشد بدون اینکه از این فراخوانی‌های سیستمی استفاده کند، \fBsocat\fP پس از باز کردن ورودی سیستم فایل یا بایند کردن به سوکت دامین یونیکس از فراخوانی سیستمی 
\f(CWchmod()\fP
استفاده می‌کند (شرایط رقابتی!)\&.
در غیر این صورت، \fBsocat\fP حالت جریان را با استفاده از 
\f(CWfchmod()\fP
تنظیم می‌کند که البته ممکن است هیچ تأثیری نداشته باشد\&.
.br 
این فراخوانی‌ها ممکن است به مالکیت یا دسترسی ریشه (root) نیاز داشته باشند\&.
.br 
نکته: این گزینه فقط می‌تواند مجوزهای ناشی از umask فرایند را محدودتر کند\&. برای گشودن مجوزها، گزینه umask را ببینید\&.
.IP "\fB\f(CWperm\-late=<mode>\fP\fP"
مجوزهای توصیف‌کننده فایل را پس از باز کردن یا اتصال کانال، با استفاده از فراخوانی سیستمی 
\f(CWfchmod()\fP
به مقدار <mode> [mode_t] تنظیم می‌کند\&.
این گزینه فقط روی ورودی‌های سیستم فایل مفید است\&. 
.IP "\fB\f(CWappend[=<bool>]\fP\fP"
همیشه داده‌ها را در انتهای واقعی فایل می‌نویسد\&.
اگر آدرس عضو گروه گزینه OPEN باشد، \fBsocat\fP از فلگ 
\f(CWO_APPEND\fP
همراه با فراخوانی سیستمی 
\f(CWopen()\fP
استفاده می‌کند (مثال)\&.
در غیر این صورت، \fBsocat\fP فراخوانی 
\f(CWfcntl(fd, F_SETFL, O_APPEND)\fP
را اعمال می‌کند\&.
.IP "\fB\f(CWnonblock[=<bool>]\fP\fP"
تلاش می‌کند تا فایل را در حالت غیرمسدودکننده باز کرده یا استفاده کند\&. تنها اثرات آن این است که فراخوانی 
\f(CWconnect()\fP
در آدرس‌های TCP مسدود نمی‌شود، و باز کردن یک پایپ نام‌گذاری‌شده برای خواندن مسدود نخواهد شد\&.
اگر آدرس عضو گروه گزینه OPEN باشد، \fBsocat\fP از فلگ 
\f(CWO_NONBLOCK\fP
همراه با فراخوانی سیستمی 
\f(CWopen()\fP
استفاده می‌کند\&.
در غیر این صورت، \fBsocat\fP فراخوانی 
\f(CWfcntl(fd, F_SETFL, O_NONBLOCK)\fP
را اعمال می‌کند\&.
.IP "\fB\f(CWbinary[=<bool>]\fP\fP"
فایل را در حالت باینری باز می‌کند تا از تبدیل ضمنی پایان‌دهنده‌های خط جلوگیری شود (Cygwin)\&.
.IP "\fB\f(CWtext[=<bool>]\fP\fP"
فایل را در حالت متنی باز می‌کند تا تبدیل ضمنی پایان‌دهنده‌های خط تحمیل شود (Cygwin)\&.
.IP "\fB\f(CWnoinherit[=<bool>]\fP\fP"
این فایل را در فرایند ایجادشده باز نگه نمی‌دارد (Cygwin)\&.
.IP "\fB\f(CWcool\-write[=<bool>]\fP\fP"
هنگامی که عملیات نوشتن با خطای EPIPE یا ECONNRESET با شکست مواجه می‌شود، آسان می‌گیرد و پیام را با سطح \fInotice\fP به جای \fIerror\fP در لاگ ثبت می‌کند\&.
این کار از پر شدن فایل گزارش با پیام‌های خطای بی‌فایده جلوگیری می‌کند، در شرایطی که \fBsocat\fP به عنوان سرور یا پروکسی با حجم بالای تبادل استفاده می‌شود و کلاینت‌ها اغلب اتصال را قطع می‌کنند\&. این گزینه را تنها همراه با گزینه fork استفاده کنید زیرا در غیر این صورت ممکن است باعث شود \fBsocat\fP حتی هنگام خرابی با کد 0 خارج شود\&.
.br 
این گزینه منسوخ شده است، توصیه می‌شود به جای آن از گزینه children\-shutup استفاده کنید\&.
.IP "\fB\f(CWend\-close[=<bool>]\fP\fP"
روش پایان دادن به اتصال (که وابسته به آدرس است) را به صرفاً بستن توصیف‌کننده‌های فایل تغییر می‌دهد\&. این گزینه زمانی مفید است که قرار باشد اتصال توسط فرایندهای دیگر مجدداً استفاده شده یا با آن‌ها به اشتراک گذاشته شود (مثال)\&.
.br 
به‌طور معمول، اتصالات سوکت با \f(CWshutdown(2)\fP خاتمه می‌یابند که حتی اگر سوکت بین چندین فرایند به اشتراک گذاشته شده باشد، آن را می‌بندد\&. 
\f(CWclose(2)\fP سوکت را از فرایند جدا می‌کند اما تا زمانی که پیوندهایی از سایر فرایندها وجود داشته باشد، آن را فعال نگه می‌دارد\&.
.br 
به همین ترتیب، هنگامی که یک آدرس از نوع EXEC یا SYSTEM خاتمه می‌یابد، socat معمولاً به‌طور صریح زیرفرایند را متوقف می‌کند\&. با این گزینه، تنها توصیف‌کننده‌های فایل را می‌بندد\&.
.IP "\fB\f(CWshut\-none[=<bool>]\fP\fP"
روش قطع کردن (shutdown) بخش نوشتاری یک اتصال (که وابسته به آدرس است) را طوری تغییر می‌دهد که هیچ کاری انجام ندهد\&.
.IP "\fB\f(CWshut\-down[=<bool>]\fP\fP"
روش قطع کردن بخش نوشتاری یک اتصال (که وابسته به آدرس است) را به shutdown(fd, SHUT_WR) تغییر می‌دهد\&. فقط با سوکت‌ها مفید است\&.
.IP "\fB\f(CWshut\-close[=<bool>]\fP\fP"
روش قطع کردن بخش نوشتاری یک اتصال (که وابسته به آدرس است) را به close(fd) تغییر می‌دهد\&.
.IP "\fB\f(CWshut\-null[=<bool>]\fP\fP"
هنگامی که یک آدرس EOF (پایان فایل) را نشان می‌دهد، \fBsocat\fP یک بسته با اندازه صفر را به کانال نوشتن آدرس دیگر ارسال می‌کند تا وضعیت EOF را انتقال دهد\&. این گزینه با UDP و سایر پروتکل‌های دیتاگرام مفید است\&. در برابر netcat و socat با گزینه null\-eof آزمایش شده است\&.
.IP "\fB\f(CWnull\-eof[=<bool>]\fP\fP"
به‌طور معمول \fBsocat\fP بسته‌های خالی (با داده بار صفر) که به سوکت‌های دیتاگرام می‌رسند را نادیده می‌گیرد تا در برابر اسکن‌های پورت دوام بیاورد\&. با این گزینه، \fBsocat\fP بسته‌های دیتاگرام خالی را به عنوان نشانگر EOF تفسیر می‌کند (گزینه shut\-null را ببینید)\&.
.IP "\fB\f(CWioctl\-void=<request>\fP\fP"
تابع \f(CWioctl()\fP را با مقدار request به عنوان آرگومان دوم و NULL به عنوان آرگومان سوم فراخوانی می‌کند\&. این گزینه امکان بهره‌برداری از ioctlهایی را فراهم می‌کند که به‌طور صریح در socat پیاده‌سازی نشده‌اند\&.
.IP "\fB\f(CWioctl\-int=<request>:<value>\fP\fP"
تابع \f(CWioctl()\fP را با مقدار request به عنوان آرگومان دوم و مقدار عدد صحیح (integer) به عنوان آرگومان سوم فراخوانی می‌کند\&.
.IP "\fB\f(CWioctl\-intp=<request>:<value>\fP\fP"
تابع \f(CWioctl()\fP را با مقدار request به عنوان آرگومان دوم و اشاره‌گری به مقدار عدد صحیح به عنوان آرگومان سوم فراخوانی می‌کند\&.
.IP "\fB\f(CWioctl\-bin=<request>:<value>\fP\fP"
تابع \f(CWioctl()\fP را با مقدار request به عنوان آرگومان دوم و اشاره‌گری به مقدار داده ارائه‌شده به عنوان آرگومان سوم فراخوانی می‌کند\&. این داده باید در قالب <dalan> مشخص شود\&.
.IP "\fB\f(CWioctl\-string=<request>:<value>\fP\fP"
تابع \f(CWioctl()\fP را با مقدار request به عنوان آرگومان دوم و اشاره‌گری به رشته داده‌شده به عنوان آرگومان سوم فراخوانی می‌کند\&.
قالب <dalan>\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه NAMED\fP\fP
.PP 
این گزینه‌ها روی ورودی‌های سیستم فایل کار می‌کنند\&.
.br 
لطفاً توجه داشته باشید که در آدرس‌های کلاینت دامین یونیکس، این به معنای ورودی bind است، نه ورودی مقصد/همتا\&.
.br 
همچنین گزینه‌های user، group و mode را ببینید\&.
.PP 
.IP "\fB\f(CWuser\-early=<user>\fP\fP"
کاربر <user> (مالک) ورودی سیستم فایل را پیش از دسترسی به آن، با استفاده از فراخوانی سیستمی 
\f(CWchown()\fP
تغییر می‌دهد\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWgroup\-early=<group>\fP\fP"
گروه <group> ورودی سیستم فایل را پیش از دسترسی به آن، با استفاده از فراخوانی سیستمی 
\f(CWchown()\fP
تغییر می‌دهد\&. این فراخوانی ممکن است به عضویت در گروه یا دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWperm\-early=<mode>\fP\fP"
حالت <mode> [mode_t] ورودی سیستم فایل را پیش از دسترسی به آن، با استفاده از فراخوانی سیستمی 
\f(CWchmod()\fP
تغییر می‌دهد\&. این فراخوانی ممکن است به مالکیت یا دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWunlink\-early[=<bool>]\fP\fP"
فایل را پیش از باز کردن آن و حتی پیش از اعمال user\-early و غیره حذف (unlink) می‌کند\&.
.IP "\fB\f(CWunlink[=<bool>]\fP\fP"
فایل را پیش از دسترسی به آن، اما پس از user\-early و غیره حذف (unlink) می‌کند\&.
.IP "\fB\f(CWunlink\-late[=<bool>]\fP\fP"
فایل را پس از باز کردن آن حذف (unlink) می‌کند تا پس از یک شرایط رقابتی کوتاه، برای سایر فرایندها غیرقابل دسترسی شود\&.
.IP "\fB\f(CWunlink\-close[=<bool>]\fP\fP"
حذف ورودی سیستم فایل مربوط به آدرس‌ها را هنگام بستن آدرس کنترل می‌کند\&.
برای پایپ‌های نام‌گذاری‌شده،
سوکت‌های دامین یونیکس،
و پیوندهای نمادین آدرس‌های pty،
پیش‌فرض حذف کردن (1) است؛ برای فایل‌های ایجادشده،
فایل‌های بازشده، و
فایل‌های بازشده عمومی، پیش‌فرض نگه‌داشتن (0) است\&.
تنظیم این گزینه روی 1 ورودی را حذف می‌کند و 0 آن را نگه می‌دارد\&. نبود مقدار به معنای 1 است\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه OPEN\fP\fP
.PP 
گزینه‌های گروه OPEN امکان تنظیم فلگ‌ها را با فراخوانی سیستمی 
\f(CWopen()\fP
فراهم می‌کنند\&. 
به عنوان مثال، گزینه `creat\(cq\& فلگ 
\f(CWO_CREAT\fP
را تنظیم می‌کند\&. هنگامی که آدرس استفاده‌شده از 
\f(CWopen()\fP
استفاده نمی‌کند (مانند STDIO)، فراخوانی 
\f(CWfcntl(\&.\&.\&., F_SETFL, \&.\&.\&.)\fP
به جای آن استفاده می‌شود\&.
.br 
همچنین گزینه‌های append و nonblock را ببینید\&.
.IP "\fB\f(CWcreat[=<bool>]\fP\fP"
در صورتی که فایل وجود نداشته باشد، آن را ایجاد می‌کند (مثال)\&.
.IP "\fB\f(CWdsync[=<bool>]\fP\fP"
فراخوانی‌های 
\f(CWwrite()\fP
را تا زمانی که فراداده (metainfo) به‌طور فیزیکی روی رسانه نوشته شود مسدود می‌کند\&.
.IP "\fB\f(CWexcl[=<bool>]\fP\fP"
همراه با گزینه creat، اگر فایل وجود داشته باشد منجر به خطا می‌شود\&.
.IP "\fB\f(CWlargefile[=<bool>]\fP\fP"
در سیستم‌های ۳۲ بیتی، امکان استفاده از فایل بزرگتر از 2^31 بایت را فراهم می‌کند\&.
.IP "\fB\f(CWnoatime[=<bool>]\fP\fP"
گزینه O_NOATIME را تنظیم می‌کند تا خواندن‌ها مهر زمانی دسترسی را تغییر ندهند\&.
.IP "\fB\f(CWnoctty[=<bool>]\fP\fP"
این فایل را به ترمینال کنترلی تبدیل نمی‌کند\&.
.IP "\fB\f(CWnofollow[=<bool>]\fP\fP"
پیوندهای نمادین را دنبال نمی‌کند\&.
.IP "\fB\f(CWnshare[=<bool>]\fP\fP"
اجازه اشتراک‌گذاری این فایل با سایر فرایندها را نمی‌دهد\&.
.IP "\fB\f(CWrshare[=<bool>]\fP\fP"
به سایر فرایندها اجازه باز کردن این فایل برای نوشتن را نمی‌دهد\&.
.IP "\fB\f(CWrsync[=<bool>]\fP\fP"
فراخوانی 
\f(CWwrite()\fP
را تا زمانی که فراداده به‌طور فیزیکی روی رسانه نوشته شود مسدود می‌کند\&.
.IP "\fB\f(CWsync[=<bool>]\fP\fP"
فراخوانی 
\f(CWwrite()\fP
را تا زمانی که داده‌ها به‌طور فیزیکی روی رسانه نوشته شوند مسدود می‌کند\&.
.IP "\fB\f(CWrdonly[=<bool>]\fP\fP"
فایل را تنها برای خواندن باز می‌کند\&.
.IP "\fB\f(CWwronly[=<bool>]\fP\fP"
فایل را تنها برای نوشتن باز می‌کند\&.
.IP "\fB\f(CWtrunc[=<bool>]\fP\fP"
هنگام باز کردن فایل، اندازه آن را به 0 کاهش می‌دهد (کوتاه می‌کند)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه REG و BLK\fP\fP
.PP 
این گزینه‌ها معمولاً روی یک توصیف‌کننده فایل یونیکس اعمال می‌شوند، اما مفهوم آن‌ها فقط روی فایلی که از دسترسی تصادفی پشتیبانی کند معنادار است\&.
.IP "\fB\f(CWseek=<offset>\fP\fP"
فراخوانی سیستمی 
\f(CWlseek(fd, <offset>, SEEK_SET)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند، بنابراین اشاره‌گر فایل را به‌طور مطلق در موقعیت <offset> [off_t یا off64_t] قرار می‌دهد\&. لطفاً توجه داشته باشید که در صورت نبود مقدار، پیش‌فرض 1 است نه 0\&.
.IP "\fB\f(CWseek\-cur=<offset>\fP\fP"
فراخوانی سیستمی 
\f(CWlseek(fd, <offset>, SEEK_CUR)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند، بنابراین اشاره‌گر فایل را به اندازه <offset> [off_t یا off64_t] بایت نسبت به موقعیت فعلی‌اش (که معمولاً 0 است) جابه‌جا می‌کند\&. لطفاً توجه داشته باشید که در صورت نبود مقدار، پیش‌فرض 1 است نه 0\&.
.IP "\fB\f(CWseek\-end=<offset>\fP\fP"
فراخوانی سیستمی 
\f(CWlseek(fd, <offset>, SEEK_END)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند، بنابراین اشاره‌گر فایل را به اندازه <offset> [off_t یا off64_t] بایت نسبت به انتهای فعلی فایل جابه‌جا می‌کند\&. لطفاً توجه داشته باشید که در صورت نبود مقدار، پیش‌فرض 1 است نه 0\&.  
.IP "\fB\f(CWftruncate=<offset>\fP\fP"
فراخوانی سیستمی 
\f(CWftruncate(fd, <offset>)\fP
(یا در صورت در دسترس بودن 
\f(CWftruncate64\fP
) را اعمال می‌کند، بنابراین فایل را در موقعیت <offset> [off_t یا off64_t] کوتاه می‌کند\&. لطفاً توجه داشته باشید که در صورت نبود مقدار، پیش‌فرض 1 است نه 0\&.
.IP 
.IP "\fB\f(CWsecrm[=<bool>]\fP\fP"
.IP "\fB\f(CWunrm[=<bool>]\fP\fP"
.IP "\fB\f(CWcompr[=<bool>]\fP\fP"
.IP "\fB\f(CWfs\-sync[=<bool>]\fP\fP"
.IP "\fB\f(CWimmutable[=<bool>]\fP\fP"
.IP "\fB\f(CWfs\-append[=<bool>]\fP\fP"
.IP "\fB\f(CWnodump[=<bool>]\fP\fP"
.IP "\fB\f(CWfs\-noatime[=<bool>]\fP\fP"
.IP "\fB\f(CWjournal\-data[=<bool>]\fP\fP"
.IP "\fB\f(CWnotail[=<bool>]\fP\fP"
.IP "\fB\f(CWdirsync[=<bool>]\fP\fP"
این گزینه‌ها ویژگی‌های غیر استاندارد فایل را در سیستم‌عامل‌ها و سیستم‌های فایلی که از این قابلیت‌ها پشتیبانی می‌کنند (مانند لینوکس با ext2fs و جانشینان آن، xfs، یا reiserfs) تغییر می‌دهند\&. برای اطلاعات بیشتر در مورد این گزینه‌ها، man 1 chattr را ببینید\&. لطفاً توجه داشته باشید که ممکن است بین ایجاد فایل و اعمال این گزینه‌ها شرایط رقابتی رخ دهد\&.

.PP 
.br 

.PP 
\fI\fBگزینه‌های PIPE\fP\fP
.PP 
این گزینه‌ها را می‌توان روی پایپ‌ها (fifos) اعمال کرد\&.
.PP 
.IP "\fB\f(CWf\-setpipe\-sz=<int>\fP\fP"
.IP "\fB\f(CWsetpipe=<int>\fP\fP"
تعداد بایت‌هایی که یک پایپ می‌تواند بافر کند را تعیین می‌کند\&. اگر بایت‌های بیشتری نوشته شود ممکن است فرایند نویسنده مسدود شود\&. هنگامی که بایت‌های بیشتری در یک فراخوانی واحد 
\f(CWwrite()\fP
نوشته شود، فرایند نویسنده مسدود شده و ممکن است هرگز بازیابی نشود\&.

.PP 
.br 

.PP 
\fI\fBگزینه‌های عمومی آدرس\fP\fP
.PP 
این گزینه‌ها را می‌توان برای تمامی انواع آدرس اعمال کرد\&. آن‌ها برخی از ویژگی‌های فرایند را تغییر می‌دهند که پس از باز کردن آدرس به حالت اولیه بازگردانده می‌شوند\&.
.PP 
.IP "\fB\f(CWchdir=<filename>\fP\fP"
.IP "\fB\f(CWcd=<filename>\fP\fP"
دایرکتوری کاری را تغییر می‌دهد\&. پس از باز کردن آدرس، فرایند اصلی به دایرکتوری کاری اولیه بازمی‌گردد\&. زیرفرایندها این تنظیم موقت را به ارث می‌برند\&.
.IP "\fB\f(CWumask=<mode>\fP\fP"
مقدار umask فرایند را پیش از باز کردن آدرس به <mode> [mode_t] تنظیم می‌کند\&. زمانی مفید است که ورودی‌های سیستم فایل ایجاد شوند یا یک شل یا برنامه اجرا گردد\&. معمولاً مقدار به‌صورت عدد اکتال با یک \(cq\&0\(cq\& آغازین مشخص می‌شود\&.
.br 
مقدار \f(CWumask\fP فرایند توسط فرایندهای فرزند به ارث برده می‌شود\&.
.br 
نکته: umask مقداری معکوس است: ایجاد یک فایل با umask=0026 منجر به مجوزهای دسترسی 0640 می‌شود\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه PROCESS\fP\fP
.PP 
گزینه‌های این گروه به جای اینکه صرفاً روی یک کانال داده تأثیر بگذارند، ویژگی‌های فرایند را تغییر می‌دهند\&.
برای آدرس‌های EXEC و SYSTEM و برای آدرس‌های نوع LISTEN و CONNECT همراه با گزینه fork، این گزینه‌ها به جای فرایند اصلی \fBsocat\fP روی فرایندهای فرزند اعمال می‌شوند\&.
.IP "\fB\f(CWchroot=<directory>\fP\fP"
پس از پردازش آدرس، یک عملیات 
\f(CWchroot()\fP
به دایرکتوری <directory> انجام می‌دهد (مثال)\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWchroot\-early=<directory>\fP\fP"
پیش از باز کردن آدرس، یک عملیات 
\f(CWchroot()\fP
به دایرکتوری <directory> انجام می‌دهد\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWsetgid=<group>\fP\fP"
پس از پردازش آدرس، گروه اصلی <group> فرایند را تغییر می‌دهد\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&. لطفاً توجه داشته باشید که این گزینه سایر امتیازات مربوط به گروه را لغو نمی‌کند\&.
.IP "\fB\f(CWsetgid\-early=<group>\fP\fP"
مانند setgid است اما پیش از باز کردن آدرس انجام می‌شود\&.
.IP "\fB\f(CWsetuid=<user>\fP\fP"
پس از پردازش آدرس، کاربر <user> (مالک) فرایند را تغییر می‌دهد\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&. لطفاً توجه داشته باشید که این گزینه امتیازات مربوط به گروه را لغو نمی‌کند\&. بررسی کنید که آیا گزینه su برای نیازهای شما مناسب‌تر است یا خیر\&.
.IP "\fB\f(CWsetuid\-early=<user>\fP\fP"
مانند setuid است اما پیش از باز کردن آدرس انجام می‌شود\&.
.IP "\fB\f(CWsu=<user>\fP\fP"
پس از پردازش آدرس، کاربر <user> (مالک) و گروه‌های فرایند را تغییر می‌دهد (مثال)\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&. 
.IP "\fB\f(CWsu\-d=<user>\fP\fP"
نام کوتاه برای \f(CWsubstuser\-delayed\fP\&.
پس از پردازش آدرس، کاربر <user> (مالک) و گروه‌های فرایند را تغییر می‌دهد (مثال)\&.
اطلاعات کاربر و گروه‌های او \fIپیش از\fP فراخوانی احتمالی 
\f(CWchroot()\fP
دریافت می‌شوند\&. این فراخوانی ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&. 
.IP "\fB\f(CWsetpgid=<pid_t>\fP\fP"
فرایند را عضو گروه فرایندی مشخص‌شده <pid_t> می‌کند\&. اگر مقداری داده نشود، یا اگر مقدار 0 یا 1 باشد، فرایند رهبر یک گروه فرایندی جدید می‌شود\&. 
.IP "\fB\f(CWsetsid\fP\fP"
فرایند را به رهبر یک نشست (session) جدید تبدیل می‌کند (مثال)\&.
.IP "\fB\f(CWnetns=<net\-namespace\-name>\fP\fP"
پیش از باز کردن آدرس تلاش می‌کند به فضای نام شبکه نام‌برده سوئیچ کند\&. پس از باز کردن آدرس، به فضای نام قبلی بازمی‌گردد (مثال با فورواردر TCP، مثال با اتصال شبکه مجازی)\&.
.br 
تنها در لینوکس؛ نیازمند دسترسی ریشه (root) است؛ از گزینه \f(CW\-\-experimental\fP استفاده کنید\&.
.br 

.PP 
.br 

.PP 
\fI\fBگروه گزینه READLINE\fP\fP
.PP 
به دلیل محدودیت‌های مجوزی، قابلیت readline در دبیان غیرفعال است (بخش BUGS را ببینید)\&.
.br
این گزینه‌ها برای نوع آدرس readline اعمال می‌شوند\&.
.IP "\fB\f(CWhistory=<filename>\fP\fP"
تاریخچه (history) را از/به <filename> می‌خواند و می‌نویسد (مثال)\&.
.IP "\fB\f(CWnoprompt\fP\fP"
از نسخه 1\&.4\&.0، socat به‌طور پیش‌فرض با به خاطر سپردن آخرین خط ناقص خروجی، سعی می‌کند اعلانی (prompt) تعیین کند که سپس به فراخوانی readline ارسال می‌شود\&. با این گزینه، socat هیچ اعلانی را به readline ارسال نمی‌کند، بنابراین ویرایش خط در ستون اول ترمینال آغاز می‌شود\&. 
.IP "\fB\f(CWnoecho=<pattern>\fP\fP"
یک الگوی باقاعده برای اعلان مشخص می‌کند که از نمایش خط ورودی بعدی بر روی صفحه و اضافه شدن آن به تاریخچه جلوگیری می‌کند\&. اعلان به عنوان متنی تعریف می‌شود که پس از آخرین نویسه خط جدید و پیش از تایپ یک نویسه ورودی، در آدرس readline چاپ شده است\&. این الگو یک عبارت باقاعده (regex) است، مانند
\(dq\&^[Pp]assword:\&.*$\(dq\& یا \(dq\&([Uu]ser:|[Pp]assword:)\(dq\&\&. برای جزئیات regex(7) را ببینید\&.
(مثال)
.IP "\fB\f(CWprompt=<string>\fP\fP"
این رشته را به عنوان اعلان به تابع readline ارسال می‌کند\&. readline هنگام پیمایش در تاریخچه، این اعلان را چاپ می‌کند\&. اگر این رشته با اعلان ثابتی که توسط یک برنامه تعاملی روی آدرس دیگر socat صادر می‌شود مطابقت داشته باشد، ظاهر و تجربه یکدستی حاصل می‌شود\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه APPLICATION\fP\fP
.PP 
این گروه شامل گزینه‌هایی است که در سطح داده عمل می‌کنند\&.
توجه داشته باشید که این گزینه‌ها تنها برای داده‌های \(dq\&خام\(dq\& منتقل‌شده توسط socat اعمال می‌شوند، نه برای داده‌های پروتکلی که توسط آدرس‌هایی مانند PROXY استفاده می‌شوند\&.
.IP "\fB\f(CWcr\fP\fP"
هنگام نوشتن/خواندن روی این کانال، نویسه پیش‌فرض پایان خط NL (\(cq\&\en\(cq\&, 0x0a) را از/به CR (\(cq\&\er\(cq\&, 0x0d) تبدیل می‌کند\&. 
.IP "\fB\f(CWcrnl\fP\fP"
هنگام نوشتن/خواندن روی این کانال، نویسه پیش‌فرض پایان خط NL (\(cq\&\en\(cq\&, 0x0a) را از/به CRNL (\(dq\&\er\en\(dq\&, 0x0d0a) تبدیل می‌کند (مثال)\&.
نکته: socat به‌سادگی تمامی نویسه‌های CR را حذف می‌کند\&.
.IP "\fB\f(CWignoreeof\fP\fP"
هنگامی که پایان فایل (EOF) در این کانال رخ می‌دهد، \fBsocat\fP آن را نادیده گرفته و تلاش می‌کند داده‌های بیشتری بخواند (مانند \(dq\&tail \-f\(dq\&) (مثال)\&.
.IP "\fB\f(CWreadbytes=<bytes>\fP\fP"
\fBsocat\fP فقط همین تعداد بایت را از این آدرس می‌خواند (آدرس تنها همین تعداد بایت را برای انتقال ارائه داده و پس از آن وانمود می‌کند که به EOF رسیده است)\&.
باید بزرگتر از 0 باشد\&.
.IP "\fB\f(CWlockfile=<filename>\fP\fP"
اگر فایل قفل وجود داشته باشد، با خطا خارج می‌شود\&. اگر فایل قفل وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و هنگام خروج فایل قفل را حذف (unlink) می‌کند\&.
.IP "\fB\f(CWwaitlock=<filename>\fP\fP"
اگر فایل قفل وجود داشته باشد، منتظر ناپدید شدن آن می‌ماند\&. هنگامی که فایل قفل وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و هنگام خروج فایل قفل را حذف می‌کند\&.
.IP "\fB\f(CWescape=<int>\fP\fP"
کد عددی نویسه‌ای را مشخص می‌کند که پایان فایل (EOF) را در جریان ورودی فعال می‌کند\&. این گزینه برای ترمینال در حالت خام مفید است (مثال)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه SOCKET\fP\fP
.PP 
این گزینه‌ها برای تمامی انواع سوکت‌ها مانند IP یا دامین یونیکس در نظر گرفته شده‌اند\&. بیشتر آن‌ها با یک فراخوانی 
\f(CWsetsockopt()\fP
اعمال می‌شوند\&.
.IP "\fB\f(CWbind=<sockname>\fP\fP"
سوکت را با استفاده از فراخوانی سیستمی 
\f(CWbind()\fP
به آدرس سوکت داده‌شده متصل (bind) می‌کند\&. قالب <sockname> به دامنه سوکت بستگی دارد:
در IP4 و IP6 قالب [hostname|hostaddress][:(service|port)] مجاز است (مثال)،
در VSOCK قالب [cid][:(port)] مجاز است\&.
.br 
همچنین ببینید: unix\-bind\-tempname
.IP "\fB\f(CWconnect\-timeout=<seconds>\fP\fP"
تلاش برای برقراری اتصال را پس از <seconds> [timeval] ثانیه با وضعیت خطا لغو می‌کند\&.
.IP "\fB\f(CWso\-bindtodevice=<interface>\fP\fP"
سوکت را به رابط شبکه <interface> داده‌شده متصل (bind) می‌کند\&.
این گزینه ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWbroadcast\fP\fP"
برای سوکت‌های دیتاگرام، اجازه ارسال به آدرس‌های برودکست و دریافت بسته‌های آدرس‌دهی‌شده به آدرس‌های برودکست را می‌دهد\&. 
.IP "\fB\f(CWdebug\fP\fP"
اشکال‌زدایی سوکت را فعال می‌کند\&.
.IP "\fB\f(CWdontroute\fP\fP"
فقط با همتاهای مستقیماً متصل‌شده ارتباط برقرار می‌کند و از مسیریاب‌ها استفاده نمی‌کند\&.
.IP "\fB\f(CWkeepalive\fP\fP"
ارسال پیام‌های زنده نگه‌داشتن (keepalive) را روی سوکت فعال می‌کند\&.
.IP "\fB\f(CWlinger=<seconds>\fP\fP"
فراخوانی‌های 
\f(CWshutdown()\fP
یا 
\f(CWclose()\fP
را تا پایان انتقال داده‌ها یا به پایان رسیدن مهلت زمانی داده‌شده [int] مسدود می‌کند\&. 
.IP "\fB\f(CWoobinline\fP\fP"
داده‌های خارج از باند (out\-of\-band) را در جریان داده ورودی قرار می‌دهد\&.
.IP "\fB\f(CWpriority=<priority>\fP\fP"
اولویت تعریف‌شده توسط پروتکل <priority> [<int>] را برای بسته‌های خروجی تنظیم می‌کند\&. 
.IP "\fB\f(CWrcvbuf=<bytes>\fP\fP"
اندازه بافر دریافت را پس از فراخوانی 
\f(CWsocket()\fP
به <bytes> [int] بایت تنظیم می‌کند\&. در سوکت‌های TCP، این مقدار متناظر با حداکثر اندازه پنجره سوکت است\&.
.IP "\fB\f(CWrcvbuf\-late=<bytes>\fP\fP"
زمانی که سوکت از قبل متصل است، اندازه بافر دریافت را به <bytes> [int] بایت تنظیم می‌کند\&. 
در سوکت‌های TCP، این مقدار متناظر با حداکثر اندازه پنجره سوکت است\&. 
.IP "\fB\f(CWso\-rcvtimeo=<time>, rcvtimeo=<time>\fP\fP"
مدت زمانی [int] را تعیین می‌کند که پس از آن در صورت عدم دریافت داده، توابعی مانند 
\f(CWrecv()\fP
، 
\f(CWread()\fP
و غیره با مهلت زمانی مواجه می‌شوند\&. توجه داشته باشید که در فاز انتقال، \fBsocat\fP این توابع را تنها زمانی فراخوانی می‌کند که 
\f(CWselect()\fP
گزارش کرده باشد که داده در دسترس است\&. با این حال این گزینه در آدرس‌های DTLS برای ایجاد مهلت زمانی در حین مذاکره اتصال مفید است\&.
.IP "\fB\f(CWso\-sndtimeo=<time>, sndtimeo=<time>\fP\fP"
مانند so\-rcvtimeo است، اما برای 
\f(CWsend\fP
\&. کاربرد شناخته‌شده‌ای ندارد\&.
.IP "\fB\f(CWrcvlowat=<bytes>\fP\fP"
حداقل تعداد بایت‌های دریافتی [int] را مشخص می‌کند که پس از آن لایه سوکت، داده‌های بافرشده را به \fBsocat\fP تحویل می‌دهد\&. 
.IP "\fB\f(CWreuseaddr[=[0|1]]\fP\fP"
به سوکت‌های دیگر اجازه می‌دهد به یک آدرس bind شوند حتی اگر بخش‌هایی از آن (مانند پورت محلی) در حال حاضر توسط \fBsocat\fP در حال استفاده باشد\&.
.br 
از نسخه 1\&.8\&.0، این گزینه سوکت به‌طور خودکار برای آدرس‌های TCP LISTEN تنظیم می‌شود\&. اگر پیش‌فرض سیستم را ترجیح می‌دهید (هیچ فراخوانی مربوط به 
\f(CWsetsockopt(\&.\&.\&.SO_REUSEADDR\&.\&.\&.)\fP
انجام نشود)، از قالب \f(CWreuseaddr=\fP استفاده کنید\&.
.br 
(مثال)\&.
.IP "\fB\f(CWsndbuf=<bytes>\fP\fP"
اندازه بافر ارسال را پس از فراخوانی 
\f(CWsocket()\fP
به <bytes> [int] بایت تنظیم می‌کند\&.
.IP "\fB\f(CWsndbuf\-late=<bytes>\fP\fP"
زمانی که سوکت متصل شد، اندازه بافر ارسال را به <bytes> [int] بایت تنظیم می‌کند\&.
.IP "\fB\f(CWsndlowat=<bytes>\fP\fP"
حداقل تعداد بایت‌های موجود در بافر ارسال را مشخص می‌کند که پیش از آن، لایه سوکت داده‌ها را ارسال نخواهد کرد به <bytes> [int]\&.
.IP "\fB\f(CWpf=<string>\fP\fP"
استفاده از نسخه یا پروتکل IP مشخص‌شده را تحمیل می‌کند\&. <string> می‌تواند مقداری مانند \(dq\&ip4\(dq\& یا \(dq\&ip6\(dq\& باشد\&. مقدار حاصل به عنوان آرگومان اول در فراخوانی‌های 
\f(CWsocket()\fP
یا 
\f(CWsocketpair()\fP
استفاده می‌شود\&.
این گزینه بر تحلیل آدرس و نحو مورد نیاز گزینه‌های bind و range تأثیر می‌گذارد\&.
.IP "\fB\f(CWsocktype=<type>\fP\fP"
نوع سوکت را که به عنوان آرگومان دوم در فراخوانی‌های
\f(CWsocket()\fP
یا 
\f(CWsocketpair()\fP
مشخص می‌شود، به <type> [int] تنظیم می‌کند\&. تحلیل آدرس تحت تأثیر این گزینه قرار نمی‌گیرد\&.
در لینوکس، 1 به معنای سوکت مبتنی بر جریان، 2 به معنای سوکت دیتاگرام، 3 به معنای سوکت خام، و 5 seqpacket (جریان با حفظ مرز بسته‌ها) است\&.
دیتاگرام‌ها زمانی مفید هستند که بخواهید مرز بسته‌ها حفظ شود\&.
.IP "\fB\f(CWprotocol\fP\fP"
پروتکل سوکت را که به عنوان آرگومان سوم در فراخوانی‌های
\f(CWsocket()\fP
یا 
\f(CWsocketpair()\fP
تعیین می‌شود، به <protocol> [int] تنظیم می‌کند\&. تحلیل آدرس تحت تأثیر این گزینه قرار نمی‌گیرد\&.
6 به معنای TCP و 17 به معنای UDP است\&.
.IP "\fB\f(CWreuseport\fP\fP"
گزینه سوکت 
\f(CWSO_REUSEPORT\fP
را تنظیم می‌کند\&.
.IP "\fB\f(CWso\-timestamp\fP\fP"
گزینه سوکت SO_TIMESTAMP را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی برچسب زمانی را فعال می‌کند\&.
.IP "\fB\f(CWsetsockopt=<level>:<optname>:<optval>\fP\fP"
تابع \f(CWsetsockopt()\fP را برای سوکت با پارامترهای داده‌شده فراخوانی می‌کند\&. پارامتر \f(CWlevel\fP [int] به عنوان آرگومان دوم در \f(CWsetsockopt()\fP استفاده می‌شود و لایه را مشخص می‌کند، مثلاً SOL_TCP برای TCP (6 در لینوکس)، یا SOL_SOCKET برای لایه سوکت (1 در لینوکس)\&. پارامتر \f(CWoptname\fP [int] آرگومان سوم در \f(CWsetsockopt()\fP است و مشخص می‌کند کدام گزینه سوکت باید تنظیم شود\&. برای اعداد واقعی ممکن است نیاز باشد فایل‌های include مناسب سیستم خود را بررسی کنید\&. برای پارامترهای چهارم و پنجم \f(CWsetsockopt()\fP، پارامتر \f(CWvalue\fP [dalan] توالی دلخواهی از بایت‌ها را مشخص می‌کند که از طریق اشاره‌گر همراه با پارامتر طول که به‌طور خودکار استخراج می‌شود، به تابع ارسال می‌گردد\&.
.IP "\fB\f(CWsetsockopt\-int=<level>:<optname>:<optval>\fP\fP"
مانند \f(CWsetsockopt\fP است، اما <optval> اشاره‌گری به int [int] است\&.
.IP "\fB\f(CWsetsockopt\-listen=<level>:<optname>:<optval>\fP\fP"
مانند \f(CWsetsockopt\fP است، اما برای آدرس‌های نوع listen به جای سوکت متصل‌شده، بر روی سوکت شنونده اعمال می‌شود\&.
.IP "\fB\f(CWsetsockopt\-string=<level>:<optname>:<optval>\fP\fP"
مانند \f(CWsetsockopt\fP است، اما <optval> یک رشته است\&.
این رشته همراه با نویسه نال پایانی به تابع ارسال می‌شود، و پارامتر طول به‌طور خودکار از داده استخراج می‌گردد\&.
.IP "\fB\f(CWsetsockopt\-socket=<level>:<optname>:<optval>\fP\fP"
مانند \f(CWsetsockopt\fP است، اما پیش از سایر عملیات
(
\f(CWbind()\fP
، 
\f(CWconnect()\fP
، 
\f(CWaccept()\fP
، \&.\&.\&.)
روی سوکت اعمال می‌شود\&.
.IP "\fB\f(CWsetsockopt\-connected=<level>:<optname>:<optval>\fP\fP"
مانند \f(CWsetsockopt\fP است، اما تنها زمانی اعمال می‌شود که سوکت با یک فراخوانی 
\f(CWconnect()\fP
یا 
\f(CWlisten()\fP
متصل شده باشد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه UNIX\fP\fP
.PP 
این گزینه‌ها برای آدرس‌های مبتنی بر دامین یونیکس اعمال می‌شوند\&.
.IP "\fB\f(CWbind\-tempname[=/tmp/pre\-XXXXXX],
unix\-bind\-tempname[=/tmp/pre\-XXXXXX]\fP\fP"
به یک مسیر تصادفی یا آدرس تصادفی (روی سوکت‌های فضای نام انتزاعی) متصل (bind) می‌شود\&.
این گزینه با آدرس‌های کلاینت دیتاگرام (\f(CWSENDTO\fP یا \f(CWCLIENT\fP) که در فرایندهای فرزندی باز می‌شوند که از یک فرایند والد مشترک انشعاب یافته‌اند (fork شده‌اند) و این فرایندهای فرزند نمی‌توانند گزینه‌های bind متفاوتی داشته باشند، مفید است\&.
در مسیر، نویسه‌های 
\f(CWX\fP
مشابه tempnam(3) با یک توالی تصادفی از نویسه‌ها جایگزین می‌شوند\&. هنگامی که هیچ آرگومانی داده نشود، \fBsocat\fP یک مقدار پیش‌فرض مانند 
\f(CW/tmp/fileXXXXXX\fP
را در نظر می‌گیرد\&.
.br 
.IP "\fB\f(CWunix\-tightsocklen[=(0|1)]\fP\fP"
در عملیات سوکت، طولی از آدرس سوکت را ارسال می‌کند که کل رکورد 
\f(CWstruct sockaddr_un\fP
را در بر نمی‌گیرد، بلکه (در کنار سایر مؤلفه‌ها) تنها بخش مرتبط نام فایل یا رشته انتزاعی را شامل می‌شود\&. پیش‌فرض 1 است\&.

.PP 
\fI\fBگروه‌های گزینه IP4 و IP6\fP\fP
.PP 
این گزینه‌ها می‌توانند با سوکت‌های مبتنی بر IPv4 و IPv6 استفاده شوند\&.
.IP "\fB\f(CWtos=<tos>\fP\fP"
فیلد نوع سرویس (TOS) بسته‌های خروجی را به <tos> [byte] تنظیم می‌کند (RFC 791 را ببینید)\&.
.IP "\fB\f(CWttl=<ttl>\fP\fP"
فیلد زمان حیات (TTL) بسته‌های خروجی را به <ttl> [byte] تنظیم می‌کند\&.
.IP "\fB\f(CWip\-options=<data>\fP\fP"
گزینه‌های IP مانند مسیریابی مبدأ را تنظیم می‌کند\&. باید در قالب باینری داده شود، قالب توصیه‌شده یک \(dq\&x\(dq\& آغازین و به دنبال آن تعداد زوجی از ارقام هگزادسیمال است\&. این گزینه ممکن است چندین بار استفاده شود، داده‌ها به یکدیگر الحاق می‌شوند\&.
به عنوان مثال، برای اتصال به میزبان 10\&.0\&.0\&.1 از طریق یک گیت‌وی با استفاده از یک مسیر مبدأ منعطف (loose source route)، گیت‌وی را به عنوان پارامتر آدرس قرار دهید و یک مسیر مبدأ منعطف را با استفاده از گزینه 
\f(CWip\-options=x8307040a000001\fP
تنظیم کنید\&.
.br 
گزینه‌های IP در RFC 791 تعریف شده‌اند\&. 
.br 
.IP "\fB\f(CWmtudiscover=<0|1|2>\fP\fP"
مقادیر 0، 1 یا 2 را می‌پذیرد تا کشف MTU مسیر (path MTU discovery) را روی این سوکت به ترتیب هرگز، در صورت تمایل، یا همیشه استفاده کند\&. 
.IP "\fB\f(CWip\-pktinfo\fP\fP"
گزینه سوکت IP_PKTINFO را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی حاوی آدرس مقصد و رابط شبکه را فعال می‌کند (لینوکس) (مثال)\&. 
.IP "\fB\f(CWip\-recverr\fP\fP"
گزینه سوکت IP_RECVERR را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی حاوی اطلاعات تفصیلی خطا را فعال می‌کند\&.
.IP "\fB\f(CWip\-recvopts\fP\fP"
گزینه سوکت IP_RECVOPTS را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی گزینه‌های IP را فعال می‌کند (لینوکس، *BSD)\&.
.IP "\fB\f(CWip\-recvtos\fP\fP"
گزینه سوکت IP_RECVTOS را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی نوع سرویس (TOS) را فعال می‌کند (لینوکس)\&.
.IP "\fB\f(CWip\-recvttl\fP\fP"
گزینه سوکت IP_RECVTTL را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی زمان حیات (TTL) را فعال می‌کند (لینوکس، *BSD)\&.
.IP "\fB\f(CWip\-recvdstaddr\fP\fP"
گزینه سوکت IP_RECVDSTADDR را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی حاوی آدرس مقصد را فعال می‌کند (*BSD) (مثال)\&.
.IP "\fB\f(CWip\-recvif\fP\fP"
گزینه سوکت IP_RECVIF را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های جانبی رابط شبکه را فعال می‌کند (*BSD) (مثال)\&.
.IP "\fB\f(CWip\-add\-membership=<multicast\-address:interface\-address>\fP\fP"
.IP "\fB\f(CWip\-add\-membership=<multicast\-address:interface\-name>\fP\fP"
.IP "\fB\f(CWip\-add\-membership=<multicast\-address:interface\-index>\fP\fP"
.IP "\fB\f(CWip\-add\-membership=<multicast\-address:interface\-address:interface\-name>\fP\fP"
.IP "\fB\f(CWip\-add\-membership=<multicast\-address:interface\-address:interface\-index>\fP\fP"
سوکت را عضو گروه چندپخشی مشخص‌شده می‌کند\&. این گزینه فقط برای IPv4 کار می‌کند، برای نسخه IPv6 به ipv6\-join\-group مراجعه کنید\&. این گزینه آدرس IP گروه چندپخشی و اطلاعات مربوط به رابط شبکه مورد نظر را دریافت می‌کند\&. رایج‌ترین نحو همان مورد اول است، در حالی که سایر موارد فقط در سیستم‌هایی در دسترس هستند که 
\f(CWstruct mreqn\fP
را ارائه می‌دهند (لینوکس)\&.
.br 
اندیس‌های رابط‌های شبکه فعال را می‌توان با استفاده از ابزار 
\fBprocan\fP
مشاهده کرد\&.
.IP "\fB\f(CWip\-add\-source\-membership=<multicast\-address:interface\-address:source\-address>\fP\fP"
سوکت را برای مبدأ مشخص‌شده، عضو گروه چندپخشی تعیین‌شده می‌کند؛ یعنی تنها ترافیک چندپخشی حاصل از این آدرس تحویل داده خواهد شد\&. این گزینه فقط برای IPv4 کار می‌کند، برای نسخه IPv6 گزینه ipv6\-join\-source\-group را ببینید\&. این گزینه آدرس IP گروه چندپخشی، آدرس IP رابط شبکه مورد نظر و آدرس IP مبدأ ترافیک چندپخشی را دریافت می‌کند\&.
.IP "\fB\f(CWipv6\-join\-group=<multicast\-address:interface\-name>\fP\fP"
.IP "\fB\f(CWipv6\-join\-group=<multicast\-address:interface\-index>\fP\fP"
سوکت را عضو گروه چندپخشی مشخص‌شده می‌کند\&. این گزینه فقط برای IPv6 کار می‌کند، برای نسخه IPv4 گزینه ip\-add\-membership را ببینید\&. این گزینه آدرس IP گروه چندپخشی و اطلاعات رابط شبکه مورد نظر را دریافت می‌کند\&.
اندیس‌های رابط‌های شبکه فعال را می‌توان با استفاده از ابزار 
\fBprocan\fP
مشاهده کرد\&.
.IP "\fB\f(CWipv6\-join\-source\-group=<multicast\-address:interface\-name:source\-address>\fP\fP"
.IP "\fB\f(CWipv6\-join\-source\-group=<multicast\-address:interface\-index:source\-address>\fP\fP"
سوکت را برای مبدأ مشخص‌شده، عضو گروه چندپخشی تعیین‌شده می‌کند؛ یعنی تنها ترافیک چندپخشی ارسال‌شده از این آدرس تحویل داده خواهد شد\&. این گزینه فقط برای IPv6 کار می‌کند، برای نسخه IPv4 گزینه ip\-add\-source\-membership را ببینید\&. این گزینه آدرس IP گروه چندپخشی، اطلاعات مربوط به رابط شبکه مورد نظر و آدرس IP مبدأ ترافیک چندپخشی را دریافت می‌کند\&. اندیس‌های رابط‌های شبکه فعال را می‌توان با استفاده از ابزار \fBprocan\fP مشاهده کرد\&.
.br 
این قابلیت آزمایشی است\&.
.IP "\fB\f(CWip\-multicast\-if=<hostname>\fP\fP"
نام میزبان یا آدرس رابط شبکه‌ای را مشخص می‌کند که باید برای ترافیک چندپخشی استفاده شود\&.
.IP "\fB\f(CWip\-multicast\-loop[=<bool>]\fP\fP"
مشخص می‌کند که آیا ترافیک چندپخشی خروجی باید به رابط بازگردد (loop back شود) یا خیر\&.
.IP "\fB\f(CWip\-multicast\-ttl=<byte>\fP\fP"
مقدار TTL مورد استفاده برای ترافیک چندپخشی خروجی را تنظیم می‌کند\&. پیش‌فرض 1 است\&.
.IP "\fB\f(CWip\-transparent\fP\fP"
گزینه سوکت IP_TRANSPARENT را تنظیم می‌کند\&.
این گزینه ممکن است به دسترسی ریشه (root) نیاز داشته باشد\&.

.PP 
.br 

.PP 
\fI\fBگزینه‌های تحلیل‌گر نام (Resolver)\fP\fP
.PP 
این گزینه‌ها به‌طور موقت رفتار تحلیل نام میزبان را تغییر می‌دهند\&. گزینه‌های به فرم 
\f(CWai\-*\fP
بر رفتار تابع 
\f(CWgetaddrinfo()\fP
تأثیر می‌گذارند که شامل جستجوهای مبتنی بر 
\f(CW/etc/hosts\fP
و NIS است\&.
.PP 
آدرس‌های به فرم 
\f(CWres\-*\fP
تنها بر جستجوهای DNS تأثیر می‌گذارند، و فقط زمانی که نتیجه در 
\f(CWnscd\fP
کَش نشده باشد\&. این گزینه‌ها ممکن است در تمامی سیستم‌عامل‌ها یا پیاده‌سازی‌های libc کار نکنند\&.
.PP 
.IP "\fB\f(CWai\-addrconfig[=0|1]\fP\fP"
.IP "\fB\f(CWaddrconfig[=0|1]\fP\fP"
فلگ AI_ADDRCONFIG را تنظیم یا لغو می‌کند تا از تحلیل نام به خانواده‌های آدرسی که روی رایانه در دسترس نیستند (مانند IPv6) جلوگیری شود\&. در صورتی که تحلیل‌گر نام، راهنمایی مربوط به خانواده آدرس را از آدرس Socat یا پیش‌فرض‌ها دریافت نکند، مقدار پیش‌فرض 1 است\&.
.IP "\fB\f(CWai\-passive[=0|1]\fP\fP"
.IP "\fB\f(CWpassive[=0|1]\fP\fP"
فلگ AI_PASSIVE را برای فراخوانی‌های 
\f(CWgetaddrinfo()\fP
تنظیم یا لغو می‌کند\&.
پیش‌فرض برای آدرس‌های نوع LISTEN، RECV و RECVFROM، و همراه با گزینه bind برابر با 1 است\&. 
.IP "\fB\f(CWai\-v4mapped[=0|1]\fP\fP"
.IP "\fB\f(CWv4mapped[=0|1]\fP\fP"
فلگ AI_V4MAPPED را برای 
\f(CWgetaddrinfo()\fP
تنظیم یا لغو می‌کند\&. در آدرس‌های \fBsocat\fP که نیازمند آدرس‌های IPv6 هستند، این گزینه آدرس‌های IPv4 را به آدرس IPv6 متناظر [::ffff:*:*] تحلیل می‌کند\&. برای آدرس‌های IPv6 در \fBsocat\fP، مقدار پیش‌فرض 1 است\&.

.IP "\fB\f(CWai\-all[=0|1]\fP\fP"
فلگ AI_ALL را برای 
\f(CWgetaddrinfo()\fP
تنظیم یا لغو می‌کند\&.
.IP 
.IP "\fB\f(CWres\-debug\fP\fP"
.IP "\fB\f(CWres\-aaonly\fP\fP"
.IP "\fB\f(CWres\-usevc\fP\fP"
.IP "\fB\f(CWres\-primary\fP\fP"
.IP "\fB\f(CWres\-igntc\fP\fP"
.IP "\fB\f(CWres\-recurse\fP\fP"
.IP "\fB\f(CWres\-defnames\fP\fP"
.IP "\fB\f(CWres\-stayopen\fP\fP"
.IP "\fB\f(CWres\-dnsrch\fP\fP"
این گزینه‌ها فلگ‌های متناظر گزینه resolver (تحلیل‌گر نام) را تنظیم می‌کنند\&.
برای پاک کردن یک گزینه پیش‌فرض، عبارت \(dq\&=0\(dq\& را به انتهای آن اضافه کنید\&. برای کسب اطلاعات بیشتر درباره این گزینه‌ها صفحه راهنمای resolver(5) را ببینید\&. \fBSocat\fP پس از پایان مرحله باز کردن آدرس، مقادیر پیشین را بازیابی می‌کند، بنابراین این گزینه‌ها تنها برای آدرسی که روی آن اعمال شده‌اند معتبر هستند\&.
.br 
لطفاً توجه داشته باشید که این فلگ‌ها فقط بر تحلیل نام DNS تأثیر می‌گذارند و روی تحلیل نام مبتنی بر hosts یا NIS اثری ندارند، و همچنین زمانی که (g)libc نتایج را از 
\f(CWnscd\fP
دریافت می‌کند هیچ تأثیری ندارند\&.
.IP "\fB\f(CWres\-retrans=<int>\fP\fP"
بازه زمانی ارسال مجدد تحلیل‌گر DNS را تنظیم می‌کند (بر اساس یک قابلیت نامستند)\&.
.IP "\fB\f(CWres\-retry=<int>\fP\fP"
تعداد دفعات تلاش مجدد تحلیل‌گر DNS را تنظیم می‌کند (بر اساس یک قابلیت نامستند)\&.
.IP "\fB\f(CWres\-nsaddr=<ipaddr>[:<port>]\fP\fP"
تلاش می‌کند تنظیمات nameserver بارگذاری‌شده از /etc/resolv\&.conf را با نوشتن نشانی IPv4 ارائه‌شده در فیلد نامستند
\f(CW_res:nsaddr_list[0]\fP
بازنویسی کند\&.
فایل
\f(CW/etc/hosts\fP
همچنان توسط تحلیل‌گر بررسی می‌شود\&. لطفاً توجه داشته باشید که در صورت در حال اجرا بودن
\f(CWnscd\fP
در glibc، همیشه ابتدا از آن پرس‌وجو خواهد شد!

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های IP6\fP\fP
.PP 
این گزینه‌ها تنها روی سوکت‌های مبتنی بر IPv6 قابل استفاده هستند\&. برای گزینه‌هایی که می‌توانند روی هر دو سوکت IPv4 و IPv6 اعمال شوند، گزینه‌های IP را ببینید\&.
.IP "\fB\f(CWipv6only[=<bool>]\fP\fP"
گزینه سوکت IPV6_V6ONLY را تنظیم می‌کند\&. اگر 0 باشد، پشته TCP اتصال‌های با پروتکل IPv4 را نیز روی همین پورت می‌پذیرد\&. مقدار پیش‌فرض وابسته به سیستم است\&.
.IP "\fB\f(CWipv6\-recvdstopts\fP\fP"
گزینه سوکت IPV6_RECVDSTOPTS را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی گزینه‌های مقصد را فعال می‌سازد\&.
.IP "\fB\f(CWipv6\-recvhoplimit\fP\fP"
گزینه سوکت IPV6_RECVHOPLIMIT را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی محدودیت جهش (hoplimit) را فعال می‌سازد\&.
.IP "\fB\f(CWipv6\-recvhopopts\fP\fP"
گزینه سوکت IPV6_RECVHOPOPTS را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی گزینه‌های جهش را فعال می‌سازد\&.
.IP "\fB\f(CWipv6\-recvpktinfo\fP\fP"
گزینه سوکت IPV6_RECVPKTINFO را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی نشانی مقصد و رابط شبکه را فعال می‌سازد\&.
.IP "\fB\f(CWipv6\-unicast\-hops=link(TYPE_INT)(<int>)\fP\fP"
گزینه سوکت IPV6_UNICAST_HOPS را تنظیم می‌کند\&. این گزینه محدودیت تعداد جهش (TTL) را برای بسته‌های تک‌پخشی (unicast) خروجی تعیین می‌کند\&.
.IP "\fB\f(CWipv6\-recvrthdr\fP\fP"
گزینه سوکت IPV6_RECVRTHDR را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی اطلاعات مسیریابی را فعال می‌سازد\&.
.IP "\fB\f(CWipv6\-tclass\fP\fP"
گزینه سوکت IPV6_TCLASS را تنظیم می‌کند\&. این گزینه کلاس انتقال بسته‌های خروجی را تعیین می‌کند\&.
.IP "\fB\f(CWipv6\-recvtclass\fP\fP"
گزینه سوکت IPV6_RECVTCLASS را تنظیم می‌کند\&. این گزینه دریافت و ثبت لاگ پیام‌های کمکی حاوی کلاس انتقال را فعال می‌سازد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های TCP\fP\fP
.PP 
این گزینه‌ها ممکن است روی سوکت‌های TCP اعمال شوند\&. عملکرد آن‌ها از طریق فراخوانی 
\f(CWsetsockopt()\fP
با پارامترهای مناسب است\&.
.IP "\fB\f(CWcork\fP\fP"
بسته‌های کوچکتر از MSS (حداکثر اندازه قطعه) را ارسال نمی‌کند\&.
.IP "\fB\f(CWdefer\-accept\fP\fP"
در هنگام شنود، اتصال‌ها را تنها زمانی می‌پذیرد که داده‌ها از طرف مقابل دریافت شده باشند\&.
.IP "\fB\f(CWkeepcnt=<count>\fP\fP"
تعداد دفعات ارسال پیام‌های keepalive پیش از بستن سوکت را روی
<count> [int]
تنظیم می‌کند\&.
.IP "\fB\f(CWkeepidle=<seconds>\fP\fP"
مدت‌زمان بیکاری پیش از ارسال نخستین پیام keepalive را روی
<seconds> [int]
تنظیم می‌کند\&.
.IP "\fB\f(CWkeepintvl=<seconds>\fP\fP"
فاصله زمانی میان دو پیام keepalive را روی
<seconds> [int]
تنظیم می‌کند\&. 
.IP "\fB\f(CWlinger2=<seconds>\fP\fP"
مدت‌زمان نگهداری سوکت در وضعیت FIN\-WAIT\-2 را روی
<seconds> [int]
تنظیم می‌کند\&.
.IP "\fB\f(CWmss=<bytes>\fP\fP"
مقدار MSS (حداکثر اندازه قطعه) را پس از فراخوانی 
\f(CWsocket()\fP
روی <bytes> [int] تنظیم می‌کند\&. سپس این مقدار با بسته SYN یا SYN/ACK به طرف مقابل پیشنهاد داده می‌شود (مثال)\&. 
.IP "\fB\f(CWmss\-late=<bytes>\fP\fP"
مقدار MSS سوکت را پس از برقراری اتصال روی <bytes> [int] تنظیم می‌کند\&.
.IP "\fB\f(CWnodelay\fP\fP"
الگوریتم Nagle را برای اندازه‌گیری RTT (زمان رفت و برگشت) غیرفعال می‌کند\&.
.IP "\fB\f(CWrfc1323\fP\fP"
گزینه‌های TCP مندرج در RFC1323 را فعال می‌سازد: مقیاس پنجره TCP، اندازه‌گیری زمان رفت و برگشت (RTTM) و محافظت در برابر دور زدن شماره ترتیب (PAWS) (در AIX)\&.
.IP "\fB\f(CWstdurg\fP\fP"
مدیریت اشاره‌گر فوری مطابق با RFC1122 را فعال می‌سازد (در AIX)\&.
.IP "\fB\f(CWsyncnt=<count>\fP\fP"
حداکثر تعداد ارسال مجدد SYN در حین اتصال را روی <count> [int] تنظیم می‌کند\&.
.IP "\fB\f(CWmd5sig\fP\fP"
تولید خلاصه پیام MD5 روی بسته‌ها را فعال می‌کند (در FreeBSD)\&.
.IP "\fB\f(CWnoopt\fP\fP"
استفاده از گزینه‌های TCP را غیرفعال می‌سازد (در FreeBSD و MacOSX)\&.
.IP "\fB\f(CWnopush\fP\fP"
گزینه سوکت TCP_NOPUSH را تنظیم می‌کند (در FreeBSD و MacOSX)\&.
.IP "\fB\f(CWsack\-disable\fP\fP"
استفاده از قابلیت تایید انتخابی (selective acknowledge) را غیرفعال می‌سازد (در OpenBSD)\&.
.IP "\fB\f(CWsignature\-enable\fP\fP"
تولید خلاصه پیام MD5 روی بسته‌ها را فعال می‌کند (در OpenBSD)\&.
.IP "\fB\f(CWabort\-threshold=<milliseconds>\fP\fP"
مدت‌زمان انتظار برای پاسخ طرف مقابل در یک اتصال برقرارشده را تعیین می‌کند (در HP\-UX)\&.
.IP "\fB\f(CWconn\-abort\-threshold=<milliseconds>\fP\fP"
مدت‌زمان انتظار برای پاسخ سرور در حین اتصال اولیه را تعیین می‌کند (در HP\-UX)\&.
.IP "\fB\f(CWkeepinit\fP\fP"
مدت‌زمان انتظار برای پاسخ سرور در حین connect() پیش از انصراف را تعیین می‌کند\&. مقدار بر حسب نیم‌ثانیه است و مقدار پیش‌فرض 150 (معادل ۷۵ ثانیه) می‌باشد (در Tru64)\&.
.IP "\fB\f(CWpaws\fP\fP"
قابلیت \(dq\&محافظت در برابر دور زدن شماره ترتیب\(dq\& را فعال می‌کند (در Tru64)\&.
.IP "\fB\f(CWsackena\fP\fP"
تایید انتخابی را فعال می‌سازد (در Tru64)\&.
.IP "\fB\f(CWtsoptena\fP\fP"
گزینه برچسب زمانی را فعال می‌کند که امکان محاسبه مجدد RTT را روی اتصال‌های موجود فراهم می‌سازد (در Tru64)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های UDP\fP\fP
.PP 
این گزینه ممکن است روی سوکت‌های دیتاگرام UDP اعمال شود\&.
.PP 
.IP "\fB\f(CWudp\-ignore\-peerport>\fP\fP"
آدرس UDP\-DATAGRAM انتظار دارد پاسخ‌های ورودی از پورتی که در پارامتر دوم آن مشخص شده است دریافت شوند\&. با این گزینه، بسته‌های دریافتی از هر پورتی پذیرفته می‌شوند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های UDPLITE\fP\fP
.PP 
این گزینه‌ها ممکن است روی آدرس‌های UDPLITE اعمال شوند:
.IP "\fB\f(CWudplite\-send\-cscov\fP\fP"
تعداد بایت‌هایی که چکسام برای آن‌ها محاسبه و ارسال می‌شود را مشخص می‌کند (\(dq\&پوشش چکسام\(dq\&)\&.
.IP "\fB\f(CWudplite\-recv\-cscov\fP\fP"
تعداد بایت‌هایی که چکسام برای آن‌ها بررسی می‌شود را مشخص می‌کند (\(dq\&پوشش چکسام\(dq\&)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های SCTP\fP\fP
.PP 
این گزینه‌ها ممکن است روی سوکت‌های جریانی SCTP اعمال شوند\&.
.IP "\fB\f(CWsctp\-nodelay\fP\fP"
گزینه سوکت SCTP_NODELAY را تنظیم می‌کند که الگوریتم Nagle را غیرفعال می‌سازد\&.
.IP "\fB\f(CWsctp\-maxseg=<bytes>\fP\fP"
گزینه سوکت SCTP_MAXSEG را روی <bytes> [int] تنظیم می‌کند\&.  سپس این مقدار با بسته SYN یا SYN/ACK به طرف مقابل پیشنهاد داده می‌شود\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های DCCP\fP\fP
.PP 
این گزینه‌ها ممکن است روی سوکت‌های DCCP اعمال شوند\&.
.IP "\fB\f(CWdccp\-set\-ccid=<int>\fP\fP"
.IP "\fB\f(CWccid=<int>\fP\fP"
سازوکار دلخواه کنترل تراکم (CCID) را انتخاب می‌کند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های UDP، TCP، SCTP، DCCP و UDPLITE\fP\fP
.PP 
در اینجا گزینه‌هایی را می‌یابیم که به سازوکار پورت شبکه مرتبط هستند و بنابراین می‌توانند همراه با آدرس‌های کلاینت و سرور UDP، TCP، SCTP، DCCP و UDP\-Lite استفاده شوند\&.
.PP 
.IP "\fB\f(CWsourceport=<port>\fP\fP"
برای اتصال‌های خروجی (کلاینت)، پورت مبدا <port> را با استفاده از یک فراخوانی اضافی 
\f(CWbind()\fP
تنظیم می‌کند\&.
در آدرس‌های شنود TCP یا UDP، اگر کلاینت از این پورت مبدا استفاده نکند، socat بلافاصله اتصال را می‌بندد\&. آدرس‌های UDP\-RECV، UDP\-RECVFROM، UDP\-SENDTO و UDP\-DATAGRAM در صورت عدم تطابق، بسته را نادیده می‌گیرند (مثال)\&.
.IP "\fB\f(CWlowport\fP\fP"
اتصال‌های خروجی (کلاینت) با این گزینه از یک پورت مبدا تصادفی استفاده‌نشده بین ۶۴۰ تا ۱۰۲۳ (شامل هر دو) استفاده می‌کنند\&. در سیستم‌عامل‌های رده یونیکس، این کار به امتیازات دسترسی ریشه (root) نیاز دارد و بنابراین نشان می‌دهد که فرایند کلاینت توسط ریشه محلی مجاز شناخته شده است\&.
آدرس‌های شنود TCP و UDP با این گزینه در صورتی که کلاینت از پورت مبدا <= 1023 استفاده نکند، بلافاصله اتصال را قطع می‌کنند\&.
این سازوکار می‌تواند در برخی شرایط، مجوز محدودی را فراهم سازد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های SOCKS\fP\fP
.PP 
هنگام استفاده از آدرس‌های نوع SOCKS، می‌توان برخی گزینه‌های خاص socks را تنظیم کرد\&.
.IP "\fB\f(CWsocksport=<tcp service>\fP\fP"
سرویس پیش‌فرض \(dq\&socks\(dq\& یا پورت ۱۰۸۰ را برای پورت سرور socks با <TCP service> جایگزین می‌کند\&.
.IP "\fB\f(CWsocksuser=<user>\fP\fP"
مقدار <user> [string] را در فیلد نام کاربری به سرور socks ارسال می‌کند\&. مقدار پیش‌فرض، نام کاربری واقعی ($LOGNAME یا $USER) است (مثال)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های HTTP\fP\fP
.PP 
گزینه‌هایی که می‌توانند همراه با آدرس‌های نوع HTTP ارائه شوند\&. تنها آدرس HTTP پیاده‌سازی‌شده در حال حاضر proxy\-connect است\&.
.PP 
.IP "\fB\f(CWhttp\-version=<string>\fP\fP"
مقدار پیش‌فرض \(dq\&1\&.0\(dq\& را که در درخواست اولیه HTTP به سرور ارسال می‌شود تغییر می‌دهد\&. در حال حاضر تأثیر دیگری ندارد، به‌ویژه هیچ راهکاری برای ارسال سرآیند Host ارائه نمی‌دهد\&.
.IP "\fB\f(CWproxyport=<TCP service>\fP\fP"
پورت پیش‌فرض پراکسی HTTP یعنی ۸۰۸۰ را با
<TCP service>
جایگزین می‌کند\&.
.IP "\fB\f(CWignorecr\fP\fP"
پروتکل HTTP نیازمند استفاده از CR+NL به عنوان پایان‌دهنده خط است\&. هنگامی که یک سرور پراکسی این استاندارد را نقض کند، ممکن است socat پاسخ آن را متوجه نشود\&. 
این گزینه به socat دستور می‌دهد که NL را به عنوان پایان‌دهنده خط تفسیر کند و از CR در پاسخ چشم‌پوشی نماید\&. با این حال، socat همچنان CR+NL را به پراکسی ارسال می‌کند\&.
.IP "\fB\f(CWproxy\-authorization=<username>:<password>\fP\fP"
احراز هویت پایه (\(dq\&basic\(dq\&) را به سرور پراکسی ارائه می‌دهد\&. آرگومان این گزینه همراه با یک سرآیند \(dq\&Proxy\-Authorization: Basic\(dq\& در قالب کدگذاری‌شده با base64 استفاده می‌شود\&.
.br 
توجه: نام کاربری و گذرواژه در فهرست فرایندها برای هر کاربری روی ماشین محلی قابل مشاهده است؛ نام کاربری و گذرواژه بدون رمزنگاری (با کدگذاری base64) به سرور پراکسی منتقل می‌شوند و ممکن است شنود شوند\&.
.IP "\fB\f(CWproxy\-authorization\-file=<filename>\fP\fP"
مشابه گزینه proxy\-authorization است، اما اطلاعات اعتبارسنجی از فایل خوانده می‌شوند و بنابراین در فهرست فرایندها قابل مشاهده نیستند\&.
.br 
.IP "\fB\f(CWresolve\fP\fP"
به طور پیش‌فرض، socat یک درخواست CONNECT حاوی نام میزبان مقصد به پراکسی ارسال می‌کند\&. با این گزینه، socat نام میزبان را به طور محلی تحلیل کرده و نشانی IP را ارسال می‌کند\&. لطفاً توجه داشته باشید که طبق RFC 2396، تنها تحلیل نام به نشانی‌های IPv4 پیاده‌سازی شده است\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های RANGE\fP\fP
.PP 
این گزینه‌ها بررسی می‌کنند که آیا باید به یک کلاینت متصل‌شونده اجازه دسترسی داده شود یا خیر\&. آن‌ها را می‌توان روی سوکت‌های شبکه شنودکننده و دریافت‌کننده اعمال کرد\&. گزینه‌های tcp\-wrappers در این گروه قرار می‌گیرند\&.
.IP "\fB\f(CWrange=<address\-range>\fP\fP"
پس از پذیرش یک اتصال، بررسی می‌کند که آیا طرف مقابل در \fIrange\fP (محدوده) قرار دارد یا خیر\&. برای نشانی‌های IPv4، مقدار address\-range به شکل address/bits (مانند 10\&.0\&.0\&.0/8) یا address:mask (مانند 10\&.0\&.0\&.0:255\&.0\&.0\&.0) است (مثال)؛ برای IPv6 به شکل [ip6\-address]/bits (مانند [::1]/128) می‌باشد\&.
اگر نشانی کلاینت مطابقت نداشته باشد، \fBsocat\fP تلاش برای برقراری اتصال را رد کرده، یک هشدار صادر می‌کند و به شنود/دریافت ادامه می‌دهد\&.
.IP "\fB\f(CWtcpwrap[=<name>]\fP\fP"
از کتابخانه libwrap (tcpd) نوشته Wietse Venema برای تعیین مجاز بودن اتصال کلاینت استفاده می‌کند\&. فایل‌های پیکربندی به طور پیش‌فرض /etc/hosts\&.allow و /etc/hosts\&.deny هستند؛ برای اطلاعات بیشتر \(dq\&man 5 hosts_access\(dq\& را ببینید\&. مقدار اختیاری <name> (از نوع رشته) به عنوان نام فرایند دیمن به توابع wrapper ارسال می‌شود (مثال)\&. 
در صورت حذف آن، نام پایه دستور فراخوانی socat (argv[0]) ارسال می‌شود\&. 
اگر هر دو گزینه tcpwrap و range روی یک آدرس اعمال شوند، برای مجاز بودن اتصال باید هر دو شرط برآورده شوند\&.
.IP "\fB\f(CWallow\-table=<filename>\fP\fP"
فایل مشخص‌شده را به جای /etc/hosts\&.allow در نظر می‌گیرد\&.
.IP "\fB\f(CWdeny\-table=<filename>\fP\fP"
فایل مشخص‌شده را به جای /etc/hosts\&.deny در نظر می‌گیرد\&.
.IP "\fB\f(CWtcpwrap\-etc=<directoryname>\fP\fP"
به دنبال hosts\&.allow و hosts\&.deny در پوشه مشخص‌شده می‌گردد\&. با گزینه‌های hosts\-allow و hosts\-deny لغو می‌شود\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های LISTEN\fP\fP
.PP 
گزینه‌های ویژه سوکت‌های شنود\&.
.IP "\fB\f(CWbacklog=<count>\fP\fP"
مقدار backlog ارسال‌شده با فراخوانی سیستمی 
\f(CWlisten()\fP
را روی <count> [int] تنظیم می‌کند\&. مقدار پیش‌فرض ۵ است\&. 
.IP "\fB\f(CWaccept\-timeout=<seconds>\fP\fP"
انتظار برای برقراری اتصال را پس از <seconds> [timeval] با وضعیت خطا به پایان می‌رساند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های CHILD\fP\fP
.PP 
آدرس‌های از نوع LISTEN و CONNECT گزینه fork را برای مدیریت چندین اتصال از طریق فرایندهای فرزند می‌پذیرند\&.
.IP "\fB\f(CWfork\fP\fP"
پس از برقراری یک اتصال، کانال آن را در یک فرایند فرزند مدیریت کرده و فرایند والد را در حال تلاش برای تولید اتصال‌های بیشتر نگه می‌دارد، چه از طریق شنود یا از طریق اتصال در یک حلقه (مثال)\&.
.br 
OPENSSL\-LISTEN و OPENSSL\-CONNECT در زمان انشعاب واقعی (fork) فرایند فرزند تفاوت دارند:
OPENSSL\-LISTEN \fIپیش از\fP دست‌تکانی SSL منشعب می‌شود، در حالی که OPENSSL\-CONNECT \fIپس از آن\fP منشعب می‌شود\&.
گزینه‌های retry و forever به فرایند فرزند به ارث نمی‌رسند\&.
.br 
در برخی سیستم‌عامل‌ها (مانند FreeBSD) این گزینه برای آدرس‌های UDP\-LISTEN کار نمی‌کند\&.
.br 
.IP "\fB\f(CWmax\-children=<count>\fP\fP"
تعداد فرایندهای فرزند همزمان را محدود می‌کند [int]\&.
پیش‌فرض بدون محدودیت است\&.
.IP "\fB\f(CWchildren\-shutup[=1|2|\&.\&.]\fP\fP"
شدت پیام‌های لاگ تولیدشده توسط فرایندهای فرزند را کاهش می‌دهد\&. برای نمونه، با مقدار ۱ پیام‌های notice به عنوان info ثبت می‌شوند (یا بسته به گزینه \-dX دور ریخته می‌شوند)، و خطاهایی که همچنان باعث خاتمه فرایند فرزند می‌شوند به عنوان هشدار ثبت می‌گردند\&.
.br 
این گزینه برای کاهش لاگ‌های سرورها یا پراکسی‌های پرترافیک در نظر گرفته شده است\&.
.br 
این گزینه جانشین گزینه cool\-write شده است\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های EXEC\fP\fP
.PP 
گزینه‌ها برای آدرس‌هایی که یک برنامه را فراخوانی می‌کنند\&.
.IP "\fB\f(CWpath=<string>\fP\fP"
متغیر محیطی PATH را برای جستجوی برنامه با <string> بازنویسی می‌کند\&. این مقدار
\f(CW$PATH\fP
در فرایند فرزند نیز مؤثر است\&.
.IP "\fB\f(CWlogin\fP\fP"
به ابتدای 
\f(CWargv[0]\fP
برای فراخوانی 
\f(CWexecvp()\fP
پیشوند \(cq\&\-\(cq\& می‌افزاید و بدین ترتیب پوسته را مانند یک پوسته ورود (login shell) رفتار می‌دهد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های FORK\fP\fP
.PP 
آدرس‌های EXEC یا SYSTEM برنامه‌ای را با استفاده از یک فرایند فرزند فراخوانی کرده و داده‌ها را میان \fBsocat\fP و آن برنامه انتقال می‌دهند\&. سازوکار ارتباط بین‌فرایندی را می‌توان با گزینه‌های زیر تغییر داد\&. به صورت پیش‌فرض، یک 
\f(CWsocketpair()\fP
ایجاد شده و به ورودی استاندارد (stdin) و خروجی استاندارد (stdout) فرایند فرزند اختصاص داده می‌شود، در حالی که خطای استاندارد (stderr) از فرایند \fBsocat\fP به ارث برده می‌شود و فرایند فرزند از توصیف‌گرهای فایل ۰ و ۱ برای ارتباط با فرایند اصلی socat استفاده می‌کند\&.
.IP "\fB\f(CWnofork\fP\fP"
زیرفرایندی برای اجرای برنامه منشعب نمی‌کند، بلکه execvp() یا system() را مستقیماً از نمونه جاری socat فراخوانی می‌کند\&. این امر از سربار فرایند دیگری میان برنامه و طرف مقابل جلوگیری می‌کند، اما محدودیت‌های بسیاری را ایجاد می‌کند:
.IP o 
این گزینه تنها می‌تواند روی دومین آدرس \fBsocat\fP اعمال شود\&.
.IP o 
نمی‌تواند روی بخشی از یک آدرس دوگانه اعمال شود\&.
.IP o 
اولین آدرس socat نمی‌تواند OPENSSL یا READLINE باشد\&.
.IP o 
گزینه‌های \-b، \-t، \-D، \-l، \-v و \-x در socat بی‌اثر می‌شوند\&.
.IP o 
برای هر دو آدرس، گزینه‌های ignoreeof، cr و crnl بی‌اثر می‌شوند\&.
.IP o 
برای هر دو آدرس، مدیریت خاص پایان/خاتمه آدرس (مانند بستن ملایم سوکت) و گزینه‌های مرتبط با آن بی‌اثر می‌شوند\&.
.IP o 
برای آدرس دوم (آدرسی که دارای گزینه nofork است)، گزینه‌های append، cloexec، flock، user، group، mode، nonblock، perm\-late، setlk و setpgid را نمی‌توان اعمال کرد\&. هرچند ممکن است برخی از این موارد روی آدرس اول استفاده شوند\&.
.IP "\fB\f(CWpipes\fP\fP"
به جای یک جفت سوکت، یک جفت لوله (pipe) بدون نام برای ارتباط بین‌فرایندی ایجاد می‌کند\&.
.IP "\fB\f(CWopenpty\fP\fP"
ارتباط با زیرفرایند را با استفاده از یک شبه‌ترمینال ایجادشده با 
\f(CWopenpty()\fP
به جای پیش‌فرض (socketpair یا ptmx) برقرار می‌کند\&.
.IP "\fB\f(CWptmx\fP\fP"
ارتباط با زیرفرایند را با استفاده از یک شبه‌ترمینال ایجادشده از طریق باز کردن \fB/dev/ptmx\fP یا \fB/dev/ptc\fP به جای پیش‌فرض (socketpair) برقرار می‌کند\&.
.IP "\fB\f(CWpty\fP\fP"
ارتباط با زیرفرایند را با استفاده از یک شبه‌ترمینال به جای یک جفت سوکت برقرار می‌کند\&. pty را با سازوکارهای موجود ایجاد می‌کند\&. اگر هر دو openpty و ptmx در دسترس باشند، از ptmx استفاده می‌کند زیرا مطابق با استاندارد POSIX است (مثال)\&.
.IP "\fB\f(CWctty\fP\fP"
شبه‌ترمینال (pty) را به tty کنترلی زیرفرایند تبدیل می‌کند (مثال)\&.
.IP "\fB\f(CWstderr\fP\fP"
خطای استاندارد (stderr) زیرفرایند را با تبدیل stderr به یک 
\f(CWdup()\fP
از stdout به کانال خروجی آن هدایت می‌کند (مثال)\&. 
.IP "\fB\f(CWfdin=<fdnum>\fP\fP"
کانال ورودی زیرفرایند را به جای stdin (0) به توصیف‌گر فایل 
<fdnum> 
آن اختصاص می‌دهد\&. برنامه‌ای که از زیرفرایند آغاز شده است باید از این fd برای خواندن داده‌ها از \fBsocat\fP استفاده کند (مثال)\&. 
.IP "\fB\f(CWfdout=<fdnum>\fP\fP"
کانال خروجی زیرفرایند را به جای stdout (1) به توصیف‌گر فایل 
<fdnum> 
آن اختصاص می‌دهد\&. برنامه‌ای که از زیرفرایند آغاز شده است باید از این fd برای نوشتن داده‌ها به \fBsocat\fP استفاده کند (مثال)\&.
.IP "\fB\f(CWsighup\fP\fP, \fB\f(CWsigint\fP\fP, \fB\f(CWsigquit\fP\fP"
باعث می‌شود \fBsocat\fP سیگنال‌های این نوع را به زیرفرایند منتقل کند\&.
اگر هیچ آدرسی این گزینه را نداشته باشد، socat با دریافت این سیگنال‌ها خاتمه می‌یابد\&.

.PP 
.br 

.PP 
گزینه‌ها برای آدرس SHELL
.PP 
.IP "\fB\f(CWshell=<filename>\fP\fP"
استفاده از پوسته پیش‌فرض را با فایل اجرایی مشخص‌شده، مانند
\f(CW/bin/dash\fP
جایگزین می‌کند\&. همچنین متغیر محیطی \f(CWSHELL\fP را تنظیم می‌کند\&.
.IP 
.br

.PP 
\fI\fBگروه گزینه‌های TERMIOS\fP\fP
.PP 
برای آدرس‌هایی که روی یک tty کار می‌کنند (مانند stdio، file:/dev/tty، exec:...، pty)، پارامترهای ترمینال تعریف‌شده در سازوکار termios یونیکس به عنوان پارامترهای گزینه آدرس در دسترس قرار گرفته‌اند\&.
لطفاً توجه داشته باشید که تغییرات پارامترهای ترمینال تعاملی شما پس از خاتمه \fBsocat\fP نیز پابرجا باقی می‌مانند، بنابراین ممکن است لازم باشد پس از آن عبارت \(dq\&reset\(dq\& یا \(dq\&stty sane\(dq\& را در پوسته خود وارد کنید\&.
برای آدرس‌های EXEC و SYSTEM با گزینه PTY، این گزینه‌ها روی pty توسط فرایندهای فرزند اعمال می‌شوند\&.
.PP 
.IP "\fB\f(CWb0\fP\fP"
ارتباط ترمینال را قطع می‌کند\&.
.IP "\fB\f(CWb19200\fP\fP"
سرعت خط سریال را روی 19200 باود تنظیم می‌کند\&. برخی نرخ‌های دیگر نیز امکان‌پذیر هستند؛ از دستوری مانند \f(CWsocat \-hh |grep \(cq\& b[1\-9]\(cq\&\fP برای یافتن تمام سرعت‌های پشتیبانی‌شده توسط پیاده‌سازی خود استفاده کنید\&.
.br 
توجه: در برخی از سیستم‌عامل‌ها، ممکن است این گزینه‌ها در دسترس نباشند\&. به جای آن از ispeed یا ospeed استفاده کنید\&.
.IP "\fB\f(CWecho[=<bool>]\fP\fP"
انعکاس محلی (local echo) را فعال یا غیرفعال می‌کند\&.
.IP "\fB\f(CWicanon[=<bool>]\fP\fP"
حالت قانونی (canonical mode) را تنظیم یا لغو می‌کند، که بافرینگ خط و برخی کاراکترهای خاص را فعال می‌سازد\&. 
.IP "\fB\f(CWraw\fP\fP"
حالت خام (raw) را تنظیم می‌کند، بدین ترتیب ورودی و خروجی تقریباً بدون پردازش عبور داده می‌شوند\&. این گزینه منسوخ شده است، به جای آن از گزینه rawer یا cfmakeraw استفاده کنید\&.
.IP "\fB\f(CWrawer\fP\fP"
ترمینال را از گزینه raw نیز خام‌تر می‌کند\&. این گزینه به طور ضمنی انعکاس (echo) را خاموش می‌کند (مثال)\&.
.IP "\fB\f(CWcfmakeraw\fP\fP"
با فراخوانی \f(CWcfmakeraw()\fP یا با شبیه‌سازی این فراخوانی حالت خام را تنظیم می‌کند\&. این گزینه به طور ضمنی انعکاس را خاموش می‌کند\&.
.IP "\fB\f(CWignbrk[=<bool>]\fP\fP"
از کاراکتر BREAK (مانند C^) چشم‌پوشی کرده یا آن را تفسیر می‌کند\&.
.IP "\fB\f(CWbrkint[=<bool>]\fP\fP"
.IP "\fB\f(CWbs0\fP\fP"
.IP "\fB\f(CWbs1\fP\fP"
.IP "\fB\f(CWbsdly=<0|1>\fP\fP"
.IP "\fB\f(CWclocal[=<bool>]\fP\fP"

.IP 
\.LP
\.nf
\fBcr0
cr1
cr2
cr3\fP
\.fi
\.IP
تأخیر بازگشت مکان‌نما (carriage return) را به ترتیب روی ۰، ۱، ۲، یا ۳ تنظیم می‌کند\&.
۰ به معنای بدون تأخیر است و سایر مقادیر وابسته به ترمینال هستند\&.
.IP 
.IP "\fB\f(CWcrdly=<0|1|2|3>\fP\fP"
.IP "\fB\f(CWcread[=<bool>]\fP\fP"
.IP "\fB\f(CWcrtscts[=<bool>]\fP\fP"

.IP 
\.LP
\.nf
\fBcs5 
cs6 
cs7 
cs8\fP
\.fi
\.IP
اندازه کاراکتر را به ترتیب روی ۵، ۶، ۷، یا ۸ بیت تنظیم می‌کند\&.
.IP 
.IP "\fB\f(CWcsize=<0|1|2|3>\fP\fP"
.IP "\fB\f(CWcstopb[=<bool>]\fP\fP"
به جای یک بیت، دو بیت توقف (stop bits) تنظیم می‌کند\&.
.IP "\fB\f(CWdsusp=<byte>\fP\fP"
مقدار کاراکتر VDSUSP را تنظیم می‌کند که فرایند پیش‌زمینه جاری را معلق کرده و پوسته را مجدداً فعال می‌سازد (همه به جز لینوکس)\&.
.IP "\fB\f(CWechoctl[=<bool>]\fP\fP"
کاراکترهای کنترلی را در نشانه‌گذاری کلاهک (مانند ^A) انعکاس می‌دهد\&.
.IP "\fB\f(CWechoe[=<bool>]\fP\fP"
.IP "\fB\f(CWechok[=<bool>]\fP\fP"
.IP "\fB\f(CWechoke[=<bool>]\fP\fP"
.IP "\fB\f(CWechonl[=<bool>]\fP\fP"
.IP "\fB\f(CWechoprt[=<bool>]\fP\fP"
.IP "\fB\f(CWeof=<byte>\fP\fP"
.IP "\fB\f(CWeol=<byte>\fP\fP"
.IP "\fB\f(CWeol2=<byte>\fP\fP"
.IP "\fB\f(CWerase=<byte>\fP\fP"
.IP "\fB\f(CWdiscard=<byte>\fP\fP"
.IP "\fB\f(CWff0\fP\fP"
.IP "\fB\f(CWff1\fP\fP"
.IP "\fB\f(CWffdly[=<bool>]\fP\fP"
.IP "\fB\f(CWflusho[=<bool>]\fP\fP"
.IP "\fB\f(CWhupcl[=<bool>]\fP\fP"
.IP "\fB\f(CWicrnl[=<bool>]\fP\fP"
.IP "\fB\f(CWiexten[=<bool>]\fP\fP"
.IP "\fB\f(CWigncr[=<bool>]\fP\fP"
.IP "\fB\f(CWignpar[=<bool>]\fP\fP"
.IP "\fB\f(CWimaxbel[=<bool>]\fP\fP"
.IP "\fB\f(CWinlcr[=<bool>]\fP\fP"
.IP "\fB\f(CWinpck[=<bool>]\fP\fP"
.IP "\fB\f(CWintr=<byte>\fP\fP"
.IP "\fB\f(CWisig[=<bool>]\fP\fP"
.IP "\fB\f(CWispeed=<unsigned\-int>\fP\fP"
نرخ باود را برای داده‌های ورودی روی این خط تنظیم می‌کند\&.
.br 
همچنین ببینید: ospeed, b19200
.IP "\fB\f(CWistrip[=<bool>]\fP\fP"
.IP "\fB\f(CWiuclc[=<bool>]\fP\fP"
.IP "\fB\f(CWixany[=<bool>]\fP\fP"
.IP "\fB\f(CWixoff[=<bool>]\fP\fP"
.IP "\fB\f(CWixon[=<bool>]\fP\fP"
.IP "\fB\f(CWkill=<byte>\fP\fP"
.IP "\fB\f(CWlnext=<byte>\fP\fP"
.IP "\fB\f(CWmin=<byte>\fP\fP"
.IP "\fB\f(CWnl0\fP\fP"
تأخیر خط جدید (newline) را روی 0 تنظیم می‌کند\&.
.IP "\fB\f(CWnl1\fP\fP"
.IP "\fB\f(CWnldly[=<bool>]\fP\fP"
.IP "\fB\f(CWnoflsh[=<bool>]\fP\fP"
.IP "\fB\f(CWocrnl[=<bool>]\fP\fP"
.IP "\fB\f(CWofdel[=<bool>]\fP\fP"
.IP "\fB\f(CWofill[=<bool>]\fP\fP"
.IP "\fB\f(CWolcuc[=<bool>]\fP\fP"
.IP "\fB\f(CWonlcr[=<bool>]\fP\fP"
.IP "\fB\f(CWonlret[=<bool>]\fP\fP"
.IP "\fB\f(CWonocr[=<bool>]\fP\fP"
.IP "\fB\f(CWopost[=<bool>]\fP\fP"
پردازش خروجی را فعال یا غیرفعال می‌کند؛ برای نمونه، تبدیل NL به CR\-NL\&.
.IP "\fB\f(CWospeed=<unsigned\-int>\fP\fP"
نرخ باود را برای داده‌های خروجی روی این خط تنظیم می‌کند\&.
.br 
همچنین ببینید: ispeed, b19200
.IP "\fB\f(CWparenb[=<bool>]\fP\fP"
تولید توازن (parity) در خروجی و بررسی توازن برای ورودی را فعال می‌کند\&.
.IP "\fB\f(CWparmrk[=<bool>]\fP\fP"
.IP "\fB\f(CWparodd[=<bool>]\fP\fP"
.IP "\fB\f(CWpendin[=<bool>]\fP\fP"
.IP "\fB\f(CWquit=<byte>\fP\fP"
.IP "\fB\f(CWreprint=<byte>\fP\fP"
.IP "\fB\f(CWsane\fP\fP"
ترمینال را به وضعیتی شبیه به یک حالت پیش‌فرض کاربردی بازمی‌گرداند\&.
.IP "\fB\f(CWstart=<byte>\fP\fP"
.IP "\fB\f(CWstop=<byte>\fP\fP"
.IP "\fB\f(CWsusp=<byte>\fP\fP"
.IP "\fB\f(CWswtc=<byte>\fP\fP"
.IP "\fB\f(CWtab0\fP\fP"
.IP "\fB\f(CWtab1\fP\fP"
.IP "\fB\f(CWtab2\fP\fP"
.IP "\fB\f(CWtab3\fP\fP"
.IP "\fB\f(CWtabdly=<unsigned\-int>\fP\fP"
.IP "\fB\f(CWtime=<byte>\fP\fP"
.IP "\fB\f(CWtostop[=<bool>]\fP\fP"
.IP "\fB\f(CWvt0\fP\fP"
.IP "\fB\f(CWvt1\fP\fP"
.IP "\fB\f(CWvtdly[=<bool>]\fP\fP"
.IP "\fB\f(CWwerase=<byte>\fP\fP"
.IP "\fB\f(CWxcase[=<bool>]\fP\fP"
.IP "\fB\f(CWxtabs\fP\fP"
.IP "\fB\f(CWi\-pop\-all\fP\fP"
در STREAMS سیستم V یونیکس، تمامی درایورها را از پشته حذف می‌کند\&.
.IP "\fB\f(CWi\-push=<string>\fP\fP"
در STREAMS سیستم V یونیکس، درایور (ماژول) با نام داده‌شده (رشته) را به درون پشته ارسال می‌کند (push)\&. برای نمونه، به منظور اطمینان از اینکه یک دستگاه کاراکتری در سولاریس از termios و غیره پشتیبانی می‌کند، از گزینه‌های زیر استفاده کنید:
\f(CWi\-pop\-all,i\-push=ptem,i\-push=ldterm,i\-push=ttcompat\fP

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های PTY\fP\fP
.PP 
این گزینه‌ها برای استفاده با نوع آدرس pty در نظر گرفته شده‌اند\&.
.PP 
.IP "\fB\f(CWlink=<filename>\fP\fP"
یک پیوند نمادین ایجاد می‌کند که به شبه‌ترمینال (pty) واقعی اشاره دارد\&. این امر ممکن است به حل این مشکل کمک کند که ptyها با نام‌های کم و بیش غیرقابل پیش‌بینی ایجاد می‌شوند، و دسترسی مستقیم و خودکار به pty ایجادشده توسط socat را دشوار می‌سازد\&. با این گزینه، کاربر می‌تواند یک نقطه «ثابت» در سلسله‌مراتب فایل تعیین کند که به او در دسترسی به pty واقعی کمک کند (مثال)\&.
از نسخه 1\&.4\&.3 برنامه \fBsocat\fP به بعد، هنگام بسته شدن آدرس، پیوند نمادین حذف می‌شود (اما گزینه unlink\-close را ببینید)\&.
.IP "\fB\f(CWwait\-slave\fP\fP"
مرحله باز کردن را تا زمانی که یک فرایند، سمت اسلیو (slave) شبه‌ترمینال را باز کند مسدود می‌کند\&.
معمولاً socat پس از ایجاد pty، با باز کردن آدرس بعدی یا با ورود به حلقه انتقال ادامه می‌دهد\&. با گزینه wait\-slave، برنامه socat پیش از ادامه کار منتظر می‌ماند تا فرایندی سمت اسلیو pty را باز کند\&. 
این گزینه تنها در صورتی کار می‌کند که سیستم‌عامل فراخوانی سیستمی \f(CWpoll()\fP را ارائه دهد\&. و همچنین به یک رفتار نامستند در ptyها وابسته است، بنابراین روی همه سیستم‌عامل‌ها کار نمی‌کند\&. این گزینه با موفقیت روی لینوکس، FreeBSD، NetBSD و روی Tru64 با openpty آزمایش شده است\&. 
.IP "\fB\f(CWpty\-interval=<seconds>\fP\fP"
هنگامی که گزینه wait\-slave تنظیم شده است، socat وضعیت HUP را با استفاده از \f(CWpoll()\fP به صورت دوره‌ای بررسی می‌کند تا ببیند آیا سمت اسلیو pty باز شده است یا خیر\&. فاصله زمانی پیش‌فرض برای بررسی دوره‌ای ۱ ثانیه است\&. برای تغییر این مقدار از گزینه pty\-interval [timeval] استفاده کنید\&.
.IP "\fB\f(CWsitout\-eio=<timeval>\fP\fP"
برنامه login در لینوکس به دلایل امنیتی tty/pty خود را می‌بندد و دوباره باز می‌کند\&. در طول این مدت، مستر pty در عملیات‌های ورودی/خروجی با خطای EIO روبرو می‌شود و ممکن است خاتمه یابد\&. با این گزینه \fBsocat\fP خطای EIO را برای مدت‌زمان مشخص‌شده تحمل می‌کند\&. لطفاً توجه داشته باشید که در این وضعیت \fBsocat\fP ترافیک را در هر دو جهت مسدود می‌کند، حتی زمانی که به این کانال مربوط نباشد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های OPENSSL\fP\fP
.PP 
این گزینه‌ها روی انواع آدرس openssl و
openssl\-listen اعمال می‌شوند\&.
.PP 
.IP "\fB\f(CWcipher=<cipherlist>\fP\fP"
فهرست رمزهایی (ciphers) را که می‌توان برای اتصال استفاده کرد مشخص می‌کند\&.
صفحه راهنمای 
\f(CWciphers\fP
، بخش \fBCIPHER LIST FORMAT\fP را برای اطلاعات تفصیلی درباره نحو، مقادیر و پیش‌فرض <cipherlist> ببینید\&.
.br 
می‌توان چندین رشته رمز را با جداکننده \(cq\&:\(cq\& تعیین کرد\&.
برخی رشته‌های رمز ساده:
.IP "3DES"
از یک مجموعه رمزی با triple DES استفاده می‌کند\&.
.IP "MD5"
از یک مجموعه رمزی با MD5 استفاده می‌کند\&.
.IP "aNULL"
از یک مجموعه رمزی بدون احراز هویت استفاده می‌کند\&.
.IP "NULL"
از رمزنگاری استفاده نمی‌کند\&.
.IP "HIGH"
از یک مجموعه رمزی با رمزنگاری \(dq\&بالا\(dq\& (high) استفاده می‌کند\&.
توجه داشته باشید که طرف مقابل باید از ویژگی انتخاب‌شده پشتیبانی کند، در غیر این صورت مذاکره با شکست مواجه خواهد شد\&.
.IP "\fB\f(CWmethod=<ssl\-method>\fP\fP"
این گزینه مبتنی بر توابع منسوخ‌شده است و تنها زمانی در دسترس است که
\fBsocat\fP با گزینه \f(CW\-\-with\-openssl\-method\fP کامپایل شده باشد\&.
به جای آن از گزینه min\-proto\-version
و احتمالاً max\-proto\-version
استفاده کنید\&.
نسخه پروتکل مورد استفاده را تنظیم می‌کند\&. رشته‌های معتبر (بدون حساسیت به بزرگی و کوچکی حروف) عبارتند از:  
.IP "\f(CWSSL2\fP"
انتخاب نسخه ۲ پروتکل SSL\&.
.IP "\f(CWSSL3\fP"
انتخاب نسخه ۳ پروتکل SSL\&.
.IP "\f(CWSSL23\fP"
انتخاب بهترین پروتکل موجود SSL یا TLS\&.
.IP "\f(CWTLS1\fP"
انتخاب نسخه ۱ پروتکل TLS\&.
.IP "\f(CWTLS1\&.1\fP"
انتخاب نسخه 1\&.1 پروتکل TLS\&.
.IP "\f(CWTLS1\&.2\fP"
انتخاب نسخه 1\&.2 پروتکل TLS\&.
هنگامی که این گزینه ارائه نشود، OpenSSL روش را با طرف مقابل خود مذاکره می‌کند\&.
.IP "\fB\f(CWmin\-proto\-version\fP\fP"
این گزینه به OpenSSL دستور می‌دهد از این نسخه یا نسخه‌های جدیدتر پروتکل SSL/TLS استفاده کند
و از پذیرش پروتکل پایین‌تر/قدیمی‌تر خودداری نماید\&. نحو معتبر عبارت است از:
.IP "\f(CWSSL2\fP"
انتخاب نسخه ۲ پروتکل SSL\&.
.IP "\f(CWSSL3\fP"
انتخاب نسخه ۳ پروتکل SSL\&.
.IP "\f(CWTLS1\fP"
.IP "\f(CWTLS1\&.0\fP"
انتخاب نسخه ۱ پروتکل TLS\&.
.IP "\f(CWTLS1\&.1\fP"
انتخاب نسخه 1\&.1 پروتکل TLS\&.
.IP "\f(CWTLS1\&.2\fP"
انتخاب نسخه 1\&.2 پروتکل TLS\&.
.IP "\f(CWTLS1\&.3\fP"
انتخاب نسخه 1\&.3 پروتکل TLS\&.
.IP "\fB\f(CWopenssl\-max\-proto\-version\fP\fP"
این گزینه مشابه min\-proto\-version است، با این حال، استفاده از نسخه پروتکل بالاتر را مجاز نمی‌داند\&. برای آزمایش طرف مقابل کاربرد دارد\&.
.IP "\fB\f(CWverify[=<bool>]\fP\fP"
بررسی گواهی طرف مقابل را کنترل می‌کند\&. مقدار پیش‌فرض 1 (true) است\&. غیرفعال کردن verify ممکن است سوکت شما را به روی همگان بگشاید و رمزنگاری را بی‌فایده سازد!
.IP "\fB\f(CWcert=<filename>\fP\fP"
فایل حاوی گواهی و کلید خصوصی را برای احراز هویت مشخص می‌کند\&. 
گواهی باید در قالب OpenSSL (*\&.pem) باشد\&. 
با openssl\-listen، استفاده از این گزینه به شدت توصیه می‌شود\&. به جز در مورد رمز aNULL، در صورت عدم ارائه گواهی، خطای \(dq\&no shared ciphers\(dq\& رخ خواهد داد\&.
.IP "\fB\f(CWkey=<filename>\fP\fP"
فایل حاوی کلید خصوصی را مشخص می‌کند\&. کلید خصوصی ممکن است در این فایل یا در فایل ارائه‌شده با گزینه cert قرار داشته باشد\&. طرفی که باید مالکیت خود بر یک گواهی را اثبات کند به کلید خصوصی نیاز دارد\&.
.IP "\fB\f(CWdhparams=<filename>\fP\fP"
فایل حاوی پارامترهای Diffie Hellman را مشخص می‌کند\&. این پارامترها همچنین می‌توانند در فایل ارائه‌شده با گزینه cert باشند که در این صورت نیازی به گزینه dhparams نخواهد بود\&.
.IP "\fB\f(CWcafile=<filename>\fP\fP"
فایل حاوی گواهی‌های مراجع معتبر (ریشه) را مشخص می‌کند\&. این فایل باید در قالب PEM باشد و شامل یک یا چند گواهی باشد\&. طرفی که اعتبار طرف مقابل خود را بررسی می‌کند، تنها به گواهی‌هایی اعتماد می‌کند که در این فایل وجود دارند\&.
.IP "\fB\f(CWcapath=<dirname>\fP\fP"
پوشه حاوی گواهی‌های معتبر (ریشه) را مشخص می‌کند\&. این پوشه باید شامل گواهی‌ها در قالب PEM و هش‌های مربوط به آن‌ها باشد (مستندات OpenSSL را ببینید)
.IP "\fB\f(CWegd=<filename>\fP\fP"
در برخی سیستم‌ها، openssl به یک منبع صریح برای داده‌های تصادفی نیاز دارد\&. نام سوکتی را مشخص کنید که در آن یک دیمن گردآوری انتروپی مانند egd داده‌های تصادفی را فراهم می‌کند، مانند /dev/egd\-pool\&.
.IP "\fB\f(CWopenssl\-maxfraglen=<int>, maxfraglen=<int>\fP\fP"
برای اتصال‌های کلاینت، یک درخواست مذاکره حداکثر طول قطعه (Max Fragment Length Negotiation Request) به سرور ارسال می‌کند تا حداکثر اندازه قطعه‌ای را که سرور برای ما ارسال خواهد کرد محدود کند\&. طول‌های پشتیبانی‌شده عبارتند از: 512، 1024، 2048، یا 4096\&. توجه داشته باشید که این گزینه برای OPENSSL\-LISTEN قابل اعمال نیست\&.
.IP "\fB\f(CWopenssl\-maxsendfrag=<int>, maxsendfrag=<int>\fP\fP"
حداکثر اندازه قطعه‌ای را که به طرف دیگر ارسال خواهیم کرد محدود می‌کند\&. محدوده طول پشتیبانی‌شده: 512 \- 16384\&. توجه داشته باشید که در OPENSSL\-LISTEN، حداکثر اندازه قطعه ممکن است بر اثر درخواست مذاکره حداکثر طول قطعه کلاینت (در صورت ارسال آن) بیشتر محدود شود\&.
.IP "\fB\f(CWpseudo\fP\fP"
در سیستم‌هایی که openssl نمی‌تواند منبع انتروپی پیدا کند و امکان استفاده از هیچ دیمن گردآوری انتروپی وجود ندارد، این گزینه سازوکاری را برای ارائه انتروپی شبه‌تصادفی فعال می‌سازد\&. این کار با استفاده از زمان جاری بر حسب میکروثانیه جهت مقداردهی اولیه مولد اعداد شبه‌تصادفی libc انجام می‌شود\&. سپس openssl با خروجی حاصل از فراخوانی‌های ()random تغذیه می‌گردد\&.
.br 
توجه: این سازوکار برای تولید کلیدهای امن کافی نیست!
.IP "\fB\f(CWcompress\fP\fP"
استفاده از فشرده‌سازی را برای یک اتصال فعال یا غیرفعال می‌کند\&. تنظیم این گزینه روی \(dq\&none\(dq\& فشرده‌سازی را غیرفعال می‌کند و تنظیم آن روی \(dq\&auto\(dq\& به OpenSSL اجازه می‌دهد بهترین الگوریتم موجود را که مورد پشتیبانی هر دو طرف باشد برگزیند\&. مقدار پیش‌فرض این است که هیچ‌یک از تنظیمات مربوط به فشرده‌سازی دستکاری نشوند\&.
توجه: به OpenSSL 0\&.9\&.8 یا بالاتر نیاز دارد و غیرفعال کردن فشرده‌سازی با OpenSSL 0\&.9\&.8 بر تمامی اتصال‌های جدید در فرایند تأثیر می‌گذارد\&.
.IP "\fB\f(CWcommonname=<string>\fP\fP"
نام عمومی (commonname) را که گواهی طرف مقابل باید با آن مطابقت داشته باشد مشخص می‌کند\&. در آدرس OPENSSL\-CONNECT این مقدار جایگزین نام میزبان یا نشانی مقصد IP داده‌شده می‌شود؛ در OPENSSL\-LISTEN این گزینه بررسی commonname گواهی‌های طرف مقابل را فعال می‌کند\&. این گزینه تنها زمانی معنا دارد که گزینه verify غیرفعال نشده باشد و رمز برگزیده، گواهی طرف مقابل را ارائه دهد\&.
.IP "\fB\f(CWno\-sni[=<bool>]\fP\fP"
از قابلیت نشان‌گذاری نام سرور (SNI) در سمت کلاینت که گواهی سرور دلخواه را انتخاب می‌کند استفاده نمی‌کند\&.
.br 
توجه: SNI از نسخه 1\&.7\&.4\&.0 برنامه \fBsocat\fP به صورت خودکار استفاده می‌شود و از commonname یا نام میزبان داده‌شده استفاده می‌کند\&.
.IP "\fB\f(CWsnihost=<string>\fP\fP"
نام میزبان نشان‌گذاری نام سرور (SNI) در سمت کلاینت را متفاوت از نام سرور یا نام عمومی (common name) مورد آدرس‌دهی تنظیم می‌کند\&. این امر ممکن است زمانی سودمند باشد که گواهی سرور دارای چندین نام میزبان یا نام‌های چندمنظوره (wildcard) است، زیرا نام میزبان SNI به صورت متن آشکار به سرور ارسال می‌شود و ممکن است شنود گردد؛ با این گزینه می‌توان یک نام ساختگی از گواهی مورد نظر را منتقل کرد\&.
.IP "\fB\f(CWfips\fP\fP"
در صورت فعال بودن در زمان کامپایل، حالت FIPS را فعال می‌سازد\&. برای اطلاعات درباره استاندارد پیاده‌سازی رمزنگاری FIPS پیوند http://oss\-institute\&.org/fips\-faq\&.html را ببینید\&.
این حالت ممکن است مستلزم آن باشد که گواهی‌های درگیر با نسخه‌ای از openssl تولید شده باشند که FIPS در آن فعال است\&. تنظیم یا لغو این گزینه در یک آدرس socat، بر تمامی آدرس‌های OpenSSL این فرایند تأثیر می‌گذارد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های RETRY\fP\fP
.PP 
گزینه‌هایی که تلاش مجدد برخی فراخوانی‌های سیستمی، به‌ویژه تلاش‌های برقراری اتصال را کنترل می‌کنند\&.
.PP 
.IP "\fB\f(CWretry=<num>\fP\fP"
تعداد دفعات تلاش مجدد پیش از لغو تلاش برای برقراری اتصال یا شنود\&.
پیش‌فرض 0 است، که به معنای تنها یک بار تلاش می‌باشد\&.
.IP "\fB\f(CWinterval=<timespec>\fP\fP"
مدت‌زمان میان تلاش‌های متوالی (ثانیه،
[timespec])\&. مقدار پیش‌فرض ۱ ثانیه است\&.
.IP "\fB\f(CWforever\fP\fP"
تعداد نامحدودی از دفعات تلاش مجدد را انجام می‌دهد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های INTERFACE\fP\fP
.PP 
این گزینه‌ها ممکن است روی آدرس‌های INTERFACE و
TUN اعمال شوند\&. این انواع آدرس و گزینه‌ها در حال حاضر تنها
روی سیستم‌عامل لینوکس پیاده‌سازی شده‌اند\&.
.PP 
نکته در مورد VLANها: در بسته‌های ورودی، هسته لینوکس پیش از انتقال داده‌ها به برنامه فضای کاربری روی سوکت‌های خام، تگ VLAN را جدا می‌کند\&. برای به دست آوردن اطلاعات VLAN به تمهیدات خاصی نیاز است، صفحه راهنمای packet(7) بخش PACKET_AUXDATA را ببینید، و برای درج اختیاری مجدد تگ در بسته، در صورت نیاز از گزینه retrieve\-vlan استفاده کنید\&.
.PP 
.IP "\fB\f(CWretrieve\-vlan\fP\fP"
در بسته‌های ورودی روی سوکت‌های خام، اطلاعات VLAN را استخراج کرده و برای پردازش‌های بعدی مجدداً در بسته‌ها درج می‌کند (لینوکس)
.IP 
.IP "\fB\f(CWiff\-up\fP\fP"
وضعیت رابط شبکه TUN را روی UP تنظیم می‌کند\&. به شدت توصیه می‌شود\&.
.IP "\fB\f(CWiff\-broadcast\fP\fP"
فلگ BROADCAST رابط شبکه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-debug\fP\fP"
فلگ DEBUG رابط شبکه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-loopback\fP\fP"
فلگ LOOPBACK رابط شبکه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-pointopoint\fP\fP"
فلگ POINTOPOINT دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-notrailers\fP\fP"
فلگ NOTRAILERS دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-running\fP\fP"
فلگ RUNNING دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-noarp\fP\fP"
فلگ NOARP دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-promisc\fP\fP"
فلگ PROMISC دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-allmulti\fP\fP"
فلگ ALLMULTI دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-master\fP\fP"
فلگ MASTER دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-slave\fP\fP"
فلگ SLAVE دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-multicast\fP\fP"
فلگ MULTICAST دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-portsel\fP\fP"
فلگ PORTSEL دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-automedia\fP\fP"
فلگ AUTOMEDIA دستگاه TUN را تنظیم می‌کند\&.
.IP "\fB\f(CWiff\-dynamic\fP\fP"
فلگ DYNAMIC دستگاه TUN را تنظیم می‌کند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های TUN\fP\fP
.PP 
گزینه‌هایی که آدرس‌های دستگاه رابط TUN/TAP در لینوکس را کنترل می‌کنند\&.
.PP 
.IP "\fB\f(CWtun\-device=<device\-file>\fP\fP"
به socat دستور می‌دهد تا مسیر دیگری را برای دستگاه شبیه‌ساز (clone) TUN در نظر بگیرد\&. مقدار پیش‌فرض
\f(CW/dev/net/tun\fP
است\&.
.IP "\fB\f(CWtun\-name=<if\-name>\fP\fP"
به رابط شبکه حاصل یک نام مشخص اختصاص می‌دهد، به جای نام تولیدشده توسط سیستم (tun0، tun1 و غیره)\&.
.IP "\fB\f(CWtun\-type=[tun|tap]\fP\fP"
نوع دستگاه TUN را مشخص می‌کند؛ از این گزینه برای ایجاد یک دستگاه TAP استفاده کنید\&. برای تفاوت میان این دو نوع، مستندات لینوکس را ببینید\&.
هنگامی که تلاش می‌کنید یک تونل میان دو دستگاه TUN برقرار کنید، نوع آن‌ها باید یکسان باشد\&.
.IP "\fB\f(CWiff\-no\-pi\fP\fP"
فلگ IFF_NO_PI را تنظیم می‌کند که تعیین می‌کند آیا دستگاه شامل اطلاعات بسته اضافی در تونل باشد یا خیر\&.
هنگامی که تلاش می‌کنید یک تونل میان دو دستگاه TUN برقرار کنید، این فلگ‌ها باید مقادیر یکسانی داشته باشند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های POSIX\-MQ\fP\fP
.PP 
گزینه‌هایی که ممکن است روی آدرس‌های POSIX\-MQ اعمال شوند\&.
.PP 
.IP "\fB\f(CWposixmq\-priority (mq\-prio)\fP\fP"
اولویت پیام‌های (بسته‌های) نوشته‌شده در صف، یا حداقل اولویت بسته خوانده‌شده از صف را مشخص می‌کند\&.
.IP "\fB\f(CWposixmq\-flush (mq\-flush)\fP\fP"
تمامی پیام‌های موجود در صف را پیش از شروع انتقال‌ها \(dq\&مصرف\(dq\& (حذف) می‌کند\&.
.IP "\fB\f(CWposixmq\-maxmsg (mq\-maxmsg)\fP\fP"
پارامتر maxmsg صف پیام POSIX را هنگام ایجاد آن تنظیم می‌کند\&.
.br 
توجه: این گزینه تنها زمانی اعمال می‌شود که صف از قبل وجود نداشته باشد\&.
.IP "\fB\f(CWposixmq\-msgsize (mq\-msgsize)\fP\fP"
پارامتر msgsize صف پیام POSIX را هنگام ایجاد آن تنظیم می‌کند\&.
.br 
توجه: این گزینه تنها زمانی اعمال می‌شود که صف از قبل وجود نداشته باشد\&.

.PP

.SH "مقادیر داده (DATA VALUES)"

.PP 
این بخش انواع مختلف داده‌هایی را توضیح می‌دهد که پارامترهای آدرس و
گزینه‌های آدرس می‌توانند دریافت کنند\&.
.PP 
.IP "address\-range"
در حال حاضر تنها برای IPv4 و IPv6 پیاده‌سازی شده است\&. گزینه آدرس
`range\(cq را ببینید\&. 
.IP "bool"
\(dq\&0\(dq\& یا \(dq\&1\(dq\&؛ اگر مقدار حذف شود، \(dq\&1\(dq\& در نظر گرفته می‌شود\&.
.IP "byte"
یک عدد int بدون علامت، خوانده‌شده با 
\f(CWstrtoul()\fP
، کوچک‌تر یا مساوی با
\f(CWUCHAR_MAX\fP
\&.
.IP "command\-line"
رشته‌ای که نام یک برنامه و آرگومان‌های آن را مشخص می‌کند که با یک فاصله از هم
جدا شده‌اند\&. 
.IP "data"
این یک مشخصه عمومی‌تر داده است، \(dq\&dalan\(dq\& (زبان توصیف داده سطح پایین)\&. رشته متنی داده‌شده شامل
اطلاعاتی درباره نوع داده هدف و مقدار آن است\&. به طور کلی یک نویسه آغازین،
نوع آیتم داده بعدی را مشخص می‌کند\&. در زمینه خاص آن ممکن است یک نوع داده پیش‌فرض
وجود داشته باشد\&.
.br 
در حال حاضر تنها مشخصات زیر پیاده‌سازی شده‌اند:
.br 
.IP "i"
یک عدد صحیح علامت‌دار، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
مثال:    \fBi\-1000\fP    (عدد صحیح \-1000)
.IP "I"
یک عدد صحیح بدون علامت، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
.IP "l"
یک عدد صحیح long علامت‌دار، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
.IP "L"
یک عدد صحیح long بدون علامت، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
.IP "s"
یک عدد صحیح short علامت‌دار، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
.IP "S"
یک عدد صحیح short بدون علامت، ذخیره‌شده با ترتیب بایت میزبان\&.
.br 
.IP "b"
یک بایت علامت‌دار (signed char)\&.
.br 
.IP "B"
یک بایت بدون علامت (unsigned char)\&.
.br 
.IP "x"
در ادامه یک تعداد زوج از ارقام هگزادسیمال می‌آید که به عنوان دنباله‌ای از
بایت‌ها ذخیره می‌شوند؛ طول داده، تعداد بایت‌های حاصل است\&.
.br 
مثال:    \fBx7f000001\fP (آدرس IP برابر با 127\&.0\&.0\&.1)
.IP "\(dq\&"
در ادامه رشته‌ای می‌آید که با تبدیل‌های متداول 
\en \er \et \ef \eb \ea \ee \e0 استفاده می‌شود؛ رشته باید با \(cq\&\(dq\&\(cq بسته شود\&. لطفاً توجه
داشته باشید که نقل‌قول‌ها و بک‌اسلش‌ها باید از تبدیل شل و \fBsocat\fP اسکیپ
شوند\&. هیچ \e0 ضمنی به انتها اضافه نمی‌شود\&.
.br 
مثال:    \fB\(dq\&Hello world!\en\(dq\&\fP
.IP "\(cq\&"
یک تک‌نویسه، با تبدیل‌های معمول\&. لطفاً توجه داشته باشید که نقل‌قول‌ها
و بک‌اسلش‌ها باید از تبدیل شل و \fBsocat\fP اسکیپ شوند\&.
.br 
مثال:    \fB\(cq\&a\(cq\&\fP
آیتم‌های داده می‌توانند بدون نیاز به تکرار مجدد مشخص‌کننده نوع، با فضای خالی از
یکدیگر جدا شوند\&.
.IP "directory"
رشته‌ای با معنای معمول نام دایرکتوری در UN*X\&.
.IP "facility"
نام یک facility در syslog با نویسه‌های کوچک\&.
.IP "fdnum"
یک نوع int بدون علامت، خوانده‌شده با 
\f(CWstrtoul()\fP
، که یک توصیف‌گر فایل در UN*X را
مشخص می‌کند\&. 
.IP "filename"
رشته‌ای با معنای معمول نام فایل در UN*X\&.
.IP "group"
اگر اولین نویسه یک رقم ده‌دهی باشد، مقدار با
\f(CWstrtoul()\fP
به عنوان یک عدد صحیح بدون علامت که شناسه گروه را مشخص می‌کند خوانده می‌شود\&. در غیر این صورت،
باید نام یک گروه موجود باشد\&.
.IP "int"
عددی که از قوانین تابع 
\f(CWstrtol()\fP
با مبنای
\(dq\&0\(dq\& پیروی می‌کند، یعنی عدد ده‌دهی، عدد هشت‌هشتی با \(dq\&0\(dq\& آغازین، یا عدد هگزادسیمال
با \(dq\&0x\(dq\& آغازین\&. مقدار باید در یک int زبان C بگنجد\&.
.IP "interface"
رشته‌ای که نام دستگاه یک رابط شبکه را همان‌طور که توسط ifconfig
یا procan نشان داده می‌شود مشخص می‌کند، مانند \(dq\&eth0\(dq\&\&.
.IP "IP address"
یک آدرس IPv4 در نماد اعداد و نقطه، یک آدرس IPv6 در نماد هگزادسیمال
محصور در براکت، یا نام میزبانی که به یک آدرس IPv4 یا یک
آدرس IPv6 تبدیل می‌شود\&.
.br 
مثال‌ها: 127\&.0\&.0\&.1، [::1]، www\&.dest\-unreach\&.org، dns1
.IP "IPv4 address"
یک آدرس IPv4 در نماد اعداد و نقطه یا نام میزبانی که به
یک آدرس IPv4 تبدیل می‌شود\&.
.br 
مثال‌ها: 127\&.0\&.0\&.1، www\&.dest\-unreach\&.org، dns2
.IP "IPv6 address"
یک آدرس IPv6 در نماد ارقام هگز و دونقطه محصور در براکت، یا
نام میزبانی که به یک آدرس IPv6 تبدیل می‌شود\&.
.br 
مثال‌ها: [::1]، [1234:5678:9abc:def0:1234:5678:9abc:def0]،
ip6name\&.domain\&.org 
.IP "long"
عددی خوانده‌شده با 
\f(CWstrtol()\fP
\&. مقدار باید در یک long زبان C بگنجد\&.
.IP "long long"
عددی خوانده‌شده با 
\f(CWstrtoll()\fP
\&. مقدار باید در یک long long زبان C بگنجد\&.
.IP "off_t"
یک عدد علامت‌دار وابسته به پیاده‌سازی، معمولاً ۳۲ بیتی، خوانده‌شده با strtol
یا strtoll\&.
.IP "off64_t"
یک عدد علامت‌دار وابسته به پیاده‌سازی، معمولاً ۶۴ بیتی، خوانده‌شده با strtol
یا strtoll\&.
.IP "mode_t"
یک عدد صحیح بدون علامت، خوانده‌شده با 
\f(CWstrtoul()\fP
، مشخص‌کننده بیت‌های حالت (مجوز)\&. 
.IP "pid_t"
عددی خوانده‌شده با 
\f(CWstrtol()\fP
، مشخص‌کننده شناسه فرآیند\&.
.IP "port"
یک uint16_t (عدد ۱۶ بیتی بدون علامت) مشخص‌کننده درگاه TCP یا UDP، خوانده‌شده
با 
\f(CWstrtoul()\fP
\&.
.IP "protocol"
یک عدد ۸ بیتی بدون علامت، خوانده‌شده با 
\f(CWstrtoul()\fP
\&.
.IP "size_t"
یک عدد بدون علامت با محدودیت‌های size_t، خوانده‌شده با 
\f(CWstrtoul\fP
\&.
.IP "sockname"
آدرس سوکت\&. گزینه آدرس `bind\(cq را ببینید\&.
.IP "string"
دنباله‌ای از نویسه‌ها که شامل \(cq\&\e0\(cq\& نبوده و بسته به
موقعیت در خط فرمان، شامل \(cq\&:\(cq\&، \(cq\&,\(cq\& یا \(dq\&!!\(dq\& نباشد\&. توجه
داشته باشید که ممکن است لازم باشد نویسه‌های متا شل را در خط فرمان اسکیپ کنید\&.
.IP "TCP service"
نام یک سرویس که با رقم آغاز نمی‌شود و توسط
\f(CWgetservbyname()\fP
تبدیل می‌شود، یا یک عدد ۱۶ بیتی از نوع int بدون علامت خوانده‌شده با
\f(CWstrtoul()\fP
\&.
.IP "timeval"
یک عدد ممیز شناور با دقت مضاعف (double float) مشخص‌کننده ثانیه‌ها؛ عدد به یک
struct timeval شامل ثانیه و میکروثانیه نگاشت می‌شود\&.
.IP "timespec"
یک عدد ممیز شناور با دقت مضاعف (double float) مشخص‌کننده ثانیه‌ها؛ عدد به یک
struct timespec شامل ثانیه و نانوثانیه نگاشت می‌شود\&.
.IP "UDP service"
نام یک سرویس که با رقم آغاز نمی‌شود و توسط
\f(CWgetservbyname()\fP
تبدیل می‌شود، یا یک عدد ۱۶ بیتی از نوع int بدون علامت خوانده‌شده با
\f(CWstrtoul()\fP
\&.
.IP "unsigned int"
عددی خوانده‌شده با 
\f(CWstrtoul()\fP
\&. مقدار باید در یک unsigned int زبان C بگنجد\&. 
.IP "user"
اگر اولین نویسه یک رقم ده‌دهی باشد، مقدار با
\f(CWstrtoul()\fP
به عنوان یک عدد صحیح بدون علامت مشخص‌کننده شناسه کاربر خوانده می‌شود\&. در غیر این صورت، باید
نام یک کاربر موجود باشد\&.
.IP "VSOCK cid"
یک uint32_t (عدد ۳۲ بیتی بدون علامت) مشخص‌کننده شناسه بافت VSOCK
(CID)، خوانده‌شده با 
\f(CWstrtoul()\fP
\&.
چندین آدرس ویژه وجود دارد: VMADDR_CID_ANY (\-1U) به معنای هر آدرسی
برای bind است؛ VMADDR_CID_HOST (2) آدرس شناخته‌شده میزبان است\&.
.IP "VSOCK port"
یک uint32_t (عدد ۳۲ بیتی بدون علامت) مشخص‌کننده درگاه VSOCK، خوانده‌شده
با 
\f(CWstrtoul()\fP
\&.

.PP 
.SH "مثالها (EXAMPLES)"

.PP 
\.LP
\.nf
\fBsocat \- TCP4:www.domain.org:80\fP
\.RE
\.fi
.IP 
داده‌ها را بین STDIO (\-) و یک
اتصال TCP4 به درگاه 80 از میزبان 
www\&.domain\&.org انتقال می‌دهد\&. این مثال منجر به برقراری یک اتصال تعاملی شبیه به
telnet یا netcat می‌شود\&. پارامترهای ترمینال stdin تغییر داده نمی‌شوند، بنابراین می‌توانید
رله را با ^D ببندید یا با ^C آن را متوقف کنید\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP4-LISTEN:www \\ 
TCP4:www.domain.org:www\fP
\.RE
\.fi
.IP 
یک هدایت‌کننده درگاه TCP ساده نصب می‌کند\&. با
TCP4\-LISTEN روی درگاه محلی \(dq\&www\(dq\& گوش می‌دهد تا زمانی که یک
اتصال وارد شود، آن را می‌پذیرد، سپس به میزبان راه دور
(TCP4) متصل می‌شود و انتقال داده را آغاز می‌کند\&. اتصال
دومی را نخواهد پذیرفت\&. 
.IP 
\.LP
\.nf
\fBsocat \-d \-d \-lmlocal2 \\
\.RS
\fBTCP4-LISTEN:80,bind=myaddr1,reuseaddr,fork,su=nobody,range=10.0.0.0/8 \\ 
TCP4:www.domain.org:80,bind=myaddr2\fP
\.RE
\.fi
.IP 
یک هدایت‌کننده درگاه TCP، که هر سمت آن به یک آدرس IP محلی دیگر متصل شده است
(bind)\&. این مثال با منشعب کردن (fork) یک فرآیند جدید
پس از هر 
\f(CWaccept()\fP
، تقریباً تعداد نامحدودی از اتصالات موازی یا متوالی را مدیریت می‌کند\&. این دستور با
تغییر کاربر (su) به کاربر 
nobody پس از fork، کمی امنیت فراهم می‌کند؛ فقط اتصالات از شبکه خصوصی 10
(range) را مجاز می‌داند؛ و به دلیل reuseaddr،
امکان راه‌اندازی مجدد فوری پس از خاتمه فرآیند اصلی را فراهم می‌کند، حتی اگر برخی سوکت‌های
فرزند به طور کامل بسته نشده باشند\&.
با گزینه \-lmlocal2، برنامه socat تا زمان رسیدن موفقیت‌آمیز به
حلقه accept لاگ‌ها را در stderr ثبت می‌کند\&. ثبت لاگ‌های بعدی با تسهیلات (facility)
برابر با local2 به syslog هدایت می‌شود\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP4-LISTEN:5555,fork,tcpwrap=script \\ 
EXEC:/bin/myscript,chroot=/home/sandbox,su-d=sandbox,pty,stderr\fP
\.RE
\.fi
.IP 
یک سرور ساده که اتصالات را می‌پذیرد
(TCP4\-LISTEN) و برای هر اتصال یک فرآیند
فرزند جدید منشعب (fork) می‌کند؛ هر فرزند به عنوان یک رله تکی عمل می‌کند\&. 
کلاینت باید با قوانین مربوط به نام فرآیند دیمون \(dq\&script\(dq\& در
/etc/hosts\&.allow و /etc/hosts\&.deny مطابقت داشته باشد، در غیر این صورت دسترسی آن رد می‌شود (ببینید \(dq\&man
5 hosts_access\(dq\&)\&.
برای اجرای (EXEC) برنامه، فرآیند فرزند
به \fB/home/sandbox\fP تغییر ریشه (chroot) می‌دهد،
به کاربر sandbox سوئیچ (su) می‌کند، و سپس برنامه
\fB/home/sandbox/bin/myscript\fP را آغاز می‌نماید\&. برنامه \fBSocat\fP و
myscript از طریق یک شبه‌ترمینال (pty) ارتباط برقرار می‌کنند؛ خروجی خطای استاندارد (stderr)
مربوط به myscript به stdout هدایت می‌شود،
بنابراین پیام‌های خطای آن از طریق \fBsocat\fP به کلاینت متصل انتقال می‌یابد\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBEXEC:"mail.sh target@domain.com",fdin=3,fdout=4 \\ 
TCP4:mail.relay.org:25,crnl,bind=alias1.server.org,mss=512\fP
\.RE
\.fi
.IP 
فایل \fBmail\&.sh\fP یک اسکریپت شل است که همراه با \fBsocat\fP توزیع شده و یک
کلاینت ساده 
SMTP را پیاده‌سازی می‌کند\&. این اسکریپت طوری برنامه‌ریزی شده است که روی توصیف‌گرهای فایل (FD) شماره ۳ (ورودی) و ۴ (خروجی) به زبان SMTP \(dq\&صحبت\(dq\& کند\&.
گزینه‌های fdin و fdout به \fBsocat\fP می‌گویند
که از این FDها برای برقراری ارتباط با 
برنامه استفاده کند\&. از آنجا که mail\&.sh ورودی و خروجی استاندارد (stdin و stdout) را به ارث می‌برد در حالی که \fBsocat\fP از
آن‌ها استفاده نمی‌کند، اسکریپت می‌تواند متن
نامه را از stdin بخواند\&. برنامه \fBSocat\fP آدرس alias1 را آدرس مبدأ محلی شما قرار می‌دهد
(bind)، به پایان‌دهی صحیح خطوط در شبکه رسیدگی می‌کند
(crnl) و حداکثر  
۵۱۲ بایت داده در هر بسته ارسال می‌نماید (mss)\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fB-,escape=0x0f \\ 
/dev/ttyS0,rawer,crnl\fP
\.RE
\.fi
.IP 
یک اتصال تعاملی را از طریق خط سریال باز می‌کند، مثلاً برای برقراری ارتباط با یک
مودم\&. گزینه rawer پارامترهای ترمینال کنسول و
ttyS0 را روی مقادیر کاربردی تنظیم می‌کند، و crnl 
به نویسه‌های صحیح خط جدید تبدیل می‌نماید\&. گزینه escape امکان
خاتمه دادن به فرآیند socat را با نویسه کنترل\-O فراهم می‌سازد\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBUNIX-LISTEN:/tmp/.X11-unix/X1,fork \\ 
SOCKS4:host.victim.org:127.0.0.1:6000,socksuser=nobody,sourceport=20\fP
\.RE
\.fi
.IP 
با UNIX\-LISTEN، برنامه \fBsocat\fP یک سوکت شنوا در دامنه یونیکس
در \fB/tmp/\&.X11\-unix/X1\fP باز می‌کند\&. این مسیر متناظر با
نمایشگر محلی :1 برنامه XWindow در دستگاه شماست، بنابراین اتصالات کلاینت XWindow به
DISPLAY=:1 پذیرفته می‌شوند\&. سپس \fBSocat\fP با
سرور SOCKS4 به آدرس host\&.victim\&.org ارتباط برقرار می‌کند که ممکن است به دلیل ضعفی
مربوط به FTP در فیلترهای ایستا IP خود، اتصالات مبتنی بر
sourceport 20 را مجاز بداند\&. برنامه \fBSocat\fP
وانمود می‌کند که توسط socksuser برابر با nobody اجرا شده است، و
درخواست اتصال به 
درگاه لوپ‌بک 6000 را می‌دهد (تنها پیکربندی‌های ضعیف sockd چنین اجازه‌ای را می‌دهند)\&. بنابراین اتصالی به
سرور XWindow قربانی به دست می‌آوریم و اگر نیازی به کوکی‌های MIT
یا احراز هویت کربروس نباشد، می‌توان کار را آغاز کرد\&. لطفاً توجه داشته باشید که در هر
لحظه فقط یک اتصال می‌تواند وجود داشته باشد، زیرا TCP تنها می‌تواند یک نشست را
با یک مجموعه معین از آدرس‌ها و درگاه‌ها برقرار کند\&.
.IP 
\.LP
\.nf
\fBsocat \-u \\
\.RS
\fB/tmp/readdata,seek-end=0,ignoreeof \\
\fBSTDIO\fP
\.RE
\.fi
.IP 
این مثالی برای انتقال داده یک‌طرفه
(\-u) است\&. برنامه \fBSocat\fP داده‌ها را از 
فایل /tmp/readdata (آدرس ضمنی GOPEN)، با شروع
از انتهای فعلی آن انتقال می‌دهد (گزینه seek\-end=0 به \fBsocat\fP اجازه می‌دهد 
خواندن را از انتهای فعلی فایل آغاز کند؛ از seek=0 یا عدم استفاده از گزینه
seek برای خواندن داده‌های موجود در ابتدا استفاده کنید) در حالتی شبیه به \(dq\&tail \-f\(dq\&
(ignoreeof)\&. این \(dq\&فایل\(dq\& 
می‌تواند یک سوکت شنوا در دامنه یونیکس نیز باشد (در این صورت از گزینه seek استفاده نکنید)\&. 
.IP 
\.LP
\.nf
\fB(sleep 5; echo PASSWORD; sleep 5; echo ls; sleep 1) | \\
\fBsocat \- \\
\.RS
\fBEXEC:'ssh \-l user server',pty,setsid,ctty\fP
\.RE
\.fi
.IP 
یک نشست ssh به سرور را با EXEC اجرا می‌کند\&. از یک pty برای ارتباط میان \fBsocat\fP و
ssh استفاده می‌کند، آن را به tty کنترلی ssh تبدیل می‌نماید (ctty)، 
و این pty را مالک
یک گروه فرآیند جدید می‌کند (setsid)، بنابراین ssh رمز عبور را از \fBsocat\fP می‌پذیرد\&.
.IP 
\.LP
\.nf
\fBsocat \-u \\
\.RS
\fBTCP4-LISTEN:3334,reuseaddr,fork \\ 
OPEN:/tmp/in.log,creat,append\fP
\.RE
\.fi
.IP 
یک جمع‌آوری‌کننده پیام مبتنی بر شبکه ساده را پیاده‌سازی می‌کند\&. 
برای هر کلاینت که به درگاه 3334 متصل می‌شود، یک فرآیند فرزند جدید تولید می‌گردد (گزینه fork)\&.
تمام داده‌های ارسال‌شده توسط کلاینت‌ها به انتهای فایل /tmp/in\&.log افزوده (append) می‌شوند\&.
اگر فایل وجود نداشته باشد، socat آن را ایجاد (creat) می‌کند\&. 
گزینه reuseaddr اجازه راه‌اندازی مجدد فوری فرآیند سرور
را می‌دهد\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBPTY,link=$HOME/dev/vmodem0,rawer,wait-slave \\ 
EXEC:'"ssh modemserver.us.org socat \- /dev/ttyS0,nonblock,rawer"'\fP
\.RE
\.fi
.IP 
یک دستگاه شبه‌ترمینال 
(PTY) در کلاینت ایجاد می‌کند که تحت
پیوند نمادین \fB$HOME/dev/vmodem0\fP قابل دسترسی است\&. 
برنامه‌ای که انتظار یک خط سریال یا مودم را دارد
می‌تواند برای استفاده از \fB$HOME/dev/vmodem0\fP پیکربندی شود؛ ترافیک آن از طریق ssh
به یک modemserver هدایت می‌شود که در آنجا نمونه دیگری از socat آن را به
\fB/dev/ttyS0\fP متصل می‌کند\&.
.IP 
\.LP
\.nf
\fBsudo socat \-\-experimental \\
\.RS
\fBTCP4-LISTEN:8000,reuseaddr,fork,netns=namespace1 \\ 
TCP4-CONNECT:server2:8000\fP
\.RE
\.fi
.IP 
یک شنونده در فضای نام شبکه داده‌شده ایجاد می‌کند که اتصالات TCP
را روی درگاه 8000 می‌پذیرد و آن‌ها را به server2 هدایت می‌نماید\&.
.IP 
\.LP
\.nf
\fBsudo socat \-\-experimental \\
\.RS
\fBTUN:192.168.2.1/24,up \\ 
TUN:192.168.2.2/24,up,netns=namespace2\fP
\.RE
\.fi
.IP 
دو رابط شبکه مجازی ایجاد می‌کند، یکی در فضای نام پیش‌فرض و دیگری
در namespace2، و بسته‌ها را میان آن‌ها هدایت می‌کند که به عنوان یک اتصال شبکه
مجازی عمل می‌نماید\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP4-LISTEN:2022,reuseaddr,fork \\ 
PROXY:proxy.local:www.domain.org:22,proxyport=3128,proxyauth=username:s3cr3t\fP
\.RE
\.fi
.IP 
یک هدایت‌کننده را آغاز می‌کند که اتصالات را روی درگاه 2022 می‌پذیرد و آن‌ها را 
از طریق دیمون پروکسی که روی درگاه 3128
(proxyport) در میزبان proxy\&.local گوش می‌دهد، با استفاده از روش
CONNECT هدایت می‌کند؛ جایی که به عنوان \(dq\&username\(dq\& با \(dq\&s3cr3t\(dq\&
احراز هویت می‌شوند (proxyauth)\&. سپس proxy\&.local
باید اتصالات به میزبان www\&.domain\&.org را روی درگاه 22 برقرار کند\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBSSL:server:4443,cafile=./server.crt,cert=./client.pem\fP
\.RE
\.fi
.IP 
یک کلاینت OpenSSL است که تلاش می‌کند یک اتصال امن به یک سرور SSL
برقرار کند\&. گزینه cafile فایلی را مشخص می‌کند که
شامل گواهی‌های قابل اعتماد است: ما تنها زمانی به سرور اعتماد می‌کنیم که یکی از
این گواهی‌ها را ارائه دهد و اثبات کند که کلید خصوصی مربوطه را در اختیار دارد\&. 
در غیر این صورت اتصال قطع می‌شود\&.
با cert فایلی حاوی گواهی کلاینت
و کلید خصوصی مربوطه مشخص می‌شود\&. این مورد زمانی لازم است که
سرور مایل به احراز هویت کلاینت باشد؛ بسیاری از سرورهای اینترنتی چنین نمی‌خواهند\&.
.br 
آدرس نخست (\(cq\&\-\(cq\&) می‌تواند با تقریباً هر آدرس socat دیگری جایگزین شود\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBOPENSSL-LISTEN:4443,reuseaddr,pf=ip4,fork,cert=./server.pem,cafile=./client.crt \\ 
PIPE\fP
\.RE
\.fi
.IP 
یک سرور OpenSSL است که اتصالات TCP را می‌پذیرد، گواهی را از
فایل server\&.pem ارائه می‌دهد و کلاینت را وادار می‌کند گواهی‌ای را ارائه دهد که
در برابر cafile\&.crt اعتبارسنجی می‌شود\&.
.br 
آدرس دوم (\(cq\&PIPE\(cq\&) می‌تواند با تقریباً هر آدرس socat دیگری
جایگزین شود\&.
.br 
برای مشاهده دستورالعمل‌های تولید و توزیع کلیدها و گواهی‌های OpenSSL،
مستندات تکمیلی socat با نام \f(CWsocat\-openssl\&.txt\fP را ببینید\&.
.IP 
\.LP
\.nf
\fBecho |
socat \-u \- \\
\.RS
\fBFILE:/tmp/bigfile,create,largefile,seek=100000000000\fP
\.RE
\.fi
.IP 
یک فایل تنک (sparse file) به اندازه ۱۰۰ گیگابایت به اضافه ۱ بایت ایجاد می‌کند؛ این کار نیازمند نوعی از سیستم‌فایل است که
از آن پشتیبانی کند (ext2، ext3، ext4، reiserfs، xfs؛ نه minix یا vfat)\&. عملیات
نوشتن ۱ بایت ممکن است زمان‌بر باشد (در reiserfs: چند دقیقه؛ در ext2: بدون زمان یا آنی)، و
فایل حاصل می‌تواند تنها با inodeهای خود مقداری فضای دیسک مصرف کند (در reiserfs: حدود
۲ مگابایت؛ در ext2: حدود ۱۶ کیلوبایت)\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP-L:7777,reuseaddr,fork \\ 
SYSTEM:'filan \-i 0 \-s >&2',nofork\fP
\.RE
\.fi
.IP 
برای اتصالات ورودی TCP روی درگاه 7777 گوش می‌دهد\&. برای هر اتصال
پذیرفته‌شده، یک شل را فراخوانی می‌کند\&. ورودی و خروجی استاندارد این شل مستقیماً
به سوکت TCP متصل است (nofork)\&. شل برنامه filan را اجرا می‌کند و به آن اجازه می‌دهد آدرس‌های سوکت را در
stderr (پنجره ترمینال شما) چاپ کند\&.
.IP 
\.LP
\.nf
\fBecho \-e "\\0\\14\\0\\0\\c" |
socat \-u \- \\
\.RS
\fBFILE:/usr/bin/squid.exe,seek=0x00074420\fP
\.RE
\.fi
.IP 
به عنوان یک ویرایشگر باینری ابتدایی عمل می‌کند: ۴ بایت 000 014 000 000 را در
فایل اجرایی /usr/bin/squid\&.exe در آفست 0x00074420 می‌نویسد (این یک وصله واقعی
برای اجرای فایل اجرایی squid کامپایل‌شده در Cygwin تحت ویندوز، در سال ۲۰۰۴ بود)\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBTCP:www.blackhat.org:31337,readbytes=1000\fP
\.RE
\.fi
.IP 
به یک سرویس ناشناخته متصل می‌شود و از سرریز شدن با داده‌ها (flooded) جلوگیری می‌کند\&.
.IP 
\.LP
\.nf
\fBsocat \-U \\
\.RS
\fBTCP:target:9999,end-close \\ 
TCP-L:8888,reuseaddr,fork\fP
\.RE
\.fi
.IP 
داده‌های دریافتی از جریان‌های مختلف TCP روی درگاه 8888 را تنها به یک جریان
به سمت target:9999 ادغام می‌کند\&. گزینه end\-close از خاتمه یافتن اتصال
اشتراکی به 9999 توسط فرآیندهای فرزند منشعب‌شده از آدرس دوم جلوگیری می‌کند (close(2) صرفاً پیوند inode را حذف می‌کند که تا زمانی
که فرآیند والد زنده است فعال می‌ماند؛ در حالی که shutdown(2) فعالانه اتصال
را خاتمه می‌دهد)\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP-LISTEN:10021,reuseaddr,socktype=6,protocol=33,fork \PIPE\fP
\.RE
\.fi
.IP 
یک سرور اکوی ساده DCCP است\&. پروتکل DCCP اکنون مستقیماً در \fBsocat\fP تدارک دیده شده است،
با این حال این مثال نشان می‌دهد چگونه می‌توان از رویه‌های TCP در \fBsocat\fP استفاده کرد و
نوع سوکت را به SOCK_DCCP=6 (در لینوکس) و پروتکل IP را به IPPROTO_DCCP=33 تغییر داد\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBTCP:<server>:10021,reuseaddr,socktype=6,protocol=33,fork\fP
\.RE
\.fi
.IP 
یک کلاینت ساده DCCP است\&. پروتکل DCCP اکنون مستقیماً در \fBsocat\fP تدارک دیده شده است،
با این حال این مثال نشان می‌دهد چگونه می‌توان از رویه‌های TCP در \fBsocat\fP استفاده کرد اما
نوع سوکت را به SOCK_DCCP=6 (در لینوکس) و پروتکل IP را به IPPROTO_DCCP=33 تغییر داد\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBUDP4-DATAGRAM:192.168.1.0:123,sp=123,broadcast,range=192.168.1.0/24\fP
\.RE
\.fi
.IP 
یک پخش همگانی (broadcast) به شبکه 192\&.168\&.1\&.0/24 ارسال می‌کند و پاسخ‌های سرورهای زمانی
موجود در آنجا را دریافت می‌نماید\&. بسته‌های NTP دریافتی از میزبان‌های خارج از این شبکه نادیده گرفته می‌شوند\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBSOCKET-DATAGRAM:2:2:17:x007bxc0a80100x0000000000000000,bind=x007bx00000000x0000000000000000,setsockopt-int=1:6:1,range=x0000xc0a80100x0000000000000000:x0000xffffff00x0000000000000000\fP
\.RE
\.fi
.IP 
از نظر معنایی معادل مثال
قبلی است، اما تمام پارامترها به
شکل جنریک مشخص شده‌اند\&. مقدار 6 در setsockopt\-int مقدار لینوکسی برای
\f(CWSO_BROADCAST\fP است\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBIP4-DATAGRAM:255.255.255.255:44,broadcast,range=10.0.0.0/8\fP
\.RE
\.fi
.IP 
با استفاده از پروتکل 44 یک پخش همگانی (broadcast) به شبکه(های) محلی ارسال می‌کند\&. تنها پاسخ‌های
مربوط به محدوده آدرس خصوصی را می‌پذیرد\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBUDP4-DATAGRAM:224.255.0.1:6666,bind=:6666,ip-add-membership=224.255.0.1:eth0\fP
\.RE
\.fi
.IP 
داده‌ها را از stdin با استفاده از UDP به آدرس چندپخشی (multicast) مشخص‌شده انتقال می‌دهد\&. هر دو
درگاه محلی و راه دور 6666 هستند\&. به رابط eth0 اعلام می‌کند که بسته‌های
چندپخشی گروه داده‌شده را نیز بپذیرد\&. چندین میزبان در شبکه محلی می‌توانند
این دستور را اجرا کنند، بنابراین تمام داده‌های ارسال‌شده توسط هر یک از میزبان‌ها توسط
سایر آن‌ها دریافت خواهد شد\&. توجه داشته باشید که دلایل احتمالی بسیاری برای بروز خطا وجود دارد،
از جمله فیلترهای IP، مسائل مسیریابی، انتخاب رابط اشتباه توسط
سیستم‌عامل، پل‌ها (bridges)، یا یک سوئیچ با پیکربندی نامناسب\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBUDP:host2:4443 \\ 
TUN:192.168.255.1/24,up\fP
\.RE
\.fi
.IP 
یک سمت از یک شبکه مجازی (اما نه خصوصی!) را با host2 برقرار می‌کند که ممکن است فرآیند
مشابهی با UDP\-L و آدرس tun برابر با 192\&.168\&.255\&.2 در آنجا اجرا شود\&. آن‌ها می‌توانند
با استفاده از آدرس‌های 192\&.168\&.255\&.1 و 192\&.168\&.255\&.2 به یکدیگر دسترسی پیدا کنند\&. توجه داشته باشید که
جریان‌سازی به عنوان مثال از طریق TCP یا SSL حفظ مرزهای بسته را تضمین نمی‌کند و
بنابراین ممکن است باعث از دست رفتن بسته‌ها شود\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBVSOCK-CONNECT:2:1234\fP
\.RE
\.fi
.IP 
یک اتصال VSOCK با میزبان (میزبان همواره با
CID=2 شناخته‌شده قابل دسترسی است) روی درگاه 1234 برقرار می‌کند\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBVSOCK-LISTEN:1234\fP
\.RE
\.fi
.IP 
روی درگاه 1234 منتظر یک اتصال VSOCK می‌ماند\&.
.IP 
\.LP
\.nf
\fBsocat \- \\
\.RS
\fBVSOCK-CONNECT:31:4321,bind:5555\fP
\.RE
\.fi
.IP 
یک اتصال VSOCK با سیستم میهمان دارای CID=31 روی درگاه 4321 برقرار می‌کند،
و سوکت محلی را به درگاه 5555 متصل (bind) می‌نماید\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBVSOCK-LISTEN:3333,reuseaddr,fork \\ 
VSOCK-CONNECT:42,3333\fP
\.RE
\.fi
.IP 
یک هدایت‌کننده را آغاز می‌کند که اتصالات VSOCK را روی درگاه 3333 می‌پذیرد، و آن‌ها را
به سیستم میهمان با CID=42 روی همان درگاه هدایت می‌نماید\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBVSOCK-LISTEN:22,reuseaddr,fork \\ 
TCP:localhost:22\fP
\.RE
\.fi
.IP 
اتصالات VSOCK را از درگاه 22 به سرور SSH محلی هدایت می‌کند\&.
اجرای این دستور در یک VM به شما امکان می‌دهد از طریق SSH با استفاده از VSOCK از میزبان متصل شوید،
همان‌طور که در مثال زیر آمده است\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP4-LISTEN:22222,reuseaddr,fork \\ 
VSOCK-CONNECT:33:22\fP
\.RE
\.fi
.IP 
اتصالات TCP را از درگاه 22222 به سیستم میهمان با CID=33 که روی
درگاه 22 در VSOCK گوش می‌دهد هدایت می‌کند\&.
اجرای این دستور در میزبان، در صورتی که سیستم میهمان مثال بالا را اجرا کرده باشد، به شما امکان می‌دهد با اجرای
\(dq\&ssh \-p 22222 user@localhost\(dq\& از طریق SSH متصل شوید\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBPTY,link=/var/run/ppp,rawer \\ 
INTERFACE:hdlc0\fP
\.RE
\.fi
.IP 
این مشکل را که pppd به یک دستگاه سریال نیاز دارد و بنابراین ممکن است نتواند
روی یک خط همگام که با یک دستگاه شبکه نشان داده می‌شود کار کند، دور می‌زند\&.
برنامه socat یک PTY برای راضی نگه داشتن pppd ایجاد می‌کند، به رابط شبکه
\f(CWhdlc0\fP متصل (bind) می‌شود، و می‌تواند داده‌ها را میان
هر دو دستگاه انتقال دهد\&. سپس از pppd روی دستگاه \f(CW/var/run/ppp\fP استفاده کنید\&.
.IP 
\.LP
\.nf
\fBsocat \-u \\
\.RS
\fBSTDIO \\ 
POSIXMQ-SEND:/queue1,unlink-early,mq-prio=10\fP
\.RE
\.fi
.IP 
بسته‌های خوانده‌شده از stdio (یعنی خطوط ورودی در هنگام اجرای تعاملی) را
با اولویت ۱۰ درون صف پیام پازیکس (POSIX message queue) می‌نویسد\&.
.IP 
\.LP
\.nf
\fBsocat \-u \\
\.RS
\fBPOSIXMQ-RECV:/queue1,fork,max-children=3 \\ 
SYSTEM:"worker.sh"\fP
.IP 
\.RE
\.fi
.IP 
پیام‌ها (بسته‌ها) را از صف پیام پازیکس دریافت می‌کند و به ازای هر پیام،
یک زیرفرآیند منشعب می‌کند که پیام را خوانده و پردازش می‌نماید\&. در یک زمان حداکثر ۳
زیرفرآیند مجاز هستند\&.
.IP 
\.LP
\.nf
\fBsocat \-T 1 \-d \-d \\
\.RS
\fBTCP-L:10081,reuseaddr,fork,crlf \\ 
SYSTEM:"echo \-e \\"\\\\\\"HTTP/1.0 200 OK\\\\\\nDocumentType: text/plain\\\\\\n\\\\\\ndate: \\$\\(date\\)\\\\\\nserver:\\$SOCAT_SOCKADDR:\\$SOCAT_SOCKPORT\\\\\\nclient: \\$SOCAT_PEERADDR:\\$SOCAT_PEERPORT\\\\\\n\\\\\\"\\"; cat; echo \-e \\"\\\\\\"\\\\\\n\\\\\\"\\""\fP
\.RE
\.fi
.IP 
یک سرور اکوی بسیار ابتدایی HTTP ایجاد می‌کند: هر کلاینت HTTP که متصل می‌شود یک پاسخ معتبر
HTTP دریافت می‌کند که حاوی اطلاعاتی درباره آدرس و درگاه کلاینت همان‌گونه که توسط
سرور میزبان دیده می‌شود، آدرس میزبان (که ممکن است در سرورهای چندخانه‌ای متفاوت باشد)،
و درخواست اصلی کلاینت است\&.
.IP 
\.LP
\.nf
\fBsocat \-d \-d \\
\.RS
\fBUDP4-RECVFROM:9999,so-broadcast,so-timestamp,ip-pktinfo,ip-recverr,ip-recvopts,ip-recvtos,ip-recvttl!!- \\ 
SYSTEM:'export; sleep 1' |\fP
\.RE
\fBgrep SOCAT\fP
\.RE
\.fi
.IP 
روی درگاه 9999 منتظر یک بسته ورودی UDP می‌ماند و متغیرهای محیطی
ارائه‌شده توسط socat را چاپ می‌کند\&. در سیستم‌های مبتنی بر BSD باید
\f(CWip\-pktinfo\fP را با \f(CWip\-recvdstaddr\fP,\f(CWip\-recvif\fP جایگزین کنید\&. به ویژه متغیر
SOCAT_IP_DSTADDR جالب توجه است: این متغیر حاوی آدرس مقصد بسته است که ممکن است یک
آدرس تک‌پخشی (unicast)، چندپخشی (multicast)، یا پخش همگانی (broadcast) باشد\&.
.IP 
\.LP
\.nf
\fBecho \-e "M-SEARCH * HTTP/1.1\\nHOST: 239.255.255.250:1900\\nMAN: \\"ssdp:discover\\"\\nMX: 4\\nST: \\"ssdp:all\\"\\n" |
socat \- \\
\.RS
\fBUDP-DATAGRAM:239.255.255.250:1900,crlf\fP
\.RE
\.fi
.IP 
یک پرس‌وجوی پروتکل SSDP (پروتکل ساده کشف سرویس) را به شبکه محلی ارسال می‌کند
و پاسخ‌های دریافت‌شده را جمع‌آوری کرده و در خروجی نمایش می‌دهد\&.
.IP 
\.LP
\.nf
\fBsystemd-socket-activate \-l 1077 \-\-inetd socat ACCEPT:0,fork PIPE\fP
\.RE
\.fi
.IP 
ابزار \f(CWsystemd\-socket\-activate\fP برنامه‌ای برای آزمایش فعال‌سازی سوکت
دیمون‌ها در \f(CWsystemd\fP است\&. با گزینه \f(CW\-\-inetd\fP منتظر یک اتصال روی
درگاه مشخص‌شده می‌ماند\&. اتصال را نمی‌پذیرد بلکه توصیف‌گر فایل شنوا را
به عنوان FDهای 0 و 1 ارسال می‌کند\&. برنامه \fBSocat\fP اتصال در حال انتظار را پذیرفته و
انتقال داده را آغاز می‌کند\&.
.IP 
.IP "\fB\f(CW\fP\fP"

.IP 
.SH "عیبیابی (DIAGNOSTICS)"

.PP 
برنامه \fBSocat\fP از یک سازوکار ثبت لاگ استفاده می‌کند که امکان فیلتر کردن پیام‌ها بر اساس شدت را فراهم می‌سازد\&. سطوح
شدت ارائه‌شده کم‌وبیش با اولویت مربوطه در syslog
سازگار هستند\&. با یک یا حداکثر چهار بار استفاده از گزینه خط فرمان \-d، پایین‌ترین
اولویت پیام‌های صادرشده را می‌توان انتخاب کرد\&. هر پیام
شامل یک نویسه بزرگ است که شدت پیام را مشخص می‌کند (یکی از
حروف F، E، W، N، I، یا D)
.PP 
.IP "FATAL:"
شرایطی که مستلزم پایان فوری و بدون قیدوشرط برنامه است\&.
.IP "ERROR:"
شرایطی که مانع از پردازش صحیح برنامه می‌شود\&. معمولاً
برنامه خاتمه می‌یابد (گزینه \-s را ببینید)\&.
.IP "WARNING:"
چیزی به درستی کار نکرده است یا در وضعیتی قرار دارد که
ادامه پردازش صحیح قابل تضمین نیست، اما ممکن است امکان‌پذیر باشد\&.
.IP "NOTICE:"
اقدامات جالب توجه برنامه، برای مثال برای نظارت بر \fBsocat\fP در انواعی از حالت‌های سرور\&.
.IP "INFO:"
توصیف کارهایی که برنامه انجام می‌دهد و شاید چرایی رخ دادن
آن‌ها\&. امکان نظارت بر چرخه حیات توصیف‌گرهای فایل را فراهم می‌کند\&.
.IP "DEBUG:"
توصیف نحوه کارکرد برنامه، تمام فراخوانی‌های سیستم یا کتابخانه و نتایج آن‌ها\&.

.PP 
پیام‌های لاگ را می‌توان در stderr، یک فایل، یا syslog نوشت\&.
.PP 
در هنگام خروج، اگر \fBsocat\fP به دلیل رسیدن به پایان فایل (EOF) یا مهلت عدم فعالیت
خاتمه یافته باشد وضعیت 0 را برمی‌گرداند؛ در صورت بروز خطا یک مقدار مثبت، و در صورت بروز خطای
مهلک یک مقدار منفی بازمی‌گرداند\&. 
.PP 
.SH "فایلها (FILES)"

.PP 
/usr/bin/socat 
.br 
/usr/bin/filan 
.br 
/usr/bin/procan
.PP 
.SH "سیگنالها (SIGNALS)"

.PP 
.IP "SIGUSR1:"
باعث ثبت آمار انتقال فعلی در لاگ می‌شود\&.
.br 
همچنین گزینه \-\-statistics را ببینید

.PP 
.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"

.PP 
متغیرهای ورودی اطلاعات را از محیط به socat منتقل می‌کنند، و متغیرهای
خروجی توسط socat برای استفاده در اسکریپت‌ها و برنامه‌های اجراشده تنظیم می‌شوند\&.
.PP 
در متغیرهای خروجی که با \(dq\&SOCAT\(dq\& آغاز می‌شوند، این پیشوند در واقع با
نام بزرگِ فایل اجرایی یا مقدار گزینه
\-lp جایگزین می‌شود\&.
.PP 
.IP "\fBSOCAT_DEFAULT_LISTEN_IP\fP (input)"
(مقادیر 4 یا 6) نسخه IP مورد استفاده را برای
آدرس‌های listen، recv، و recvfrom در صورتی که هیچ
گزینه pf (خانواده پروتکل) داده نشده باشد، تعیین می‌کند\&. توسط
گزینه‌های \-4 یا \-6 در socat بازنویسی (override) می‌شود\&.
.IP 
.IP "\fBSOCAT_PREFERRED_RESOLVE_IP\fP (input)"
(مقادیر 0، 4، یا 6) نسخه IP مورد استفاده
را هنگام حل نام‌های میزبان هدف در صورتی که نسخه توسط نوع آدرس، گزینه pf (خانواده پروتکل)، یا
قالب آدرس مشخص نشده باشد، تعیین می‌کند\&. اگر تبدیل نام ورودی مطابقتی برنگرداند، اولین
نتیجه (با نسخه IP متفاوت) انتخاب می‌شود\&. با مقدار 0، برنامه socat همواره اولین
رکورد و نسخه IP آن را انتخاب می‌کند\&. 
.IP 
.IP "\fBSOCAT_MAIN_WAIT\fP (input)"
مدت زمانی (ثانیه) را برای به خواب رفتن
فرآیند اصلی در آغاز تابع main\e() مشخص می‌کند\&. برای اشکال‌زدایی مفید است\&.
.IP 
.IP "\fBSOCAT_TRANSFER_WAIT\fP (input)"
مدت زمانی (ثانیه) را برای به خواب رفتن
فرآیند پس از باز کردن آدرس‌ها و پیش از ورود به حلقه انتقال مشخص می‌کند\&. برای
اشکال‌زدایی مفید است\&.
.IP 
.IP "\fBSOCAT_FORK_WAIT\fP (input)"
مدت زمانی (ثانیه) را برای به خواب رفتن
فرآیندهای والد و فرزند پس از یک fork() موفقیت‌آمیز مشخص می‌کند\&. برای
اشکال‌زدایی مفید است\&.
.IP 
.IP "\fBSOCAT_VERSION\fP (output)"
برنامه Socat این متغیر را روی رشته نسخه خود تنظیم می‌کند،
مانند \f(CW\(dq\&1\&.7\&.0\&.0\(dq\&\fP برای نسخه‌های منتشرشده یا مثلاً \f(CW\(dq\&1\&.6\&.0\&.1+envvar\(dq\&\fP برای
نسخه‌های موقت؛ می‌تواند در اسکریپت‌های فراخوانی‌شده توسط socat استفاده شود\&. 
.IP 
.IP "\fBSOCAT_PID\fP (output)"
برنامه Socat این متغیر را روی شناسه فرآیند خود تنظیم می‌کند\&. در صورت
استفاده از گزینه آدرس fork، متغیر SOCAT_PID شناسه فرآیندهای فرزند را
دریافت می‌کند\&. عمل Fork برای exec، system، و
SHELL مقدار SOCAT_PID را تغییر نمی‌دهد\&.
.IP 
.IP "\fBSOCAT_PPID\fP (output)"
برنامه Socat این متغیر را روی شناسه فرآیند خود تنظیم می‌کند\&. در
صورت fork، متغیر SOCAT_PPID شناسه فرآیند اصلی را حفظ می‌کند\&.
.IP 
.IP "\fBSOCAT_PEERADDR\fP (output)"
در آدرس‌های سوکت غیرفعال (تمام آدرس‌های LISTEN و
RECVFROM)، این متغیر روی رشته‌ای تنظیم می‌شود که آدرس سوکت طرف
مقابل را توصیف می‌کند\&. اطلاعات درگاه شامل آن نمی‌شود\&.
.IP 
.IP "\fBSOCAT_PEERPORT\fP (output)"
در آدرس‌های سوکت غیرفعال مناسب
(TCP، UDP، و SCTP \- LISTEN و RECVFROM)، این متغیر روی رشته‌ای حاوی
شماره درگاه طرف مقابل تنظیم می‌شود\&.
.IP 
.IP "\fBSOCAT_SOCKADDR\fP (output)"
در تمام آدرس‌های LISTEN، این متغیر
روی رشته‌ای تنظیم می‌شود که آدرس سوکت محلی را توصیف می‌کند\&. اطلاعات درگاه
شامل آن نمی‌شود\&.
.IP 
.IP "\fBSOCAT_SOCKPORT\fP (output)"
در آدرس‌های TCP\-LISTEN،
UDP\-LISTEN، و
SCTP\-LISTEN، این متغیر روی درگاه
محلی تنظیم می‌شود\&.
.IP 
.IP "\fBSOCAT_TIMESTAMP\fP (output)"
در تمام آدرس‌های RECVFROM که در آن‌ها گزینه
آدرس so\-timestamp اعمال شده باشد، socat این
متغیر را روی برچسب زمانی حاصل تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_OPTIONS\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4 که در آن‌ها
گزینه آدرس ip\-recvopts اعمال شده باشد، socat این
متغیر را با گزینه‌های IP بسته دریافت‌شده پر می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_DSTADDR\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4 که در آن‌ها
گزینه آدرس ip\-recvdstaddr (در BSD) یا
ip\-pktinfo (در سایر پلتفرم‌ها) اعمال شده باشد، socat این
متغیر را روی آدرس مقصد بسته دریافت‌شده تنظیم می‌کند\&. این به ویژه
برای شناسایی بسته‌های با آدرس پخش همگانی و چندپخشی مفید است\&.
.IP 
.IP "\fBSOCAT_IP_IF\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4 که در آن‌ها
گزینه آدرس ip\-recvif (در BSD) یا
ip\-pktinfo (در سایر پلتفرم‌ها) اعمال شده باشد، socat این
متغیر را روی نام رابطی که بسته در آن دریافت شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_LOCADDR\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4
که در آن‌ها گزینه آدرس ip\-pktinfo اعمال شده باشد،
socat این متغیر را روی آدرس رابطی که بسته در آن دریافت شده
تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_TOS\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4 که در آن‌ها
گزینه آدرس ip\-recvtos اعمال شده باشد، socat این
متغیر را روی TOS (نوع سرویس) بسته دریافت‌شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_TTL\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv4 که در آن‌ها
گزینه آدرس ip\-recvttl اعمال شده باشد، socat این
متغیر را روی TTL (طول عمر) بسته دریافت‌شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_HOPLIMIT\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv6
که در آن‌ها گزینه آدرس ipv6\-recvhoplimit اعمال
شده باشد، socat این متغیر را روی مقدار hoplimit بسته دریافت‌شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_DSTADDR\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv6
که در آن‌ها گزینه آدرس ipv6\-recvpktinfo
اعمال شده باشد، socat این متغیر را روی آدرس مقصد بسته دریافت‌شده
تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_TCLASS\fP (output)"
در تمام آدرس‌های RECVFROM مبتنی بر IPv6
که در آن‌ها گزینه آدرس ipv6\-recvtclass اعمال شده باشد،
\fBsocat\fP این متغیر را روی کلاس انتقال بسته دریافت‌شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_OPENSSL_X509_ISSUER\fP (output)"
فیلد Issuer (صادرکننده) از گواهی طرف مقابل
.IP 
.IP "\fBSOCAT_OPENSSL_X509_SUBJECT\fP (output)"
فیلد Subject (موضوع) از گواهی طرف مقابل
.IP 
.IP "\fBSOCAT_OPENSSL_X509_COMMONNAME\fP (output)"
ورودی‌های commonName از موضوع گواهی طرف مقابل\&. مقادیر چندگانه با \(dq\& // \(dq\& از هم جدا می‌شوند\&.
.IP 
.IP "\fBSOCAT_OPENSSL_X509_*\fP (output)"
تمام ورودی‌های دیگر از موضوع گواهی طرف مقابل
.IP 
.IP "\fBSOCAT_OPENSSL_X509V3_DNS\fP (output)"
ورودی‌های DNS از افزونه‌های گواهی طرف مقابل \- فیلد subjectAltName\&. مقادیر چندگانه با \(dq\& // \(dq\& از هم جدا می‌شوند\&.
.IP 
.IP "\fBHOSTNAME\fP (input)"
برای تعیین نام میزبان جهت ثبت لاگ استفاده می‌شود (گزینه
\-lh را ببینید)\&.
.IP 
.IP "\fBLOGNAME\fP (input)"
به عنوان نام کاربری کلاینت socks در صورتی که هیچ
socksuser مشخص نشده باشد، استفاده می‌شود\&.
.br 
با گزینه‌های su و
su\-d، مقدار LOGNAME روی نام کاربری داده‌شده تنظیم می‌شود\&.
.IP 
.IP "\fBUSER\fP (input)"
به عنوان نام کاربری کلاینت socks در صورتی که هیچ
socksuser مشخص نشده باشد و LOGNAME خالی باشد، استفاده می‌شود\&.
.br 
با گزینه‌های su و
su\-d، مقدار USER روی نام کاربری داده‌شده تنظیم می‌شود\&.
.IP 
.IP "\fBSHELL\fP (output)"
با گزینه‌های su و
su\-d، مقدار SHELL روی شل لاگین
کاربر داده‌شده تنظیم می‌شود\&.
.IP 
.IP "\fBPATH\fP (output)"
می‌تواند با گزینه path برای آدرس‌های exec،
system، و SHELL تنظیم شود\&.
.IP 
.IP "\fBHOME\fP (output)"
با گزینه‌های su و
su\-d، مقدار HOME روی دایرکتوری خانگی
کاربر داده‌شده تنظیم می‌شود\&.
.IP 
.SH "تقدیر و تشکر (CREDITS)"

.PP 
فعالیت گروه‌ها و سازمان‌های زیر برای این
پروژه بسیار ارزشمند بوده است:
.PP 
پروژه \fIFSF\fP (گنو، http://www\&.fsf\&.org) 
با نرم‌افزارهای توسعه آزاد و قابل حمل خود و
انبوهی از ابزارها و کتابخانه‌های مفید دیگر\&.
.PP 
\fIجامعه توسعه‌دهندگان لینوکس\fP (http://www\&.linux\&.org) برای ارائه یک سیستم‌عامل آزاد و
متن‌باز\&.
.PP 
گروه \fIOpen Group\fP (http://www\&.unix\-systems\&.org) برای در دسترس قرار دادن رایگان
مشخصات استاندارد خود در اینترنت\&.
.PP 
.SH "نسخه (VERSION)"

.PP 
این صفحه راهنما نسخه 1\&.8\&.0 از \fBsocat\fP را شرح می‌دهد\&.
.PP 
.SH "اشکالات (BUGS)"

.PP 
آدرس‌ها نمی‌توانند تودرتو باشند، بنابراین یک فرآیند تکی socat نمی‌تواند، به عنوان مثال، ssl را
روی socks به کار بیندازد\&.
.PP 
گزینه آدرس ftruncate بدون مقدار به جای 0 از پیش‌فرض 1 استفاده می‌کند\&.
.PP 
حالت‌های با جزئیات (\-x و/یا \-v) در صورت استفاده از گزینه‌های آدرس cr یا crnl، نویسه‌های پایان خط را
به طور ناسازگار نمایش می‌دهند: آن‌ها داده‌ها را در هر دو جهت \fIپس از\fP
تبدیل نشان می‌دهند\&.
.PP 
مجوزهای OpenSSL و GNU Readline ناسازگار هستند\&. بنابراین پشتیبانی از readline
در دبیان غیرفعال شده است\&.
.PP 
گزارش اشکالات را به <socat@dest\-unreach\&.org> ارسال کنید
.PP 
.SH "همچنین ببینید (SEE ALSO)"

.PP 
nc(1), rinetd(8), openssl(1),
stunnel(8), rlwrap(1), setsid(1)
.PP 
صفحه اصلی \fBSocat\fP: http://www\&.dest\-unreach\&.org/socat
.PP 
.SH "نویسنده (AUTHOR)"

.PP 
Gerhard Rieger <rieger@dest\-unreach\&.org> و مشارکت‌کنندگان