.TH LDAPWHOAMI 1 "2026-03-09" "OpenLDAP 2.6.13" "دستورات کاربر"
.\" $OpenLDAP$
.\" Copyright 1998-2026 The OpenLDAP Foundation All Rights Reserved.
.\" Copying restrictions apply.  See COPYRIGHT/LICENSE.
.SH "نام (NAME)"
ldapwhoami \- ابزار who am i در LDAP
.SH "خلاصه دستور (SYNOPSIS)"
.B ldapwhoami
[\c
.BR \-V [ V ]]
[\c
.BI \-d \ debuglevel\fR]
[\c
.BR \-n ]
[\c
.BR \-v ]
[\c
.BR \-x ]
[\c
.BI \-D \ binddn\fR]
[\c
.BR \-W ]
[\c
.BI \-w \ passwd\fR]
[\c
.BI \-y \ passwdfile\fR]
[\c
.BI \-H \ ldapuri\fR]
[\c
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]]
[\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 ]]
.SH "توضیحات (DESCRIPTION)"
.I ldapwhoami
عملیات گسترده LDAP تحت عنوان «من کی هستم؟» ("Who Am I?") را پیاده‌سازی می‌کند.
.LP
.B ldapwhoami
اتصالی به یک کارساز LDAP باز می‌کند، متصل می‌شود (bind انجام می‌دهد) و عملیات whoami را اجرا می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.BR \-V [ V ]
چاپ اطلاعات نسخه.
اگر \fB\-VV\fP داده شود، تنها اطلاعات نسخه چاپ می‌شود.
.TP
.BI \-d \ debuglevel
تنظیم سطح اشکال‌زدایی LDAP روی \fIdebuglevel\fP.
برای اینکه این گزینه تأثیری داشته باشد،
.B ldapwhoami
باید با تعریف LDAP_DEBUG کامپایل شده باشد.
.TP
.B \-n
نمایش آنچه انجام خواهد شد، بدون اجرای واقعی عملیات whoami.
برای اشکال‌زدایی در ترکیب با \fB\-v\fP مفید است.
.TP
.B \-v
اجرا در حالت پرگو (verbose)، با نوشتن پیام‌های تشخیصی فراوان در خروجی استاندارد.
.TP
.B \-x
استفاده از احراز هویت ساده به‌جای SASL.
.TP
.BI \-D \ binddn
استفاده از نام متمایز \fIbinddn\fP برای اتصال به شاخه راهنمای LDAP.
برای اتصال‌های SASL، انتظار می‌رود کارساز این مقدار را نادیده بگیرد.
.TP
.B \-W
درخواست اعلان گذرواژه برای احراز هویت ساده.
این گزینه به‌جای مشخص کردن گذرواژه در خط فرمان استفاده می‌شود.
.TP
.BI \-w \ passwd
استفاده از \fIpasswd\fP به‌عنوان گذرواژه برای احراز هویت ساده.
.TP
.BI \-y \ passwdfile
استفاده از محتویات کامل \fIpasswdfile\fP به‌عنوان گذرواژه برای احراز هویت ساده.
.TP
.BI \-H \ ldapuri
مشخص کردن URI(های) ارجاع‌دهنده به کارساز(های) LDAP؛ تنها فیلدهای پروتکل/میزبان/درگاه مجاز هستند؛ فهرستی از URI که با فاصله یا کاما از یکدیگر جدا شده‌اند مورد انتظار است.
.TP
.BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ]
.TP
.BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ]

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

افزونه‌های عمومی:
.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

افزونه‌های WhoAmI:
.nf
  (none)
.fi
.TP
.BI \-o \ opt \fR[= optparam \fR]

مشخص کردن هر گزینه‌ای از
.BR ldap.conf (5)
یا یکی از موارد زیر:
.nf
  nettimeout=<timeout>  (به ثانیه، یا "none" یا "max")
  ldif_wrap=<width>     (بر حسب ستون، یا "no" برای عدم شکست خط)
.fi

برای جزئیات گزینه‌هایی که می‌توان با
.B -o
پاس داد،
.BR ldap.conf (5)
را بررسی کنید.
.TP
.BI \-O \ security-properties
مشخص کردن ویژگی‌های امنیتی SASL.
.TP
.B \-I
فعال‌سازی حالت تعاملی SASL. همیشه اعلان ورودی می‌دهد. حالت پیش‌فرض اعلان ورودی تنها در صورت نیاز است.
.TP
.B \-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 (امنیت لایه انتقال). در صورت استفاده از
\fB\-ZZ\fP، این دستور مستلزم موفقیت‌آمیز بودن عملیات خواهد بود.
.SH "مثال (EXAMPLE)"
.nf
    ldapwhoami \-x \-D "cn=Manager,dc=example,dc=com" \-W
.fi
.SH "همچنین ببینید (SEE ALSO)"
.BR ldap.conf (5)،
.BR ldap (3)،
.BR ldap_extended_operation (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 دانشگاه میشیگان برگرفته شده است.