.TH LDAPMODRDN 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)" ldapmodrdn \- ابزار تغییر نام یا انتقال ورودی در دایرکتوری LDAP .SH "خلاصه دستور (SYNOPSIS)" .B ldapmodrdn [\c .BR \-V [ V ]] [\c .BI \-d \ debuglevel\fR] [\c .BR \-n ] [\c .BR \-v ] [\c .BR \-r ] [\c .BI \-s \ newsup\fR] [\c .BR \-c ] [\c .BI \-f \ file\fR] [\c .BR \-M [ M ]] [\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 \-P \ { 2 \||\| 3 }] [\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 ]] [\c .I dn rdn\fR] .SH "توضیحات (DESCRIPTION)" .B ldapmodrdn یک رابط کاربری در پوسته برای فراخوانی کتابخانه‌ای .BR ldap_rename (3) است. .LP .B ldapmodrdn اتصالی به کارساز LDAP باز می‌کند، متصل می‌شود (bind انجام می‌دهد) و RDN ورودی‌ها را تغییر می‌دهد. اطلاعات ورودی از ورودی استاندارد، از طریق \fIfile\fP با استفاده از گزینه .RI \- f یا از جفت آرگومان خط فرمان \fIdn\fP و \fIrdn\fP خوانده می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .BR \-V [ V ] چاپ اطلاعات نسخه. اگر \fB\-VV\fP داده شود، تنها اطلاعات نسخه چاپ می‌شود. .TP .BI \-d \ debuglevel تنظیم سطح اشکال‌زدایی LDAP روی \fIdebuglevel\fP. برای اینکه این گزینه تأثیری داشته باشد، .B ldapmodrdn باید با تعریف LDAP_DEBUG کامپایل شده باشد. .TP .B \-n نمایش آنچه انجام خواهد شد، بدون تغییر دادن واقعی ورودی‌ها. برای اشکال‌زدایی در ترکیب با .B \-v مفید است. .TP .B \-v استفاده از حالت پرگو (verbose)، همراه با نوشتن پیام‌های تشخیصی فراوان در خروجی استاندارد. .TP .B \-r حذف مقادیر قبلی RDN از ورودی. حالت پیش‌فرض، نگه‌داشتن مقادیر قبلی است. .TP .BI \-s \ newsup مشخص کردن یک ورودی مافوق (superior) جدید. (یعنی، انتقال ورودی هدف و تبدیل آن به فرزند ورودی مافوق جدید.) این گزینه در LDAPv2 پشتیبانی نمی‌شود. .TP .B \-c حالت عملیات مداوم. خطاها گزارش می‌شوند، اما .B ldapmodrdn به اعمال تغییرات ادامه خواهد داد. حالت پیش‌فرض خروج پس از گزارش یک خطاست. .TP .BI \-f \ file خواندن اطلاعات تغییر ورودی از \fIfile\fP به‌جای ورودی استاندارد یا خط فرمان. .TP .BR \-M [ M ] فعال‌سازی کنترل مدیریت DSA IT. گزینه .B \-MM کنترل را حیاتی می‌کند. .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 \-P \ { 2 \||\| 3 } مشخص کردن نسخه پروتکل LDAP مورد استفاده. .TP .BR \-e \ [ ! ] \fIext\fP [ =\fIextparam\fP ] .TP .BR \-E \ [ ! ] \fIext\fP [ =\fIextparam\fP ] مشخص کردن افزونه‌های عمومی با \fB\-e\fP و افزونه‌های modrdn با \fB\-E\fP. علامت \'\fB!\fP\' نشان‌دهنده حیاتی بودن (criticality) است. افزونه‌های عمومی: .nf [!]assert= (یک فیلتر RFC 4515) !authzid= ("dn:" یا "u:") [!]bauthzid (کنترل authzid طبق RFC 3829) [!]chaining[=[/]] [!]manageDSAit [!]noop ppolicy [!]postread[=] (فهرست ویژگی‌های جداشده با کاما) [!]preread[=] (فهرست ویژگی‌های جداشده با کاما) [!]relax sessiontracking[=] abandon,cancel,ignore (سیگنال SIGINT عملیات abandon/cancel می‌فرستد، یا پاسخ را نادیده می‌گیرد؛ اگر حیاتی باشد، منتظر SIGINT نمی‌ماند. در اصل کنترل نیستند) .fi افزونه‌های Modrdn: .nf (هیچ) .fi .TP .BI \-o \ opt \fR[= optparam \fR] مشخص کردن هر گزینه‌ای از .BR ldap.conf (5) یا یکی از موارد زیر: .nf nettimeout= (به ثانیه، یا "none" یا "max") ldif_wrap= (بر حسب ستون، یا "no" برای عدم شکست خط) .fi .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: "" یا .BI u: .TP .BI \-Y \ mech مشخص کردن سازوکار SASL مورد استفاده برای احراز هویت. در صورت مشخص نشدن، برنامه بهترین سازوکاری را که کارساز می‌شناسد انتخاب خواهد کرد. .TP .BR \-Z [ Z ] ارسال عملیات گسترده StartTLS (امنیت لایه انتقال). در صورت استفاده از \fB\-ZZ\fP، این دستور مستلزم موفقیت‌آمیز بودن عملیات خواهد بود. .SH "قالب ورودی (INPUT FORMAT)" اگر آرگومان‌های خط فرمان \fIdn\fP و \fIrdn\fP داده شوند، \fIrdn\fP جایگزین RDN ورودی مشخص‌شده با DN یعنی \fIdn\fP خواهد شد. .LP در غیر این صورت، محتویات \fIfile\fP (یا ورودی استاندارد در صورتی که پرچم \fB\-f\fP داده نشده باشد) باید شامل یک یا چند ورودی باشد. .LP .nf Distinguished Name (DN) Relative Distinguished Name (RDN) .fi .LP می‌توان از یک یا چند خط خالی برای جداسازی هر جفت DN/RDN استفاده کرد. .SH "مثال (EXAMPLE)" با فرض اینکه فایل .B /tmp/entrymods وجود داشته و دارای محتوای زیر باشد: .LP .nf cn=Modify Me,dc=example,dc=com cn=The New Me .fi .LP دستور: .LP .nf ldapmodrdn \-r \-f /tmp/entrymods .fi .LP مقدار RDN ورودی "Modify Me" را از "Modify Me" به "The New Me" تغییر داده و مقدار قدیمی cn یعنی "Modify Me" حذف خواهد شد. .LP .SH "پیام‌های تشخیصی (DIAGNOSTICS)" در صورتی که هیچ خطایی رخ ندهد وضعیت خروج 0 خواهد بود. بروز خطاها موجب برگرداندن وضعیت خروج غیر صفر و نوشته شدن پیام تشخیصی در خروجی خطای استاندارد می‌شود. .SH "همچنین ببینید (SEE ALSO)" .BR ldapadd (1)، .BR ldapdelete (1)، .BR ldapmodify (1)، .BR ldapsearch (1)، .BR ldap.conf (5)، .BR ldap (3)، .BR ldap_rename (3) .SH "نویسنده (AUTHOR)" پروژه اوپن‌ال‌دپ .SH "قدردانی (ACKNOWLEDGEMENTS)" .B "OpenLDAP Software" توسط پروژه اوپن‌ال‌دپ توسعه یافته و نگهداری می‌شود . .B "OpenLDAP Software" از انتشار 3.3 نرم‌افزار LDAP دانشگاه میشیگان برگرفته شده است.