نام (NAME)

slapmodify - ویرایش و اصلاح ورودیها در پایگاهداده SLAPD

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

/usr/bin/slapmodify [-b suffix] [-c] [-d debug-level] [-f slapd.conf] [-F confdir] [-g] [-j lineno] [-l ldif-file] [-n dbnum] [-o option[=value]] [-q] [-s] [-S SID] [-u] [-v] [-w]

توضیحات (DESCRIPTION)

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

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

نکته: در صورتی که نمایه‌سازی‌هایی (indexing) پیکربندی شده باشند، slapmodify هنگام اصلاح پایگاه‌داده آن‌ها را نیز انجام می‌دهد. برای جزئیات بیشتر، لطفاً به slapindex(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 مشخص شوند، فایل پیکربندی خوانده شده و به قالب پوشه پیکربندی تبدیل می‌شود و در پوشه مشخص‌شده نوشته خواهد شد. اگر هیچ‌یک از دو گزینه مشخص نشوند، پیش از تلاش برای استفاده از فایل پیکربندی پیش‌فرض، برای خواندن پوشه پیکربندی پیش‌فرض تلاش می‌شود. اگر یک پوشه پیکربندی معتبر وجود داشته باشد، فایل پیکربندی پیش‌فرض نادیده گرفته می‌شود. اگر حالت آزمایش (dry-run) نیز مشخص شده باشد، هیچ تبدیلی صورت نخواهد گرفت.
-g: غیرفعال کردن اتصال زیرمجموعه‌ها (subordinate gluing). فقط پایگاه‌داده مشخص‌شده پردازش خواهد شد و نه زیرمجموعه‌های متصل به آن (در صورت وجود).
-j lineno: پرش به شماره خط مشخص‌شده در فایل LDIF پیش از پردازش هرگونه ورودی. این امکان را می‌دهد تا اصلاحاتی که به دلیل خطا در ورودی LDIF متوقف شده بودند، پس از تصحیح خطاها از سر گرفته شوند.
-l ldif-file: خواندن LDIF از فایل مشخص‌شده به‌جای ورودی استاندارد.
-n dbnum: اعمال تغییرات روی dbnum-امین پایگاه‌داده فهرست‌شده در فایل پیکربندی. گزینه -n نمی‌تواند همراه با گزینه -b استفاده شود. برای دستکاری پایگاه‌داده پیکربندی slapd-config(5)، از -n 0 استفاده کنید زیرا همیشه اولین پایگاه‌داده است. با این حال، باید پیش از این کار به‌صورت فیزیکی روی سیستم‌فایل وجود داشته باشد.
-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))
schema-check={yes|no}
value-check={yes|no}

گزینه schema-check بررسی طرحواره (schema) را تغییر وضعیت می‌دهد (به‌طور پیش‌فرض فعال است)؛ گزینه value-check بررسی مقدار را تغییر وضعیت می‌دهد (به‌طور پیش‌فرض غیرفعال است). گزینه دوم با -q ناسازگار است.

-q: فعال‌سازی حالت سریع (بررسی‌های یکپارچگی کمتر). بررسی‌های سازگاری کمتری روی داده‌های ورودی انجام می‌دهد، و هنگام نوشتن در پایگاه‌داده هیچ بررسی سازگاری انجام نمی‌دهد. زمان اجرا را بهبود می‌بخشد اما در صورت بروز هرگونه خطا یا وقفه، پایگاه‌داده حاصل غیرقابل استفاده خواهد بود.
-s: غیرفعال کردن بررسی طرحواره (schema). این گزینه برای استفاده هنگام دستکاری پایگاه‌های داده حاوی اشیاء خاص، مانند اشیاء کسری در یک رونوشت جزئی (partial replica) در نظر گرفته شده است. ایجاد اشیاء عادی که با طرحواره مطابقت ندارند ممکن است منجر به رفتار غیرمنتظره و نامطلوب شود.
-S SID: شناسه سرور (Server ID) برای استفاده در entryCSN تولیدشده. همچنین در صورت تنظیم -w برای contextCSN نیز استفاده می‌شود. مقدار پیش‌فرض 0 است.
-u: فعال‌سازی حالت آزمایش / شبیه‌سازی (dry-run؛ عدم نوشتن در بک‌اند).
-v: فعال‌سازی حالت پرحرف (verbose).
-w: نوشتن اطلاعات زمینه syncrepl. پس از افزودن و اعمال تمام ورودی‌ها، contextCSN با بزرگترین CSN موجود در پایگاه‌داده به‌روزرسانی می‌شود.

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

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

همه بک‌اندها از تمام انواع اصلاحات پشتیبانی نمی‌کنند؛ به‌ویژه نوع تغییر modrdn برای هیچ‌یک از بک‌آندهای فعلی پیاده‌سازی نشده است.

دستور slapmodify ممکن است بررسی‌های نام‌گذاری یا طرحواره را ارائه ندهد. توصیه می‌شود در صورت امکان از ldapmodify(1) استفاده کنید.

مثال‌ها (EXAMPLES)

برای اعمال اصلاحات مشخص‌شده در فایل ldif روی پایگاه‌داده slapd(8) خود، دستور زیر را اجرا کنید:

/usr/bin/slapmodify -l ldif

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

ldap(3), ldif(5), slapcat(8), slapadd(8), slapindex(8), ldapmodify(1), slapd(8)

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

قدردانی (ACKNOWLEDGEMENTS)

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