نام (NAME)

slapd.plugin - پیکربندی افزونه برای slapd، دیمن مستقل LDAP

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

/etc/openldap/slapd.conf

توضیحات (DESCRIPTION)

فایل slapd.conf(5) شامل اطلاعات پیکربندی برای دیمن slapd(8) است. این فایل پیکربندی همچنین توسط ابزارهای SLAPD شامل slapadd(8)، slapcat(8)، slapmodify(8) و slapindex(8) استفاده می‌شود.

فایل slapd.conf شامل مجموعه‌ای از گزینه‌های پیکربندی سراسری است که بر slapd به‌طور کلی (شامل تمام بک‌اندها) اعمال می‌شود، و به دنبال آن صفر یا چند تعریف بک‌اند پایگاه‌داده می‌آید که شامل اطلاعات مختص به یک نمونه بک‌اند است.

قالب کلی slapd.conf به صورت زیر است:

# comment - these options apply to every database
<global configuration options>
# first database definition & configuration options
database    <backend 1 type>
<configuration options specific to backend 1>
# subsequent database definitions & configuration options
...

اگر slapd با --enable-slapi کامپایل شده باشد، پشتیبانی از افزونه‌ها بر اساس Netscape's Directory Server Plug-Ins فراهم است. نسخهٔ ۴ این API در حال حاضر پیاده‌سازی شده است، به همراه برخی گسترش‌ها از نسخهٔ ۵.

هم داده‌های سراسری و هم داده‌های مختص به پایگاه‌داده می‌توانند شامل اطلاعات افزونه باشند. افزونه‌های مرتبط با یک پایگاه‌دادهٔ خاص پیش از افزونه‌های سراسری فراخوانی می‌شوند. این صفحهٔ راهنما دستورهای پیکربندی slapd(8) را که بر بارگذاری افزونه‌های SLAPI تأثیر می‌گذارند، به تفصیل شرح می‌دهد.

آرگومان‌هایی که باید با متن واقعی جایگزین شوند درون براکت‌های <> نشان داده شده‌اند.

ساختار دستورالعمل‌های افزونه به شرح زیر است:

plugin <type> <lib_path> <init_function> [<arguments>]

یک افزونه از نوع مشخص‌شده را برای پایگاه‌دادهٔ فعلی بارگذاری می‌کند.

بخش <type> می‌تواند یکی از موارد زیر باشد: preoperation که پیش از پردازش عملیات برای پایگاه‌دادهٔ مشخص‌شده اجرا می‌شود، postoperation که پس از پردازش عملیات برای پایگاه‌دادهٔ مشخص‌شده اجرا می‌گردد، extendedop که هنگام اجرای یک عملیات گسترش‌یافته (extended operation) به کار می‌رود، یا object. مورد اخیر برای انواع متفرقه نظیر افزونه‌های ACL، صفت‌های محاسباتی (computed attribute) و بازنویس‌های فیلتر جستجو (search filter rewriter) استفاده می‌شود.

آرگومان <libpath> مسیر شیء بارگذاری‌شدنی افزونه را مشخص می‌کند؛ اگر یک مسیر نسبی داده شود، شیء بر اساس بستهٔ بارگذاری پویای زیربنایی (از ltdl مربوط به libtool استفاده می‌شود) جستجو می‌گردد.

آرگومان <init_function> مشخص می‌کند که هنگام بارگذاری اولیهٔ افزونه چه نمادی (symbol) باید فراخوانی شود. این تابع باید توابع ارائه‌شده توسط افزونه را برای عملیات مورد نظر ثبت کند. باید توجه داشت که همین تابع راه‌اندازی (init function) است که تعیین می‌کند افزونه چه زمانی و برای چه عملیاتی فراخوانی شود، نه نوع افزونه که به عنوان آرگومان اول مشخص شده است. فهرست اختیاری <arguments> به تابع init ارسال می‌شود.

pluginlog <file>

یک مسیر جایگزین را برای فایل گزارش (log) افزونه مشخص می‌کند (پیش‌فرض /var/lib/openldap/errors است).

modulepath <pathspec>

این دستور مسیر بارگذاری ماژول را برای بک‌اندهای با قابلیت بارگذاری پویا تنظیم می‌کند، همان‌گونه که در slapd.conf(5) شرح داده شده است؛ با این حال، از آنجا که هم بک‌اندهای با قابلیت بارگذاری پویا و هم افزونه‌های SLAPI از همان کتابخانهٔ زیربنایی (ltdl مربوط به libtool) استفاده می‌کنند، مقدار آن بر مسیر جستجوی افزونه نیز تأثیر می‌گذارد. به‌طور کلی، مسیر جستجو از مسیرهایی تشکیل شده است که با دو‌نقطه (:) از یکدیگر جدا می‌شوند؛ معمولاً مسیر تعریف‌شده توسط کاربر ابتدا جستجو می‌شود؛ سپس در صورت تعریف بودن، مقدار متغیر محیطی LTDL_LIBRARY_PATH استفاده می‌گردد؛ در نهایت، مسیر بارگذاری پویای مختص به سیستم بررسی می‌شود (برای نمونه در لینوکس، مقدار متغیر محیطی LD_LIBRARY_PATH). لطفاً مستندات ltdl را با دقت مطالعه کنید زیرا رفتار آن بسیار وابسته به پلتفرم است.

فایل‌ها (FILES)

/etc/openldap/slapd.conf

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

/var/lib/openldap/errors

فایل گزارش (log) پیش‌فرض افزونه

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

slapd(8)،

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

قدردانی‌ها (ACKNOWLEDGEMENTS)

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