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

.PP 
.SH "نام (NAME)"
socat \- رله چندمنظوره (SOcket CAT)
.PP 
.SH "خلاصه دستور (SYNOPSIS)"
\f(CWsocat [options] <address> <address>\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 برنامه‌ای مبتنی بر خط فرمان است که دو جریان بایت (byte stream) دوطرفه برقرار کرده و داده‌ها را میان آن‌ها منتقل می‌کند\&. از آنجا که این جریان‌ها را می‌توان از مجموعه گسترده‌ای از انواع مختلف مبدأها و مقصدهای داده (رجوع به انواع نشانی‌ها) ایجاد کرد، و به دلیل این‌که می‌توان گزینه‌های نشانی فراوانی را بر روی این جریان‌ها اعمال نمود، socat برای اهداف بسیار گوناگونی قابل استفاده است\&.
.PP 
ابزار \fBFilan\fP برنامه‌ای است که اطلاعات مربوط به توصیف‌گرهای فایل فعال خود را در خروجی استاندارد (stdout) چاپ می‌کند\&. این ابزار برای اشکال‌زدایی \fBsocat\fP نوشته شده است، اما برای مقاصد دیگر نیز ممکن است مفید باشد\&. برای یافتن اطلاعات بیشتر از گزینه \-h استفاده کنید\&.
.PP 
ابزار \fBProcan\fP برنامه‌ای است که اطلاعات مربوط به پارامترهای پردازش را در خروجی استاندارد چاپ می‌کند\&. این ابزار به منظور درک بهتر برخی از ویژگی‌های پردازش‌های UNIX و اشکال‌زدایی \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) کند تا به آن فرصتی برای خاتمه تمیز (graceful) داده شود\&. برای مدتی مشخص، \fBsocat\fP به انتقال داده در جهت دیگر ادامه می‌دهد، اما پس از آن تمام کانال‌های باقی‌مانده را بسته و خاتمه می‌یابد\&.
.PP 
.SH "گزینه‌ها (OPTIONS)"

