'\" t .\" Title: smbcontrol .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/16/2026 .\" Manual: User Commands .\" Source: Samba 4.24.6 .\" Language: English .\" .TH "SMBCONTROL" "1" "08/16/2026" "Samba 4\&.24\&.6" "User Commands" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "نام (NAME)" smbcontrol \- ارسال پیام به فرایندهای smbd، nmbd یا winbindd .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u smbcontrol [\-?|\-\-help] [\-\-usage] [\-t|\-\-timeout] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-\-configfile=CONFIGFILE] [\-\-option=name=value] [\-l|\-\-log\-basename=LOGFILEBASE] [\-\-leak\-report] [\-\-leak\-report\-full] .HP \w'\ 'u smbcontrol [destination] [message\-type] [parameter] .SH "توضیحات (DESCRIPTION)" .PP این ابزار بخشی از مجموعهٔ \fBsamba\fR(7) است\&. .PP دستور smbcontrol برنامهٔ بسیار کوچکی است که پیام‌هایی را به دیمن‌های در حال اجرای \fBsmbd\fR(8)، \fBnmbd\fR(8) یا \fBwinbindd\fR(8) روی سیستم ارسال می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP \-t|\-\-timeout .RS 4 تنظیم مهلت زمانی (timeout) بر حسب ثانیه\&. .RE .PP destination .RS 4 یکی از مقادیر \fInmbd\fR، \fIsmbd\fR، \fIwinbindd\fR یا شناسهٔ فرایند (PID)\&. .sp مقصد \fIall\fR باعث می‌شود پیام به تمامی دیمن‌های در حال اجرا شامل nmbd و winbind «پخش همگانی» (broadcast) شود\&. این تغییر از نسخهٔ Samba 3\&.3 اعمال شده است؛ پیش از آن پارامتر smbd این کار را انجام می‌داد\&. .sp مقصد \fIsmbd\fR باعث می‌شود پیام به دیمن smbd مشخص‌شده در فایل smbd\&.pid ارسال گردد\&. .sp مقصد \fInmbd\fR باعث می‌شود پیام به دیمن nmbd مشخص‌شده در فایل nmbd\&.pid ارسال گردد\&. .sp مقصد \fIwinbindd\fR باعث می‌شود پیام به دیمن winbind مشخص‌شده در فایل winbindd\&.pid ارسال گردد\&. .sp اگر یک شناسهٔ فرایند (PID) مشخص شود، پیام تنها به همان فرایند ارسال می‌شود\&. .RE .PP message\-type .RS 4 نوع پیام ارسالی\&. برای جزئیات، بخش \fBانواع پیام (MESSAGE\-TYPES)\fR را ببینید\&. .RE .PP parameters .RS 4 هرگونه پارامتر مورد نیاز برای message\-type مشخص‌شده\&. .RE .PP \-?|\-\-help .RS 4 چاپ خلاصه‌ای از گزینه‌های خط فرمان\&. .RE .PP \-\-usage .RS 4 نمایش پیام کوتاه نحوهٔ استفاده\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 مقدار \fIlevel\fR یک عدد صحیح از 0 تا 10 است\&. مقدار پیش‌فرض در صورت عدم تعیین برای برنامه‌های کلاینت برابر 1 است\&. .sp هر چه این مقدار بیشتر باشد، جزئیات بیشتری دربارهٔ فعالیت‌های کارساز (سرور) در فایل‌های گزارش (log) ثبت خواهد شد\&. در سطح 0، تنها خطاهای بحرانی و هشدارهای جدی ثبت می‌شوند\&. سطح 1 سطحی معقول برای استفادهٔ روزمره است \- مقدار کمی اطلاعات دربارهٔ عملیات انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از 1 حجم زیادی از داده‌های گزارش را تولید می‌کنند و تنها باید هنگام بررسی یک مشکل استفاده شوند\&. سطوح بالاتر از 3 فقط برای استفادهٔ توسعه‌دهندگان طراحی شده‌اند و مقادیر عظیمی دادهٔ گزارش تولید می‌کنند که بیشتر آن‌ها بسیار پیچیده و نامفهوم هستند\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در خط فرمان، پارامتر \m[blue]\fBlog level\fR\m[] در فایل /etc/samba/smb\&.conf را لغو (override) خواهد کرد\&. .RE .PP \-\-debug\-stdout .RS 4 خروجی اشکال‌زدایی (debug) را به خروجی استاندارد (STDOUT) هدایت می‌کند\&. به طور پیش‌فرض تمام کلاینت‌ها گزارش‌ها را در خروجی خطای استاندارد (STDERR) ثبت می‌کنند\&. .RE .PP \-\-configfile= .RS 4 فایل مشخص‌شده شامل جزئیات پیکربندی مورد نیاز کلاینت است\&. اطلاعات موجود در این فایل می‌تواند عمومی (برای کلاینت و سرور) باشد یا تنها گزینه‌های خاص کلاینت مانند \m[blue]\fBclient smb encrypt\fR\m[] را فراهم کند\&. برای اطلاعات بیشتر /etc/samba/smb\&.conf را ببینید\&. نام پیش‌فرض فایل پیکربندی هنگام ساخت و کامپایل تعیین می‌شود\&. .RE .PP \-\-option== .RS 4 مقداردهی گزینهٔ "" در \fBsmb.conf\fR(5) به مقدار "" از طریق خط فرمان\&. این کار مقادیر پیش‌فرض زمان کامپایل و گزینه‌های خوانده‌شده از فایل پیکربندی را بازنویسی می‌کند\&. اگر یک نام یا مقدار حاوی فاصله است، کل عبارت \-\-option=name=value را داخل علامت نقل‌قول قرار دهید\&. .RE .PP \-l|\-\-log\-basename=logdirectory .RS 4 نام دایرکتوری پایه برای فایل‌های گزارش/اشکال‌زدایی\&. پسوند \fB"\&.progname"\fR به انتهای آن افزوده خواهد شد (مانند log\&.smbclient، log\&.smbd و غیره)\&. این فایل گزارش هرگز توسط کلاینت حذف نمی‌شود\&. .RE .PP \-\-leak\-report .RS 4 فعال‌سازی گزارش نشت حافظهٔ talloc هنگام خروج از برنامه\&. .RE .PP \-\-leak\-report\-full .RS 4 فعال‌سازی گزارش کامل نشت حافظهٔ talloc هنگام خروج از برنامه\&. .RE .PP \-V|\-\-version .RS 4 چاپ شماره نسخهٔ برنامه\&. .RE .SH "انواع پیام (MESSAGE\-TYPES)" .PP انواع پیام‌های در دسترس عبارتند از: .PP close\-share .RS 4 دستور به smbd برای بستن اتصالات کلاینت به اشتراک (share) نام‌برده‌شده\&. توجه داشته باشید که این دستور اثری بر اتصالات کلاینت به سایر اشتراک‌ها ندارد\&. این message\-type نام اشتراکی که باید اتصالات آن بسته شود را به عنوان آرگومان دریافت می‌کند، یا نویسهٔ "*" که تمام اشتراک‌های باز فعلی را می‌بندد\&. این ویژگی ممکن است زمانی که تغییراتی در کنترل‌های دسترسی اشتراک اعمال کرده‌اید مفید باشد\&. این پیام تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP close\-denied\-share .RS 4 مانند \fBclose\-share\fR عمل می‌کند، با این تفاوت که کاربرانی را که هنوز مجاز به دسترسی به اشتراک هستند قطع نمی‌کند\&. می‌توان پس از تغییر کنترل‌های دسترسی اشتراک، آن را با اطمینان خاطر به تمام فرایندهای smbd ارسال کرد\&. این کار تنها کاربرانی را تحت تأثیر قرار می‌دهد که دسترسی آن‌ها پس از اتصال اولیه رد (denied) شده است\&. این پیام تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP debug .RS 4 تنظیم سطح اشکال‌زدایی (debug level) به مقدار تعیین‌شده توسط پارامتر\&. این پیام را می‌توان به هر یک از مقاصد ارسال کرد\&. اگر این پیام به دیمن‌های smbd یا winbindd ارسال شود، فرایند والد پیام را مجدداً به تمامی فرایندهای فرزند ارسال می‌کند و سطح اشکال‌زدایی را در تک‌تک آن‌ها تغییر می‌دهد\&. .RE .PP kill\-client\-ip .RS 4 دستور به smbd برای بستن اتصالات کلاینت از یک آدرس IP مشخص\&. این message\-type آدرس IP که اتصالات کلاینت از آن باید بسته شوند را به عنوان آرگومان دریافت می‌کند\&. این پیام تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP force\-election .RS 4 این پیام باعث می‌شود دیمن nmbd برگزاری یک انتخابات جدید برای browse master را اجبار کند\&. .RE .PP ping .RS 4 ارسال تعداد مشخصی از پیام‌های "ping" و انتظار برای دریافت همان تعداد پیام پاسخ "pong"\&. این پیام را می‌توان به هر یک از مقاصد ارسال کرد\&. .RE .PP profile .RS 4 تغییر تنظیمات پروفایل یک دیمن بر اساس پارامتر ارائه‌شده\&. پارامتر می‌تواند "on" برای فعال کردن جمع‌آوری آمار پروفایل، "off" برای غیرفعال کردن جمع‌آوری آمار پروفایل، "count" برای فعال‌سازی فقط جمع‌آوری آمار شمارشی (آمارهای زمانی غیرفعال می‌شوند) و "flush" برای صفر کردن آمارهای فعلی پروفایل باشد\&. این پیام را می‌توان به مقاصد smbd یا nmbd ارسال کرد\&. .RE .PP debuglevel .RS 4 درخواست مقدار debuglevel از یک دیمن مشخص و چاپ آن در خروجی استاندارد (stdout)\&. این پیام را می‌توان به هر یک از مقاصد ارسال کرد\&. .RE .PP profilelevel .RS 4 درخواست مقدار profilelevel از یک دیمن مشخص و چاپ آن در خروجی استاندارد (stdout)\&. این پیام را می‌توان به مقاصد smbd یا nmbd ارسال کرد\&. .RE .PP printnotify .RS 4 دستور به smbd برای ارسال یک پیام اعلان چاپگر (printer notify) به تمام کلاینت‌های Windows NT متصل به یک چاپگر\&. این message\-type آرگومان‌های زیر را می‌پذیرد: .PP queuepause printername .RS 4 ارسال پیام اعلان توقف صف به چاپگر مشخص‌شده\&. .RE .PP queueresume printername .RS 4 ارسال پیام اعلان ازسرگیری صف برای چاپگر مشخص‌شده\&. .RE .PP jobpause printername unixjobid .RS 4 ارسال پیام اعلان توقف کار چاپ برای چاپگر و unixjobid مشخص‌شده\&. .RE .PP jobresume printername unixjobid .RS 4 ارسال پیام اعلان ازسرگیری کار چاپ برای چاپگر و unixjobid مشخص‌شده\&. .RE .PP jobdelete printername unixjobid .RS 4 ارسال پیام اعلان حذف کار چاپ برای چاپگر و unixjobid مشخص‌شده\&. .RE .sp توجه داشته باشید که این پیام صرفاً اعلان رخ دادن یک رویداد را ارسال می‌کند و در عمل باعث رخ دادن فیزیکی آن رویداد نمی‌شود\&. .sp این پیام تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP dmalloc\-mark .RS 4 تنظیم یک نشانه برای dmalloc\&. می‌تواند به هر دو دیمن smbd و nmbd ارسال شود\&. تنها در صورتی فعال است که سامبا همراه با پشتیبانی از dmalloc ساخته شده باشد\&. .RE .PP dmalloc\-log\-changed .RS 4 تخلیه (dump) اشاره‌گرهایی که از زمان نشانه‌گذاری توسط dmalloc\-mark تغییر کرده‌اند\&. می‌تواند به هر دو دیمن smbd و nmbd ارسال شود\&. تنها در صورتی فعال است که سامبا همراه با پشتیبانی از dmalloc ساخته شده باشد\&. .RE .PP shutdown .RS 4 خاموش کردن دیمن مشخص‌شده\&. می‌تواند به هر دو دیمن smbd و nmbd ارسال شود\&. .RE .PP pool\-usage .RS 4 چاپ گزارشی خوانا برای انسان از تمام میزان مصرف حافظهٔ talloc(pool) توسط دیمن/فرایند مشخص‌شده\&. برای هر دو دیمن smbd و nmbd در دسترس است\&. .RE .PP ringbuf\-log .RS 4 واکشی و چاپ گزارش ringbuf\&. نیازمند \fIlogging = ringbuf\fR است\&. برای smbd، winbindd و nmbd در دسترس است\&. .RE .PP drvupgrade .RS 4 وادار کردن کلاینت‌های متصل به چاپگرهایی که از درایور مشخص‌شده استفاده می‌کنند به به‌روزرسانی نسخهٔ محلی درایور خود\&. تنها می‌تواند به smbd ارسال شود\&. .RE .PP reload\-config .RS 4 مجبور کردن دیمن به بارگذاری مجدد فایل پیکربندی smb\&.conf\&. می‌تواند به \fBsmbd\fR، \fBnmbd\fR یا \fBwinbindd\fR ارسال شود\&. .RE .PP reload\-printers .RS 4 مجبور کردن smbd به بازخوانی مجدد اطلاعات چاپگرها\&. تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP idmap .RS 4 اعلان دربارهٔ تغییرات نگاشت شناسه (id mapping)\&. می‌تواند به \fBsmbd\fR یا (که هنوز پیاده‌سازی نشده است) \fBwinbindd\fR ارسال شود\&. .PP flush [uid|gid] .RS 4 تخلیه و پاک‌سازی حافظه‌های موقت (caches) مربوط به نگاشت‌های sid <\-> gid و/یا sid <\-> uid\&. .RE .PP delete .RS 4 حذف یک نگاشت از حافظهٔ موقت (cache)\&. نگاشت با مشخص می‌شود که می‌تواند sid: S\-x\-\&.\&.\&.، یک gid: "GID number" یا یک uid: "UID number" باشد\&. .RE .PP kill .RS 4 حذف یک نگاشت از حافظهٔ موقت (cache)\&. در صورتی که شناسه هم‌اکنون در حال استفاده باشد، فرایند \fBsmbd\fR را خاتمه می‌دهد\&. .RE .RE .PP num\-children .RS 4 پرس‌وجوی تعداد فرایندهای فرزند smbd\&. این پیام تنها می‌تواند به \fBsmbd\fR ارسال شود\&. .RE .PP reload\-certs .RS 4 دستور به کارساز LDAP یک Samba AD DC برای بازخوانی مجدد گواهی‌های TLS که از اتصالات ldaps:// محافظت می‌کنند\&. این پیام تنها می‌تواند به \fBldap_server\fR ارسال شود\&. .RE .SH "نسخه (VERSION)" .PP این صفحهٔ راهنما بخشی از نسخهٔ 4\&.24\&.6 مجموعهٔ نرم‌افزاری Samba است\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBnmbd\fR(8) و \fBsmbd\fR(8)\&. .SH "نویسنده (AUTHOR)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط با آن توسط Andrew Tridgell ایجاد شده‌اند\&. امروزه Samba توسط تیم Samba Team به عنوان یک پروژهٔ متن‌باز، به شیوه‌ای مشابه روند توسعهٔ هستهٔ لینوکس، توسعه و نگهداری می‌شود\&.