نام (NAME)

slapo-valsort - اورلی مرتبسازی مقادیر ویژگیها برای slapd

خلاصه دستور (SYNOPSIS)

/etc/openldap/slapd.conf

توضیحات (DESCRIPTION)

اورلی مرتب‌سازی مقادیر (Value Sorting) می‌تواند همراه با یک پایگاه‌دادهٔ بک‌اند برای مرتب‌سازی مقادیر ویژگی‌های چندمقداری خاص درون یک زیردرخت به کار رود. این مرتب‌سازی هر بار که ویژگی‌ها در پاسخ یک جستجو بازگردانده شوند، انجام می‌گیرد.

مرتب‌سازی را می‌توان به صورت صعودی یا نزولی و با استفاده از روش‌های مرتب‌سازی عددی یا الفبایی‌عددی مشخص کرد. علاوه بر این، می‌توان یک مرتب‌سازی «وزن‌دار» (weighted) را نیز تعیین نمود که از یک وزن عددی اضافه‌شده به ابتدای مقادیر ویژگی استفاده می‌کند. مرتب‌سازی وزن‌دار همواره به صورت صعودی انجام می‌شود، اما برای مقادیری که وزن یکسانی دارند می‌تواند با روش‌های دیگر ترکیب شود. وزن با قرار دادن یک وزن صحیح {<weight>} در ابتدای هر مقدار از ویژگی که مرتب‌سازی وزن‌دار برای آن مورد نظر است، مشخص می‌شود. این ضریب وزنی حذف شده و در نتایج جستجو بازگردانده نمی‌شود، مگر اینکه کنترل valsort مشخص شده باشد (1.3.6.1.4.1.4203.666.5.14).

کنترل valsort نیازمند مقداری متشکل از یک Sequence حاوی یک پرچم بولی است. ضریب وزنی تنها در صورتی بازگردانده می‌شود که مقدار بولی TRUE باشد. در قالب lber-encode(3)، مقدار مورد نیاز باید با نحو "{b}" مطابقت داشته باشد.

پیکربندی (CONFIGURATION)

این گزینه‌های slapd.conf بر اورلی مرتب‌سازی مقادیر اعمال می‌شوند. آن‌ها باید پس از دستورالعمل overlay قرار گیرند.

valsort-attr <attribute> <baseDN> (<sort-method> | weighted [<sort-method>])

یک روش مرتب‌سازی را برای attribute مشخص‌شده در زیردرختی با ریشهٔ baseDN پیکربندی می‌کند. sort-method می‌تواند یکی از موارد alpha-ascend، alpha-descend، numeric-ascend یا numeric-descend باشد. اگر روش ویژهٔ weighted مشخص شده باشد، یک sort-method ثانویه نیز ممکن است تعیین شود. تعیین یک sort-method الفبایی‌عددی برای یک ویژگی با نحو Integer یا NumericString یک خطا است، و تعیین یک sort-method عددی برای ویژگی با نحوی غیر از Integer یا NumericString نیز خطا محسوب می‌شود.

مثال‌ها (EXAMPLES)

database mdb
suffix dc=example,dc=com
...
overlay valsort
valsort-attr member ou=groups,dc=example,dc=com alpha-ascend

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

0x30 0x03 0x01 0x01 0xff

این کنترل را می‌توان از خط فرمان با استفاده از کدگذاری base64 مقدار ارسال کرد:

ldapsearch -E 1.3.6.1.4.1.4203.666.5.14=::MAMBAf8=

فایل‌ها (FILES)

/etc/openldap/slapd.conf

فایل پیکربندی پیش‌فرض slapd

همچنین ببینید (SEE ALSO)

slapd.conf(5), slapd-config(5).

قدردانی (ACKNOWLEDGEMENTS)

این ماژول در سال ۲۰۰۵ توسط Howard Chu از شرکت Symas Corporation نوشته شد. این کار با حمایت مالی دانشگاه استنفورد (Stanford University) انجام گرفت.