.lf 1 "-
.TH SLAPO-VALSORT 5 "2026/03/09" "OpenLDAP 2.6.13"
.\" Copyright 2005-2026 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.\" $OpenLDAP$
.SH "نام (NAME)"
slapo\-valsort \- اورلی مرتبسازی مقادیر ویژگیها برای slapd
.SH "خلاصه دستور (SYNOPSIS)"
/etc/openldap/slapd.conf
.SH "توضیحات (DESCRIPTION)"
اورلی مرتب‌سازی مقادیر (Value Sorting) می‌تواند همراه با یک پایگاه‌دادهٔ بک‌اند برای مرتب‌سازی مقادیر ویژگی‌های چندمقداری خاص درون یک زیردرخت به کار رود. این مرتب‌سازی هر بار که ویژگی‌ها در پاسخ یک جستجو بازگردانده شوند، انجام می‌گیرد.
.LP
مرتب‌سازی را می‌توان به صورت صعودی یا نزولی و با استفاده از روش‌های مرتب‌سازی عددی یا الفبایی‌عددی مشخص کرد. علاوه بر این، می‌توان یک مرتب‌سازی «وزن‌دار» (weighted) را نیز تعیین نمود که از یک وزن عددی اضافه‌شده به ابتدای مقادیر ویژگی استفاده می‌کند. مرتب‌سازی وزن‌دار همواره به صورت صعودی انجام می‌شود، اما برای مقادیری که وزن یکسانی دارند می‌تواند با روش‌های دیگر ترکیب شود. وزن با قرار دادن یک وزن صحیح
{<\fIweight\fP>}
در ابتدای هر مقدار از ویژگی که مرتب‌سازی وزن‌دار برای آن مورد نظر است، مشخص می‌شود. این ضریب وزنی حذف شده و در نتایج جستجو بازگردانده نمی‌شود، مگر اینکه کنترل valsort مشخص شده باشد (1.3.6.1.4.1.4203.666.5.14).
.LP
کنترل valsort نیازمند مقداری متشکل از یک Sequence حاوی یک پرچم بولی است. ضریب وزنی تنها در صورتی بازگردانده می‌شود که مقدار بولی TRUE باشد. در قالب
.BR lber-encode (3)،
مقدار مورد نیاز باید با نحو "{b}" مطابقت داشته باشد.

.SH "پیکربندی (CONFIGURATION)"
این گزینه‌های
.I slapd.conf
بر اورلی مرتب‌سازی مقادیر اعمال می‌شوند.
آن‌ها باید پس از دستورالعمل
.B overlay
قرار گیرند.
.TP
valsort\-attr <\fIattribute\fP> <\fIbaseDN\fP> (<\fIsort-method\fP> | weighted [<\fIsort-method\fP>])
یک روش مرتب‌سازی را برای
.I attribute
مشخص‌شده در زیردرختی با ریشهٔ
.I baseDN
پیکربندی می‌کند.
.I sort-method
می‌تواند یکی از موارد
.BR alpha\-ascend ،
.BR alpha\-descend ،
.BR numeric\-ascend
یا
.B numeric\-descend
باشد. اگر روش ویژهٔ
.B weighted
مشخص شده باشد، یک
.I sort-method
ثانویه نیز ممکن است تعیین شود. تعیین یک
.I sort-method
الفبایی‌عددی برای یک ویژگی با نحو Integer یا NumericString یک خطا است، و تعیین یک
.I sort-method
عددی برای ویژگی با نحوی غیر از Integer یا NumericString نیز خطا محسوب می‌شود.
.SH "مثال‌ها (EXAMPLES)"
.LP
.nf
	database mdb
	suffix dc=example,dc=com
	...
	overlay valsort
	valsort\-attr member ou=groups,dc=example,dc=com alpha\-ascend
.fi

برای فراخوانی
.BR ldapsearch (1)
با کنترل valsort، مقدار کنترل باید به شکل مناسبی تنظیم شود. بایت‌های (octet) زیر نمایانگر کدگذاری مطلوب "{b}" هستند:
.LP
.nf
	0x30 0x03 0x01 0x01 0xff
.fi

این کنترل را می‌توان از خط فرمان با استفاده از کدگذاری base64 مقدار ارسال کرد:
.LP
.nf
	ldapsearch \-E 1.3.6.1.4.1.4203.666.5.14=::MAMBAf8=
.fi

.SH "فایل‌ها (FILES)"
.TP
\fI/etc/openldap/slapd.conf\fP
فایل پیکربندی پیش‌فرض \fBslapd\fP
.SH "همچنین ببینید (SEE ALSO)"
.BR slapd.conf (5),
.BR slapd\-config (5).
.SH "قدردانی (ACKNOWLEDGEMENTS)"
.P
این ماژول در سال ۲۰۰۵ توسط Howard Chu از شرکت Symas Corporation نوشته شد. این کار با حمایت مالی دانشگاه استنفورد (Stanford University) انجام گرفت.