نام (NAME)

ldapurl - ابزار قالب‌بندی نشانی‌های اینترنتی (URL) پروتکل LDAP

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

ldapurl [-a attrs] [-b searchbase] [-e [!]ext[=extparam]] [-E [!]ext[=extparam]] [-f filter] [-H ldapuri] [-h ldaphost] [-p ldapport] [-s {base|one|sub|children}] [-S scheme]

توضیحات (DESCRIPTION)

ldapurl دستوری است که امکان ساخت یا تجزیه کردن نشانی‌های یکتای منبع (URI) پروتکل LDAP را فراهم می‌کند.

هنگامی که با گزینه -H فراخوانی شود، ldapurl اجزای سازنده آرگومان گزینه ldapuri را استخراج کرده و در صورت نیاز کاراکترهای با کدگذاری هگزادسیمال (hex-escaped) را رمزگشایی می‌کند. این دستور در اصل به‌عنوان یک رابط برای فراخوانی ldap_url_parse(3) عمل می‌کند. در غیر این صورت، این دستور بر اساس مؤلفه‌های ارسال‌شده با گزینه‌های مناسب، یک LDAP URI می‌سازد و عمل وارون را انجام می‌دهد. گزینه -H با گزینه‌های -a، -b، -E، -f، -H، -h، -p، -S و -s ناسازگار است.

گزینه‌ها (OPTIONS)

-a attrs

تنظیم یک فهرست جداشده با کاما از انتخاب‌کننده‌های ویژگی (attribute selectors).

-b searchbase

تنظیم searchbase (پایه جستجو).

-e [!]ext[=extparam]

مشخص کردن افزونه‌های عمومی با -e. علامت '!' نشان‌دهنده حیاتی (critical) بودن است.

افزونه‌های عمومی:

[!]assert=<filter>    (یک فیلتر RFC 4515)
!authzid=<authzid>    ("dn:<dn>" یا "u:<user>")
[!]bauthzid           (کنترل authzid طبق RFC 3829)
[!]chaining[=<resolve>[/<cont>]]
[!]manageDSAit
[!]noop
ppolicy
[!]postread[=<attrs>] (فهرست ویژگی‌ها جداشده با کاما)
[!]preread[=<attrs>]  (فهرست ویژگی‌ها جداشده با کاما)
[!]relax
sessiontracking[=<username>]
abandon,cancel,ignore (سیگنال SIGINT عملیات abandon/cancel می‌فرستد،
یا پاسخ را نادیده می‌گیرد؛ اگر حیاتی باشد، منتظر SIGINT نمی‌ماند.
در اصل کنترل نیستند)

-E [!]ext[=extparam]

تنظیم افزونه‌های URL؛ ناسازگار با -H.

-f filter

تنظیم فیلتر URL. هیچ بررسی خاصی برای انطباق با فیلترهای LDAP طبق RFC 4515 انجام نمی‌شود، اما مقدار در صورت نیاز به شکل هگزادسیمال کدگذاری (hex-escaped) می‌شود.

-H ldapuri

مشخص کردن URI مورد نظر برای تفکیک اجزا (explode).

-h ldaphost

تنظیم میزبان.

-p ldapport

تنظیم درگاه TCP.

-S scheme

تنظیم طرح‌واره (scheme) مربوط به URL. مقادیر پیش‌فرض برای سایر فیلدها مانند ldapport ممکن است به مقدار scheme وابسته باشد.

-s {base|one|sub|children}

محدوده (scope) جستجو را مشخص می‌کند که می‌تواند یکی از مقادیر base، one، sub یا children باشد تا جستجوی شیء پایه، یک‌سطحی، زیردرخت، یا فرزندان را مشخص نماید. مقدار پیش‌فرض sub است. نکته: محدوده children نیازمند افزونه ویژگی‌های زیرمجموعه (subordinate) در LDAPv3 است.

قالب خروجی (OUTPUT FORMAT)

اگر گزینه -H استفاده شود، ldapuri ارائه‌شده به اجزای سازنده‌اش تجزیه شده و به شکلی شبیه به LDIF در خروجی استاندارد چاپ می‌شود.

در غیر این صورت، نشانی URI ساخته‌شده با مقادیر ارسال‌شده توسط سایر گزینه‌ها در خروجی استاندارد چاپ می‌شود.

مثال‌ها (EXAMPLES)

دستور زیر:

ldapurl -h ldap.example.com -b dc=example,dc=com -s sub -f "(cn=Some One)"

خروجی زیر را بازمی‌گرداند:

ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)

دستور:

ldapurl -H ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)

خروجی زیر را بازمی‌گرداند:

scheme: ldap
host: ldap.example.com
port: 389
dn: dc=example,dc=com
scope: sub
filter: (cn=Some One)

عیب‌یابی (DIAGNOSTICS)

در صورت عدم بروز خطا، وضعیت خروج صفر است. خطاها منجر به وضعیت خروج غیرصفر و نوشته شدن یک پیام تشخیصی در خروجی خطای استاندارد می‌شوند.

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

ldap(3)، ldap_url_parse(3)

نویسندگان (AUTHORS)

پروژه اوپن‌ال‌دپ http://www.openldap.org

قدردانی (ACKNOWLEDGEMENTS)

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