'\" t .\" Title: samba-regedit .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets vsnapshot .\" Date: 08/16/2026 .\" Manual: System Administration tools .\" Source: Samba 4.24.6 .\" Language: English .\" .TH "SAMBA\-REGEDIT" "8" "08/16/2026" "Samba 4\&.24\&.6" "System Administration tools" .\" ----------------------------------------------------------------- .\" * 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\-regedit \- ابزاری مبتنی بر ncurses برای مدیریت رجیستری سامبا .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u samba\-regedit [\-?|\-\-help] [\-\-usage] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-\-configfile=CONFIGFILE] [\-\-option=name=value] [\-l|\-\-log\-basename=LOGFILEBASE] [\-\-leak\-report] [\-\-leak\-report\-full] [\-R|\-\-name\-resolve=NAME\-RESOLVE\-ORDER] [\-O|\-\-socket\-options=SOCKETOPTIONS] [\-m|\-\-max\-protocol=MAXPROTOCOL] [\-n|\-\-netbiosname=NETBIOSNAME] [\-\-netbios\-scope=SCOPE] [\-W|\-\-workgroup=WORKGROUP] [\-\-realm=REALM] [\-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 دستور samba\-regedit ابزاری مبتنی بر ncurses برای مدیریت رجیستری سامبا است\&. از این ابزار می‌توان برای نمایش و ویرایش کلیدها، زیرکلیدهای رجیستری و مقادیر آن‌ها استفاده کرد\&. .SH "گزینه‌ها (OPTIONS)" .PP \-?|\-\-help .RS 4 چاپ خلاصه‌ای از گزینه‌های خط فرمان\&. .RE .PP \-\-usage .RS 4 نمایش پیام خلاصه نحوه استفاده از دستور\&. .RE .PP \-d|\-\-debuglevel=level .RS 4 مقدار \fIlevel\fR یک عدد صحیح از 0 تا 10 است\&. در صورت مشخص نشدن این پارامتر، مقدار پیش‌فرض برای برنامه‌های کلاینت 1 است\&. .sp هرچه این مقدار بیشتر باشد، جزئیات بیشتری درباره فعالیت‌های سرور در فایل‌های گزارش ثبت خواهد شد\&. در سطح 0، فقط خطاهای بحرانی و هشدارهای جدی ثبت می‌شوند\&. سطح 1 سطحی منطقی برای استفاده روزمره است؛ چرا که حجم اندکی از اطلاعات درباره عملیات انجام‌شده تولید می‌کند\&. .sp سطوح بالاتر از 1 مقادیر قابل توجهی داده‌های گزارشی تولید می‌کنند و فقط هنگام عیب‌یابی و بررسی مشکلات باید استفاده شوند\&. سطوح بالاتر از 3 فقط برای استفاده توسعه‌دهندگان طراحی شده‌اند و حجم عظیمی از داده‌های گزارش تولید می‌کنند که اکثر آن‌ها بسیار مبهم و پیچیده هستند\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، مقدار پارامتر \m[blue]\fBlog level\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-\-debug\-stdout .RS 4 خروجی رفع اشکال را به خروجی استاندارد (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 \-R|\-\-name\-resolve=NAME\-RESOLVE\-ORDER .RS 4 این گزینه برای تعیین سرویس‌های نام‌گذاری و ترتیب آن‌ها جهت تبدیل نام میزبان به آدرس IP به کار می‌رود\&. این گزینه رشته‌ای از گزینه‌های مختلف تحلیل نام را که با فاصله از هم جدا شده‌اند، می‌پذیرد\&. بهتر است کل عبارت \-\-name\-resolve=NAME\-RESOLVE\-ORDER را داخل نقل‌قول قرار دهید\&. .sp گزینه‌ها عبارتند از: "lmhosts"، "host"، "wins" و "bcast"\&. این گزینه‌ها موجب تحلیل نام‌ها به شیوه زیر می‌شوند: .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBlmhosts\fR: جستجوی آدرس IP در فایل lmhosts سامبا\&. اگر خط مربوطه در lmhosts نوع نام متصل به نام NetBIOS نداشته باشد (برای جزئیات به \fBlmhosts\fR(5) مراجعه کنید)، هر نوع نامی برای جستجو مطابقت داده می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBhost\fR: انجام تبدیل استاندارد نام میزبان به آدرس IP با استفاده از فایل سیستم /etc/hosts، سامانه NIS یا پرس‌وجوهای DNS\&. این روش تحلیل نام به سیستم‌عامل وابسته است (برای مثال در IRIX یا Solaris ممکن است توسط فایل /etc/nsswitch\&.conf کنترل شود)\&. توجه داشته باشید که این روش فقط در صورتی استفاده می‌شود که نوع نام NetBIOS مورد پرس‌وجو از نوع 0x20 (سرور) باشد، در غیر این صورت نادیده گرفته می‌شود\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBwins\fR: پرس‌وجوی نام از طریق آدرس IP ذکرشده در پارامتر \fIwins server\fR\&. اگر هیچ سرور WINS مشخص نشده باشد، این روش نادیده گرفته خواهد شد\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fBbcast\fR: ارسال برودکست (پخش همگانی) روی هر یک از رابط‌های محلی شناخته‌شده که در پارامتر \fIinterfaces\fR فهرست شده‌اند\&. این روش کم‌ترین قابلیت اطمینان را در میان روش‌های تحلیل نام دارد، زیرا به حضور میزبان مقصد در زیرشبکه متصل محلی وابسته است\&. .RE .sp .RE اگر این پارامتر تنظیم نشود، ترتیب تحلیل نام تعریف‌شده در پارامتر فایل /etc/samba/smb\&.conf (\m[blue]\fBname resolve order\fR\m[]) استفاده خواهد شد\&. .sp ترتیب پیش‌فرض به صورت lmhosts, host, wins, bcast است\&. بدون این پارامتر یا هرگونه ورودی در پارامتر \m[blue]\fBname resolve order\fR\m[] در فایل /etc/samba/smb\&.conf، روش‌های تحلیل نام به همین ترتیب امتحان خواهند شد\&. .RE .PP \-O|\-\-socket\-options=SOCKETOPTIONS .RS 4 گزینه‌های سوکت TCP برای تنظیم روی سوکت کلاینت\&. برای مشاهده فهرست گزینه‌های معتبر به پارامتر socket options در صفحه راهنمای /etc/samba/smb\&.conf مراجعه کنید\&. .RE .PP \-m|\-\-max\-protocol=MAXPROTOCOL .RS 4 مقدار این پارامتر (یک رشته) بالاترین سطح پروتکلی است که توسط کلاینت پشتیبانی خواهد شد\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، مقدار پارامتر \m[blue]\fBclient max protocol\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-n|\-\-netbiosname=NETBIOSNAME .RS 4 این گزینه به شما امکان می‌دهد نام NetBIOS مورد استفاده سامبا برای خود را بازنویسی کنید\&. این کار معادل تنظیم پارامتر \m[blue]\fBnetbios name\fR\m[] در فایل /etc/samba/smb\&.conf است\&. با این حال، تنظیمات خط فرمان نسبت به تنظیمات موجود در /etc/samba/smb\&.conf اولویت دارند\&. .RE .PP \-\-netbios\-scope=SCOPE .RS 4 این گزینه دامنه (scope) مورد استفاده توسط nmblookup را هنگام برقراری ارتباط در زمان تولید نام‌های NetBIOS مشخص می‌کند\&. برای جزئیات بیشتر درباره کاربرد دامنه‌های NetBIOS به rfc1001\&.txt و rfc1002\&.txt مراجعه کنید\&. دامنه‌های NetBIOS \fIبسیار\fR به‌ندرت استفاده می‌شوند؛ فقط در صورتی این پارامتر را تنظیم کنید که مدیر سیستمِ تمام سیستم‌های NetBIOS طرف ارتباط خود باشید\&. .RE .PP \-W|\-\-workgroup=WORKGROUP .RS 4 دامنه SMB مربوط به نام کاربری را تنظیم می‌کند\&. این مقدار، دامنه پیش‌فرض تعریف‌شده در smb\&.conf را بازنویسی می‌کند\&. اگر دامنه مشخص‌شده با نام NetBIOS سرور یکسان باشد، باعث می‌شود کلاینت به جای SAM دامنه، با استفاده از SAM محلی سرور وارد شود\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، مقدار پارامتر \m[blue]\fBworkgroup\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-r|\-\-realm=REALM .RS 4 قلمرو (realm) را برای دامنه مشخص می‌کند\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، مقدار پارامتر \m[blue]\fBrealm\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-U|\-\-user=[DOMAIN\e]USERNAME[%PASSWORD] .RS 4 نام کاربری یا نام کاربری و گذرواژه SMB را تعیین می‌کند\&. .sp اگر %PASSWORD مشخص نشود، از کاربر خواسته می‌شود آن را وارد کند\&. کلاینت ابتدا متغیر محیطی \fBUSER\fR (که می‌تواند شامل گذرواژه جداشده با % نیز باشد) و سپس متغیر \fBLOGNAME\fR (که مجاز به داشتن گذرواژه نیست) را بررسی می‌کند و در صورت وجود هر یک، مقدار آن استفاده می‌شود\&. اگر این متغیرهای محیطی یافت نشوند، نام کاربری موجود در حافظه پنهان اعتبارنامه کربروس (Kerberos Credentials cache) ممکن است به کار رود\&. .sp گزینه سوم استفاده از فایل اعتبارنامه (credentials) است که حاوی متن خام نام کاربری و گذرواژه است\&. این گزینه عمدتاً برای اسکریپت‌هایی فراهم شده است که در آن‌ها مدیر سیستم مایل نیست اعتبارنامه‌ها را در خط فرمان یا از طریق متغیرهای محیطی ارسال کند\&. در صورت استفاده از این روش، اطمینان حاصل کنید که دسترسی‌های فایل مانع از دسترسی کاربران غیرمجاز شود\&. برای جزئیات بیشتر گزینه \fI\-A\fR را ببینید\&. .sp درباره گنجاندن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر ورودی کاربر در خط فرمان محتاط باشید\&. از نظر امنیتی بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را بپرسد، یا اینکه گذرواژه را یک بار با kinit دریافت کنید\&. .sp اگرچه سامبا تلاش می‌کند گذرواژه را از عنوان فرآیند (آن‌گونه که در ps دیده می‌شود) پاک کند، اما این کار پس از شروع برنامه صورت می‌گیرد و بنابراین در معرض شرایط رقابتی (race condition) قرار دارد\&. .RE .PP \-N|\-\-no\-pass .RS 4 در صورت مشخص شدن، این پارامتر از درخواست معمول گذرواژه از کاربر توسط کلاینت جلوگیری می‌کند\&. این گزینه هنگام دسترسی به سرویسی که نیازی به گذرواژه ندارد مفید است\&. .sp کلاینت درخواست گذرواژه خواهد داد، مگر اینکه گذرواژه‌ای در خط فرمان مشخص شده باشد یا این پارامتر تعریف شده باشد\&. .sp اگر گذرواژه‌ای در خط فرمان مشخص شده باشد و این گزینه نیز تعریف گردد، گذرواژه موجود در خط فرمان بدون نمایش پیام نادیده گرفته شده و هیچ گذرواژه‌ای استفاده نخواهد شد\&. .RE .PP \-\-password .RS 4 گذرواژه را در خط فرمان مشخص می‌کند\&. .sp درباره گنجاندن گذرواژه‌ها در اسکریپت‌ها یا ارسال مقادیر ورودی کاربر در خط فرمان محتاط باشید\&. از نظر امنیتی بهتر است اجازه دهید ابزار کلاینت سامبا در صورت نیاز گذرواژه را بپرسد، یا اینکه گذرواژه را یک بار با kinit دریافت کنید\&. .sp اگر \-\-password مشخص نشود، این ابزار متغیر محیطی \fBPASSWD\fR و سپس \fBPASSWD_FD\fR (که انتظار می‌رود حاوی یک شماره توصیف‌کننده فایل (FD) باز باشد) را بررسی می‌کند\&. .sp در نهایت، متغیر \fBPASSWD_FILE\fR (شامل مسیر فایلی که باید باز شود) را بررسی خواهد کرد\&. این فایل فقط باید شامل گذرواژه باشد\&. حتماً اطمینان حاصل کنید که دسترسی‌های فایل مانع از دسترسی کاربران غیرمجاز شود! .sp اگرچه سامبا تلاش می‌کند گذرواژه را از عنوان فرآیند (آن‌گونه که در ps دیده می‌شود) پاک کند، اما این کار پس از شروع برنامه صورت می‌گیرد و بنابراین در معرض شرایط رقابتی (race condition) قرار دارد\&. .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 استفاده از گذرواژه ذخیره‌شده حساب ماشین (machine account)\&. .RE .PP \-\-simple\-bind\-dn=DN .RS 4 شناسه DN برای استفاده در اتصال ساده (simple bind)\&. .RE .PP \-\-use\-kerberos=desired|required|off .RS 4 این پارامتر مشخص می‌کند که آیا ابزارهای کلاینت سامبا برای احراز هویت با کربروس تلاش کنند یا خیر\&. برای احراز هویت کربروس باید هنگام اتصال به سرویس، به جای آدرس‌های IP از نام‌های DNS استفاده کنید\&. به طور پیش‌فرض ابزارهای کلاینت سامبا تلاش می‌کنند از حافظه پنهان اعتبارنامه کربروس (ccache) پیش‌فرض استفاده کنند\&. در صورتی که ccache وجود نداشته باشد یا گزینه \-U|\-\-user مشخص شده باشد، کلاینت‌ها از شما درخواست ورود گذرواژه کرده و یک بلیت کربروس (kinit) برای شما دریافت خواهند کرد\&. اگر مایل به استفاده از یک حافظه پنهان اعتبارنامه کربروس جایگزین هستید، از گزینه \-\-use\-krb5\-ccache استفاده کنید\&. .sp توجه داشته باشید که مشخص کردن این پارامتر در اینجا، مقدار پارامتر \m[blue]\fBclient use kerberos\fR\m[] را در فایل /etc/samba/smb\&.conf بازنویسی خواهد کرد\&. .RE .PP \-\-use\-krb5\-ccache=CCACHE .RS 4 مکان حافظه پنهان اعتبارنامه را برای احراز هویت کربروس مشخص می‌کند\&. .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 مجموعه سامبا است\&. .SH "همچنین ببینید (SEE ALSO)" .PP \fBsmbd\fR(8)، \fBsamba\fR(7) و \fBnet\fR(8)\&. .SH "نویسنده (AUTHOR)" .PP نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط اندرو تریدجل (Andrew Tridgell) ساخته شده است\&. سامبا در حال حاضر توسط تیم سامبا (Samba Team) به عنوان یک پروژه متن‌باز مشابه نحوه توسعه هسته لینوکس توسعه داده می‌شود\&. .PP صفحه راهنمای samba\-regedit توسط کارولین سیگر (Karolin Seeger) نوشته شده است\&.