'\" t .\" Title: samba .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/16/2026 .\" Manual: System Administration tools .\" Source: Samba 4.24.6 .\" Language: Persian .\" .TH "SAMBA" "8" "08/16/2026" "Samba 4\&.24\&.6" "ابزارهای مدیریت سیستم" .\" ----------------------------------------------------------------- .\" * 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)" samba \- کارساز برای ارائه خدمات AD و SMB/CIFS به کلاینت‌ها .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u samba [\-D|\-\-daemon] [\-F|\-\-foreground] [\-i|\-\-interactive] [\-M|\-\-model=MODEL] [\-\-maximum\-runtime=seconds] [\-b|\-\-show\-build] [\-\-no\-process\-group] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-\-configfile=CONFIGFILE] [\-\-option=name=value] [\-l|\-\-log\-basename=LOGFILEBASE] [\-\-leak\-report] [\-\-leak\-report\-full] [\-V|\-\-version] .SH "توضیحات (DESCRIPTION)" .PP این برنامه بخشی از مجموعه \fBsamba\fR(7) است\&. .PP دستور samba دیمن کارسازی است که خدمات اکتیو دایرکتوری (Active Directory)، اشتراک فایل و چاپ را به کلاینت‌ها ارائه می‌دهد\&. این کارساز فضا برای فایل‌ها و خدمات دایرکتوری را با استفاده از پروتکل SMB (یا CIFS) و سایر پروتکل‌های مرتبط مانند DCE/RPC، LDAP و Kerberos در اختیار کلاینت‌ها می‌گذارد\&. .PP کلاینت‌های پشتیبانی‌شده شامل MSCLIENT 3\&.0 برای DOS، Windows for Workgroups، Windows 95/98/ME، Windows NT، Windows 2000/XP/2003، OS/2، DAVE برای Macintosh و cifsfs برای Linux هستند\&. .PP توضیحات گسترده درباره خدماتی که کارساز می‌تواند ارائه دهد در صفحه راهنمای فایل پیکربندی کنترل‌کننده ویژگی‌های آن خدمات آمده است (ببینید \fBsmb.conf\fR(5)\&). این صفحه راهنما به توصیف خدمات نمی‌پردازد، بلکه بر جنبه‌های مدیریتی اجرای کارساز تمرکز دارد\&. .PP لطفاً توجه داشته باشید که اجرای این کارساز پیامدهای امنیتی مهمی دارد و خواندن صفحه راهنمای \fBsmb.conf\fR(5) پیش از اقدام به نصب الزامی است\&. .SH "گزینه‌ها (OPTIONS)" .PP \-D|\-\-daemon .RS 4 در صورت تعیین، این پارامتر سبب می‌شود کارساز به‌صورت یک دیمن عمل کند\&. یعنی از ترمینال جدا شده و در پس‌زمینه اجرا می‌شود و درخواست‌ها را روی پورت‌های مناسب دریافت می‌کند\&. اجرای کارساز به‌صورت دیمن، روش توصیه‌شده برای اجرای samba در کارسازهایی است که خدماتی بیش از کاربرد تفننی فایل و چاپ ارائه می‌دهند\&. اگر samba از خط فرمان شل اجرا شود، این سوییچ پیش‌فرض فرض می‌شود\&. .RE .PP \-F|\-\-foreground .RS 4 در صورت تعیین، این پارامتر موجب می‌شود فرایند samba دیمن نشود؛ یعنی double\-fork انجام نداده و از ترمینال جدا نشود\&. .RE .PP \-i|\-\-interactive .RS 4 اگر این پارامتر مشخص شود، کارساز به‌صورت «تعاملی» اجرا می‌شود و نه به‌صورت دیمن، حتی اگر در خط فرمان شل اجرا شده باشد\&. تنظیم این پارامتر حالت ضمنی دیمن هنگام اجرا از خط فرمان را لغو می‌کند\&. samba همچنین پیام‌ها را در خروجی استاندارد ثبت می‌کند، مشابه حالتی که پارامتر \-S داده شده باشد\&. .RE .PP \-M|\-\-model .RS 4 از این پارامتر می‌توان برای تعیین «مدل فرایند» (process model) مورد استفاده توسط samba استفاده کرد\&. این گزینه نحوه رسیدگی به کلاینت‌های همزمان را مشخص می‌کند\&. مدل‌های فرایند موجود شامل موارد زیر هستند: .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIsingle\fR .sp تمام خدمات Samba در یک فرایند واحد اجرا می‌شوند\&. این مدل برای پیکربندی‌های محیط عملیاتی (production) توصیه نمی‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIstandard\fR .sp برای هر سرویس Samba یک فرایند ایجاد می‌شود و برای آن دسته از خدماتی که از آن پشتیبانی می‌کنند (در حال حاضر تنها LDAP و NETLOGON)، به ازای هر اتصال کلاینت جدید یک فرایند تازه آغاز می‌گردد\&. .sp از نظر تاریخی، این روش «استاندارد» رفتار Samba تا نسخه 4\&.10 بود\&. توجه داشته باشید در صورتی که تعداد زیادی اتصال کلاینت داشته باشید، این مدل می‌تواند منابع زیادی مصرف کند\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIprefork\fR .sp حالت پیش‌فرض\&. برای هر سرویس Samba یک فرایند آغاز می‌شود و تعداد ثابتی فرایند کارگر (worker) برای خدماتی که از آن پشتیبانی می‌کنند (در حال حاضر LDAP، NETLOGON و KDC) راه‌اندازی می‌گردد\&. اتصالات کلاینت سپس میان فرایندهای کارگر به اشتراک گذاشته می‌شوند\&. درخواست‌های مربوط به خدماتی که از prefork پشتیبانی نمی‌کنند توسط یک فرایند تکی برای آن سرویس مدیریت می‌شوند\&. .sp تعداد فرایندهای کارگر prefork راه‌اندازی‌شده توسط پارامتر \m[blue]\fBprefork children\fR\m[] در \fBsmb.conf\fR(5) کنترل می‌شود که مقدار پیش‌فرض آن 4 است\&. .RE .sp .RE .RE .PP \-\-maximum\-runtime=seconds .RS 4 حداکثر زمان اجرای فرایند کارساز را تا خاتمه خودکار بر حسب ثانیه تنظیم می‌کند\&. .RE .PP \-b|\-\-show\-build .RS 4 اطلاعات مربوط به نحوه ساخت و کامپایل Samba را چاپ می‌کند\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 \fIlevel\fR یک عدد صحیح از 0 تا 10 است\&. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض 0 است\&. .sp هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیت‌های کارساز در فایل‌های لاگ ثبت خواهد شد\&. در سطح 0، تنها خطاهای بحرانی و هشدارهای جدی ثبت می‌شوند\&. سطح 1 سطحی معقول برای استفاده روزمره است \- مقدار کمی اطلاعات درباره عملیات انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از 1 حجم قابل‌توجهی از داده‌های لاگ تولید می‌کنند و فقط باید هنگام بررسی یک مشکل استفاده شوند\&. سطوح بالاتر از 3 فقط برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم بسیار عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار نامفهوم و پیچیده هستند\&. .sp توجه داشته باشید که تعیین این پارامتر در اینجا، پارامتر \m[blue]\fBlog level\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی (override) می‌کند\&. .RE .PP \-\-debug\-stdout .RS 4 این گزینه خروجی اشکال‌زدایی را به STDOUT هدایت می‌کند\&. به‌طور پیش‌فرض دیمن‌های کارساز پیام‌ها را در یک فایل لاگ ثبت می‌کنند\&. .RE .PP \-\-configfile=CONFIGFILE .RS 4 فایل مشخص‌شده شامل جزئیات پیکربندی مورد نیاز کارساز است\&. اطلاعات موجود در این فایل شامل اطلاعات ویژه کارساز مانند فایل printcap مورد استفاده و همچنین شرح تمام خدماتی است که کارساز باید ارائه دهد\&. برای اطلاعات بیشتر ببینید /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 .PP \-?|\-\-help .RS 4 خلاصه‌ای از گزینه‌های خط فرمان را چاپ می‌کند\&. .RE .PP \-\-usage .RS 4 پیام کوتاهی درباره نحوه استفاده نمایش می‌دهد\&. .RE .SH "فایل‌ها (FILES)" .PP /etc/rc .RS 4 یا هر اسکریپت راه‌اندازی اولیه دیگری که سیستم شما استفاده می‌کند\&. .sp در صورت اجرای کارساز به‌صورت یک دیمن هنگام راه‌اندازی سیستم، این فایل باید شامل توالی راه‌اندازی مناسب برای کارساز باشد\&. .RE .PP /etc/services .RS 4 اگر کارساز از طریق متا\-دیمن inetd اجرا می‌شود، این فایل باید حاوی نگاشت نام سرویس (مانند netbios\-ssn) به پورت سرویس (مانند 139) و نوع پروتکل (مانند tcp) باشد\&. .RE .PP /usr/local/samba/lib/smb\&.conf .RS 4 این مسیر پیش‌فرض فایل پیکربندی کارساز \fBsmb.conf\fR(5) است\&. سایر مکان‌های رایجی که سیستم‌ها این فایل را در آن نصب می‌کنند شامل /usr/samba/lib/smb\&.conf و /etc/samba/smb\&.conf است\&. .sp این فایل تمام خدماتی را که کارساز باید در دسترس کلاینت‌ها قرار دهد شرح می‌دهد\&. برای اطلاعات بیشتر ببینید \fBsmb.conf\fR(5)\&. .RE .SH "عیب‌یابی (DIAGNOSTICS)" .PP بیشتر پیام‌های عیب‌یابی صادرشده توسط کارساز در یک فایل لاگ مشخص ثبت می‌شوند\&. نام فایل لاگ هنگام کامپایل تعیین می‌شود، اما می‌توان آن را از طریق خط فرمان تغییر داد\&. .PP تعداد و ماهیت پیام‌های عیب‌یابی موجود به سطح اشکال‌زدایی (debug level) استفاده‌شده توسط کارساز بستگی دارد\&. اگر با مشکلی مواجه شدید، سطح اشکال‌زدایی را روی 3 تنظیم کرده و فایل‌های لاگ را به دقت بررسی کنید\&. .PP بیشتر پیام‌ها تا حد معقولی خودتوضیح هستند\&. متأسفانه در زمان نگارش این صفحه راهنما، پیام‌های عیب‌یابی بسیار زیادی در کد منبع وجود دارد که توصیف تک‌تک آن‌ها ممکن نیست\&. در این مرحله، بهترین راهکار همچنان جستجو (grep) در کد منبع و بررسی شرایطی است که باعث ایجاد پیام‌های عیب‌یابی مشاهده‌شده شده‌اند\&. .SH "نسخه (VERSION)" .PP این صفحه راهنما بخشی از نسخه 4\&.24\&.6 مجموعه Samba است\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBhosts_access\fR(5), \fBsmb.conf\fR(5), \fBsmbclient\fR(8), \fBsamba-tool\fR(8), \fBsmbd\fR(8), \fBnmbd\fR(8), \fBwinbindd\fR(1) و RFCهای اینترنتی rfc1001\&.txt, rfc1002\&.txt\&. علاوه بر این، مشخصات CIFS (سابقاً SMB) به‌صورت پیوندی از صفحه وب زیر در دسترس است: https://www\&.samba\&.org/cifs\&. .SH "نویسنده (AUTHOR)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط توسط Andrew Tridgell ایجاد شده‌اند\&. Samba اکنون توسط Samba Team به‌عنوان پروژه‌ای متن‌باز، مشابه روش توسعه هسته لینوکس، توسعه می‌یابد\&.