نام (NAME)

slapindex - بازسازی نمایهها در پایگاهداده slapd

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

/usr/bin/slapindex [-b suffix] [-c] [-d debug-level] [-f slapd.conf] [-F confdir] [-g] [-n dbnum] [-o option[=value]] [-q] [-t] [-v] [attr[...]]

توضیحات (DESCRIPTION)

Slapindex برای بازسازی نمایه‌های slapd(8) بر اساس محتویات فعلی یک پایگاه‌داده به کار می‌رود. این ابزار پایگاه‌داده داده‌شده را که بر اساس شماره پایگاه‌داده یا پسوند (suffix) مشخص می‌شود باز کرده و نمایه‌ها را برای تمام مقادیر همه ویژگی‌های کلیه ورودی‌ها به‌روزرسانی می‌کند. اگر فهرستی از ویژگی‌های مشخص در خط فرمان ارائه شود، تنها نمایه‌های مربوط به آن ویژگی‌ها بازسازی خواهند شد. پایگاه‌های داده‌ای که به عنوان subordinate (زیرمجموعه) این پایگاه‌داده پیکربندی شده‌اند نیز مجدداً نمایه می‌شوند، مگر اینکه گزینه -g مشخص شده باشد.

تمام فایل‌هایی که در نهایت توسط slapindex ایجاد می‌شوند، متعلق به همان هویتی خواهند بود که slapindex تحت آن اجرا شده است؛ بنابراین مطمئن شوید که یا slapindex را با همان هویتی که slapd(8) اجرا خواهد شد اجرا کنید (گزینه -u در slapd(8) را ببینید)، یا مالکیت فایل‌ها را پیش از اجرای slapd(8) تغییر دهید.

گزینه‌ها (OPTIONS)

-b suffix: استفاده از suffix مشخص‌شده برای تعیین اینکه عملیات روی کدام پایگاه‌داده انجام شود. به‌طور پیش‌فرض، نخستین پایگاه‌داده‌ای که از عملیات درخواستی پشتیبانی کند استفاده می‌شود. گزینه -b نمی‌تواند همراه با گزینه -n به کار رود.
-c: فعال‌سازی حالت ادامه (نادیده گرفتن خطاها).
-d debug-level: فعال‌سازی پیام‌های اشکال‌زدایی بر اساس debug-level مشخص‌شده؛ برای جزئیات به slapd(8) مراجعه کنید.
-f slapd.conf: مشخص کردن یک فایل جایگزین slapd.conf(5).
-F confdir: مشخص کردن یک دایرکتوری پیکربندی. اگر هر دو گزینه -f و -F مشخص شده باشند، فایل پیکربندی خوانده شده و به قالب دایرکتوری پیکربندی تبدیل می‌شود و در دایرکتوری مشخص‌شده نوشته خواهد شد. اگر هیچ‌یک از این دو گزینه مشخص نشوند، پیش از تلاش برای استفاده از فایل پیکربندی پیش‌فرض، برای خواندن دایرکتوری پیکربندی پیش‌فرض تلاش خواهد شد. اگر یک دایرکتوری پیکربندی معتبر وجود داشته باشد، فایل پیکربندی پیش‌فرض نادیده گرفته می‌شود.
-g: غیرفعال کردن چسباندن زیرمجموعه‌ها (subordinate gluing). تنها پایگاه‌داده مشخص‌شده پردازش خواهد شد و زیرمجموعه‌های متصل به آن (در صورت وجود) پردازش نمی‌شوند.
-n dbnum: تولید خروجی برای dbnumمین پایگاه‌داده فهرست‌شده در فایل پیکربندی. پایگاه‌داده پیکربندی slapd-config(5)، همواره نخستین پایگاه‌داده است، بنابراین از -n 0 استفاده کنید.
گزینه -n نمی‌تواند همراه با گزینه -b استفاده شود.
-o option[=value]: مشخص کردن یک option همراه با یک value (اختیاری). گزینه‌ها و مقادیر عمومی ممکن عبارتند از:

syslog=<subsystems>  (see `-s' in slapd(8))
syslog-level=<level> (see `-S' in slapd(8))
syslog-user=<user>   (see `-l' in slapd(8))

-q: فعال‌سازی حالت سریع (بررسی‌های یکپارچگی کمتر). هنگام نوشتن در پایگاه‌داده هیچ بررسی سازگاری انجام نمی‌دهد. زمان نمایه‌سازی را بهبود می‌بخشد، اما در صورت بروز هرگونه خطا یا وقفه، پایگاه‌داده به احتمال زیاد غیرقابل استفاده خواهد بود.
-t: فعال‌سازی حالت کوتاه کردن (truncate). پایگاه‌داده نمایه را قبل از نمایه‌سازی هرگونه ورودی کوتاه (خالی) می‌کند. تنها همراه با back-mdb قابل استفاده است.
-v: فعال‌سازی حالت پرحرف (verbose).

محدودیت‌ها (LIMITATIONS)

برای اطمینان از سازگاری پایگاه‌داده، دیمن slapd(8) شما هنگام انجام این کار نباید در حال اجرا باشد (دست‌کم نه در حالت خواندن-نوشتن).

این دستور فرصت کافی برای کاربر فراهم می‌کند تا نوشیدنی مورد علاقه خود را تهیه کرده و بنوشد.

مثال‌ها (EXAMPLES)

برای نمایه‌سازی مجدد پایگاه‌داده SLAPD خود، دستور زیر را اجرا کنید:

/usr/bin/slapindex

برای بازسازی نمایه تنها برای یک ویژگی خاص، مانند "uid"، دستور زیر را اجرا کنید:

/usr/bin/slapindex uid

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

ldap(3), ldif(5), slapadd(8), ldapadd(1), slapd(8)

"OpenLDAP Administrator's Guide" (http://www.OpenLDAP.org/doc/admin)

قدردانی (ACKNOWLEDGEMENTS)

OpenLDAP Software توسط پروژه OpenLDAP در http://www.openldap.org توسعه یافته و نگهداری می‌شود. OpenLDAP Software از انتشار LDAP 3.3 دانشگاه میشیگان مشتق شده است.