.PP 
برنامه \fBSocat\fP گزینه‌هایی در خط فرمان فراهم می‌کند که رفتار برنامه را تغییر می‌دهند\&. این گزینه‌ها ارتباطی با گزینه‌های نشانی (address options) ندارند که به عنوان بخشی از مشخصات نشانی به کار می‌روند\&.
.PP 
.IP "\fB\f(CW\-V\fP\fP"
اطلاعات نسخه و قابلیت‌های دردسترس را در stdout چاپ کرده و خارج می‌شود\&.
.IP "\fB\f(CW\-h | \-?\fP\fP"
متن راهنمایی را شامل توضیح گزینه‌های خط فرمان و انواع نشانی‌های دردسترس در stdout چاپ کرده و خارج می‌شود\&.
.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\fP\fP\f(CW <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"
نام برنامه‌ای را که در پیام‌های خطا چاپ می‌شود و برای ساخت نام‌های متغیرهای محیطی به کار می‌رود، تغییر می‌دهد\&.
.IP "\fB\f(CW\-lu\fP\fP"
دقت برچسب زمان (timestamp) پیام‌های خطا را به میکروثانیه افزایش می‌دهد\&. هنگام ارسال به syslog کار نمی‌کند\&.
.IP "\fB\f(CW\-lm[<facility>]\fP\fP"
حالت گزارش‌گیری ترکیبی\&. هنگام راه‌اندازی پیام‌ها در stderr چاپ می‌شوند؛ هنگامی که \fBsocat\fP حلقه فاز انتقال یا حالت دیمن را آغاز می‌کند (یعنی پس از باز کردن همه جریان‌ها و پیش از آغاز انتقال داده، یا با سوکت‌های شنونده به همراه گزینه fork، پیش از نخستین فراخوانی accept)، گزارش‌گیری را به syslog تغییر می‌دهد\&. با مشخص کردن <facility> اختیاری، نوع syslog را می‌توان تعیین کرد که به‌طور پیش‌فرض \(dq\&daemon\(dq است\&.
.IP "\fB\f(CW\-lh\fP\fP"
نام میزبان (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
(میکروثانیه‌های زمان جاری) باشد\&. بدیهی است که این ارجاعات باید در برابر گسترش توسط شل محافظت شوند\&.
.IP "\fB\f(CW\-R <file>\fP\fP"
داده‌های خام (باینری) منتقل‌شده از نشانی سمت راست به سمت چپ را در فایل مشخص‌شده تخلیه می‌کند\&. برای سفارشی‌سازی نام فایل به گزینه \-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 صرفاً جهت ثبت یک پیام گزارش دریافت می‌شوند\&. به دام انداختن این سیگنال‌ها برای درج اطلاعات مربوط به سیگنال در گزارش‌های \fBsocat\fP مفید است، اما از تولید core dump یا سایر کنش‌های پیش‌فرض جلوگیری می‌کند\&. مجموعه پیش‌فرض این سیگنال‌ها عبارت است از SIGHUP، SIGINT، SIGQUIT، SIGILL، SIGABRT، SIGBUS، SIGFPE، SIGSEGV و SIGTERM؛ این مجموعه (0x89de در لینوکس) را با یک نگاشت بیتی جایگزین کنید (برای نمونه، SIGFPE دارای مقدار 8 و بیت آن 0x0080 است)\&.
.br 
نکته: سیگنال‌های SIGHUP، SIGINT، SIGQUIT، SIGUSR1، SIGPIPE، SIGALRM، SIGTERM و SIGCHLD ممکن است در هر حالتی به‌طور ویژه مدیریت شوند\&.
.IP "\fB\f(CW\-t\fP\fP\f(CW<timeout>\fP"
هنگامی که یک کانال به EOF برسد (که از طریق گزینه ignoreeof نادیده گرفته نشده باشد)، بخش نوشتن کانال دیگر متوقف (shutdown) می‌شود\&. سپس، \fBsocat\fP پیش از خاتمه یافتن، به مدت <timeout> ثانیه [timeval] منتظر می‌ماند\&. چنانچه در طول بازه مهلت زمانی بخش خواندن کانال دیگر نیز به EOF برسد، socat بدون انتظار برای پایان مهلت، خاتمه می‌یابد\&. پیش‌فرض 0\&.5 ثانیه است، مقدار 0 نیز معتبر است\&. این مهلت زمانی فقط برای نشانی‌هایی کاربرد دارد که بخش‌های خواندن و نوشتن آن‌ها را بتوان به‌طور جداگانه بست یا متوقف کرد\&..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> به معنای نامحدود هستند، پیش‌فرض \-1 است\&.
.br 
برای پروتکل‌هایی مانند UDP که قادر به انتقال EOF نیستند کاربردی است\&.
.IP "\fB\f(CW\-u\fP\fP"
از حالت یک‌طرفه استفاده می‌کند\&. آدرس اول فقط برای خواندن و آدرس دوم فقط برای نوشتن استفاده می‌شود (مثال)\&. 
.IP "\fB\f(CW\-U\fP\fP"
از حالت یک‌طرفه در جهت معکوس استفاده می‌کند\&. آدرس اول فقط برای نوشتن و آدرس دوم فقط برای خواندن استفاده می‌شود\&. 
.IP "\fB\f(CW\-g\fP\fP"
هنگام تجزیهٔ گزینه‌های آدرس، بررسی نمی‌کند که آیا گزینه در محیط آدرس مشخص‌شده مفید تلقی می‌شود یا خیر\&. در صورتی از آن استفاده کنید که بخواهید، به عنوان مثال، اِعمال یک گزینهٔ socket بر روی یک دستگاه سریالی را تحمیل کنید\&.
.IP "\fB\f(CW\-L\fP\fP\f(CW<lockfile>\fP"
اگر lockfile وجود داشته باشد، با خطا خارج می‌شود\&. اگر lockfile وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و هنگام خروج lockfile را حذف (unlink) می‌کند\&.
.IP "\fB\f(CW\-W\fP\fP\f(CW<lockfile>\fP"
اگر lockfile وجود داشته باشد، تا زمان ناپدید شدن آن منتظر می‌ماند\&. وقتی lockfile وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و هنگام خروج lockfile را حذف (unlink) می‌کند\&.
.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 
مشخصات آدرسی که از ساختار بالا پیروی می‌کنند، مشخصات آدرس \fIsingle\fP (تک) نیز نامیده می‌شوند\&.
دو آدرس تک را می‌توان با \(dq\&!!\(dq\& ترکیب کرد تا یک آدرس از نوع \fIdual\fP (دوگانه) برای یک کانال تشکیل شود\&. در اینجا، آدرس اول توسط \fBsocat\fP برای خواندن داده‌ها و آدرس دوم برای نوشتن داده‌ها استفاده می‌شود\&. هیچ راهی برای تعیین یک گزینه تنها یک‌بار به طوری که روی هر دو آدرس تک اعمال شود وجود ندارد\&.
.PP 
معمولاً آدرس‌ها در حالت خواندن/نوشتن باز می‌شوند\&. هنگامی که یک آدرس بخشی از یک مشخصات آدرس دوگانه باشد، یا هنگامی که گزینهٔ \-u یا \-U استفاده شود، ممکن است یک آدرس فقط برای خواندن یا فقط برای نوشتن به کار رود\&. در نظر گرفتن این موضوع در برخی از انواع آدرس مهم است\&.
.PP 
از نسخهٔ 1\&.5\&.0 و بالاتر socat، تحلیل واژگانی تلاش می‌کند نقل‌قول‌ها و پرانتزها را به صورت معنادار مدیریت کند و امکان گریز دادن (escape) نویسه‌های خاص را فراهم می‌سازد\&. 
اگر یکی از نویسه‌های ( { [ \(cq\& یافت شود، نویسهٔ پایانی متناظر \- ) } ] \(cq\& \- جستجو می‌شود؛ آن‌ها همچنین می‌توانند به صورت تو در تو باشند\&. در داخل این ساختارها، نویسه‌ها و رشته‌های خاص socat مانند : , !! به صورت ویژه پردازش نمی‌شوند\&. تمام این نویسه‌ها و رشته‌ها را می‌توان با \e یا درون \(dq\&\(dq\& گریز داد\&.
.PP.SH "انواع آدرس (ADDRESS TYPES)"

.PP 
این بخش انواع آدرس‌های موجود را به همراه کلمات کلیدی، پارامترها و معناشناسی آن‌ها توصیف می‌کند\&.
.PP 
.IP "\fB\f(CWCREATE:<filename>\fP\fP"
فایل <filename> را با 
\f(CWcreat()\fP
باز کرده و از توصیف‌گر فایل برای نوشتن استفاده می‌کند\&.
این یک آدرس فقط‌نوشتنی است زیرا فایلی که با 
\f(CWcreat\fP
باز شده باشد را نمی‌توان خواند\&. گزینه‌های \-u و
\-U، و آدرس‌های دوگانه را ببینید\&.
.br 
پرچم‌هایی مانند O_LARGEFILE را نمی‌توان اعمال کرد\&. اگر به آن‌ها نیاز دارید از
OPEN همراه با گزینه‌های
create,create استفاده کنید\&.
.br 
مقدار <filename> باید یک مسیر معتبر، موجود یا ناموجود باشد\&.
اگر <filename> یک لوله نام‌گذاری‌شده (named pipe) باشد، 
\f(CWcreat()\fP
ممکن است مسدود (block) شود؛
اگر <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] مشخص‌شده
بسته به مشخصات آدرس، تفکیک نام یا گزینه pf با استفاده از نگارش ۴ یا ۶ پروتکل IP برقرار می‌کند\&.
.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"
یک زیرفرآیند را fork می‌کند که ارتباط با فرآیند والد خود را برقرار ساخته
و برنامه مشخص‌شده را با 
\f(CWexecvp()\fP
فراخوانی می‌نماید\&.
دستور <command\-line> یک دستور ساده است
که آرگومان‌های آن با تک‌فاصله‌ها جدا شده‌اند\&. اگر نام برنامه
شامل \(cq\&/\(cq باشد، بخش پس از آخرین \(cq\&/\(cq به عنوان ARGV[0] در نظر گرفته می‌شود\&. اگر
نام برنامه یک مسیر نسبی باشد، معناشناسی 
\f(CWexecvp()\fP
برای یافتن برنامه از طریق
\f(CW$PATH\fP
اعمال می‌گردد\&. پس از شروع موفقیت‌آمیز برنامه، \fBsocat\fP داده‌ها را به stdin فرآیند نوشته
و با استفاده از یک سوکت دامنه یونیکس که به طور پیش‌فرض توسط 
\f(CWsocketpair()\fP
ایجاد شده است، از stdout آن می‌خواند\&. (مثال)
.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] استفاده کرده و بسته‌ها را از host
دریافت می‌کند، و بسته‌های ارسالی از سایر میزبان‌ها را نادیده می‌گیرد\&.
پروتکل ۲۵۵ از سوکت خامی استفاده می‌کند که در آن سرآیند 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"
با استفاده از بسته‌های خام شامل داده‌های سطح پیوند، با شبکه‌ای متصل روی یک رابط
ارتباط برقرار می‌کند\&. <interface> نام رابط
شبکه است\&. در حال حاضر فقط روی Linux در دسترس است\&.
.br 
گروه‌های گزینه: FD,SOCKET 
.br 
گزینه‌های مفید:
pf,
type
.br 
همچنین ببینید: ip\-recv
.IP 
.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
مطابقت دارد یا خیر\&. از این نوع نشانی برای نمونه می‌توان برای پیاده‌سازی
ارتباطات متقارن یا نامتقارن broadcast یا multicast استفاده کرد\&.
.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، و نشانی‌های دوگانه مراجعه کنید\&.
این نشانی می‌تواند برای مثال توسط همتاهای نشانی IP\-SENDTO در socat مخاطب قرار گیرد\&.
پروتکل ۲۵۵ از سوکت خامی استفاده می‌کند که در آن سرآیند 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> را باز می‌کند
(مثال)\&.
این عملیات روی سوکت‌های دامنه UNIX با شکست مواجه می‌شود\&. 
.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"
روی tcp <port> [سرویس 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 استفاده کنید تا دیتاگرام‌ها به اندازه کافی کوچک شوند که به همراه سرریز (overhead) در شبکه جای بگیرند\&.
از گزینه \-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"
روی UDP <port> [سرویس 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 
نکته: هنگامی که یک لوله هم برای خواندن و هم برای نوشتن استفاده شود، مانند
یک سرویس بازآوا (echo) عمل می‌کند\&.
.br 
نکته: هنگامی که یک لوله هم برای خواندن و هم برای نوشتن استفاده شود، و socat تلاش کند
بایت‌های بیشتری نسبت به گنجایش بافر لوله بنویسد (در لینوکس 2\&.4: ۲۰۴۸ بایت)، ممکن است socat
مسدود (block) شود\&. استفاده از گزینه‌ای در 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"
یک لوله (pipe) بدون نام ایجاد کرده و از آن برای خواندن و نوشتن استفاده می‌کند\&. این آدرس مانند یک پژواک‌دهنده (echo) عمل می‌کند، زیرا هر چیزی که در آن نوشته شود بلافاصله به عنوان دادهٔ خوانده‌شده ظاهر می‌شود\&.
.br 
نکته: هنگامی که socat تلاش می‌کند بایت‌های بیشتری نسبت به گنجایش صف لوله بنویسد (در لینوکس 2\&.4: ۲۰۴۸ بایت)، ممکن است socat مسدود (block) شود\&. برای مثال، استفاده از گزینهٔ 
\f(CW\-b 2048\fP
را مد نظر قرار دهید\&.
.br 
گروه‌های گزینه: FD 
.br 
همچنین ببینید: named pipe، SOCKETPAIR
.IP "\fB\f(CWSOCKETPAIR\fP\fP"
یک socketpair ایجاد کرده و از آن برای خواندن و نوشتن استفاده می‌کند\&. مانند یک پژواک‌دهنده عمل می‌کند، زیرا هر چیزی که در آن نوشته شود بلافاصله به عنوان دادهٔ خوانده‌شده ظاهر می‌شود\&. نوع سوکت پیش‌فرض datagram است، بنابراین مرزهای بسته (packet boundaries) را حفظ می‌کند\&.
.br 
گروه‌های گزینه: FD 
.br 
گزینه‌های کاربردی:
socktype
.br 
همچنین ببینید: unnamed pipe
.IP 
.IP "\fB\f(CWSTALL\fP\fP"
بخش خواندن این آدرس هرگز داده‌ای و نه EOF ارائه می‌دهد؛ بخش نوشتن نیز هرگز برای نوشتن داده آماده نمی‌شود\&. این رفتار ممکن است برای آزمایش و برخی سناریوهای ویژه کاربردی باشد\&.
.IP 
.IP "\fB\f(CWTEXT:<string>\fP\fP"
متن ارائه‌شده به عنوان پارامتر به عنوان دادهٔ ورودی در نظر گرفته می‌شود: در یک لوله داخلی بافر شده و سپس طبق معمول پردازش می‌شود\&. تبدیل‌های استاندارد روی رشته اعمال می‌شوند، بنابراین می‌توانید بررسی کنید که پارامترها چگونه تجزیه و آماده می‌شوند که این موضوع برای آدرس‌هایی مانند EXEC حیاتی است\&.
.br 
خروجی روی این آدرس به \f(CWstdout\fP ارسال می‌شود\&. بنابراین این آدرس می‌تواند ساختارهایی مانند:
.br 
\fB\f(CWecho \(dq\&<string>\(dq\& | socat STDIO TCP:<server>:<port>\fP\fP
.br 
را با:
.br 
\fB\f(CWsocat TEXT:\(dq\&<string>\en\(dq\& TCP:<server>:<port>\fP\fP
.br 
جایگزین کند\&. به مثال مربوط به sudo در زیر نگاهی بیندازید\&.
.IP 
.IP "\fB\f(CWPOSIXMQ\-READ:/<mqueue>\fP\fP"
صف پیام‌های POSIX مشخص‌شده را باز کرده یا ایجاد می‌کند و پیام‌ها (بسته‌ها) را می‌خواند\&. این آدرس مرزهای بسته را حفظ می‌کند\&.
.br 
این یک آدرس فقط‌خواندنی است؛ گزینه‌های \-u و \-U و آدرس‌های دوگانه (dual addresses) را ببینید\&.
.br 
\fBSocat\fP این نوع آدرس را فقط در لینوکس ارائه می‌دهد زیرا POSIX MQ در آنجا مبتنی بر توصیف‌کننده‌های فایل (filedescriptors) یونیکس است\&.
.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 مشخص‌شده را بسته به زمینه (context) در حالت خواندن و/یا نوشتن باز کرده یا ایجاد می‌کند، سپس پیام‌ها (بسته‌ها) را خوانده و/یا می‌نویسد\&.
در حالت دوطرفه این صرفاً یک سرویس پژواک‌دهنده دیگر است\&. POSIXMQ حالت دوطرفه را رد می‌کند تا از خالی‌شدن ناخواستهٔ صف جلوگیری شود؛ در صورت نیاز از POSIXMQ\-BIDIRECTIONAL استفاده کنید\&.
.br 
برای اطلاعات بیشتر POSIXMQ\-READ و POSIXMQ\-SEND را ببینید\&.
.IP 
.IP "\fB\f(CWPROXY:<proxy>:<hostname>:<port>\fP\fP"
با استفاده از نسخه ۴ یا ۶ TCP/IP بسته به تعیین نشانی، تحلیل نام یا گزینهٔ pf، به یک کارگزار پیشکار (HTTP proxy) روی درگاه ۸۰۸۰ متصل می‌شود و یک درخواست 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 پایانهٔ مجازی را باز کرده و مانند یک خط سریال یا پایانه از آن استفاده کند (مثال)\&. اگر هر دو سازوکار 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"
از GNU readline و history روی stdio استفاده می‌کند تا ویرایش و استفاده مجدد از خطوط ورودی امکان‌پذیر شود (مثال)\&. این قابلیت به کتابخانه‌های GNU readline و history نیاز دارد\&. توجه داشته باشید که stdio باید یک دستگاه پایانه (یا شبه‌پایانه) باشد، در غیر این صورت به نظر می‌رسد readline کار نمی‌کند\&.
.br 
گروه‌های گزینه: FD,READLINE,TERMIOS 
.br 
گزینه‌های کاربردی:
history,
noecho
.br 
همچنین ببینید:
STDIO
.IP "\fB\f(CWSCTP\-CONNECT:<host>:<port>\fP\fP"
یک اتصال جریانی SCTP به <host> [نشانی IP] و <port> [سرویس TCP] مشخص‌شده با استفاده از نسخه ۴ یا ۶ IP بسته به تعیین نشانی، تحلیل نام یا گزینهٔ pf برقرار می‌کند\&.
.br 
گروه‌های گزینه: FD,SOCKET,IP4,IP6,SCTP,CHILD,RETRY 
.br 
گزینه‌های کاربردی:
bind,
pf,
connect\-timeout,
tos,
mtudiscover,
mtudiscover6,
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 برابر با 4 یا نسخه مشخص‌شده با
گزینه آدرس 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 (صفحه راهنمای socket(2) را ببینید) یک سوکت جریانی ایجاد کرده و به remote\-address متصل می‌شود\&.
این دو پارامتر سوکت باید با اعداد
int مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های سرآیند خود مراجعه کنید\&. آرگومان remote\-address باید نمایش داده‌ای
از یک ساختار sockaddr بدون مؤلفه‌های sa_family و (در BSD) sa_len
باشد\&.
.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"
با استفاده از سه پارامتر سوکت داده‌شده نخست (صفحه
راهنمای socket(2) را ببینید) یک سوکت دیتاگرام ایجاد کرده و داده‌های خروجی را به remote\-address ارسال می‌کند\&. این سه
پارامتر سوکت باید با اعداد int
مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های سرآیند خود مراجعه
کنید\&. آرگومان remote\-address باید نمایش داده‌ای
از یک ساختار sockaddr بدون مؤلفه‌های sa_family و (در BSD) sa_len
باشد\&.
.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 مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های سرآیند خود
مراجعه کنید\&. آرگومان local\-address باید
نمایش داده‌ای از یک ساختار sockaddr بدون
مؤلفه‌های sa_family و (در BSD) sa_len باشد\&.
.br 
لطفاً توجه داشته باشید که علاوه بر گزینه‌های گروه‌های مشخص‌شده، در صورت اعمال گزینه \-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> مقید می‌کند\&. داده‌های ورودی را دریافت می‌کند\&. این سه
پارامتر باید با اعداد int مشخص شوند\&. برای یافتن مقادیر مناسب به
مستندات سیستم‌عامل و فایل‌های سرآیند خود مراجعه کنید\&. آرگومان
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 مشخص شوند\&. برای یافتن مقادیر مناسب به مستندات سیستم‌عامل و فایل‌های سرآیند خود
مراجعه کنید\&. آرگومان 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 mode\(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 متصل می‌شود (example)\&.
.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,
socksuser,
sockspass,
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 نسخهٔ ۵ بر روی TCP به <socks\-server> [آدرس IP]
متصل می‌شود
و آن را برای پذیرش اتصال‌های ورودی روی <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 
این یک آدرس فقط‌نوشتنی است، گزینه‌های \-u و
\-U، و آدرس‌های دوگانه (dual addresses) را ببینید\&.
.br 
گروه‌های گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSTDIN\fP\fP"
از توصیف‌گر فایل ۰ استفاده می‌کند\&.
.br 
این یک آدرس فقط‌خواندنی است، گزینه‌های \-u و
\-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 
این یک آدرس فقط‌نوشتنی است، گزینه‌های \-u و
\-U، و آدرس‌های دوگانه را ببینید\&.
.br 
گروه‌های گزینه: FD (TERMIOS,REG,SOCKET) 
.br 
همچنین ببینید: FD
.IP "\fB\f(CWSHELL:<shell\-command>\fP\fP"
.IP "\fB\f(CWSHELL\fP\fP"
یک زیرپردازه را منشعب (fork) می‌کند که ارتباط با پردازهٔ والد خود را برقرار ساخته
و برنامهٔ مشخص‌شده را با شل پیکربندی‌شده ($SHELL) فراخوانی می‌نماید\&.
توجه داشته باشید که <shell\-command> [رشته] نباید
شامل \(cq\&,\(cq\& یا \(dq\&!!\(dq\& باشد، و ممکن است نویسهٔ \(cq\&:\(cq\& و نویسه‌های متای شل نیاز به
محافظت (escape) داشته باشند\&.
پس از شروع موفقیت‌آمیز برنامه، \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"
یک زیرپردازه را فورک (fork) می‌کند که ارتباط با پردازه والد خود را برقرار کرده
و برنامه مشخص‌شده را با 
\f(CWsystem()\fP
فراخوانی می‌کند\&. لطفاً توجه داشته باشید که
<shell\-command> [رشته] نباید 
شامل \(cq\&,\(cq\& یا \(dq\&!!\(dq\& باشد، و نویسه‌های فرا (meta characters) پوسته ممکن است نیاز به
حفاظت (escape) داشته باشند\&.
پس از شروع موفقیت‌آمیز برنامه، \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,
mtudiscover6,
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 است\&.
توجه داشته باشید که باز کردن
این نشانی معمولاً تا زمان اتصال یک کلاینت مسدود (block) می‌شود\&.
.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 لینوکس ایجاد کرده و به صورت اختیاری نشانی و
netmask ارائه‌شده توسط پارامترها را به آن اختصاص می‌دهد\&. رابط شبکه حاصل تقریباً
برای استفاده توسط سایر پردازه‌ها آماده است؛ socat به «سمت سیمی» (\(dq\&wire side\(dq\&) آن خدمت‌رسانی می‌کند\&. این نشانی
نیازمند دسترسی خواندن و نوشتن به دستگاه شبیه‌ساز تونل، معمولاً
\f(CW/dev/net/tun\fP
، و همچنین مجوز تنظیم برخی از \f(CWioctl()s\fP است\&.
\fBگزینه iff\-up برای فعال‌سازی فوری رابط لازم است!\fP
.br 
نکته: اگر قصد انتقال بسته‌ها بین دو «سمت سیمی» socat را دارید،
به پروتکلی نیاز دارید که مرزهای بسته‌ها را حفظ کند، مانند UDP؛ پروتکل TCP ممکن است با
گزینه nodelay کار کند\&.
.br 
گروه‌های گزینه: FD,NAMED,OPEN,TUN 
.br 
گزینه‌های مفید:
iff\-up,
tun\-device,
tun\-name,
tun\-type,
interface\-mtu,
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، هیچ اتصال واقعی
برقرار نمی‌شود؛ برای «اتصال» به سرور باید داده ارسال شود، و هیچ
وضعیت پایان فایل (end\-of\-file) قابل انتقال نیست\&.
.br 
از نسخه 1\&.8\&.1\&.0، سوکت هنگام خاموش شدن، یک بسته UDP با
طول صفر ارسال می‌کند که ممکن است وضعیت EOF را در طرف مقابل تحریک کند (گزینه ضمنی
shut\-null)\&.
رفتار پیشین را می‌توانید با گزینه shut\-none بازیابی کنید\&.
.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
مطابقت داشته باشد\&. این نوع آدرس می‌تواند برای نمونه جهت پیاده‌سازی ارتباطات
متقارن یا نامتقارن broadcast یا multicast به کار رود\&.
.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
پشتیبانی می‌کند (example1،
example2)\&.
.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] می‌ماند و به فرستنده `connects\(cq\& می‌کند\&.
نسخهٔ IP پذیرفته‌شده 4 یا نسخهٔ مشخص‌شده با گزینهٔ
pf است\&.
لطفاً توجه داشته باشید که به دلیل ویژگی‌های پروتکل UDP، هیچ اتصال واقعی
برقرار نمی‌شود؛ داده‌ها ابتدا باید از سمت طرف مقابل برسند، بنابراین، باز کردن
این آدرس معمولاً تا زمان اتصال یک کلاینت مسدود می‌شود\&. علاوه بر این،
هیچ وضعیت پایان فایلی (EOF) در UDP مشخص نشده است\&.
.br 
از نسخهٔ 1\&.8\&.1\&.0، سوکت هنگام خاموش شدن یک بستهٔ UDP
با طول صفر می‌فرستد که ممکن است EOF را در طرف مقابل فعال کند (گزینهٔ ضمنی
shut\-null)\&.
رفتار پیشین را با گزینهٔ shut\-none بازیابی کنید\&.
.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 نسخهٔ 4 یا 6
بسته به تعیین نشانی، تفکیک نام، یا گزینهٔ
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 نسخهٔ 4 یا 6 
بسته به گزینهٔ 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 
این یک آدرس فقط‌خواندنی است، گزینه‌های \-u و
\-U، و آدرس‌های دوگانه (dual addresses) را ببینید\&.
.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> یک سوکت دامنه یونیکس (UNIX domain socket)
است، به آن متصل می‌شود\&.
اگر <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"
با استفاده از یک سوکت جریانی دامنه یونیکس (UNIX domain stream socket) روی <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، که نباید از قبل
وجود داشته باشد)\&.
این نوع آدرس به‌خوبی با همتاهای آدرس socat از نوع UNIX\-RECVFROM و UNIX\-RECV
کار می‌کند\&.
.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>] ایجاد می‌کند\&.
بسته‌ها را از چندین همتای نامشخص دریافت کرده و داده‌ها را با هم ادغام می‌کند\&.
هیچ پاسخی امکان‌پذیر نیست، این یک آدرس فقط‌خواندنی است، گزینه‌های \-u و
\-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"
یک اتصال جریانی (stream) مربوط به VSOCK را به <cid> [شناسه VSOCK cid] و <port> [درگاه VSOCK] مشخص‌شده برقرار می‌کند\&.
.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] گوش فرا داده و یک اتصال 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 مربوطه یکسان هستند، جز اینکه به سوکت‌های مبتنی بر سیستم فایل اشاره نمی‌کنند بلکه یک فضای آدرس دامنه UNIX جایگزین را هدف قرار می‌دهند\&. برای دستیابی به این منظور، رشته‌های آدرس سوکت در داخل به‌صورت پیش‌فرض با پیشوند \(dq\&\e0\(dq\& مقداردهی می‌شوند\&. این ویژگی (صرفاً؟) در Linux موجود است\&.
گروه‌های گزینه همانند آدرس‌های UNIX مربوطه هستند، با این تفاوت که آدرس‌های ABSTRACT عضوی از گروه NAMED نیستند\&.
.br 
گزینه‌های کاربردی:
netns

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

.PP 
گزینه‌های آدرس را می‌توان روی مشخصات آدرس اعمال کرد تا روند باز کردن آدرس‌ها و ویژگی‌های کانال‌های داده حاصل تحت تأثیر قرار گیرند\&. 
.PP 
به دلایل فنی نمی‌توان هر گزینه‌ای را برای هر نوع آدرسی اعمال کرد؛ برای مثال، اعمال یک گزینه سوکت روی یک فایل معمولی با شکست مواجه خواهد شد\&. برای شناسایی بیشتر ترکیب‌های غیرقابل‌استفاده در همان ابتدای فاز باز کردن، مفهوم \fIگروه‌های گزینه\fP معرفی شده است\&. هر گزینه به یک یا چند گروه گزینه تعلق دارد\&. گزینه‌ها فقط می‌توانند با انواع آدرسی استفاده شوند که حداقل از یکی از گروه‌های گزینه آن‌ها پشتیبانی کنند (اما گزینه \-g را ببینید)\&.
.PP 
گزینه‌های آدرس دارای انواع داده‌ای هستند که مقادیر آن‌ها باید با آن نوع مطابقت داشته باشد\&.
هر گزینه آدرس تنها از یک کلیدواژه یا یک کلیدواژه به همراه \(dq\&=value\(dq\& تشکیل شده است، که در آن value باید با نوع داده گزینه سازگار باشد\&.
برخی از گزینه‌های آدرس پارامترهای فراخوانی‌های سیستمی را دستکاری می‌کنند؛
برای مثال، گزینه sync پرچم
\f(CWO_SYNC\fP
را در فراخوانی 
\f(CWopen()\fP
تنظیم می‌کند\&. 
گزینه‌های دیگر موجب یک فراخوانی سیستمی یا کتابخانه‌ای می‌شوند؛ برای مثال، با گزینه \(lqttl=value\(rq فراخوانی 
\f(CWsetsockopt(fd, SOL_IP, IP_TTL, value, sizeof(int))\fP
اعمال می‌گردد\&.
گزینه‌های دیگر متغیرهای داخلی \fBsocat\fP را تنظیم می‌کنند که در حین انتقال داده استفاده می‌شوند؛
برای مثال، \(lqcrnl\(rq موجب تبدیل صریح نویسه‌ها می‌شود\&. 
تعداد کمی از گزینه‌ها پیاده‌سازی‌های پیچیده‌تری دارند؛ برای مثال، su\-d
(مخفف substuser\-delayed) برخی اطلاعات کاربر و گروه را جویا شده، آن‌ها را ذخیره می‌کند و بعداً پس از یک فراخوانی احتمالی 
\f(CWchroot()\fP
اعمال می‌نماید\&.
.PP 
اگر چندین گزینه برای یک آدرس مشخص شود، ترتیب آن‌ها در مشخصه آدرس (تقریباً) هیچ تأثیری بر ترتیب اجرا یا اعمال آن‌ها ندارد\&. در عوض، \fBsocat\fP دارای یک مدل درونی \fIفاز گزینه\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 
این گروه گزینه شامل گزینه‌هایی است که بر روی یک توصیف‌گر فایل به سبک UN*X اعمال می‌شوند، فارغ از اینکه چگونه ایجاد شده باشد\&.
از آنجا که تمام انواع آدرس‌های فعلی \fBsocat\fP مبتنی بر توصیف‌گر فایل هستند، این گزینه‌ها می‌توانند بر روی هر آدرسی اعمال شوند\&. 
.br 
نکته: برخی از این گزینه‌ها همچنین عضو یک گروه گزینه دیگر هستند که سازوکار متفاوتی بدون استفاده از fd ارائه می‌دهد\&.
برای این گزینه‌ها، بسته به نوع واقعی آدرس و گروه‌های گزینه آن مشخص می‌شود که کدام سازوکار استفاده گردد\&. سازوکار دوم (غیر مبتنی بر fd) در اولویت قرار دارد\&.
.IP "\fB\f(CWcloexec[=<bool>]\fP\fP"
پرچم 
\f(CWFD_CLOEXEC\fP
را با فراخوانی سیستمی 
\f(CWfcntl()\fP
روی مقدار <bool> تنظیم می‌کند\&. در صورت تنظیم، توصیف‌گر فایل در فراخوانی‌های خانواده توابع 
\f(CWexec()\fP
بسته می‌شود\&. \fBSocat\fP
به‌طور داخلی این پرچم را برای fdهایی که کنترل می‌کند مدیریت می‌نماید، بنابراین در بیشتر موارد نیازی به اعمال این گزینه نخواهد بود\&. 
.IP "\fB\f(CWsetlk[=<bool>]\fP\fP"
تلاش می‌کند با استفاده از فراخوانی سیستمی 
\f(CWfcntl(fd, F_SETLK, \&.\&.\&.)\fP
یک قفل نوشتن اختیاری (discretionary) بر روی کل فایل تنظیم کند\&. اگر فایل قبلاً قفل شده باشد، این فراخوانی منجر به بروز خطا می‌شود\&. 
در Linux، هنگامی که مجوزهای فایل برای گروه به شکل \(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 پس از باز کردن فایل یا مقید شدن (bind) به سوکت دامنهٔ UNIX، از فراخوان سیستمی
\f(CWchown()\fP
استفاده می‌کند (وضعیت رقابتی!)\&.
در صورت عدم وجود مدخل سیستم‌فایل، \fBsocat\fP کاربر جریان را با استفاده از فراخوان سیستمی
\f(CWfchown()\fP
تعیین می‌کند\&.
این فراخوان‌ها ممکن است به دسترسی ریشه (root) نیاز داشته باشند\&.
.IP "\fB\f(CWuser\-late=<user>\fP\fP"
مالک fd را پس از باز کردن یا متصل کردن کانال، با استفاده از فراخوان سیستمی
\f(CWfchown()\fP
به <user> تغییر می‌دهد\&.
این گزینه فقط روی مدخل‌های سیستم‌فایل مفید است\&.
.IP "\fB\f(CWgroup=<group>\fP\fP"
گروه <group> جریان را تعیین می‌کند\&.
اگر نشانی عضوی از گروه گزینه‌های NAMED باشد،
\fBsocat\fP پس از باز کردن فایل یا مقید شدن (bind) به سوکت دامنهٔ UNIX، از فراخوان سیستمی
\f(CWchown()\fP
استفاده می‌کند (وضعیت رقابتی!)\&.
در صورت عدم وجود مدخل سیستم‌فایل، \fBsocat\fP گروه جریان را با فراخوان سیستمی
\f(CWfchown()\fP
تعیین می‌کند\&.
این فراخوان‌ها ممکن است نیازمند عضویت در گروه یا امتیازات ریشه (root) باشند\&.
.IP "\fB\f(CWgroup\-late=<group>\fP\fP"
گروه fd را پس از باز کردن یا متصل کردن کانال، با استفاده از فراخوان سیستمی
\f(CWfchown()\fP
به <group> تنظیم می‌کند\&.
این گزینه فقط روی مدخل‌های سیستم‌فایل مفید است\&.
.IP "\fB\f(CWmode=<mode>\fP\fP"
حالت <mode> [از نوع mode_t] (مجوزهای دسترسی) جریان را تنظیم می‌کند\&.
اگر نشانی عضوی از گروه گزینه‌های NAMED بوده و از فراخوان‌های
\f(CWopen()\fP
یا
\f(CWcreat()\fP
استفاده کند، این حالت همراه با آن‌ها اعمال می‌شود\&.
اگر نشانی عضوی از گروه گزینه‌های NAMED باشد بدون آن‌که از این فراخوان‌های سیستمی استفاده کند،
\fBsocat\fP پس از باز کردن مدخل سیستم‌فایل یا مقید شدن (bind) به سوکت دامنهٔ UNIX، از فراخوان سیستمی
\f(CWchmod()\fP
استفاده می‌کند (وضعیت رقابتی!)\&.
در غیر این صورت، \fBsocat\fP حالت جریان را با استفاده از
\f(CWfchmod()\fP
تنظیم می‌کند که البته ممکن است هیچ اثری نداشته باشد\&.
.br 
این فراخوان‌ها ممکن است نیازمند مالکیت فایل یا دسترسی ریشه باشند\&.
.br 
نکته: این گزینه تنها می‌تواند مجوزهای حاصل از umask فرایند را محدودتر کند\&. برای سهل‌گیرانه‌تر کردن مجوزها گزینهٔ umask را ببینید\&.
.IP "\fB\f(CWperm\-late=<mode>\fP\fP"
مجوزهای دسترسی fd را پس از باز کردن یا متصل کردن کانال، با استفاده از فراخوان سیستمی
\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 مسدود نمی‌شود، و باز کردن یک لولهٔ نام‌گذاری‌شده (named pipe) برای خواندن مسدود نمی‌گردد\&.
اگر نشانی عضوی از گروه گزینه‌های 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"
این فایل را در فرایند ایجادشده (spawned) باز نگه نمی‌دارد (Cygwin)\&.
.IP "\fB\f(CWcool\-write[=<bool>]\fP\fP"
هنگامی که نوشتن با EPIPE یا ECONNRESET ناموفق می‌شود آسان می‌گیرد و پیام را به جای سطح \fIerror\fP با سطح \fInotice\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 سوکت را از فرایند \(dq\&پیوندزدایی\(dq\& می‌کند اما تا زمانی که هنوز پیوندهایی از دیگر فرایندها وجود داشته باشد، آن را فعال نگه می‌دارد\&.
.br 
به همین ترتیب، هنگامی که نشانی از نوع EXEC یا SYSTEM پایان می‌یابد، socat معمولاً زیرفرایند را صراحتاً می‌کشد (kill می‌کند)\&. با این گزینه، تنها توصیف‌گرهای فایل را خواهد بست\&.
.IP "\fB\f(CWshut\-none[=<bool>]\fP\fP"
روش قطع کردن بخش نوشتاری اتصال (وابسته به نشانی) را به گونه‌ای تغییر می‌دهد که کاری انجام ندهد\&.
.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 به عنوان آرگومان دوم و مقدار عدد صحیح به عنوان آرگومان سوم فراخوانی می‌کند\&.
.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 
لطفاً توجه داشته باشید که در نشانی‌های کلاینت دامنهٔ UNIX، این به معنی مدخل bind است،
نه مدخل هدف/همتا (target/peer)\&.
.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
تغییر می‌دهد\&. این فراخوان ممکن است به عضویت در گروه یا امتیاز ریشه
نیاز داشته باشد\&. 
.IP "\fB\f(CWperm\-early=<mode>\fP\fP"
پیش از دسترسی به مدخل سامانه فایل، <mode> [از نوع mode_t] آن را
با استفاده از فراخوان سیستمی
\f(CWchmod()\fP
تغییر می‌دهد\&. این فراخوان ممکن است به مالکیت یا امتیاز ریشه
نیاز داشته باشد\&. 
.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) می‌کند تا پس از یک شرایط مسابقهٔ (race condition) کوتاه،
برای سایر فرایندها غیرقابل دسترسی شود\&. 
.IP "\fB\f(CWunlink\-close[=<bool>]\fP\fP"
حذف مدخل سامانه فایل نشانی را هنگام بستن آن کنترل می‌کند\&.
برای لوله‌های نام‌گذاری‌شده (named pipes)،
سوکت‌های دامنهٔ UNIX،
و پیوندهای نمادین نشانی‌های 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"
هنگام باز کردن فایل، اندازهٔ آن را به ۰ برش می‌دهد (truncate می‌کند)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های REG و BLK\fP\fP
.PP 
این گزینه‌ها معمولاً روی یک توصیف‌گر فایل UN*X اعمال می‌شوند، اما
مفهوم آن‌ها تنها روی فایلی معنادار است که از دسترسی تصادفی (random access) پشتیبانی کند\&.
.IP "\fB\f(CWseek=<offset>\fP\fP"
فراخوان سیستمی 
\f(CWlseek(fd, <offset>, SEEK_SET)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند،
و در نتیجه اشاره‌گر فایل را به‌صورت مطلق در موقعیت <offset>
[از نوع off_t یا off64_t] قرار می‌دهد\&. لطفاً توجه داشته باشید که در صورت
ذکر نشدن مقدار، مقدار پیش‌فرض ۱ است، نه ۰\&.
.IP "\fB\f(CWseek\-cur=<offset>\fP\fP"
فراخوان سیستمی 
\f(CWlseek(fd, <offset>, SEEK_CUR)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند،
و بدین ترتیب اشاره‌گر فایل را به میزان <offset> بایت [از نوع off_t یا
off64_t] نسبت به موقعیت فعلی‌اش (که معمولاً ۰ است)
جابه‌جا می‌کند\&. لطفاً توجه داشته باشید که در صورت ذکر نشدن مقدار، مقدار پیش‌فرض ۱ است، نه ۰\&.
.IP "\fB\f(CWseek\-end=<offset>\fP\fP"
فراخوان سیستمی 
\f(CWlseek(fd, <offset>, SEEK_END)\fP
(یا 
\f(CWlseek64\fP
) را اعمال می‌کند،
و بدین ترتیب اشاره‌گر فایل را به میزان <offset> بایت [از نوع off_t یا
off64_t] نسبت به انتهای فعلی فایل قرار می‌دهد\&. لطفاً
توجه داشته باشید که در صورت ذکر نشدن مقدار، مقدار پیش‌فرض ۱ است، نه ۰\&.  
.IP "\fB\f(CWftruncate=<offset>\fP\fP"
فراخوان سیستمی 
\f(CWftruncate(fd, <offset>)\fP
(یا در صورت در دسترس بودن 
\f(CWftruncate64\fP
) را اعمال می‌کند، و بدین ترتیب
فایل را در موقعیت <offset> [از نوع off_t یا 
off64_t] برش می‌دهد\&. لطفاً توجه داشته باشید که در صورت ذکر نشدن مقدار، مقدار پیش‌فرض ۱ است،
نه ۰\&.
.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 را ببینید\&. لطفاً توجه داشته باشید که ممکن است بین ایجاد
فایل و اعمال این گزینه‌ها یک شرایط مسابقه (race condition) وجود داشته باشد\&.

.PP 
.br 

.PP 
\fI\fBگزینه‌های PIPE\fP\fP
.PP 
این گزینه‌ها ممکن است روی لوله‌ها (pipes / 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"
دایرکتوری کاری را تغییر می‌دهد\&. پس از باز کردن آدرس، فرآیند اصلی (master) به دایرکتوری کاری اولیه بازمی‌گردد\&. زیرفرآیندها این تنظیم موقت را به ارث می‌برند\&.
.IP "\fB\f(CWumask=<mode>\fP\fP"
مقدار umask فرآیند را پیش از باز کردن آدرس به <mode> [از نوع mode_t] تنظیم می‌کند\&. این گزینه هنگام ایجاد ورودی‌های فایل‌سیستم یا فراخوانی شل یا یک برنامه کاربردی است\&. معمولاً این مقدار به‌صورت یک عدد هشت‌هشتی (octal) با یک \(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"
پیش از باز کردن آدرس تلاش می‌کند تا به فضای نام شبکهٔ (network namespace) مشخص‌شده تغییر وضعیت دهد\&. پس از باز کردن آدرس به فضای نام پیشین بازمی‌گردد (مثال با فورواردر TCP، مثال با اتصال شبکهٔ مجازی)\&.
.br 
تنها در لینوکس؛ این گزینه نیازمند ریشه (root) است و آزمایشی محسوب می‌شود\&.
.br 

.PP 
.br 

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

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های APPLICATION\fP\fP
.PP 
این گروه شامل گزینه‌هایی است که در سطح داده عمل می‌کنند\&.
توجه داشته باشید که این گزینه‌ها تنها بر داده‌های خام (\(dq\&raw\(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"
اگر lockfile وجود داشته باشد، با خطا خارج می‌شود\&. اگر lockfile وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و در هنگام خروج lockfile را حذف (unlink) می‌کند\&.
.IP "\fB\f(CWwaitlock=<filename>\fP\fP"
اگر lockfile وجود داشته باشد، تا زمان ناپدید شدن آن منتظر می‌ماند\&. زمانی که lockfile وجود نداشته باشد، آن را ایجاد کرده و ادامه می‌دهد، و در هنگام خروج lockfile را حذف (unlink) می‌کند\&.
.IP "\fB\f(CWescape=<int>\fP\fP"
کد عددی نویسه‌ای را مشخص می‌کند که باعث تحریک EOF در جریان ورودی می‌شود\&. این گزینه در ترمینال در حالت خام (raw mode) مفید است
(مثال)\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های SOCKET\fP\fP
.PP 
این گزینه‌ها برای همهٔ انواع سوکت‌ها، به عنوان مثال IP یا دامنهٔ UNIX در نظر گرفته شده‌اند\&. بیشتر آن‌ها با یک فراخوانی 
\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> داده‌شده مقید می‌کند\&.
این گزینه ممکن است به امتیازات ریشه (root) نیاز داشته باشد\&.
.IP "\fB\f(CWbroadcast\fP\fP"
برای سوکت‌های دیتاگرام، ارسال به آدرس‌های برودکست (پخش همگانی) و دریافت بسته‌های آدرس‌دهی‌شده به آدرس‌های برودکست را امکان‌پذیر می‌سازد\&. 
.IP "\fB\f(CWdebug\fP\fP"
اشکال‌زدایی (debugging) سوکت را فعال می‌کند\&.
.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، این مقدار متناظر با بیشینه اندازه پنجره (window size) سوکت است\&.
.IP "\fB\f(CWrcvbuf\-late=<bytes>\fP\fP"
اندازه بافر دریافت را هنگامی که سوکت از پیش متصل شده است روی <bytes> [int] تنظیم می‌کند\&.
در سوکت‌های TCP، این مقدار متناظر با بیشینه اندازه پنجره سوکت است\&.
.IP "\fB\f(CWso\-rcvtimeo=<time>, rcvtimeo=<time>\fP\fP"
مدت زمان [int] تا اتمام مهلت زمانی (timeout) توابعی مانند 
\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(CWprotocol\-family=<string>\fP\fP, \fB\f(CWpf=<string>\fP\fP"
عبارت pf مخفف protocol family (خانواده پروتکل) است، که گاهی دامنه ارتباطی (communication domain) یا خانواده آدرس (address family) نیز نامیده می‌شود\&.
این گزینه استفاده از نسخه IP یا پروتکل مشخص‌شده را اجبار می‌کند\&. <string> می‌تواند یک عدد یا عبارتی مانند \(dq\&ip4\(dq\& (به معنای 2) یا \(dq\&ip6\(dq\& (به معنای 10) باشد\&.
مقدار حاصل به عنوان نخستین آرگومان در فراخوانی‌های 
\f(CWsocket()\fP
یا
\f(CWsocketpair()\fP
و در فیلد 
\f(CWai_family\fP
در راهنماهای (hints)
\f(CWgetaddrinfo()\fP
استفاده می‌شود\&.
این گزینه بر تفکیک آدرس و ساختار نحوی مورد نیاز برای گزینه‌های bind و range تأثیر می‌گذارد\&.
.IP "\fB\f(CWsocktype=<type>\fP\fP"
نوع سوکت را، که به عنوان آرگومان دوم در فراخوانی‌های 
\f(CWsocket()\fP
یا 
\f(CWsocketpair()\fP
مشخص می‌شود، روی <type> [int] تنظیم می‌کند\&. تفکیک آدرس تحت تأثیر این گزینه قرار نمی‌گیرد\&.
در لینوکس، 1 به معنای سوکت مبتنی بر جریان (stream oriented)، 2 به معنای سوکت داده‌گرام (datagram)، 3 به معنای سوکت خام (raw)، و 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 files) مناسب سیستم خود را بررسی کنید\&. برای پارامترهای چهارم و پنجم \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> یک رشته است\&.
این رشته با نویسه تهی پایانی (trailing null character) به تابع ارسال می‌شود و پارامتر طول به‌طور خودکار از داده‌ها به دست می‌آید\&.
.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 
این گزینه‌ها برای آدرس‌های مبتنی بر دامنه UNIX اعمال می‌شوند\&.
.IP "\fB\f(CWbind\-tempname[=/tmp/pre\-XXXXXX],
unix\-bind\-tempname[=/tmp/pre\-XXXXXX]\fP\fP"
به یک مسیر تصادفی یا آدرس تصادفی (در سوکت‌های فضای نام انتزاعی) متصل (bind) می‌شود\&.
این گزینه با آدرس‌های کلاینت داده‌گرام (\f(CWSENDTO\fP یا \f(CWCLIENT\fP) که در فرآیندهای فرزندی مشتق‌شده از یک فرآیند والد مشترک باز می‌شوند و نمی‌توانند گزینه‌های 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 مانند مسیریابی مبدأ (source routing) را تنظیم می‌کند\&. باید در قالب دودویی ارائه شود؛ قالب توصیه‌شده یک \(dq\&x\(dq\& در ابتدا و به دنبال آن تعداد زوجی از ارقام هگزادسیمال است\&. این گزینه می‌تواند چندین بار استفاده شود و داده‌ها به انتها الحاق می‌شوند\&.
به عنوان مثال، برای اتصال به میزبان 10\&.0\&.0\&.1 از طریق یک gateway با استفاده از مسیر مبدأ آزاد (loose source route)، از gateway به عنوان پارامتر آدرس استفاده کنید و با استفاده از گزینه 
\f(CWip\-options=x8307040a000001\fP
یک مسیر مبدأ آزاد تنظیم نمایید\&.
.br 
گزینه‌های IP در RFC 791 تعریف شده‌اند\&. 
.br.IP "\fB\f(CWip\-mtu\-discover=<0|1|2>, mtudiscover=<0|1|2>\fP\fP"
برای هرگز، در صورت تمایل، یا همیشه استفاده کردن از کشف MTU مسیر (path MTU discovery) روی سوکت IPv4، مقادیر 0، 1 یا 2 را می‌پذیرد\&. 
.IP "\fB\f(CWip\-pktinfo\fP\fP"
گزینه سوکت IP_PKTINFO را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی (ancillary messages) شامل نشانی مقصد و رابط شبکه را فعال می‌سازد (Linux) (نمونه)\&. 
.IP "\fB\f(CWip\-recverr\fP\fP"
گزینه سوکت IP_RECVERR را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی شامل اطلاعات تفصیلی خطا را فعال می‌سازد\&.
.IP "\fB\f(CWip\-recvopts\fP\fP"
گزینه سوکت IP_RECVOPTS را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی گزینه‌های IP را فعال می‌سازد (Linux، *BSD)\&.
.IP "\fB\f(CWip\-recvtos\fP\fP"
گزینه سوکت IP_RECVTOS را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی TOS (نوع سرویس) را فعال می‌سازد (Linux)\&.
.IP "\fB\f(CWip\-recvttl\fP\fP"
گزینه سوکت IP_RECVTTL را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی TTL (طول عمر) را فعال می‌سازد (Linux، *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"
سوکت را عضو گروه چندپخشی (multicast) مشخص‌شده می‌کند\&. این فقط برای IPv4 کار می‌کند، برای گونه IPv6 گزینه ipv6\-join\-group را ببینید\&. این گزینه نشانی IP گروه چندپخشی و اطلاعات مربوط به رابط شبکه موردنظر را دریافت می‌کند\&. رایج‌ترین نحو همان حالت اول است، در حالی که حالت‌های دیگر تنها روی سیستم‌هایی که \f(CWstruct mreqn\fP را فراهم می‌کنند در دسترس هستند (Linux)\&.
.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>], mcloop[=<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 options)\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 را اضافه کنید\&. برای اطلاعات بیشتر درباره این گزینه‌ها man resolver(5) را ببینید\&. \fBSocat\fP مقادیر قدیمی را پس از اتمام فاز باز کردن آدرس بازیابی می‌کند، بنابراین این گزینه‌ها صرفاً برای همان آدرسی که رویشان اعمال شده‌اند معتبر هستند\&.
.br 
لطفاً توجه داشته باشید که این پرچم‌ها فقط بر تحلیل نام DNS اثر می‌گذارند و نه تحلیل‌های مبتنی بر hosts یا NIS، و در حالتی که (g)libc نتایج را از 
\f(CWnscd\fP
دریافت می‌کند نیز هیچ تأثیری ندارند\&.
.IP "\fB\f(CWres\-retrans=<int>\fP\fP"
فاصله زمانی ارسال مجدد (retransmission) تحلیل‌گر DNS را تنظیم می‌کند (بر اساس یک قابلیت مستند‌نشده)\&.
.IP "\fB\f(CWres\-retry=<int>\fP\fP"
تعداد دفعات ارسال مجدد تحلیل‌گر DNS را تنظیم می‌کند (بر اساس یک قابلیت مستند‌نشده)\&.
.IP "\fB\f(CWres\-nsaddr=<ipaddr>[:<port>]\fP\fP"
تلاش می‌کند تا با نوشتن نشانی IPv4 داده‌شده در فیلد مستند‌نشده 
\f(CW_res:nsaddr_list[0]\fP
تنظیمات کارساز نام (nameserver) بارگذاری‌شده از /etc/resolv\&.conf را بازنویسی کند\&.
فایل 
\f(CW/etc/hosts\fP
همچنان توسط تحلیل‌گر نام بررسی می‌شود\&. لطفاً توجه داشته باشید هنگامی که 
\f(CWnscd\fP
مربوط به glibc\(cq\&s در حال اجرا باشد، همیشه ابتدا از آن پرس‌وجو می‌شود!

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های IP6 (IP6 option group)\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 را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی حاوی گزینه‌های جهش (hop options) را فعال می‌کند\&.
.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 را تنظیم می‌کند\&. این گزینه دریافت و ثبت پیام‌های کمکی حاوی کلاس انتقال را فعال می‌کند\&.
.IP "\fB\f(CWipv6\-multicast\-loop[=<bool>], mcloop6[=<bool>]\fP\fP"
مشخص می‌کند که آیا ترافیک چندپخشی (multicast) خروجی باید به همان رابط شبکه نیز بازگردد (loop back) یا خیر\&.
.IP "\fB\f(CWipv6\-mtu\-discover=<0|1|2>, mtudiscover6=<0|1|2>\fP\fP"
مقادیر 0، 1 یا 2 را می‌پذیرد تا کشف path MTU را روی سوکت IPv6 به‌ترتیب به حالت‌های هرگز (never)، در صورت تمایل (want) یا همیشه (always) تنظیم کند\&.

.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"
در حین شنود، اتصال‌ها را تنها زمانی می‌پذیرد که داده‌ای از طرف مقابل (peer) رسیده باشد\&.
.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"
مدیریت اشاره‌گر اضطراری (urgent pointer) سازگار با 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() پیش از صرف‌نظر کردن تنظیم می‌کند\&. مقدار بر حسب نیم‌ثانیه است، پیش‌فرض ۱۵۰ (۷۵ ثانیه) است (مخصوص Tru64)\&.
.IP "\fB\f(CWpaws\fP\fP"
قابلیت \(dq\&محافظت در برابر شماره توالی‌های دورزده\(dq\& را فعال می‌کند (مخصوص Tru64)\&.
.IP "\fB\f(CWsackena\fP\fP"
تصدیق انتخابی (selective acknowledge) را فعال می‌کند (مخصوص Tru64)\&.
.IP "\fB\f(CWtsoptena\fP\fP"
گزینه برچسب زمانی (time stamp) را که امکان محاسبه مجدد 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"
تعداد بایت‌هایی را که مجموع مقابله‌ای (checksum) برای آن‌ها محاسبه و ارسال می‌شود (\(dq\&پوشش مجموع مقابله‌ای\(dq\&) تنظیم می‌کند\&.
.IP "\fB\f(CWudplite\-recv\-cscov\fP\fP"
تعداد بایت‌هایی را که مجموع مقابله‌ای (checksum) برای آن‌ها بررسی می‌شود (\(dq\&پوشش مجموع مقابله‌ای\(dq\&) تنظیم می‌کند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های SCTP\fP\fP
.PP 
این گزینه‌ها ممکن است برای سوکت‌های جریانی (stream) پروتکل 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، اگر کلاینت از این sourceport استفاده نکند، socat بلافاصله اتصال را می‌بندد\&. نشانی‌های UDP\-RECV، UDP\-RECVFROM، UDP\-SENDTO و UDP\-DATAGRAM در صورت عدم تطابق، بسته را نادیده می‌گیرند
(مثال)\&.
.IP "\fB\f(CWlowport\fP\fP"
اتصال‌های خروجی (کلاینت) با این گزینه، از یک پورت مبدأ تصادفیِ آزاد بین ۶۴۰ تا ۱۰۲۳ (شامل هر دو) استفاده می‌کنند\&. در سیستم‌عامل‌های رده UNIX، این کار نیازمند دسترسی ریشه (root) است و بنابراین نشان می‌دهد که فرایند کلاینت توسط ریشه محلی مجاز شناخته شده است\&.
نشانی‌های شنود TCP و UDP با این گزینه، در صورتی که کلاینت از sourceport کمتر یا مساوی ۱۰۲۳ استفاده نکند، اتصال را بلافاصله قطع می‌کنند\&.
این سازوکار می‌تواند در برخی شرایط، یک سطح دسترسی یا اعتبارسنجی محدود فراهم کند\&.

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

.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 یعنی 8080 را با <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] تنظیم می‌کند\&. پیش‌فرض 5 است\&. 
.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\-CONNECT و OPENSSL\-LISTEN در زمانی که فرزند را منشعب (fork) می‌کنند با یکدیگر تفاوت دارند:
OPENSSL\-LISTEN عمل fork را \fIپیش از\fP دست‌تکانی SSL انجام می‌دهد، در حالی که OPENSSL\-CONNECT عمل fork را \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"
سطح اهمیت پیام‌های لاگ تولیدشده توسط فرایندهای فرزند را کاهش می‌دهد\&. برای نمونه، با مقدار 1 اعلان‌ها (notices) به عنوان 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 به ارث برده می‌شود، و فرایند فرزند از توصیف‌گرهای فایل 0 و 1 برای برقراری ارتباط با فرایند اصلی socat استفاده می‌کند\&.
.IP "\fB\f(CWnofork\fP\fP"
برای اجرای برنامه زیرفرایندی را fork نمی‌کند؛ در عوض execvp() یا system() را مستقیماً از نمونه فعلی socat فراخوانی می‌کند\&. این کار از بار اضافی یک فرایند دیگر بین برنامه و همتای آن جلوگیری می‌کند، اما محدودیت‌های بسیاری به همراه دارد:
.IP o 
این گزینه تنها می‌تواند برای دومین آدرس \fBsocat\fP اعمال شود\&..IP o 
نمی‌تواند بر بخشی از یک آدرس دوگانه (dual address) اعمال شود\&.
.IP o 
آدرس نخست socat نمی‌تواند OPENSSL یا READLINE باشد\&.
.IP o 
گزینه‌های \-b، \-t، \-D، \-l، \-v و \-x در socat بی‌اثر می‌شوند\&.
.IP o 
برای هر دو آدرس، گزینه‌های ignoreeof، cr و crnl بی‌اثر می‌شوند\&.
.IP o 
برای هر دو آدرس، مدیریت خاتمه/بستن مختص آدرس (مانند بستن ملایم سوکت \- graceful socket shutdown) و گزینه‌های مربوطه بی‌اثر می‌شوند\&.
.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"
به جای حالت پیش‌فرض (socketpair یا ptmx)، با استفاده از یک شبه‌ترمینال
ایجادشده توسط 
\f(CWopenpty()\fP
با زیرفرایند ارتباط برقرار می‌کند\&.
.IP "\fB\f(CWptmx\fP\fP"
به جای حالت پیش‌فرض (socketpair)، با استفاده از یک شبه‌ترمینال ایجادشده از طریق
باز کردن \fB/dev/ptmx\fP یا \fB/dev/ptc\fP با زیرفرایند ارتباط برقرار می‌کند\&.
.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"
با ایجاد یک \f(CWdup()\fP از stdout برای stderr، خروجی خطای استاندارد (stderr) زیرفرایند را
به کانال خروجی آن هدایت می‌کند (مثال)\&. 
.IP "\fB\f(CWfdin=<fdnum>\fP\fP"
کانال ورودی زیرفرایند را به جای stdin (0) به توصیف‌گر فایل (file descriptor)
<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 باود (baud) تنظیم می‌کند\&. نرخ‌های دیگر نیز ممکن هستند؛ از
دستوری شبیه به \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) را تنظیم یا پاک می‌کند و میان‌گیری خطی (line buffering) و برخی
نویسه‌های ویژه را فعال می‌سازد\&. 
.IP "\fB\f(CWraw\fP\fP"
حالت خام (raw mode) را تنظیم می‌کند، که باعث می‌شود ورودی و خروجی تقریباً بدون پردازش عبور داده شوند\&. این گزینه منسوخ شده است؛ در عوض از گزینه rawer یا cfmakeraw استفاده کنید\&.
.IP "\fB\f(CWrawer\fP\fP"
ترمینال را از گزینه raw نیز خام‌تر می‌کند\&. این گزینه به طور ضمنی echo را غیرفعال می‌کند\&. (مثال)\&.
.IP "\fB\f(CWcfmakeraw\fP\fP"
با فراخوانی \f(CWcfmakeraw()\fP یا با شبیه‌سازی این فراخوانی، حالت خام را تنظیم می‌کند\&. این گزینه به طور ضمنی echo را غیرفعال می‌کند\&.
.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) را به ترتیب روی 0، 1، 2 یا 3 تنظیم می‌کند\&.
0 به معنای عدم تاخیر است، سایر مقادیر وابسته به ترمینال هستند\&.
.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
اندازه نویسه (character size) را به ترتیب روی 5، 6، 7 یا 8 بیت تنظیم می‌کند\&.
.IP 
.IP "\fB\f(CWcsize=<0|1|2|3>\fP\fP"
.IP "\fB\f(CWcstopb[=<bool>]\fP\fP"
به جای یک بیت، دو بیت توقف (stop bit) تنظیم می‌کند\&.
.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"
نرخ باود (baud rate) را برای داده‌های ورودی روی این خط تنظیم می‌کند\&.
.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"
نرخ باود (baud rate) را برای داده‌های خروجی روی این خط تنظیم می‌کند\&.
.br 
همچنین ببینید: ispeed، b19200
.IP "\fB\f(CWparenb[=<bool>]\fP\fP"
تولید پاریتی در خروجی و بررسی پاریتی برای ورودی را فعال می‌کند\&.
.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"
در UNIX System V STREAMS، تمام درایورها را از پشته حذف می‌کند\&.
.IP "\fB\f(CWi\-push=<string>\fP\fP"
در UNIX System V STREAMS، درایور (ماژول) با نام (رشته) داده‌شده را روی
پشته قرار می‌دهد (push می‌کند)\&. برای نمونه، جهت اطمینان از اینکه یک
دستگاه نویسه‌ای در Solaris از termios و غیره پشتیبانی می‌کند، از گزینه‌های زیر استفاده کنید:
\f(CWi\-pop\-all,i\-push=ptem,i\-push=ldterm,i\-push=ttcompat\fP
.IP "\fB\f(CWtermios\-setflags=<word>:<flags>, setflags=<word>:<flags>\fP\fP"
یک کلمه (word) از \f(CWc_*flag\fP در \f(CWstruct termios\fP را روی مقدار داده‌شده تنظیم می‌کند\&. کلمه 0
برابر \f(CWc_iflag\fP و کلمه 3 برابر \f(CWc_lflag\fP است\&.

.PP 
.br 

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

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های OPENSSL\fP\fP
.PP 
این گزینه‌ها برای انواع آدرس openssl و
openssl\-listen اعمال می‌شوند\&.
.PP 
.IP "\fB\f(CWcipher=<cipherlist>\fP\fP"
فهرست رمزنگاره‌هایی (cipherها) را که ممکن است برای اتصال استفاده شوند مشخص می‌کند\&.
برای اطلاعات تفصیلی دربارهٔ نحو، مقادیر، و پیش‌فرضِ <cipherlist>، به صفحهٔ
راهنمای \f(CWciphers\fP
، بخش \fBCIPHER LIST FORMAT\fP مراجعه کنید\&.
.br 
می‌توان چندین رشتهٔ رمزنگاره را که با \(cq\&:\(cq از هم جدا شده‌اند وارد کرد\&.
برخی رشته‌های رمزنگارهٔ ساده:
.IP "3DES"
از مجموعه رمزنگاری با Triple DES استفاده می‌کند\&.
.IP "MD5"
از مجموعه رمزنگاری با MD5 استفاده می‌کند\&.
.IP "aNULL"
از مجموعه رمزنگاری بدون احراز اصالت استفاده می‌کند\&.
.IP "NULL"
از رمزنگاری استفاده نمی‌کند\&.
.IP "HIGH"
از مجموعه رمزنگاری با رمزنگاری \(dq\&بالا\(dq\& (high) استفاده می‌کند\&.
توجه داشته باشید که طرف مقابل (peer) باید از ویژگی انتخاب‌شده پشتیبانی کند، در غیر این صورت مذاکره
شکست خواهد خورد\&.
.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"
انتخاب نسخهٔ 2 پروتکل SSL\&.
.IP "\f(CWSSL3\fP"
انتخاب نسخهٔ 3 پروتکل SSL\&.
.IP "\f(CWSSL23\fP"
انتخاب بهترین پروتکل موجود SSL یا TLS\&.
.IP "\f(CWTLS1\fP"
انتخاب نسخهٔ 1 پروتکل TLS\&.
.IP "\f(CWTLS1\&.1\fP"
انتخاب نسخهٔ 1\&.1 پروتکل TLS\&.
.IP "\f(CWTLS1\&.2\fP"
انتخاب نسخهٔ 1\&.2 پروتکل TLS\&.
هنگامی که این گزینه ارائه نشود، OpenSSL روش را با همتای (peer) خود
مذاکره می‌کند\&.
.IP "\fB\f(CWopenssl\-min\-proto\-version=<string>\fP\fP, \fB\f(CWmin\-proto\-version=<string>\fP\fP"
این گزینه به OpenSSL می‌گوید که از این نسخه یا نسخه‌های بالاتر پروتکل SSL/TLS استفاده کند
و از پذیرش پروتکل پایین‌تر/قدیمی‌تر خودداری نماید\&. نحو معتبر عبارت است از:
.IP "\f(CWSSL2\fP"
انتخاب نسخهٔ 2 پروتکل SSL\&.
.IP "\f(CWSSL3\fP"
انتخاب نسخهٔ 3 پروتکل SSL\&.
.IP "\f(CWTLS1\fP"
.IP "\f(CWTLS1\&.0\fP"
انتخاب نسخهٔ 1 پروتکل 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=<string>\fP\fP, \fB\f(CWmax\-proto\-version=<string>\fP\fP"
این گزینه مشابه min\-proto\-version است،
با این حال، استفاده از نسخهٔ پروتکل بالاتر را مجاز نمی‌داند\&. برای آزمایش
همتا (peer) مفید است\&.
.IP "\fB\f(CWverify[=<bool>]\fP\fP"
بررسی گواهی همتا (peer) را کنترل می‌کند\&. مقدار پیش‌فرض 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، بیشینه اندازه قطعه ممکن است در صورت ارسال Maximum Fragment Length Negotiation Request توسط کلاینت، بیشتر محدود شود\&.
.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"
از قابلیت Server Name Indication (SNI) در سمت کلاینت که گواهی سرور مدنظر را انتخاب می‌کند، استفاده نمی‌کند\&.
.br 
نکته: SNI از نسخه 1\&.7\&.4\&.0 ابزار \fBsocat\fP به صورت خودکار استفاده می‌شود و از commonname یا نام میزبان داده‌شده استفاده می‌کند\&.
.IP "\fB\f(CWsnihost=<string>\fP\fP"
نام میزبان Server Name Indication (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])\&. پیش‌فرض 1 ثانیه است\&.
.IP "\fB\f(CWforever\fP\fP"
تعداد نامحدودی از تلاش‌های مجدد را انجام می‌دهد\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های INTERFACE\fP\fP
.PP 
این گزینه‌ها ممکن است برای آدرس‌های INTERFACE و TUN اعمال شوند\&. این نوع آدرس‌ها و گزینه‌ها در حال حاضر تنها در سیستم‌عامل لینوکس پیاده‌سازی شده‌اند\&.
.PP 
نکته درباره VLANها: در بسته‌های ورودی، هسته لینوکس برچسب VLAN را پیش از تحویل داده‌ها به برنامه فضای کاربری روی سوکت‌های خام (raw sockets) حذف می‌کند\&. برای دریافت اطلاعات 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 را تنظیم می‌کند\&.
.IP "\fB\f(CWinterface\-mtu=<num> (if\-mtu=<num>)\fP\fP"
مقدار MTU رابط‌ها را با استفاده از رابط netlink تنظیم می‌کند\&.

.PP 
.br 

.PP 
\fI\fBگروه گزینه‌های TUN\fP\fP
.PP 
گزینه‌هایی که آدرس‌های دستگاه رابط TUN/TAP لینوکس را کنترل می‌کنند\&.
.PP 
.IP "\fB\f(CWtun\-device=<device\-file>\fP\fP"
به socat دستور می‌دهد که مسیر دیگری را برای دستگاه شبیه‌سازی 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=<link(TYPE_UNSIGNED_INT)(unsigned int)>\fP (mq\-prio)\fP"
)
اولویت پیام‌ها (بسته‌ها)ی نوشته‌شده در صف، یا کمینه اولویت بسته‌ای را که باید از صف خوانده شود، تعیین می‌کند\&.
.IP "\fB\f(CWposixmq\-flush (mq\-flush)\fP\fP"
پیش از آغاز انتقال، تمام پیام‌های موجود در صف را \(dq\&مصرف\(dq\& (حذف) می‌کند\&.
.IP "\fB\f(CWposixmq\-maxmsg=<long> (mq\-maxmsg)\fP\fP"
پارامتر maxmsg صف پیام POSIX را هنگام ایجاد آن تعیین می‌کند\&.
.br 
نکته: این گزینه تنها زمانی اعمال می‌شود که صف از قبل وجود نداشته باشد\&.
.br 
نکته: این مقدار توسط تنظیمات هسته در
\f(CW/proc/sys/fs/mqueue/msg_max\fP
محدود شده است و پیش‌فرض سیستم تا حد 10 پایین است\&..IP "\fB\f(CWposixmq\-msgsize=<long> (mq\-msgsize)\fP\fP"
هنگام ایجاد صف پیام POSIX، پارامتر msgsize آن را تنظیم می‌کند\&.
.br 
نکته: این گزینه فقط زمانی اعمال می‌شود که صف از قبل وجود نداشته باشد\&.
.br 
نکته: این مقدار توسط تنظیم هسته
\f(CW/proc/sys/fs/mqueue/msgsize_max\fP
محدود می‌شود\&.

.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"
یک عدد unsigned int، خوانده‌شده با 
\f(CWstrtoul()\fP
، کوچک‌تر یا مساوی با
\f(CWUCHAR_MAX\fP
\&.
.IP "command\-line"
رشته‌ای که نام یک برنامه و آرگومان‌های آن را مشخص می‌کند، جداشده با یک فاصله ساده\&. 
.IP "data"
این یک مشخصه عمومی‌تر داده است، \(dq\&dalan\(dq\& (زبان توصیف داده سطح پایین)\&. رشته متنی داده‌شده حاوی اطلاعاتی درباره نوع داده هدف و مقدار آن است\&. به‌طور کلی نویسه آغازین نوع موردِ داده بعدی را مشخص می‌کند\&. در زمینه خاص آن ممکن است یک نوع داده پیش‌فرض وجود داشته باشد\&.
.br 
در حال حاضر فقط مشخصات زیر پیاده‌سازی شده‌اند:
.br 
.IP "i"
یک عدد صحیح علامت‌دار، ذخیره‌شده به ترتیب بایت میزبان (host byte order)\&.
.br 
مثال:    \fBi\-1000\fP    (عدد صحیح \-1000)
.IP "I"
یک عدد صحیح بدون علامت، ذخیره‌شده به ترتیب بایت میزبان\&.
.br 
.IP "l"
یک عدد صحیح بلند علامت‌دار، ذخیره‌شده به ترتیب بایت میزبان\&.
.br 
.IP "L"
یک عدد صحیح بلند بدون علامت، ذخیره‌شده به ترتیب بایت میزبان\&.
.br 
.IP "s"
یک عدد صحیح کوتاه علامت‌دار، ذخیره‌شده به ترتیب بایت میزبان\&.
.br 
.IP "S"
یک عدد صحیح کوتاه بدون علامت، ذخیره‌شده به ترتیب بایت میزبان\&.
.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\&"
یک نویسه تکی (char)، با تبدیل‌های معمول\&. لطفاً توجه داشته باشید که نقل‌قول‌ها و بک‌اسلش‌ها باید از پوسته و تبدیل \fBsocat\fP اسکیپ شوند\&.
.br 
مثال:    \fB\(cq\&a\(cq\&\fP
موارد داده را می‌توان با فاصله (whitespace) جدا کرد بدون نیاز به تکرار دوباره مشخص‌کننده نوع\&.
.IP "directory"
رشته‌ای با معناشناسی معمول نام دایرکتوری UN*X\&.
.IP "facility"
نام یک facility در syslog با حروف کوچک\&.
.IP "fdnum"
نوعی از unsigned int، خوانده‌شده با 
\f(CWstrtoul()\fP
، که یک توصیف‌گر فایل UN*X را مشخص می‌کند\&. 
.IP "filename"
رشته‌ای با معناشناسی معمول نام فایل UN*X\&.
.IP "group"
اگر نویسه اول یک رقم ده‌دهی باشد، مقدار با
\f(CWstrtoul()\fP
به‌صورت یک عدد صحیح بدون علامت خوانده می‌شود که یک شناسه گروه (group id) را مشخص می‌کند\&. در غیر این صورت، باید نام یک گروه موجود باشد\&.
.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
، که شناسه فرایند (PID) را مشخص می‌کند\&.
.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
تحلیل می‌شود، یا یک عدد ۱۶ بیتی unsigned int خوانده‌شده با
\f(CWstrtoul()\fP
\&.
.IP "timeval"
یک عدد ممیز شناور با دقت مضاعف (double float) که ثانیه‌ها را مشخص می‌کند؛ عدد درون یک struct timeval، متشکل از ثانیه‌ها و میکروثانیه‌ها نگاشت می‌شود\&.
.IP "timespec"
یک عدد ممیز شناور با دقت مضاعف (double float) که ثانیه‌ها را مشخص می‌کند؛ عدد درون یک struct timespec، متشکل از ثانیه‌ها و نانوثانیه‌ها نگاشت می‌شود\&.
.IP "UDP service"
نام یک سرویس، بدون شروع با رقم، که توسط
\f(CWgetservbyname()\fP
تحلیل می‌شود، یا یک عدد ۱۶ بیتی unsigned int خوانده‌شده با
\f(CWstrtoul()\fP
\&..IP "unsigned int"
عددی که با 
\f(CWstrtoul()\fP
خوانده می‌شود\&. مقدار باید در یک unsigned int در زبان C بگنجد\&. 
.IP "user"
اگر نویسه نخست یک رقم ده‌دهی باشد، مقدار با
\f(CWstrtoul()\fP
به‌عنوان یک عدد صحیح بدون علامت که شناسه کاربر (user id) را مشخص می‌کند خوانده می‌شود\&. در غیر این صورت، باید نام یک کاربر موجود باشد\&.
.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 به پورت ۸۰ از میزبان
www\&.domain\&.org انتقال می‌دهد\&. این مثال نتیجه‌ای مشابه یک اتصال تعاملی با
telnet یا netcat دارد\&. پارامترهای ترمینال stdin تغییر داده نمی‌شوند، بنابراین می‌توانید
بازپخش (relay) را با ^D ببندید یا با ^C آن را متوقف کنید\&.
.IP 
\.LP
\.nf
\fBsocat -d -d \\
\.RS
\fBREADLINE,history=$HOME/.http_history \\ 
TCP4:www.domain.org:www,crnl\fP
\.RE
\.fi
.IP 
این مثال شبیه به مورد پیشین است، با این تفاوت که می‌توانید سطر فعلی را به شیوه‌ای مشابه
bash ویرایش کنید (READLINE) و از فایل
تاریخچه \&.http_history بهره ببرید؛ \fBsocat\fP پیام‌هایی را درباره
پیشرفت فرایند چاپ می‌کند (\-d \-d)\&. پورت بر اساس نام سرویس
(www) مشخص شده است، و نویسه‌های درست پایان سطر شبکه
(crnl) به جای NL استفاده شده‌اند\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP4-LISTEN:www \\ 
TCP4:www.domain.org:www\fP
\.RE
\.fi
.IP 
یک فورواردر ساده پورت TCP را برپا می‌کند\&. با
گزینه TCP4\-LISTEN روی پورت محلی \(dq\&www\(dq\& تا زمان برقراری
یک اتصال به گوش می‌نشیند، آن را می‌پذیرد (accept)، سپس به میزبان دوردست
(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 پس از انشعاب، تا حدی امنیت ایجاد می‌کند؛ تنها به اتصالاتِ شبکه خصوصی 10 اجازه دسترسی می‌دهد
(range)؛ به لطف reuseaddr، راه‌اندازی مجددِ فوری پس از خاتمه فرایند والد ممکن است، حتی اگر برخی از سوکت‌های فرزند کاملاً بسته نشده باشند\&.
با گزینه \-lmlocal2، برنامه socat تا زمان رسیدنِ موفقیت‌آمیز به حلقه accept لاگ‌ها را به stderr ارسال می‌کند\&. لاگ‌های بعدی به syslog با تسهیلات (facility) محلی local2 هدایت می‌شوند\&.
.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 را پیاده‌سازی می‌کند\&. این اسکریپت طوری برنامه‌ریزی شده است که با پروتکل SMTP روی توصیف‌گرهای فایل (FDs) شماره ۳ (ورودی) و ۴ (خروجی) تبادل داده کند\&.
گزینه‌های 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 را با نویسه control\-O فراهم می‌کند\&. 
می‌توانید استفاده از READLINE را به جای نشانی نخست مد نظر قرار دهید\&.
.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 باز می‌کند\&. این مسیر متناظر با
نمایشگر محلی XWindow یعنی :1 روی رایانه شماست، بنابراین اتصالات کلاینت XWindow به
DISPLAY=:1 پذیرفته می‌شوند\&. سپس \fBSocat\fP با سرور SOCKS4 یعنی host\&.victim\&.org ارتباط برقرار می‌کند که ممکن است
به دلیل یک ضعف مرتبط با FTP در فیلترهای ایستا IP خود، اتصالات مبتنی بر sourceport 20 را بپذیرد\&.
\fBSocat\fP وانمود می‌کند که توسط socksuser به نام nobody فراخوانی شده است، و درخواست می‌کند که به
پورت لوپ‌بک ۶۰۰۰ متصل شود (تنها پیکربندی‌های ضعیف sockd اجازه چنین کاری را می‌دهند)\&. بنابراین ما به
سرور XWindow هدف متصل می‌شویم و اگر نیازی به کوکی‌های MIT
یا احراز هویت Kerberos نداشته باشد، می‌توانیم کار خود را آغاز کنیم\&. لطفاً توجه داشته باشید که در هر زمان تنها
یک اتصال می‌تواند برقرار باشد، چرا که 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\&
همچنین می‌تواند یک سوکت یونیکس دامین شنونده (listening UNIX domain socket) باشد (در این صورت از گزینه 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 به server برقرار و اجرا می‌کند\&. از یک pty برای ارتباط میان \fBsocat\fP و
ssh استفاده می‌کند، آن را به controlling 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
\fBREADLINE,noecho='[Pp]assword:' \\ 
EXEC:'ftp ftp.server.com',pty,setsid,ctty\fP
\.RE
\.fi
.IP 
یک تاریخچه خط فرمان (READLINE) را به دور ابزار کلاینت ftp اجراشده با EXEC اضافه می‌کند\&.
این کار امکان ویرایش و استفاده مجدد از دستورهای FTP را برای مرور نسبتاً راحت
در سلسله‌مراتب پوشه‌های ftp فراهم می‌سازد\&. گذرواژه نمایش داده می‌شود (echo)!
برای اینکه ftp اعلان دستور (prompt) صادر کند، وجود pty الزامی است\&.
با این وجود، ممکن است تداخل یا ابهاماتی در ارتباط با گذرواژه و اعلان‌های
FTP رخ دهد\&.
.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 
یک شنونده در network namespace داده‌شده ایجاد می‌کند که اتصالات TCP را
روی پورت 8000 پذیرفته و آن‌ها را به server2 هدایت (forward) می‌کند\&.
.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 
دو رابط شبکه مجازی ایجاد می‌کند، یکی در namespace پیش‌فرض و دیگری
در 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 
یک هدایت‌کننده (forwarder) را آغاز می‌کند که اتصالات را روی پورت 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) به اندازه 100GB+1B ایجاد می‌کند؛ این کار نیازمند نوعی سیستم فایل است که
از آن پشتیبانی کند (ext2, ext3, ext4, reiserfs, xfs؛ نه minix, vfat)\&. عملیات
نوشتن ۱ بایت ممکن است زمان‌بر باشد (reiserfs: چند دقیقه؛ ext2: بدون زمان \(dq\&no\(dq\& time)، و
فایل حاصل ممکن است صرفاً به خاطر inodeهای خود مقداری از فضای دیسک را اشغال کند (reiserfs:
مقدار 2MB؛ ext2: مقدار 16KB)\&. 
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP-L:7777,reuseaddr,fork \\ 
SYSTEM:'filan -i 0 -s >&2',nofork\fP
\.RE
\.fi
.IP 
برای اتصالات ورودی TCP روی پورت 7777 به شنود می‌نشیند\&. به ازای هر اتصال
پذیرفته‌شده، یک شل را فراخوانی می‌کند\&. این شل stdin و stdout خود را به‌طور مستقیم
به سوکت TCP متصل دارد (nofork)\&.  شل دستور filan را اجرا کرده و باعث می‌شود آدرس‌های سوکت را در
stderr (پنجره ترمینال شما) چاپ کند\&..IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBSTDIO,cfmakeraw \\ 
SHELL,pty,setsid,ctty,stderr\fP
\.RE
\.fi
.IP 
یک پوسته در پایانه‌ی فعلی ایجاد می‌کند که کنترل کارها (job control)، تاریخچه و غیره را فراهم می‌سازد\&.
.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 را در آفست 0x00074420 از فایل اجرایی /usr/bin/squid\&.exe می‌نویسد (این یک وصله‌ی واقعی در سال ۲۰۰۴ برای اجرای فایل اجرایی squid مربوط به Cygwin تحت Windows بود)\&.
.IP 
\.LP
\.nf
\fBsocat - \\
\.RS
\fBTCP:www.blackhat.org:31337,readbytes=1000\fP
\.RE
\.fi
.IP 
به یک سرویس ناشناخته متصل می‌شود و از سرریز شدن داده‌ها جلوگیری می‌کند\&.
.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 توسط فرآیندهای فرزند (که توسط نشانی دوم fork شده‌اند) جلوگیری می‌کند (تابع close(2) تنها ارجاع inode را حذف می‌کند که تا زمان حیات فرآیند والد فعال باقی می‌ماند؛ در حالی که shutdown(2) اتصال را به‌طور فعال خاتمه می‌دهد)\&.
.IP 
\.LP
\.nf
\fBsocat \\
\.RS
\fBTCP-LISTEN:10021,reuseaddr,socktype=6,protocol=33,fork \PIPE\fP
\.RE
\.fi
.IP 
یک سرور اکو (echo server) ساده‌ی DCCP است\&. اکنون DCCP مستقیماً در \fBsocat\fP تعبیه شده است، اما این مثال نشان می‌دهد چگونه می‌توان از روال‌های TCP در \fBsocat\fP استفاده کرد و نوع سوکت را به SOCK_DCCP=6 (در Linux) و پروتکل 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 (در Linux) و پروتکل 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 
از نظر معنایی معادل مثال قبلی است، اما تمامی پارامترها در قالبی عمومی (generic) مشخص شده‌اند\&. مقدار 6 برای setsockopt\-int همان مقدار معادل \f(CWSO_BROADCAST\fP در Linux است\&.
.IP 
\.LP
\.nf
\fBsocat - \\
\.RS
\fBIP4-DATAGRAM:255.255.255.255:44,broadcast,range=10.0.0.0/8\fP
\.RE
\.fi
.IP 
با استفاده از پروتکل 44 یک برودکست به شبکه‌(های) محلی ارسال می‌کند\&. تنها پاسخ‌ها را از محدوده‌ی نشانی‌های خصوصی می‌پذیرد\&.
.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 
با استفاده از UDP داده‌ها را از stdin به نشانی چندپخشی (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، حفظ مرز بسته‌ها را تضمین نمی‌کند و از این رو ممکن است باعث از دست رفتن بسته‌ها (packet loss) شود\&.
.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 با سیستم مهمان (guest) دارای CID=31 روی پورت 1234 برقرار کرده و سوکت محلی را به پورت 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 که روی پورت VSOCK 22 گوش می‌دهد هدایت می‌کند\&.
در صورتی که میهمان مثال بالا را اجرا کند، اجرای این دستور در میزبان به شما اجازه می‌دهد با اجرای
\(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 به یک دستگاه سریال نیاز دارد و بنابراین ممکن است نتواند روی یک خط همگام (synchronous) که توسط یک دستگاه شبکه نمایش داده می‌شود کار کند، دور می‌زند\&.
دستور socat یک PTY برای راضی نگه‌داشتن pppd ایجاد کرده، به رابط شبکهٔ \f(CWhdlc0\fP متصل می‌شود، و می‌تواند داده‌ها را میان هر دو دستگاه انتقال دهد\&. سپس از 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 (یعنی خطوط ورودی هنگام اجرای تعاملی) را با اولویت 10 در صف پیام‌های POSIX می‌نویسد\&.
.IP 
\.LP
\.nf
\fBsocat -u \\
\.RS
\fBPOSIXMQ-RECV:/queue1,fork,max-children=3 \\ 
SYSTEM:"worker.sh"\fP
.IP 
\.RE
\.fi
.IP 
پیام‌ها (بسته‌ها) را از صف پیام‌های POSIX دریافت کرده و برای هر پیام، یک زیرفرآیند منشعب (fork) می‌کند که پیام را خوانده و پردازش می‌نماید\&. در هر لحظه حداکثر ۳ زیرفرآیند به صورت هم‌زمان مجاز است\&.
.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 
یک کارساز پژواک (echo server) بسیار ابتدایی HTTP ایجاد می‌کند: هر کلاینت HTTP که متصل می‌شود یک پاسخ معتبر HTTP دریافت می‌کند که حاوی اطلاعاتی دربارهٔ نشانی و پورت کلاینت آن‌گونه که توسط میزبان کارساز دیده می‌شود، نشانی میزبان (که ممکن است روی کارسازهای چندشبکه‌ای [multihomed] متغیر باشد)، و درخواست اصلی کلاینت است\&.
.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 
منتظر یک بستهٔ ورودی UDP روی پورت 9999 می‌ماند و متغیرهای محیطی ارائه‌شده توسط 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 (پروتکل کشف سادهٔ سرویس یا Simple Service Discovery Protocol) به شبکهٔ محلی ارسال کرده و پاسخ‌های دریافت‌شده را جمع‌آوری و چاپ می‌کند\&.
.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، منتظر یک اتصال روی پورت مشخص‌شده می‌ماند\&. این برنامه اتصال را قبول (accept) نمی‌کند، بلکه توصیف‌گر فایل در حال گوش دادن را به عنوان FDهای 0 و 1 منتقل می‌کند\&. دستور \fBSocat\fP اتصالِ در انتظار را می‌پذیرد و انتقال داده را آغاز می‌نماید\&.
.IP 
\.LP
\.nf
\fBsudo socat -u TEXT:"0 $((2**31-1))" /proc/sys/net/ipv4/ping_group_range\fP
\.RE
\.fi
.IP 
با استفاده از نشانی TEXT در \fBsocat\fP به جای لوله‌کشی (pipe) آن به \f(CWtee\fP تحت \f(CWsudo\fP، متنی را به کمک \f(CWsudo\fP در یک فایل \f(CW/proc/sys/\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 در وضعیتی مشابه حالت کارساز (server mode)\&.
.IP "INFO:"
شرح کارهایی که برنامه انجام می‌دهد و احتمالاً چرایی وقوع آن‌ها\&. امکان پایش چرخه حیات توصیف‌کننده‌های فایل (file descriptors) را فراهم می‌سازد\&.
.IP "DEBUG:"
شرح نحوه عملکرد برنامه، تمامی فراخوانی‌های سیستمی یا کتابخانه‌ای و نتایج آن‌ها\&.

.PP 
پیام‌های گزارش می‌توانند در stderr، در یک فایل یا در syslog نوشته شوند\&.
.PP 
در هنگام خروج، اگر \fBsocat\fP به‌دلیل EOF یا پایان مهلت عدم‌فعالیت (inactivity timeout) متوقف شده باشد وضعیت 0، در صورت بروز خطا مقداری مثبت، و در صورت بروز خطای مهلک (fatal error) مقداری منفی بازمی‌گرداند\&.
.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 (ورودی)"
(مقادیر 4 یا 6) نسخه IP مورد استفاده برای آدرس‌های listen، recv، و recvfrom را در صورتی که گزینه pf (protocol\-family) داده نشده باشد تعیین می‌کند\&. توسط گزینه‌های \-4 یا \-6 دستور socat بازنویسی می‌شود\&.
.IP 
.IP "\fBSOCAT_PREFERRED_RESOLVE_IP\fP (ورودی)"
(مقادیر 0، 4، یا 6) نسخه IP مورد استفاده هنگام تفکیک نام میزبان مقصد را تعیین می‌کند، در صورتی که نسخه توسط نوع آدرس، گزینه pf (protocol\-family)، یا قالب آدرس مشخص نشده باشد\&. اگر تفکیک نام مدخل منطبقی را بازنگرداند، نخستین نتیجه (با نسخه IP متفاوت) انتخاب می‌شود\&. با مقدار 0، socat همواره اولین رکورد و نسخه IP آن را برمی‌گزیند\&.
.IP 
.IP "\fBSOCAT_MAIN_WAIT\fP (ورودی)"
مدت زمان (به ثانیه) به خواب رفتن فرایند اصلی در آغاز تابع main\e() را تعیین می‌کند\&. برای اشکال‌زدایی کاربرد دارد\&.
.IP 
.IP "\fBSOCAT_TRANSFER_WAIT\fP (ورودی)"
مدت زمان (به ثانیه) به خواب رفتن فرایند پس از باز کردن آدرس‌ها و پیش از ورود به حلقه انتقال را تعیین می‌کند\&. برای اشکال‌زدایی کاربرد دارد\&.
.IP 
.IP "\fBSOCAT_FORK_WAIT\fP (ورودی)"
مدت زمان (به ثانیه) به خواب رفتن فرایندهای والد و فرزند را پس از یک fork() موفقیت‌آمیز تعیین می‌کند\&. برای اشکال‌زدایی کاربرد دارد\&.
.IP 
.IP "\fBSOCAT_VERSION\fP (خروجی)"
دستور 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 (خروجی)"
دستور socat این متغیر را روی شناسه فرایند (PID) خود تنظیم می‌کند\&. در صورت استفاده از گزینه آدرس fork، متغیر SOCAT_PID شناسه فرایند فرزند را دریافت می‌کند\&. انشعاب فرایند (forking) برای exec، system، و SHELL مقدار SOCAT_PID را تغییر نمی‌دهد\&.
.IP 
.IP "\fBSOCAT_PPID\fP (خروجی)"
دستور socat این متغیر را روی شناسه فرایند خود تنظیم می‌کند\&. در صورت fork، متغیر SOCAT_PPID شناسه pid فرایند اصلی (master) را نگه می‌دارد\&.
.IP 
.IP "\fBSOCAT_PEERADDR\fP (خروجی)"
در آدرس‌های سوکت غیرفعال (تمامی آدرس‌های LISTEN و RECVFROM)، این متغیر روی رشته‌ای که آدرس سوکت طرف مقابل (peer) را توصیف می‌کند تنظیم می‌شود\&. اطلاعات درگاه (port) شامل آن نمی‌شود\&.
.IP 
.IP "\fBSOCAT_PEERPORT\fP (خروجی)"
در آدرس‌های سوکت غیرفعال مناسب (TCP، UDP، و SCTP \- LISTEN و RECVFROM)، این متغیر روی رشته‌ای حاوی شماره درگاه طرف مقابل تنظیم می‌شود\&.
.IP 
.IP "\fBSOCAT_SOCKADDR\fP (خروجی)"
در تمامی آدرس‌های LISTEN، این متغیر روی رشته‌ای که آدرس سوکت محلی را توصیف می‌کند تنظیم می‌شود\&. اطلاعات درگاه گنجانده نمی‌شود\&.
.IP 
.IP "\fBSOCAT_SOCKPORT\fP (خروجی)"
در آدرس‌های TCP\-LISTEN، UDP\-LISTEN، و SCTP\-LISTEN، این متغیر روی درگاه محلی تنظیم می‌شود\&.
.IP 
.IP "\fBSOCAT_TIMESTAMP\fP (خروجی)"
در تمامی آدرس‌های RECVFROM که گزینه آدرس so\-timestamp در آن‌ها اعمال شده است، socat این متغیر را روی برچسب زمانی حاصل تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_OPTIONS\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-recvopts در آن‌ها اعمال شده است، socat این متغیر را با گزینه‌های IP بسته دریافتی پر می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_DSTADDR\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-recvdstaddr (در BSD) یا ip\-pktinfo (در سایر پلتفرم‌ها) در آن‌ها اعمال شده است، socat این متغیر را روی آدرس مقصد بسته دریافتی تنظیم می‌کند\&. این متغیر به‌ویژه برای شناسایی بسته‌های آدرس‌دهی‌شده همگانی (broadcast) و چندپخشی (multicast) مفید است\&.
.IP 
.IP "\fBSOCAT_IP_IF\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-recvif (در BSD) یا ip\-pktinfo (در سایر پلتفرم‌ها) در آن‌ها اعمال شده است، socat این متغیر را روی نام رابطی که بسته از آن دریافت شده است تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_LOCADDR\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-pktinfo در آن‌ها اعمال شده است، socat این متغیر را روی آدرس رابطی که بسته از آن دریافت شده تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_TOS\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-recvtos در آن‌ها اعمال شده است، socat این متغیر را روی TOS (نوع سرویس) بسته دریافتی تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IP_TTL\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv4 که گزینه آدرس ip\-recvttl در آن‌ها اعمال شده است، socat این متغیر را روی TTL (طول عمر) بسته دریافتی تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_HOPLIMIT\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv6 که گزینه آدرس ipv6\-recvhoplimit در آن‌ها اعمال شده است، socat این متغیر را روی مقدار hoplimit بسته دریافتی تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_DSTADDR\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv6 که گزینه آدرس ipv6\-recvpktinfo در آن‌ها اعمال شده است، socat این متغیر را روی آدرس مقصد بسته دریافتی تنظیم می‌کند\&.
.IP 
.IP "\fBSOCAT_IPV6_TCLASS\fP (خروجی)"
در تمامی آدرس‌های RECVFROM مبتنی بر IPv6 که گزینه آدرس ipv6\-recvtclass در آن‌ها اعمال شده است، \fBsocat\fP این متغیر را روی کلاس انتقال بسته دریافتی تنظیم می‌کند\&..IP 
.IP "\fBSOCAT_OPENSSL_X509_ISSUER\fP (خروجی)"
فیلد Issuer از گواهی طرف مقابل (peer)
.IP 
.IP "\fBSOCAT_OPENSSL_X509_SUBJECT\fP (خروجی)"
فیلد Subject از گواهی طرف مقابل
.IP 
.IP "\fBSOCAT_OPENSSL_X509_COMMONNAME\fP (خروجی)"
مدخل‌های commonName از موضوع (subject) گواهی طرف مقابل\&. مقادیر چندگانه با \(dq\& // \(dq از یکدیگر جدا می‌شوند\&.
.IP 
.IP "\fBSOCAT_OPENSSL_X509_*\fP (خروجی)"
تمام مدخل‌های دیگر از موضوع (subject) گواهی طرف مقابل
.IP 
.IP "\fBSOCAT_OPENSSL_X509V3_DNS\fP (خروجی)"
مدخل‌های DNS از افزونه‌های (extensions) گواهی طرف مقابل \- فیلد subjectAltName\&. مقادیر چندگانه با \(dq\& // \(dq از یکدیگر جدا می‌شوند\&.
.IP 
.IP "\fBHOSTNAME\fP (ورودی)"
برای تعیین نام میزبان جهت ثبت وقایع (لاگ‌گیری) استفاده می‌شود (به
\-lh مراجعه کنید)\&.
.IP 
.IP "\fBLOGNAME\fP (ورودی)"
اگر هیچ socksuser مشخص نشده باشد، به عنوان نام کاربری کلاینت socks استفاده
می‌شود\&.
.br 
با گزینه‌های su و
su\-d، متغیر LOGNAME روی نام کاربری داده‌شده تنظیم می‌شود\&.
.IP 
.IP "\fBUSER\fP (ورودی)"
اگر هیچ socksuser مشخص نشده باشد و LOGNAME خالی باشد، به عنوان نام کاربری
کلاینت socks استفاده می‌شود\&.
.br 
با گزینه‌های su و
su\-d، متغیر USER روی نام کاربری داده‌شده تنظیم می‌شود\&.
.IP 
.IP "\fBSHELL\fP (خروجی)"
با گزینه‌های su و
su\-d، متغیر SHELL روی پوستهٔ ورود (login shell) کاربر داده‌شده
تنظیم می‌شود\&.
.IP 
.IP "\fBPATH\fP (خروجی)"
می‌تواند با گزینهٔ path برای نشانی‌های exec،‏
system و SHELL تنظیم شود\&.
.IP 
.IP "\fBHOME\fP (خروجی)"
با گزینه‌های su و
su\-d، متغیر HOME روی دایرکتوری خانگی کاربر
داده‌شده تنظیم می‌شود\&.
.IP 
.SH "قدردانی‌ها (CREDITS)"

.PP 
تلاش‌ها و آثار گروه‌ها و سازمان‌های زیر برای این پروژه بسیار ارزشمند
بوده است:
.PP 
پروژهٔ \fIFSF\fP ‏(GNU، 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\&.1 از \fBsocat\fP را شرح می‌دهد\&.
.PP 
.SH "گزارش باگ‌ها (BUGS)"

.PP 
نشانی‌ها نمی‌توانند تودرتو باشند، بنابراین یک فرایند منفرد socat نمی‌تواند، به عنوان مثال، ssl
را روی socks اجرا کند\&.
.PP 
گزینهٔ نشانی ftruncate بدون مقدار، به جای 0 از مقدار پیش‌فرض 1 استفاده می‌کند\&.
.PP 
حالت‌های پرگویی (\-x و/یا \-v) در هنگام استفاده از گزینه‌های نشانی cr یا crnl، نویسه‌های پایان خط
را به طور ناهماهنگ نمایش می‌دهند: آن‌ها داده‌ها را در هر دو جهت، \fIپس از\fP
تبدیل نشان می‌دهند\&.
.PP 
تنظیم اندازه بلوک انتقال داده (\-b) با نشانی 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> و مشارکت‌کنندگان