.TH "LDAPURL" "1" "2026-03-09" "OpenLDAP 2.6.13" "دستورات کاربر"
.\" $OpenLDAP$
.\" Copyright 2008-2026 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.SH "نام (NAME)"
ldapurl \- ابزار قالب‌بندی نشانی‌های اینترنتی (URL) پروتکل LDAP
.SH "خلاصه دستور (SYNOPSIS)"
.B ldapurl
[\c
.BR \-a \ attrs\fR]
[\c
.BI \-b \ searchbase\fR]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BI \-f \ filter\fR]
[\c
.BI \-H \ ldapuri\fR]
[\c
.BI \-h \ ldaphost\fR]
[\c
.BI \-p \ ldapport\fR]
[\c
.BR \-s \ { base \||\| one \||\| sub \||\| children }]
[\c
.BI \-S \ scheme\fR]
.SH "توضیحات (DESCRIPTION)"
.I ldapurl
دستوری است که امکان ساخت یا تجزیه کردن نشانی‌های یکتای منبع (URI) پروتکل LDAP را فراهم می‌کند.
.LP
هنگامی که با گزینه \fB\-H\fP فراخوانی شود،
.B ldapurl
اجزای سازنده آرگومان گزینه \fIldapuri\fP را استخراج کرده و در صورت نیاز کاراکترهای با کدگذاری هگزادسیمال (hex-escaped) را رمزگشایی می‌کند.
این دستور در اصل به‌عنوان یک رابط برای فراخوانی
.BR ldap_url_parse (3)
عمل می‌کند.
در غیر این صورت، این دستور بر اساس مؤلفه‌های ارسال‌شده با گزینه‌های مناسب، یک LDAP URI می‌سازد و عمل وارون را انجام می‌دهد.
گزینه \fB\-H\fP با گزینه‌های
.BR \-a ،
.BR \-b ،
.BR \-E ،
.BR \-f ،
.BR \-H ،
.BR \-h ،
.BR \-p ،
.BR \-S
و
.BR \-s
ناسازگار است.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-a \ attrs
تنظیم یک فهرست جداشده با کاما از انتخاب‌کننده‌های ویژگی (attribute selectors).
.TP
.BI \-b \ searchbase
تنظیم \fIsearchbase\fP (پایه جستجو).
.TP
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
مشخص کردن افزونه‌های عمومی با
.BR \-e .
علامت '\fB!\fP' نشان‌دهنده حیاتی (critical) بودن است.
.sp
افزونه‌های عمومی:
.nf
  [!]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 نمی‌ماند.
  در اصل کنترل نیستند)
.fi
.TP
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
تنظیم افزونه‌های URL؛ ناسازگار با
.BR \-H .
.TP
.BI \-f \ filter
تنظیم فیلتر URL. هیچ بررسی خاصی برای انطباق با فیلترهای LDAP طبق RFC 4515 انجام نمی‌شود، اما مقدار در صورت نیاز به شکل هگزادسیمال کدگذاری (hex-escaped) می‌شود.
.TP
.BI \-H \ ldapuri
مشخص کردن URI مورد نظر برای تفکیک اجزا (explode).
.TP
.BI \-h \ ldaphost
تنظیم میزبان.
.TP
.BI \-p \ ldapport
تنظیم درگاه TCP.
.TP
.BI \-S \ scheme
تنظیم طرح‌واره (scheme) مربوط به URL. مقادیر پیش‌فرض برای سایر فیلدها مانند \fIldapport\fP ممکن است به مقدار \fIscheme\fP وابسته باشد.
.TP
.BR \-s \ { base \||\| one \||\| sub \||\| children }
محدوده (scope) جستجو را مشخص می‌کند که می‌تواند یکی از مقادیر
.BR base ،
.BR one ،
.BR sub
یا
.B children
باشد تا جستجوی شیء پایه، یک‌سطحی، زیردرخت، یا فرزندان را مشخص نماید.
مقدار پیش‌فرض
.B sub
است.
نکته:
محدوده
.B children
نیازمند افزونه ویژگی‌های زیرمجموعه (subordinate) در LDAPv3 است.
.SH "قالب خروجی (OUTPUT FORMAT)"
اگر گزینه \fB\-H\fP استفاده شود، \fIldapuri\fP ارائه‌شده به اجزای سازنده‌اش تجزیه شده و به شکلی شبیه به LDIF در خروجی استاندارد چاپ می‌شود.
.LP
در غیر این صورت، نشانی URI ساخته‌شده با مقادیر ارسال‌شده توسط سایر گزینه‌ها در خروجی استاندارد چاپ می‌شود.
.SH "مثال‌ها (EXAMPLES)"
دستور زیر:
.LP
.nf
    ldapurl \-h ldap.example.com \-b dc=example,dc=com \-s sub \-f "(cn=Some One)"
.fi
.LP
خروجی زیر را بازمی‌گرداند:
.LP
.nf
    ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)
.fi
.LP
دستور:
.LP
.nf
    ldapurl \-H ldap://ldap.example.com:389/dc=example,dc=com??sub?(cn=Some%20One)
.fi
.LP
خروجی زیر را بازمی‌گرداند:
.LP
.nf
    scheme: ldap
    host: ldap.example.com
    port: 389
    dn: dc=example,dc=com
    scope: sub
    filter: (cn=Some One)
.fi
.SH "عیب‌یابی (DIAGNOSTICS)"
در صورت عدم بروز خطا، وضعیت خروج صفر است.
خطاها منجر به وضعیت خروج غیرصفر و نوشته شدن یک پیام تشخیصی در خروجی خطای استاندارد می‌شوند.
.SH "همچنین ببینید (SEE ALSO)"
.BR ldap (3)،
.BR ldap_url_parse (3)
.SH "نویسندگان (AUTHORS)"
پروژه اوپن‌ال‌دپ <http://www.openldap.org>
.SH "قدردانی (ACKNOWLEDGEMENTS)"
.\" Shared Project Acknowledgement Text
.B "OpenLDAP Software"
توسط پروژه اوپن‌ال‌دپ توسعه یافته و نگهداری می‌شود <http://www.openldap.org>.
.B "OpenLDAP Software"
از نسخه 3.3 LDAP دانشگاه میشیگان برگرفته شده است.