.\" $OpenLDAP$
.\" This contribution is derived from OpenLDAP Software.
.\" All of the modifications to OpenLDAP Software represented in this
.\" contribution were developed by Peter Marschall <peter@adpm.de>.
.\" I have not assigned rights and/or interest in this work to any party.
.\"
.\" Copyright 2009 Peter Marschall
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted only as authorized by the OpenLDAP Public License.
.\"
.\" A copy of this license is available in file LICENSE in the
.\" top-level directory of the distribution or, alternatively, at
.\" http://www.OpenLDAP.org/license.html.

.TH LDAPEXOP 1

.SH "نام (NAME)"
ldapexop \- اجرای عملیات گسترشیافته پروتکل LDAP

.SH "خلاصه دستور (SYNOPSIS)"
.B ldapexop
[\c
.BR \-V [ V ]]
[\c
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
[\c
.BI \-f \ file\fR]
[\c
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
.BR \-W ]
[\c
.BI \-w \ passwd\fR]
[\c
.BI \-y \ passwdfile\fR]
[\c
.BI \-H \ URI\fR]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\c
.BI \-o \ opt \fR[= optparam \fR]]
[\c
.BI \-O \ security-properties\fR]
[\c
.BR \-I ]
[\c
.BR \-Q ]
[\c
.BR \-N ]
[\c
.BI \-U \ authcid\fR]
[\c
.BI \-R \ realm\fR]
[\c
.BI \-X \ authzid\fR]
[\c
.BI \-Y \ mech\fR]
[\c
.BR \-Z [ Z ]]
{\c
.I oid
|
.BI oid: data
|
.BI oid:: b64data
|
.B whoami
|
.BI cancel \ cancel-id
|
.BI refresh \ DN \ \fR[\fIttl\fR]}

.SH "توضیحات (DESCRIPTION)"
دستور
.B ldapexop
عملیات گسترش‌یافته LDAP مشخص‌شده توسط
.I oid
یا یکی از کلمات کلیدی ویژه
.BR whoami ،
.B cancel
یا
.B refresh
را صادر و اجرا می‌کند.
.PP
داده‌های اضافی برای عملیات گسترش‌یافته را می‌توان با استفاده از
.I data
یا به‌صورت کدگذاری base-64 با
.I b64data
(در صورت استفاده از
.BR oid )
یا با استفاده از پارامترهای اضافی (در مورد عملیات‌های گسترش‌یافته نام‌گذاری‌شده در بالا) به سرور ارسال کرد.
.PP
لطفاً توجه داشته باشید که رفتار
.B ldapexop
برای یک عملیات گسترش‌یافته یکسان، در صورتی که به‌صورت یک OID مشخص شود با زمانی که به‌صورت یک عملیات با نام ویژه مشخص گردد، متفاوت خواهد بود:
.PP
فراخوانی
.B ldapexop
با شناسه OID مربوط به عملیات گسترش‌یافته
.B whoami
(RFC 4532):
.nf

  ldapexop [<options>] 1.3.6.1.4.1.4203.1.11.3

.fi
خروجی زیر را به همراه دارد:
.nf

  # extended operation response
  data:: <base64 encoded response data>

.fi
در حالی که فراخوانی آن با کلمه کلیدی
.B whoami
.nf

  ldapexop [<options>] whoami

.fi
منجر به نتیجه زیر می‌شود:
.nf

  dn:<client's identity>

.fi

