'\" t .\" Title: mdsearch .\" 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 "MDSEARCH" "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)" mdsearch \- اجرای جستجوهای Spotlight روی یک سرور SMB .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u mdfine {server} {sharename} {query} [\-p,\ \-\-path=STRING] [\-L,\ \-\-live] [\-?|\-\-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(1) است\&. .PP دستور mdsearch یک ابزار ساده برای اجرای جستجوهای Spotlight روی یک سرور SMB است که سرویس RPC مربوط به Spotlight به نام \fImdssvc\fR را اجرا می‌کند\&. .SH "گزینه‌ها (OPTIONS)" .PP server .RS 4 نام سرور SMB یا نشانی IP آن برای اتصال\&. .RE .PP sharename .RS 4 نام یک اشتراک (share) روی سرور\&. .RE .PP query .RS 4 نحو عبارت پرس‌وجو شکل ساده‌شده‌ای از انطباق الگوهای نام فایل (globbing) است که برای کاربران پوسته آشناست\&. پرس‌وجوها ساختار زیر را دارند: .sp attribute=="value" .sp برای پرس‌وجوها روی یک سرور Samba که ویژگی Spotlight با استفاده از بَک‌اِند Elasticsearch در آن فعال است، فهرست ویژگی‌های فرادادهٔ (metadata) پشتیبانی‌شده در فایل نگاشت ویژگی‌های JSON که معمولاً در مسیر /usr/share/samba/mdssvc/elasticsearch_mappings\&.json نصب شده، ارائه شده است\&. .RE .PP \-p PATH, \-\-path=PATH .RS 4 مسیر سمت سرور برای جستجو، پیش‌فرض \fI"/"\fR است\&. .RE .PP \-L, \-\-live .RS 4 پرس‌وجو در حال اجرا باقی می‌ماند\&. .RE .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 \-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 دیده می‌شود) پاک کند، اما این کار پس از راه‌اندازی صورت می‌گیرد و بنابراین در معرض شرایط رقابتی (race condition) است\&. .RE .PP \-\-pw\-nt\-hash .RS 4 گذرواژه ارائه‌شده یک درهم‌ساز (hash) از نوع 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 تلاش می‌کنند از حافظهٔ پنهان اعتبارنامهٔ پیش‌فرض Kerberos (ccache) استفاده کنند\&. در صورتی که 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 مکان حافظهٔ پنهان اعتبارنامه (credential cache) را برای احراز هویت 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 "مثال‌ها (EXAMPLES)" .PP جستجو در تمام مشخصه‌های فرادادهٔ نمایه‌شده، تطابق دقیق: .sp .if n \{\ .RS 4 .\} .nf \*(Aq*=="Samba"\*(Aq .fi .if n \{\ .RE .\} .PP جستجو در تمام مشخصه‌های فرادادهٔ نمایه‌شده، تطابق پیشوندی: .sp .if n \{\ .RS 4 .\} .nf \*(Aq*=="Samba*"\*(Aq .fi .if n \{\ .RE .\} .PP جستجو بر اساس نام فایل: .sp .if n \{\ .RS 4 .\} .nf \*(AqkMDItemFSName=="Samba*"\*(Aq .fi .if n \{\ .RE .\} .PP جستجو بر اساس تاریخ: .sp .if n \{\ .RS 4 .\} .nf \*(AqkMDItemFSContentChangeDate<$time\&.iso(2018\-10\-01T10:00:00Z)\*(Aq .fi .if n \{\ .RE .\} .PP جستجو در محتوای فایل‌ها: .sp .if n \{\ .RS 4 .\} .nf \*(AqkMDItemTextContent=="Samba*"\*(Aq .fi .if n \{\ .RE .\} .PP عبارت‌ها: .sp .if n \{\ .RS 4 .\} .nf kMDItemFSName=="Samba*"||kMDItemTextContent=="Tango*"\*(Aq .fi .if n \{\ .RE .\} .SH "همچنین ببینید (SEE ALSO)" .PP File Metadata Search Programming Guide https://developer\&.apple\&.com/library/archive/documentation/Carbon/Conceptual/SpotlightQuery/Concepts/Introduction\&.html .SH "نسخه (VERSION)" .PP این صفحهٔ راهنما بخشی از نسخهٔ 4\&.24\&.6 از مجموعهٔ Samba است\&..SH "نویسنده (AUTHOR)" .PP نرم‌افزار اصلی Samba و ابزارهای مرتبط با آن توسط Andrew Tridgell ساخته شده‌اند\&. Samba اکنون توسط Samba Team به‌عنوان یک پروژه متن‌باز، مشابه شیوه توسعه هسته Linux توسعه داده می‌شود\&. .PP صفحه راهنمای mdsearch توسط Ralph Boehme نوشته شده است\&.