.TH "LDAPMODIFY" "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)" ldapmodify, ldapadd \- ابزارهای ویرایش، افزودن و اصلاح ورودیها در دایرکتوری LDAP .SH "خلاصه دستور (SYNOPSIS)" .B ldapmodify [\c .BR \-V [ V ]] [\c .BI \-d \ debuglevel\fR] [\c .BR \-n ] [\c .BR \-v ] [\c .BR \-a ] [\c .BR \-c ] [\c .BI \-f \ file\fR] [\c .BI \-j \ lineno\fR] [\c .BI \-S \ 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 ]] .LP .B ldapadd [\c .BR \-V [ V ]] [\c .BI \-d \ debuglevel\fR] [\c .BR \-n ] [\c .BR \-v ] [\c .BR \-c ] [\c .BI \-f \ file\fR] [\c .BI \-j \ lineno\fR] [\c .BI \-S \ 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 ]] .SH "توضیحات (DESCRIPTION)" .B ldapmodify یک رابط خط فرمانی برای فراخوانی‌های کتابخانه‌ای .BR ldap_add_ext (3)، .BR ldap_modify_ext (3)، .BR ldap_delete_ext (3) و .BR ldap_rename (3) است. .B ldapadd به‌عنوان یک پیوند سخت (hard link) به ابزار ldapmodify پیاده‌سازی شده است. هنگام فراخوانی به‌صورت .BR ldapadd ، فلگ \fB\-a\fP (افزودن ورودی جدید) به‌طور خودکار فعال می‌شود. .LP .B ldapmodify اتصالی به یک کارساز LDAP باز می‌کند، متصل می‌شود (bind انجام می‌دهد) و ورودی‌ها را تغییر می‌دهد یا اضافه می‌کند. اطلاعات ورودی با استفاده از گزینه .B \-f از ورودی استاندارد یا از \fIfile\fP خوانده می‌شود. .SH "گزینه‌ها (OPTIONS)" .TP .BR \-V [ V ] چاپ اطلاعات نسخه. اگر \fB\-VV\fP مشخص شود، تنها اطلاعات نسخه چاپ می‌شود. .TP .BI \-d \ debuglevel تنظیم سطح اشکال‌زدایی LDAP روی \fIdebuglevel\fP. برای اینکه این گزینه تأثیری داشته باشد، .B ldapmodify باید با تعریف LDAP_DEBUG کامپایل شده باشد. .TP .B \-n نمایش آنچه انجام خواهد شد، بدون تغییر واقعی ورودی‌ها. برای اشکال‌زدایی در ترکیب با .B \-v مفید است. .TP .B \-v اجرا در حالت پرگو (verbose)، همراه با نوشتن پیام‌های تشخیصی فراوان در خروجی استاندارد. .TP .B \-a افزودن ورودی‌های جدید. رفتار پیش‌فرض .B ldapmodify ویرایش ورودی‌های موجود است. در صورت فراخوانی به‌صورت .BR ldapadd ، این فلگ همیشه فعال است. .TP .B \-c حالت عملیات پیوسته. خطاها گزارش می‌شوند، اما .B ldapmodify به اعمال تغییرات ادامه خواهد داد. حالت پیش‌فرض، خروج از برنامه پس از گزارش خطا است. .TP .BI \-f \ file خواندن اطلاعات تغییر ورودی از \fIfile\fP به‌جای ورودی استاندارد. .TP .BI \-j \ lineno پرش به شماره سطر مشخص‌شده در فایل LDIF پیش از پردازش هر ورودی. این امکان را فراهم می‌کند که عملیات بارگذاری که به دلیل خطا در ورودی LDIF متوقف شده بود، پس از اصلاح خطاها ادامه یابد. .TP .BI \-S \ file رکوردهای افزودن یا تغییری که به دلیل بروز خطا رد شده‌اند در \fIfile\fP نوشته می‌شوند و پیام خطای بازگردانده شده توسط کارساز به‌صورت کامنت اضافه می‌شود. بیشترین کاربرد آن در ترکیب با .B \-c است. .TP .BR \-M [ M ] فعال‌سازی کنترل مدیریت DSA IT. گزینه .B \-MM این کنترل را حیاتی (critical) می‌کند. .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 و افزونه‌های ویرایش با \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 افزونه‌های ویرایش (Modify extensions): .nf [!]txn[=abort|commit] .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 (امنیت لایه انتقال). در صورت استفاده از .B \-ZZ\c ، این دستور مستلزم موفقیت‌آمیز بودن عملیات خواهد بود. .SH "قالب ورودی (INPUT FORMAT)" محتویات \fIfile\fP (یا ورودی استاندارد در صورتی که هیچ فلگ \fB\-f\fP در خط فرمان داده نشده باشد) باید با قالب تعریف‌شده در .BR ldif (5) (فرمت LDIF مطابق تعریف در RFC 2849) مطابقت داشته باشد. .SH "مثال‌ها (EXAMPLES)" با فرض اینکه فایل .B /tmp/entrymods وجود دارد و دارای محتویات زیر است: .LP .nf dn: cn=Modify Me,dc=example,dc=com changetype: modify replace: mail mail: modme@example.com \- add: title title: Grand Poobah \- add: jpegPhoto jpegPhoto:< file:///tmp/modme.jpeg \- delete: description \- .fi .LP دستور: .LP .nf ldapmodify \-f /tmp/entrymods .fi .LP محتوای ویژگی .I mail ورودی "Modify Me" را با مقدار "modme@example.com" جایگزین می‌کند، یک .I title با مقدار "Grand Poobah" اضافه می‌کند، محتویات فایل "/tmp/modme.jpeg" را به‌عنوان یک .IR jpegPhoto درج می‌نماید و ویژگی .I description را به‌طور کامل حذف می‌کند. .LP با فرض اینکه فایل .B /tmp/newentry وجود دارد و دارای محتویات زیر است: .LP .nf dn: cn=Barbara Jensen,dc=example,dc=com objectClass: person cn: Barbara Jensen cn: Babs Jensen sn: Jensen title: the world's most famous mythical manager mail: bjensen@example.com uid: bjensen .fi .LP دستور: .LP .nf ldapadd \-f /tmp/newentry .fi .LP یک ورودی جدید برای Babs Jensen با استفاده از مقادیر فایل .B /tmp/newentry اضافه خواهد کرد. .LP با فرض اینکه فایل .B /tmp/entrymods وجود دارد و دارای محتویات زیر است: .LP .nf dn: cn=Barbara Jensen,dc=example,dc=com changetype: delete .fi .LP دستور: .LP .nf ldapmodify \-f /tmp/entrymods .fi .LP ورودی Babs Jensen را حذف خواهد کرد. .SH "عیب‌یابی (DIAGNOSTICS)" در صورت عدم وقوع خطا، وضعیت خروج صفر است. خطاها منجر به وضعیت خروج غیرصفر و نوشته شدن یک پیام تشخیصی در خطای استاندارد می‌شوند. .SH "همچنین ببینید (SEE ALSO)" .BR ldapadd (1)، .BR ldapdelete (1)، .BR ldapmodrdn (1)، .BR ldapsearch (1)، .BR ldap.conf (5)، .BR ldap (3)، .BR ldap_add_ext (3)، .BR ldap_delete_ext (3)، .BR ldap_modify_ext (3)، .BR ldap_modrdn_ext (3)، .BR ldif (5). .SH "نویسندگان (AUTHORS)" پروژه اوپن‌ال‌دپ .SH "قدردانی (ACKNOWLEDGEMENTS)" .\" Shared Project Acknowledgement Text .B "OpenLDAP Software" توسط پروژه اوپن‌ال‌دپ توسعه یافته و نگهداری می‌شود . .B "OpenLDAP Software" از نسخه 3.3 LDAP دانشگاه میشیگان برگرفته شده است.