.SH "گزینه‌ها (OPTIONS)"
.TP
.BI \-V [ V ]
چاپ اطلاعات نسخه.
اگر
.B \-VV
داده شود، تنها اطلاعات نسخه چاپ می‌شود.
.TP
.BI \-d \ debuglevel
تنظیم سطح اشکال‌زدایی LDAP بر روی
.IR debuglevel .
.TP
.BI \-n
نمایش کارهایی که باید انجام شود، بدون اجرای واقعی آن‌ها.
این گزینه در ترکیب با
.B \-v
برای اشکال‌زدایی مفید است.
.TP
.BI \-v
اجرا در حالت پرگو (verbose)، همراه با نوشتن پیام‌های تشخیصی بسیار در خروجی استاندارد.
.TP
.BI \-f \ file
خواندن عملیات‌ها از
.IR file .
.TP
.BI \-x
استفاده از احراز هویت ساده به‌جای SASL.
.TP
.BI \-D \ binddn
استفاده از نام متمایز (Distinguished Name)
.I binddn
برای اتصال (bind) به دایرکتوری LDAP.
.TP
.BI \-W
درخواست گذرواژه برای احراز هویت ساده.
این گزینه به جای تعیین گذرواژه در خط فرمان استفاده می‌شود.
.TP
.BI \-w \ passwd
استفاده از
.I passwd
به عنوان گذرواژه برای احراز هویت ساده.
.TP
.BI \-y \ passwdfile
استفاده از کل محتوای
.I passwdfile
به عنوان گذرواژه برای احراز هویت ساده.
.TP
.BI \-H \ URI
مشخص کردن URIهای اشاره‌کننده به سرور(های) ldap؛ تنها فیلدهای پروتکل/میزبان/پورت مجاز هستند؛ فهرستی از URIها که با فاصله یا کاما از هم جدا شده‌اند مورد انتظار است.
.TP
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
مشخص کردن افزونه‌های عمومی. علامت \'!\' نشان‌دهنده حیاتی بودن (criticality) است.
.nf
  [!]assert=<filter>    (an RFC 4515 Filter)
  !authzid=<authzid>    ("dn:<dn>" or "u:<user>")
  [!]bauthzid           (RFC 3829 authzid control)
  [!]chaining[=<resolve>[/<cont>]]
  [!]manageDSAit
  [!]noop
  ppolicy
  [!]postread[=<attrs>] (a comma-separated attribute list)
  [!]preread[=<attrs>]  (a comma-separated attribute list)
  [!]relax
  sessiontracking[=<username>]
  abandon,cancel,ignore (SIGINT sends abandon/cancel,
  or ignores response; if critical, doesn't wait for SIGINT.
  not really controls)
.fi
.TP
.BI \-o \ opt \fR[= optparam \fR]
مشخص کردن هر یک از گزینه‌های
.BR ldap.conf (5)
یا یکی از موارد زیر:
.nf
  nettimeout=<timeout>  (in seconds, or "none" or "max")
  ldif_wrap=<width>     (in columns, or "no" for no wrapping)
.fi
.TP
.BI \-O \ security-properties
مشخص کردن مشخصه‌های امنیتی SASL.
.TP
.BI \-I
فعال‌سازی حالت تعاملی SASL. همیشه درخواست گذرواژه شود. حالت پیش‌فرض این است که فقط در صورت نیاز درخواست شود.
.TP
.BI \-Q
فعال‌سازی حالت ساکت SASL. هرگز درخواست گذرواژه نشود.
.TP
.B \-N
عدم استفاده از DNS معکوس برای استانداردسازی نام میزبان SASL.
.TP
.BI \-U \ authcid
مشخص کردن شناسه احراز هویت برای اتصال SASL. قالب شناسه به سازوکار واقعی SASL مورد استفاده بستگی دارد.
.TP
.BI \-R \ realm
مشخص کردن قلمرو (realm) شناسه احراز هویت برای اتصال SASL. قالب قلمرو به سازوکار واقعی SASL مورد استفاده بستگی دارد.
.TP
.BI \-X \ authzid
مشخص کردن شناسه مجوز درخواستی برای اتصال SASL.
.I authzid
باید یکی از قالب‌های زیر باشد:
.BI dn: "<distinguished name>"
یا
.BI u: <username>
.TP
.BI \-Y \ mech
مشخص کردن سازوکار SASL مورد استفاده برای احراز هویت.
بدون این گزینه، برنامه بهترین سازوکاری را که سرور می‌شناسد انتخاب می‌کند.
.TP
.BR \-Z [ Z ]
صدور عملیات گسترش‌یافته StartTLS (امنیت لایه انتقال).
ارائه دو بار آن
.RB ( \-ZZ )
مستلزم موفقیت‌آمیز بودن اجباری عملیات خواهد بود.

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

.SH "همچنین ببینید (SEE ALSO)"
.BR ldap_extended_operation_s (3)

.SH "نویسنده (AUTHOR)"
این صفحه راهنما توسط Peter Marschall بر اساس پیام راهنمای کاربرد
.B ldapexop
و چند آزمایش با
.B ldapexop
نوشته شده است.
انتظار نداشته باشید که کامل یا کاملاً درست باشد.

.SH "سپاسگزاری (ACKNOWLEDGEMENTS)"
.B "نرم‌افزار OpenLDAP"
توسط پروژه OpenLDAP در <http://www.openldap.org> توسعه یافته و نگهداری می‌شود.
.B "نرم‌افزار OpenLDAP"
از انتشار دانشگاه میشیگان LDAP 3.3 مشتق شده است.