SMBTREE(1) User Commands SMBTREE(1)

smbtree - یک مرورگر متنی شبکه SMB

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]

این ابزار بخشی از مجموعه samba(7) است.

دستور smbtree یک برنامه مرورگر SMB در حالت متنی است. این ابزار شبیه به «Network Neighborhood» در رایانه‌های ویندوزی عمل می‌کند. این برنامه درختی شامل تمامی دامنه‌های شناخته‌شده، سرورهای موجود در آن دامنه‌ها و اشتراک‌های (shares) روی آن سرورها را چاپ می‌کند.

-D|--domains

تنها فهرستی از تمام دامنه‌های شناخته‌شده از طریق برودکست یا توسط master browser را چاپ می‌کند.

-S|--servers

تنها فهرستی از تمامی دامنه‌ها و سرورهایی که به برودکست پاسخ می‌دهند یا توسط master browser شناخته شده‌اند را چاپ می‌کند.

-?|--help

خلاصه‌ای از گزینه‌های خط فرمان را چاپ می‌کند.

--usage

پیام کوتاهی درباره نحوه استفاده نمایش می‌دهد.

-d|--debuglevel=level

پارامتر level یک عدد صحیح بین ۰ تا ۱۰ است. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض برای برنامه‌های کلاینت ۱ است.

هرچه این مقدار بالاتر باشد، جزئیات بیشتری درباره فعالیت‌های سرور در فایل‌های لاگ ثبت خواهد شد. در سطح ۰، تنها خطاهای حیاتی و هشدارهای جدی ثبت می‌شوند. سطح ۱ سطحی معقول برای استفاده روزمره است - و حجم کمی از اطلاعات درباره عملیات انجام‌شده تولید می‌کند.

سطوح بالاتر از ۱ مقدار قابل‌توجهی از داده‌های لاگ را تولید خواهند کرد و تنها باید هنگام بررسی یک مشکل استفاده شوند. سطوح بالاتر از ۳ تنها برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم عظیمی از داده‌های لاگ تولید می‌کنند که بیشتر آن‌ها بسیار نامفهوم است.

توجه داشته باشید که تعیین این پارامتر در اینجا، مقدار پارامتر log level را در فایل /etc/samba/smb.conf بازنویسی (override) می‌کند.

--debug-stdout

این گزینه خروجی اشکال‌زدایی (debug) را به STDOUT هدایت می‌کند. به‌طور پیش‌فرض تمام کلاینت‌ها در STDERR لاگ ثبت می‌کنند.

--configfile=<configuration file>;

فایل مشخص‌شده حاوی جزئیات پیکربندی مورد نیاز کلاینت است. اطلاعات موجود در این فایل می‌تواند عمومی (برای کلاینت و سرور) باشد یا اینکه صرفاً گزینه‌های اختصاصی کلاینت مانند client smb encrypt را فراهم کند. برای اطلاعات بیشتر فایل /etc/samba/smb.conf را ببینید. نام پیش‌فرض فایل پیکربندی در زمان کامپایل تعیین می‌شود.

--option=<name>=<value>

گزینه smb.conf(5) با عنوان «<name>» را از طریق خط فرمان به مقدار «<value>» تنظیم می‌کند. این کار پیش‌فرض‌های زمان کامپایل و گزینه‌های خوانده‌شده از فایل پیکربندی را بازنویسی می‌کند. اگر نام یا مقدار شامل فاصله باشد، کل عبارت --option=name=value را داخل علامت نقل‌قول قرار دهید.

-l|--log-basename=logdirectory

نام دایرکتوری پایه برای فایل‌های لاگ/اشکال‌زدایی. پسوند ".progname" به انتهای آن افزوده خواهد شد (مانند log.smbclient، log.smbd و غیره). فایل لاگ هرگز توسط کلاینت حذف نمی‌شود.

--leak-report

فعال‌سازی گزارش نشت حافظه talloc در زمان خروج.

--leak-report-full

فعال‌سازی گزارش کامل نشت حافظه talloc در زمان خروج.

-V|--version

شماره نسخه برنامه را چاپ می‌کند.

-U|--user=[DOMAIN\]USERNAME[%PASSWORD]

نام کاربری یا نام کاربری و گذرواژه SMB را تعیین می‌کند.

اگر PASSWORD% مشخص نشود، از کاربر خواسته می‌شود آن را وارد کند. کلاینت ابتدا متغیر محیطی USER (که مجاز است شامل گذرواژه جداشده با % نیز باشد) و سپس متغیر LOGNAME (که مجاز به داشتن گذرواژه نیست) را بررسی می‌کند و در صورت وجود هر یک، مقدار آن استفاده می‌شود. اگر این متغیرهای محیطی یافت نشوند، ممکن است از نام کاربری موجود در حافظه پنهان اعتبارنامه Kerberos استفاده شود.

گزینه سوم استفاده از یک فایل اطلاعات هویتی (credentials) است که حاوی متن ساده نام کاربری و گذرواژه است. این گزینه عمدتاً برای اسکریپت‌هایی فراهم شده است که مدیر سیستم در آن‌ها تمایلی به ارسال اطلاعات هویتی در خط فرمان یا متغیرهای محیطی ندارد. اگر از این روش استفاده می‌شود، اطمینان حاصل کنید که مجوزهای دسترسی فایل، امکان دسترسی کاربران غیرمجاز را محدود کرده باشد. برای جزئیات بیشتر گزینه -A را ببینید.

در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید. از نظر امنیتی بهتر است اجازه دهید در صورت نیاز ابزار کلاینت Samba گذرواژه را درخواست کند، یا گذرواژه را یک‌بار با kinit دریافت کنید.

