'\" -*- coding: utf-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH getent.ldap 1 "Feb 2025" "Version 0.9.13" "User Commands"
.SH "نام (NAME)"
getent.ldap \- پرس‌وجوی اطلاعات از LDAP
.SH "خلاصه دستور (SYNOPSIS)"
'nh
.fi
.ad l
\*(T<\fBgetent.ldap\fR\*(T> \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fIoptions\fR] [\fIDATABASE\fR] [\fIKEY...\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH "توضیحات (DESCRIPTION)"
دستور \fBgetent.ldap\fR می‌تواند برای جستجو یا برشمردن اطلاعات از LDAP استفاده شود.
برخلاف دستور
\fBgetent\fR(1)،
این دستور جستجوهای پیکربندی‌شده در
\*(T<\fI/etc/nsswitch.conf\fR\*(T>
را کاملاً نادیده می‌گیرد و مستقیماً از دیمن
\fBnslcd\fR(8)
پرس‌وجو می‌کند.
.PP
دستور \fBgetent.ldap\fR تلاش می‌کند تا حد امکان با رفتار و خروجی
\fBgetent\fR
و قالب فایل‌های مسطح مربوطه مطابقت داشته باشد، هرچند چندین تفاوت وجود دارد.
اگر چندین مدخل منطبق با یک پرس‌وجوی خاص در LDAP یافت شود، چندین مقدار چاپ می‌شوند (برای مثال آدرس‌های اترنت که چندین نام دارند، سرویس‌هایی که از چندین پروتکل پشتیبانی می‌کنند، و غیره).
همچنین، برخی از پایگاه‌های داده دارای گزینه‌های اضافی هستند که در ادامه شرح داده شده‌اند.
.SH "گزینه‌ها (OPTIONS)"
گزینه‌هایی که می‌توان برای دستور \fBgetent.ldap\fR مشخص کرد عبارتند از:
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T> 
نمایش راهنمای کوتاه و خروج.
.TP 
\*(T<\fB\-V, \-\-version\fR\*(T> 
نمایش اطلاعات نسخه و خروج.
.SH "پایگاه‌های داده (DATABASES)"
آرگومان \fIDATABASE\fR می‌تواند هر یک از پایگاه‌های داده پشتیبانی‌شده زیر باشد:
.TP 
\*(T<\fBaliases\fR\*(T>
نام‌های مستعار ایمیل را فهرست یا پرس‌وجو می‌کند.
اگر \fIKEY\fR مشخص شده باشد، نام مستعار را بر اساس نام جستجو می‌کند، در غیر این صورت تمام نام‌های مستعار را از LDAP بازمی‌گرداند.
.TP 
\*(T<\fBethers\fR\*(T>
آدرس‌های اترنت را فهرست یا پرس‌وجو می‌کند.
اگر \fIKEY\fR با قالب یک آدرس اترنت مطابقت داشته باشد، جستجو بر اساس آدرس انجام می‌شود، در غیر این صورت جستجو بر اساس نام صورت می‌گیرد و یا در صورت عدم ذکر \fIKEY\fR، تمام مدخل‌ها بازگردانده می‌شوند.
برخلاف \fBgetent\fR، دستور \fBgetent.ldapd\fR از شمارش تمام آدرس‌های اترنت پشتیبانی می‌کند.
.TP 
\*(T<\fBgroup\fR\*(T>
گروه‌ها را فهرست یا پرس‌وجو می‌کند.
اگر \fIKEY\fR عددی باشد، گروه را بر اساس شناسه گروه (group id) جستجو می‌کند.
.TP 
\*(T<\fBgroup.bymember\fR\*(T>
مقدار \fIKEY\fR یک نام کاربری است و گروه‌هایی که این کاربر عضو آن‌ها است بازگردانده می‌شوند.
قالب آن مشابه خروجی \*(T<\fBgroup\fR\*(T> است، اما به دلایل عملکرد و کارایی، اعضای گروه حذف شده‌اند.
.TP 
\*(T<\fBhosts\fR\*(T>
نام‌ها و آدرس‌های میزبان را بر اساس نام میزبان، آدرس IPv4 یا IPv6 فهرست یا جستجو می‌کند. این مورد هر دو آدرس IPv4 و IPv6 را (در صورت در دسترس بودن) بازمی‌گرداند.
.TP 
\*(T<\fBhostsv4\fR\*(T>
مشابه \*(T<\fBhosts\fR\*(T> است، اما هر آدرس IPv6 ارائه‌شده به عنوان نام میزبان در نظر گرفته می‌شود و تنها آدرس‌های IPv4 بازگردانده می‌شوند.
.TP 
\*(T<\fBhostsv6\fR\*(T>
مشابه \*(T<\fBhosts\fR\*(T> است، اما \fIKEY\fR به عنوان یک آدرس IPv6 یا یک نام میزبان در نظر گرفته شده و تنها آدرس‌های IPv6 بازگردانده می‌شوند.
.TP 
\*(T<\fBnetgroup\fR\*(T>
نت‌گروه‌ها و سه‌گانه‌های نت‌گروه (میزبان، کاربر، دامنه) که عضو نت‌گروه هستند را فهرست یا پرس‌وجو می‌کند.
برخلاف \fBgetent\fR، دستور \fBgetent.ldapd\fR از شمارش تمام آدرس‌های اترنت پشتیبانی می‌کند.
.TP 
\*(T<\fBnetgroup.norec\fR\*(T>
مشابه \*(T<\fBnetgroup\fR\*(T> است، با این تفاوت که هیچ جستجوی بعدی برای باز کردن و گسترش نت‌گروه‌هایی که عضو نت‌گروه ارائه‌شده هستند انجام نمی‌شود، و خروجی ممکن است شامل نام سایر نت‌گروه‌ها و نیز سه‌گانه‌های نت‌گروه باشد.
.TP 
\*(T<\fBnetworks\fR\*(T>
نام‌ها و آدرس‌های شبکه را فهرست یا پرس‌وجو می‌کند.
\fIKEY\fR می‌تواند یک نام یا آدرس شبکه باشد.
این نگاشت می‌تواند هر دو آدرس شبکه IPv4 و IPv6 را بازگرداند.
.TP 
\*(T<\fBnetworksv4\fR\*(T>
تنها آدرس‌های شبکه IPv4 را بازمی‌گرداند.
.TP 
\*(T<\fBnetworksv6\fR\*(T>
تنها آدرس‌های شبکه IPv6 را بازمی‌گرداند.
.TP 
\*(T<\fBpasswd\fR\*(T>
پایگاه داده حساب‌های کاربری را برمی‌شمارد یا جستجو می‌کند.
\fIKEY\fR می‌تواند یک نام کاربری یا شناسه عددی کاربر باشد، یا برای فهرست کردن تمام کاربران مشخص نشود.
.TP 
\*(T<\fBprotocols\fR\*(T>
پایگاه داده پروتکل‌های اینترنت را برمی‌شمارد.
.TP 
\*(T<\fBrpc\fR\*(T>
نام‌های خوانا برای انسان را که به شماره برنامه‌های RPC نگاشت می‌شوند فهرست یا جستجو می‌کند.
جستجو با \fIKEY\fR می‌تواند بر اساس نام یا شماره برنامه rpc انجام گیرد.
.TP 
\*(T<\fBservices\fR\*(T>
نگاشت بین نام‌های سرویس‌های اینترنتی و شماره پورت و نوع پروتکل متناظر آن‌ها را فهرست یا جستجو می‌کند.
\fIKEY\fR می‌تواند نام یا شماره سرویس باشد، که می‌تواند با یک اسلش اختیاری و نام پروتکل همراه شود تا جستجو تنها به مدخل‌های پروتکل مشخص‌شده محدود شود.
.TP 
\*(T<\fBshadow\fR\*(T>
اطلاعات پیشرفته حساب‌های کاربری را برمی‌شمارد یا جستجو می‌کند.
توجه داشته باشید که اطلاعات shadow احتمالاً فقط برای کاربر ریشه (root) قابل مشاهده است و به طور پیش‌فرض \fBnslcd\fR حتی برای root نیز درهم‌سازهای رمز عبور (password hashes) را افشا نمی‌کند.
.SH "همچنین ببینید (SEE ALSO)"
\fBgetent\fR(1),
\fBnslcd\fR(8)
.SH "نویسندگان (AUTHORS)"
این راهنما توسط Arthur de Jong <arthur@arthurdejong.org> نوشته شده است.
.SH "گزارش باگ‌ها (BUGS)"
در حال حاضر، \fBgetent.ldapd\fR کد وضعیت خروج را به درستی تنظیم نمی‌کند. این دستور باید همان کدهای خروجی را که \fBgetent\fR بازمی‌گرداند برگرداند (مثلاً برای مدخل‌های ناموجود).