'\" t .\" Title: smbtree .\" 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 "SMBTREE" "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)" smbtree \- یک مرورگر متنی شبکه SMB .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u smbtree [\-D|\-\-domains] [\-S|\-\-servers] [\-?|\-\-help] [\-\-usage] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-\-configfile=CONFIGFILE] [\-\-option=name=value] [\-l|\-\-log\-basename=LOGFILEBASE] [\-\-leak\-report] [\-\-leak\-report\-full] [\-U|\-\-user=[DOMAIN/]USERNAME[%PASSWORD]] [\-N|\-\-no\-pass] [\-\-password=STRING] [\-\-pw\-nt\-hash] [\-A|\-\-authentication\-file=FILE] [\-P|\-\-machine\-pass] [\-\-simple\-bind\-dn=DN] [\-\-use\-kerberos=desired|required|off] [\-\-use\-krb5\-ccache=CCACHE] [\-\-use\-winbind\-ccache] [\-\-client\-protection=sign|encrypt|off] [\-V|\-\-version] .SH "توضیحات (DESCRIPTION)" .PP این ابزار بخشی از مجموعه \fBsamba\fR(7) است\&. .PP دستور smbtree یک برنامه مرورگر SMB در حالت متنی است\&. این ابزار شبیه به «Network Neighborhood» در رایانه‌های ویندوزی عمل می‌کند\&. این برنامه درختی شامل تمامی دامنه‌های شناخته‌شده، سرورهای موجود در آن دامنه‌ها و اشتراک‌های (shares) روی آن سرورها را چاپ می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP \-D|\-\-domains .RS 4 تنها فهرستی از تمام دامنه‌های شناخته‌شده از طریق برودکست یا توسط master browser را چاپ می‌کند\&. .RE .PP \-S|\-\-servers .RS 4 تنها فهرستی از تمامی دامنه‌ها و سرورهایی که به برودکست پاسخ می‌دهند یا توسط master browser شناخته شده‌اند را چاپ می‌کند\&. .RE .PP \-?|\-\-help .RS 4 خلاصه‌ای از گزینه‌های خط فرمان را چاپ می‌کند\&. .RE .PP \-\-usage .RS 4 پیام کوتاهی درباره نحوه استفاده نمایش می‌دهد\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 پارامتر \fIlevel\fR یک عدد صحیح بین ۰ تا ۱۰ است\&. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض برای برنامه‌های کلاینت ۱ است\&. .sp هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیت‌های سرور در فایل‌های لاگ ثبت خواهد شد\&. در سطح ۰، تنها خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند\&. سطح ۱ سطحی معقول برای استفاده روزمره است \- و حجم کمی از اطلاعات درباره عملیات انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از ۱ مقدار قابل‌توجهی از داده‌های لاگ را تولید خواهند کرد و تنها باید هنگام بررسی یک مشکل استفاده شوند\&. سطوح بالاتر از ۳ تنها برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار نامفهوم است\&. .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 .PP \-U|\-\-user=[DOMAIN\e]USERNAME[%PASSWORD] .RS 4 نام کاربری یا نام کاربری و گذرواژه SMB را تعیین می‌کند\&. .sp اگر PASSWORD% مشخص نشود، از کاربر خواسته می‌شود آن را وارد کند\&. کلاینت ابتدا متغیر محیطی \fBUSER\fR (که مجاز است شامل گذرواژه جداشده با % نیز باشد) و سپس متغیر \fBLOGNAME\fR (که مجاز به داشتن گذرواژه نیست) را بررسی می‌کند و در صورت وجود هر یک، مقدار آن استفاده می‌شود\&. اگر این متغیرهای محیطی یافت نشوند، ممکن است از نام کاربری موجود در حافظه پنهان اعتبارنامه Kerberos استفاده شود\&. .sp گزینه سوم استفاده از یک فایل اطلاعات هویتی (credentials) است که حاوی متن ساده نام کاربری و گذرواژه است\&. این گزینه عمدتاً برای اسکریپت‌هایی فراهم شده است که مدیر سیستم در آن‌ها تمایلی به ارسال اطلاعات هویتی در خط فرمان یا متغیرهای محیطی ندارد\&. اگر از این روش استفاده می‌شود، اطمینان حاصل کنید که مجوزهای دسترسی فایل، امکان دسترسی کاربران غیرمجاز را محدود کرده باشد\&. برای جزئیات بیشتر گزینه \fI\-A\fR را ببینید\&. .sp در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید\&. از نظر امنیتی بهتر است اجازه دهید در صورت نیاز ابزار کلاینت Samba گذرواژه را درخواست کند، یا گذرواژه را یک‌بار با kinit دریافت کنید\&. .sp اگرچه Samba تلاش می‌کند گذرواژه را از عنوان فرایند (همان‌طور که در ps دیده می‌شود) پاک کند، اما این عمل پس از راه‌اندازی رخ می‌دهد و بنابراین مستعد شرایط رقابتی (race condition) است\&. .RE .PP \-N|\-\-no\-pass .RS 4 در صورت تعیین، این پارامتر از درخواست معمول گذرواژه از کاربر توسط کلاینت جلوگیری می‌کند\&. این ویژگی هنگام دسترسی به سرویسی که نیازی به گذرواژه ندارد کاربردی است\&. .sp مگر اینکه گذرواژه‌ای در خط فرمان مشخص شده باشد یا این پارامتر تعریف شده باشد، کلاینت گذرواژه را درخواست خواهد کرد\&. .sp اگر گذرواژه‌ای در خط فرمان مشخص شده باشد و این گزینه نیز تعیین شده باشد، گذرواژه موجود در خط فرمان بدون هیچ پیامی نادیده گرفته شده و هیچ گذرواژه‌ای استفاده نخواهد شد\&. .RE .PP \-\-password .RS 4 گذرواژه را در خط فرمان مشخص می‌کند\&. .sp در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید\&. از نظر امنیتی بهتر است اجازه دهید در صورت نیاز ابزار کلاینت Samba گذرواژه را درخواست کند، یا گذرواژه را یک‌بار با kinit دریافت کنید\&. .sp اگر \-\-password مشخص نشود، این ابزار متغیر محیطی \fBPASSWD\fR و سپس \fBPASSWD_FD\fR را بررسی می‌کند که انتظار می‌رود شامل شماره یک توصیف‌کننده فایل (FD) باز باشد\&. .sp در نهایت، متغیر \fBPASSWD_FILE\fR (شامل مسیر فایلی که باید باز شود) را بررسی خواهد کرد\&. این فایل تنها باید حاوی گذرواژه باشد\&. اطمینان حاصل کنید که مجوزهای فایل، دسترسی کاربران غیرمجاز را محدود کرده باشد! .sp اگرچه Samba تلاش می‌کند گذرواژه را از عنوان فرایند (همان‌طور که در ps دیده می‌شود) پاک کند، اما این عمل پس از راه‌اندازی رخ می‌دهد و بنابراین مستعد شرایط رقابتی است\&. .RE .PP \-\-pw\-nt\-hash .RS 4 گذرواژه ارائه‌شده هش NT است\&. .RE .PP \-A|\-\-authentication\-file=filename .RS 4 این گزینه به شما امکان می‌دهد فایلی را مشخص کنید که نام کاربری و گذرواژه استفاده‌شده در اتصال از آن خوانده شود\&. قالب این فایل بدین صورت است: .sp .if n \{\ .RS 4 .\} .nf username = password = domain = .fi .if n \{\ .RE .\} .sp اطمینان حاصل کنید که مجوزهای دسترسی فایل، مانع از دسترسی کاربران غیرمجاز شود! .RE .PP \-P|\-\-machine\-pass .RS 4 از گذرواژه ذخیره‌شده حساب ماشین استفاده می‌کند\&. .RE .PP \-\-simple\-bind\-dn=DN .RS 4 شناسه متمایز (DN) برای استفاده در اتصال ساده (simple bind)\&. .RE .PP \-\-use\-kerberos=desired|required|off .RS 4 این پارامتر مشخص می‌کند که آیا ابزارهای کلاینت Samba برای احراز هویت با استفاده از Kerberos تلاش خواهند کرد یا خیر\&. برای احراز هویت با Kerberos، هنگام اتصال به یک سرویس باید به جای آدرس‌های IP از نام‌های DNS استفاده کنید\&. به‌طور پیش‌فرض، ابزارهای کلاینت Samba تلاش می‌کنند از حافظه پنهان اعتبارنامه (ccache) پیش‌فرض Kerberos استفاده کنند\&. در صورتی که ccache وجود نداشته باشد یا گزینه \-U|\-\-user مشخص شده باشد، کلاینت‌ها درخواست ورود گذرواژه را مطرح کرده و یک بلیت Kerberos (از طریق kinit) برای شما دریافت خواهند کرد\&. اگر مایلید از یک حافظه پنهان اعتبارنامه جایگزین برای Kerberos استفاده کنید، از گزینه \-\-use\-krb5\-ccache استفاده کنید\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، پارامتر \m[blue]\fBclient use kerberos\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-\-use\-krb5\-ccache=CCACHE .RS 4 محل حافظه پنهان اعتبارنامه را برای احراز هویت Kerberos مشخص می‌کند\&. .sp این گزینه مقدار \-\-use\-kerberos=required را اعمال خواهد کرد\&. .RE .PP \-\-use\-winbind\-ccache .RS 4 تلاش می‌کند از حافظه پنهان اعتبارنامه ارائه‌شده توسط winbind استفاده کند\&. .RE .PP \-\-client\-protection=sign|encrypt|off .RS 4 سطح حفاظت اتصال را که ابزار کلاینت باید به کار ببرد، تعیین می‌کند\&. .sp توجه داشته باشید که تعیین این پارامتر در اینجا، پارامتر \m[blue]\fBclient protection\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .sp در صورتی که به کنترل دقیق‌تری نیاز دارید می‌توانید از این گزینه‌ها استفاده کنید: \-\-option=clientsmbencrypt=OPTION، \-\-option=clientipcsigning=OPTION، \-\-option=clientsigning=OPTION\&. .RE .SH "نسخه (VERSION)" .PP این صفحه راهنما بخشی از نسخه 4\&.24\&.6 مجموعه Samba است\&. .SH "نویسندگان (AUTHORS)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط با آن توسط Andrew Tridgell ایجاد شده‌اند\&. Samba اکنون توسط Samba Team به عنوان یک پروژه متن‌باز، مشابه روش توسعه هسته لینوکس، توسعه داده می‌شود\&. .PP صفحه راهنمای smbtree توسط Jelmer Vernooij نوشته شده است\&.