نام (NAME)

slapcat - ابزار استخراج پایگاه‌داده SLAPD به قالب متنی LDIF

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

/usr/bin/slapcat [-afilter] [-bsuffix] [-c] [-ddebug-level] [-fslapd.conf] [-Fconfdir] [-g] [-HURI] [-lldif-file] [-ndbnum] [-ooption[=value]] [-ssubtree-dn] [-v]

توضیحات (DESCRIPTION)

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

رکوردهای ورودی بر اساس ترتیب پایگاه‌داده ارائه می‌شوند، نه بر اساس اولویت بالاتر (superior first). رکوردهای ورودی شامل تمام ویژگی‌های (کاربری و عملیاتی) ذخیره‌شده در پایگاه‌داده خواهند بود. رکوردهای ورودی شامل ویژگی‌های تولیدشده به‌صورت پویا (مانند subschemaSubentry) نخواهند بود.

خروجی slapcat برای استفاده به عنوان ورودی برای slapadd(8) در نظر گرفته شده است. خروجی slapcat را معمولاً نمی‌توان بدون ویرایش قبلی خروجی به عنوان ورودی برای ldapadd(1) یا سایر کلاینت‌های LDAP استفاده کرد. این ویرایش معمولاً شامل مرتب‌سازی مجدد رکوردها به ترتیب اولویت بالاتر (superior first) و حذف ویژگی‌های عملیاتی غیرقابل ویرایش توسط کاربر (no-user-modification) است.

گزینه‌ها (OPTIONS)

-a filter: تنها استخراج ورودی‌های منطبق با فیلتر ارائه‌شده. برای نمونه:

slapcat -a \
    "(!(entryDN:dnSubtreeMatch:=ou=People,dc=example,dc=com))"

تمام ورودی‌ها به جز زیردرخت "ou=People,dc=example,dc=com" از پایگاه‌داده "dc=example,dc=com" را استخراج خواهد کرد. منسوخ شده است؛ در عوض از -H ldap:///???(filter) استفاده کنید.

-b suffix: استفاده از suffix مشخص‌شده برای تعیین پایگاه‌داده‌ای که باید خروجی برای آن تولید شود. به‌طور پیش‌فرض، نخستین پایگاه‌داده‌ای که از عملیات درخواستی پشتیبانی کند استفاده می‌شود. گزینه -b نمی‌تواند همراه با گزینه -n استفاده شود.
-c: فعال‌سازی حالت ادامه (نادیده گرفتن خطاها). تکرار چندین‌بارهٔ گزینه -c باعث می‌شود slapcat(8) تلاش بیشتری به عمل آورد.
-d debug-level: فعال‌سازی پیام‌های اشکال‌زدایی طبق debug-level مشخص‌شده؛ برای جزئیات به slapd(8) مراجعه کنید.
-f slapd.conf: مشخص کردن یک فایل جایگزین برای slapd.conf(5).
-F confdir: مشخص کردن یک پوشه پیکربندی. اگر هر دو گزینه -f و -F مشخص شوند، فایل پیکربندی خوانده شده و به قالب پوشه پیکربندی تبدیل می‌شود و در پوشه مشخص‌شده نوشته می‌شود. اگر هیچ‌کدام مشخص نشوند، پیش از تلاش برای استفاده از فایل پیکربندی پیش‌فرض، ابتدا تلاش می‌شود پوشه پیکربندی پیش‌فرض خوانده شود. در صورت وجود یک پوشه پیکربندی معتبر، فایل پیکربندی پیش‌فرض نادیده گرفته می‌شود.
-g: غیرفعال کردن اتصال زیرمجموعه‌ها (subordinate gluing). تنها پایگاه‌داده مشخص‌شده پردازش خواهد شد و نه زیرمجموعه‌های متصل به آن (در صورت وجود).
-H URI: استفاده از dn، دامنه (scope) و فیلتر از URI برای مدیریت انحصاری ورودی‌های منطبق.
-l ldif-file: نوشتن LDIF در فایل مشخص‌شده به‌جای خروجی استاندارد.
-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))
ldif_wrap={no|<n>}

n تعداد ستون‌های مجاز برای خروجی LDIF است (n برابر با 0 از مقدار پیش‌فرض معادل ۷۸ استفاده می‌کند). حداقل مقدار ۲ است که فضایی برای یک کاراکتر و یک کاراکتر ادامه‌دهنده باقی می‌گذارد. از no برای عدم شکستن خطوط (no wrap) استفاده کنید.

-s subtree-dn: تنها استخراج ورودی‌های موجود در زیردرخت مشخص‌شده توسط این DN. در صورتی که گزینه -b یا -n داده نشده باشد، به منزلهٔ -b subtree-dn خواهد بود. منسوخ شده است؛ در عوض از -H ldap:///subtree-dn استفاده کنید.
-v: فعال‌سازی حالت پرحرف (verbose).

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

برای برخی از انواع بک‌اند، جهت تضمین سازگاری پایگاه‌داده، دیمن slapd(8) شما هنگام انجام این کار نباید در حال اجرا باشد (حداقل در حالت خواندن-نوشتن نباشد). اجرای slapcat همراه با بک‌اندهای slapd-mdb(5) و slapd-null(5) همواره ایمن است.

مثال‌ها (EXAMPLES)

برای تهیه یک پشتیبان متنی از پایگاه‌داده SLAPD و ذخیره آن در فایلی به نام ldif، دستور زیر را وارد کنید:

/usr/bin/slapcat -l ldif

همچنین ببینید (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 دانشگاه میشیگان برگرفته شده است.