." : smtpctl.8,v 1.66 2023/03/02 17:09:53 jmc Exp $ ." ." Copyright (c) 2006 Pierre-Yves Ritschard ." Copyright (c) 2012 Gilles Chehade ." ." Permission to use, copy, modify, and distribute this software for any ." purpose with or without fee is hereby granted, provided that the above ." copyright notice and this permission notice appear in all copies. ." ." THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES ." WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF ." MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ." ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES ." WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ." ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF ." OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. ." .Dd : March 2 2023 $ .Dt SMTPCTL 8 .Os .Sh "نام (NAME)" .Nm smtpctl , .Nm mailq .Nd کنترل دیمن SMTP .Sh "خلاصه دستور (SYNOPSIS)" .Nm .Ar دستور .Op Ar آرگومان ... .Nm mailq .Sh "توضیحات (DESCRIPTION)" برنامه .Nm دیمن .Xr smtpd 8 را کنترل می‌کند. دستورات را می‌توان به کوتاه‌ترین پیشوند بدون ابهام خلاصه کرد؛ برای نمونه، .Cm sh ro به جای .Cm show routes . .Pp دستور .Nm mailq جهت سازگاری با سایر MTAها ارائه شده است و صرفاً یک میان‌بر برای .Cm show queue می‌باشد. .Pp دستورات زیر در دسترس هستند: .Bl -tag -width Ds .It Cm discover Ar envelope-id | message-id زمان‌بندی مجدد یک پاکت نامه (envelope)، یا تمام پاکت‌های دارای همان شناسه پیام (message ID) که به صورت دستی به صف منتقل شده بودند. .It Cm encrypt Op Ar string رمزگذاری گذرواژه .Ar string به قالبی مناسب برای اعتبارنامه‌های کاربر و چاپ آن در خروجی استاندارد. اگر .Ar string مشخص نشده باشد، گذرواژه‌ها به صورت متن آشکار از ورودی استاندارد خوانده می‌شوند. .Pp توصیه می‌شود از ارائه گذرواژه به عنوان پارامتر خودداری کنید زیرا از طریق خروجی دستورات .Xr top 1 و .Xr ps 1 قابل مشاهده خواهد بود. .It Cm log brief غیرفعال کردن ثبت گزارش‌های اشکال‌زدایی پرجزئیات. .It Cm log verbose فعال کردن ثبت گزارش‌های اشکال‌زدایی پرجزئیات. .It Cm monitor نمایش به‌روزرسانی‌های برخی شمارنده‌های داخلی .Xr smtpd 8 در فواصل یک ثانیه‌ای. هر خط افزایش همه شمارنده‌ها را از زمان آخرین به‌روزرسانی گزارش می‌دهد، به جز برخی شمارنده‌ها که همواره مقادیر مطلق هستند. سطر اول مقدار جاری هر شمارنده را گزارش می‌کند. فیلدها عبارتند از: .Pp .Bl -bullet -compact .It تعداد فعلی کلاینت‌های فعال SMTP (مقدار مطلق). .It کلاینت‌های جدید SMTP. .It کلاینت‌های قطع‌شده. .It تعداد فعلی پاکت‌ها در صف (مقدار مطلق). .It پاکت‌های به تازگی وارد صف‌شده. .It پاکت‌های خارج‌شده از صف. .It تحویل‌های موفق. .It شکست‌های موقت. .It شکست‌های دائمی. .It حلقه‌های پیام (message loops). .It پاکت‌های منقضی‌شده. .It پاکت‌های حذف‌شده توسط مدیر سیستم. .It پیام‌های برگشتی (bounce) تولیدشده. .El .It Cm pause envelope Ar envelope-id | message-id | Cm all تعلیق موقت زمان‌بندی برای پاکت با شناسه مشخص، پاکت‌های با شناسه پیام معین، یا تمام پاکت‌ها. .It Cm pause mda توقف موقت تحویل نامه‌ها به کاربران محلی. .It Cm pause mta توقف موقت رله و تحویل نامه‌ها به کاربران راه دور. .It Cm pause smtp توقف موقت پذیرش نشست‌های ورودی. .It Cm profile Ar subsystem فعال‌سازی تحلیل کارایی بلادرنگ (profiling) برای .Ar subsystem . زیرسیستم‌های پشتیبانی‌شده عبارتند از: .Pp .Bl -bullet -compact .It queue، جهت بررسی هزینه ورودی/خروجی صف .It imsg، جهت بررسی هزینه گرداننده‌های رویداد .El .It Cm remove Ar envelope-id | message-id | Cm all حذف یک پاکت منفرد، پاکت‌های با شناسه پیام مشخص، یا تمام پاکت‌ها. .It Cm resume envelope Ar envelope-id | message-id | Cm all از سرگیری زمان‌بندی برای پاکت با شناسه مشخص، پاکت‌های با شناسه پیام مشخص، یا تمام پاکت‌ها. .It Cm resume mda از سرگیری تحویل پیام‌ها به کاربران محلی. .It Cm resume mta از سرگیری رله و تحویل به کاربران راه دور. .It Cm resume route Ar route-id از سرگیری مسیریابی در مسیر غیرفعال‌شده .Ar route-id . .It Cm resume smtp از سرگیری پذیرش نشست‌های ورودی. .It Cm schedule Ar envelope-id | message-id | Cm all نشانه‌گذاری به عنوان آماده برای تحویل فوری برای یک پاکت، پاکت‌های با شناسه پیام مشخص، یا تمام پاکت‌ها. .It Cm show envelope Ar envelope-id نمایش محتوای پاکت برای شناسه داده‌شده. .It Cm show hosts نمایش فهرست میزبان‌های راه دور MX شناخته‌شده. برای هر یک از آن‌ها، آدرس IP، نام میزبان متعارف، شمارنده ارجاع، تعداد اتصالات فعال به این میزبان و زمان سپری‌شده از آخرین اتصال را نمایش می‌دهد. .It Cm show hoststats نمایش وضعیت آخرین تحویل برای دامنه‌هایی که در ۴ ساعت گذشته فعال بوده‌اند. شامل فیلدهای زیر است که با نویسه "|" از یکدیگر جدا شده‌اند: .Pp .Bl -bullet -compact .It دامنه. .It برچسب زمانی .Ux آخرین تحویل. .It وضعیت آخرین تحویل. .El .It Cm show message Ar envelope-id نمایش محتوای پیام برای شناسه داده‌شده. .It Cm show queue نمایش اطلاعات مربوط به پاکت‌هایی که در حال حاضر در صف هستند. هر خط از خروجی یک پاکت منفرد را توصیف می‌کند. شامل فیلدهای زیر است که با "|" جدا شده‌اند: .Pp .Bl -bullet -compact .It شناسه پاکت (Envelope ID). .It خانواده آدرس کلاینتی که نامه را در صف قرار داده است. .It نوع تحویل: یکی از مقادیر "mta" ،"mda" یا "bounce". .It فلگ‌های مختلف روی پاکت. .It آدرس فرستنده (مسیر بازگشت). .It آدرس گیرنده اصلی. .It آدرس مقصد. .It زمان ایجاد. .It زمان انقضا. .It زمان آخرین تلاش برای تحویل یا رله. .It تعداد دفعات تلاش برای تحویل یا رله. .It وضعیت اجرای جاری: یکی از مقادیر "pending" یا "inflight" در صورتی که .Xr smtpd 8 در حال اجرا باشد، یا "offline" در غیر این صورت. .It تأخیر بر حسب ثانیه تا تلاش بعدی در صورت در انتظار بودن، یا زمان سپری‌شده در صورت اجرای فعلی. اگر .Xr smtpd 8 در حال اجرا نباشد این فیلد خالی است. .It رشته خطای آخرین تلاش ناموفق برای تحویل یا رله. .El .It Cm show relays نمایش فهرست رله‌های فعال فعلی و رابط‌های اتصال (connectors) مرتبط. برای هر رله، تعدادی شمارنده و اطلاعات درباره وضعیت داخلی آن در یک خط نمایش داده می‌شود. سپس فهرست اتصالات می‌آید (آدرس‌های مبدأ که باید از آن‌ها برای این رله متصل شد). .It Cm show routes نمایش وضعیت مسیرهایی که در حال حاضر توسط .Xr smtpd 8 شناخته شده‌اند. هر خط شامل شماره مسیر، آدرس مبدأ، آدرس مقصد، مجموعه‌ای از فلگ‌ها، تعداد اتصالات روی این مسیر، سطح جریمه فعلی که مدت زمان غیرفعال شدن مسیر در صورت بروز خطا را تعیین می‌کند، و تأخیر پیش از فعال‌سازی مجدد آن است. فلگ‌های زیر تعریف شده‌اند: .Pp .Bl -tag -width xx -compact .It D مسیر در حال حاضر غیرفعال است. .It N مسیر جدید است و هنوز هیچ نشست SMTP برقرار نشده است. .It Q مسیر دارای یک مهلت زمانی ثبت‌شده برای کاهش سطح جریمه و احتمالاً فعال‌سازی مجدد یا کنار گذاشتن آن است. .El .It Cm show stats نمایش آمارهای زمان اجرای مربوط به .Xr smtpd 8 . .It Cm show status نمایش وضعیت اجرای سیستم‌های MTA ،MDA و SMTP (در حال اجرا یا موقتاً متوقف). .It Cm spf walk جستجوی بازگشتی رکوردهای SPF برای دامنه‌های خوانده‌شده از ورودی استاندارد (stdin). برای نمونه: .Bd -literal -offset indent $ smtpctl spf walk < domains.txt .Ed .Pp رکوردهای SPF ممکن است حاوی ماکروهایی باشند که نمی‌توانند در یک لیست ایستا گنجانده شوند و باید به صورت پویا در زمان اتصال تفکیک شوند. دستور .Cm spf walk در این موارد نمی‌تواند نتایج کاملی ارائه دهد. .It Cm trace Ar subsystem فعال‌سازی ردگیری بلادرنگ (tracing) برای .Ar subsystem . زیرسیستم‌های پشتیبانی‌شده عبارتند از: .Pp .Bl -bullet -compact .It imsg .It io .It smtp (نشست‌های ورودی) .It filters .It mta (نشست‌های خروجی) .It bounce .It scheduler .It expand (بسط نام‌های مستعار/مجازی/فوروارد) .It lookup (جستجوی کاربران/اعتبارنامه‌ها) .It stat .It rules (منطبق بر نشست‌های ورودی) .It mproc .It all .El .It Cm unprofile Ar subsystem غیرفعال‌سازی تحلیل کارایی بلادرنگ برای .Ar subsystem . .It Cm untrace Ar subsystem غیرفعال‌سازی ردگیری بلادرنگ برای .Ar subsystem . .It Cm update table Ar name به‌روزرسانی محتوای جدول .Ar name ، برای جدول‌هایی که از بک‌اند .Dq file استفاده می‌کنند. .El .Pp هنگامی که .Nm smtpd پیامی را دریافت می‌کند، یک .Ar message-id برای پیام و یک .Ar envelope-id به ازای هر گیرنده تولید می‌کند. شناسه .Ar message-id یک شناسه تصادفی ۳۲ بیتی است که تضمین می‌شود روی سیستم میزبان یکتا باشد. شناسه .Ar envelope-id یک شناسه یکتای ۶۴ بیتی است که .Ar message-id را در ۳۲ بیت بالایی و یک شناسه پاکت تصادفی را در ۳۲ بیت پایینی کدگذاری می‌کند. .Pp دستوری که یک .Ar message-id را مشخص می‌کند برای تمامی گیرندگان یک پیام اعمال می‌شود؛ دستوری که یک .Ar envelope-id را مشخص می‌کند برای یک گیرنده خاص از پیام اعمال خواهد شد. .Sh "فایل‌ها (FILES)" .Bl -tag -width "/run/smtpd.sockXXX" -compact .It Pa /run/smtpd.sock سوکت دامنه .Ux مورد استفاده برای ارتباط با .Xr smtpd 8 . .El .Sh "همچنین ببینید (SEE ALSO)" .Xr smtpd 8 .Sh "تاریخچه (HISTORY)" برنامه .Nm نخستین بار در .Ox 4.6 ظاهر شد.