اگرچه Samba تلاش می‌کند گذرواژه را از عنوان فرایند (همان‌طور که در ps دیده می‌شود) پاک کند، اما این عمل پس از راه‌اندازی رخ می‌دهد و بنابراین مستعد شرایط رقابتی (race condition) است.

-N|--no-pass

در صورت تعیین، این پارامتر از درخواست معمول گذرواژه از کاربر توسط کلاینت جلوگیری می‌کند. این ویژگی هنگام دسترسی به سرویسی که نیازی به گذرواژه ندارد کاربردی است.

مگر اینکه گذرواژه‌ای در خط فرمان مشخص شده باشد یا این پارامتر تعریف شده باشد، کلاینت گذرواژه را درخواست خواهد کرد.

اگر گذرواژه‌ای در خط فرمان مشخص شده باشد و این گزینه نیز تعیین شده باشد، گذرواژه موجود در خط فرمان بدون هیچ پیامی نادیده گرفته شده و هیچ گذرواژه‌ای استفاده نخواهد شد.

--password

گذرواژه را در خط فرمان مشخص می‌کند.

در مورد قرار دادن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر عرضه‌شده توسط کاربر در خط فرمان محتاط باشید. از نظر امنیتی بهتر است اجازه دهید در صورت نیاز ابزار کلاینت Samba گذرواژه را درخواست کند، یا گذرواژه را یک‌بار با kinit دریافت کنید.

اگر --password مشخص نشود، این ابزار متغیر محیطی PASSWD و سپس PASSWD_FD را بررسی می‌کند که انتظار می‌رود شامل شماره یک توصیف‌کننده فایل (FD) باز باشد.

در نهایت، متغیر PASSWD_FILE (شامل مسیر فایلی که باید باز شود) را بررسی خواهد کرد. این فایل تنها باید حاوی گذرواژه باشد. اطمینان حاصل کنید که مجوزهای فایل، دسترسی کاربران غیرمجاز را محدود کرده باشد!

اگرچه Samba تلاش می‌کند گذرواژه را از عنوان فرایند (همان‌طور که در ps دیده می‌شود) پاک کند، اما این عمل پس از راه‌اندازی رخ می‌دهد و بنابراین مستعد شرایط رقابتی است.

--pw-nt-hash

گذرواژه ارائه‌شده هش NT است.

-A|--authentication-file=filename

این گزینه به شما امکان می‌دهد فایلی را مشخص کنید که نام کاربری و گذرواژه استفاده‌شده در اتصال از آن خوانده شود. قالب این فایل بدین صورت است: 
username = <value>
password = <value>
domain   = <value>

اطمینان حاصل کنید که مجوزهای دسترسی فایل، مانع از دسترسی کاربران غیرمجاز شود!

-P|--machine-pass

از گذرواژه ذخیره‌شده حساب ماشین استفاده می‌کند.

--simple-bind-dn=DN

شناسه متمایز (DN) برای استفاده در اتصال ساده (simple bind).

--use-kerberos=desired|required|off

این پارامتر مشخص می‌کند که آیا ابزارهای کلاینت Samba برای احراز هویت با استفاده از Kerberos تلاش خواهند کرد یا خیر. برای احراز هویت با Kerberos، هنگام اتصال به یک سرویس باید به جای آدرس‌های IP از نام‌های DNS استفاده کنید. به‌طور پیش‌فرض، ابزارهای کلاینت Samba تلاش می‌کنند از حافظه پنهان اعتبارنامه (ccache) پیش‌فرض Kerberos استفاده کنند. در صورتی که ccache وجود نداشته باشد یا گزینه -U|--user مشخص شده باشد، کلاینت‌ها درخواست ورود گذرواژه را مطرح کرده و یک بلیت Kerberos (از طریق kinit) برای شما دریافت خواهند کرد. اگر مایلید از یک حافظه پنهان اعتبارنامه جایگزین برای Kerberos استفاده کنید، از گزینه --use-krb5-ccache استفاده کنید.

توجه داشته باشید که مشخص کردن این پارامتر در اینجا، پارامتر client use kerberos را در فایل /etc/samba/smb.conf بازنویسی خواهد کرد.

--use-krb5-ccache=CCACHE

محل حافظه پنهان اعتبارنامه را برای احراز هویت Kerberos مشخص می‌کند.

این گزینه مقدار --use-kerberos=required را اعمال خواهد کرد.

--use-winbind-ccache

تلاش می‌کند از حافظه پنهان اعتبارنامه ارائه‌شده توسط winbind استفاده کند.

--client-protection=sign|encrypt|off

سطح حفاظت اتصال را که ابزار کلاینت باید به کار ببرد، تعیین می‌کند.

توجه داشته باشید که تعیین این پارامتر در اینجا، پارامتر client protection را در فایل /etc/samba/smb.conf بازنویسی خواهد کرد.

در صورتی که به کنترل دقیق‌تری نیاز دارید می‌توانید از این گزینه‌ها استفاده کنید: --option=clientsmbencrypt=OPTION، --option=clientipcsigning=OPTION، --option=clientsigning=OPTION.

این صفحه راهنما بخشی از نسخه 4.24.6 مجموعه Samba است.

نرم‌افزار اصلی Samba و ابزارهای مرتبط با آن توسط Andrew Tridgell ایجاد شده‌اند. Samba اکنون توسط Samba Team به عنوان یک پروژه متن‌باز، مشابه روش توسعه هسته لینوکس، توسعه داده می‌شود.

صفحه راهنمای smbtree توسط Jelmer Vernooij نوشته شده است.

08/16/2026 Samba 4.24.6