'\" t .\" Title: wspsearch .\" 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 "WSPSEARCH" "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)" wspsearch \- اجرای جستجوهای پروتکل Windows Search روی یک سرور SMB .SH "خلاصه دستور (SYNOPSIS)" .HP \w'\ 'u wspsearch {//server/share} [\-\-limit=results] [\-\-search=phrase] [\-\-kind=KIND] [\-\-query=QUERY] [\-?|\-\-help] [\-\-usage] [\-d|\-\-debuglevel=DEBUGLEVEL] [\-\-debug\-stdout] [\-s|\-\-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] .SH "توضیحات (DESCRIPTION)" .PP این ابزار بخشی از مجموعهٔ \fBsamba\fR(1) است\&. .PP دستور wspsearch یک ابزار ساده برای اجرای جستجوهای پروتکل Windows Search روی یک سرور SMB است که سرویس WSP روی آن فعال شده باشد\&. .SH "گزینه‌ها (OPTIONS)" .PP server .RS 4 نام سرور SMB یا نشانی IP آن برای اتصال\&. .RE .PP sharename .RS 4 نام یک اشتراک (share) روی سرور\&. .RE .PP \-\-query .RS 4 یک پرس‌وجوی مشخص‌شده در ساختار ساده‌شدهٔ شبیه به AQS (نحو پیشرفتهٔ پرس‌وجو یا Advanced Query Syntax)\&. .sp نحو پایهٔ (AQS) پشتیبانی می‌شود (بخش \fISEE ALSO\fR را ببینید)\&. یک پرس‌وجو از توالی پرس‌وجوهایی تشکیل شده است که با عملگرهای بولی AND، OR و NOT به یکدیگر متصل شده‌اند\&. عناصر پرس‌وجو اساساً محدودیت‌هایی هستند که توسط یک ویژگی (property) تعریف می‌شوند\&. محدودیت‌هایی روی عملگرهای پشتیبانی‌شده وجود دارد و برخی انواع ویژگی‌ها مانند بازه‌های شمارشی (enumerated ranges) اصلاً پشتیبانی نمی‌شوند\&. علاوه بر این، از نظر نحوی مقادیر بازه همانند آنچه در AQS مشخص شده محدود نمی‌شوند (بازه‌ها در عوض به‌صورت value\-value مشخص می‌شوند)\&. برخی موارد خاص که در رابط کاربری جستجوی ویندوز می‌بینید (برای نمونه اندازه‌هایی مانند \*(Aqtiny\*(Aq، \*(Aqsmall\*(Aq، \*(Aqlarge\*(Aq و غیره) استثناهایی هستند که کم‌وبیش به عنوان کلیدواژه با آن‌ها رفتار می‌شود\&. بخش \fIEXAMPLES\fR را ببینید\&. .RE .PP \-\-search=phrase .RS 4 یک عبارت ساده که در سراسر نمایه (index) جستجو می‌شود\&. .RE .PP \-\-kind=KIND .RS 4 نوع (kind) یکی از موارد زیر؛ .RS .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fICalendar\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fICommunication\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIContact\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIDocument\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIEmail\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIFeed\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIFolder\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIGame\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIInstantMessage\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIJournal\fR .RE.sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIMovie\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIMusic\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fILink\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fINote\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIPicture\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIProgram\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIRecordedTV\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fISearchFolder\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fITask\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIVideo\fR .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} \fIWebHistory\fR .RE .sp .RE .RE .PP \-\-limit .RS 4 محدودیتی برای تعداد نتایج بازگردانده شده؛ به‌طور پیش‌فرض محدودیت ۵۰۰ نتیجه وجود دارد، مقدار ۰ نشان‌دهندهٔ نبود محدودیت است و همهٔ نتایج بازگردانده خواهند شد\&. .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 بازنویسی خواهد کرد\&. .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 گزینه سوم استفاده از یک فایل اعتبارسنجی است که حاوی متن خام نام کاربری و گذرواژه است\&. این گزینه عمدتاً برای اسکریپت‌هایی فراهم شده است که مدیر سیستم مایل نیست اطلاعات اعتبارسنجی را در خط فرمان یا از طریق متغیرهای محیطی ارسال کند\&. در صورت استفاده از این روش، اطمینان حاصل کنید که مجوزهای دسترسی فایل، مانع دسترسی کاربران غیرمجاز شود\&. برای جزئیات بیشتر به \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 استفاده از گذرواژهٔ ذخیره‌شدهٔ حساب ماشین (machine account)\&. .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 را بازنویسی (override) خواهد کرد\&. .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 را بازنویسی (override) خواهد کرد\&. .sp در صورتی که به کنترل دقیق‌تری نیاز دارید می‌توانید از موارد زیر استفاده کنید: \-\-option=clientsmbencrypt=OPTION, \-\-option=clientipcsigning=OPTION, \-\-option=clientsigning=OPTION\&. .RE.SH "مثال‌ها (EXAMPLES)" .PP جستجو با استفاده از یک عبارت ساده: .sp .if n \{\ .RS 4 .\} .nf \*(Aqwspsearch \-Usomeuser%password //server/share \-\-phrase="cats"\*(Aq .fi .if n \{\ .RE .\} .PP جستجو با استفاده از پرس‌وجویی شبیه به AQS برای تصویری که نام آن با p403 یا p404 آغاز می‌شود: .sp .if n \{\ .RS 4 .\} .nf \*(Aqwspsearch \-Usomeuser%password //server/share \-\-query="ALL:$