.\" Copyright 2011, Mark R. Bannister .\" Copyright, the authors of the Linux man-pages project .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .TH getent 1 2026-02-08 "Linux man-pages 6.19" .SH "نام (NAME)" getent \- دریافت مدخل‌ها از کتابخانه‌های سوئیچ سرویس نام (Name Service Switch) .SH "خلاصه دستور (SYNOPSIS)" .SY getent .RI [ option \~.\|.\|.\&] .I database .IR key \~.\|.\|. .YS .SH "توضیحات (DESCRIPTION)" دستور .B getent مدخل‌های پایگاه‌های داده تحت پشتیبانی کتابخانه‌های سوئیچ سرویس نام (Name Service Switch) را نمایش می‌دهد، که در .IR /etc/nsswitch.conf پیکربندی می‌شوند. اگر یک یا چند آرگومان .I key ارائه شود، تنها مدخل‌هایی که با کلیدهای ارائه‌شده مطابقت دارند نمایش داده می‌شوند. در غیر این صورت، چنانچه هیچ .I key مشخص نشده باشد، تمام مدخل‌ها نمایش داده خواهند شد (مگر اینکه پایگاه داده از شمارش .RI ( enumeration ) پشتیبانی نکند). .P .I database می‌تواند هر یک از مواردی باشد که توسط کتابخانه C گنو پشتیبانی می‌شوند و در زیر فهرست شده‌اند: .TP .B ahosts هنگامی که هیچ .I key مشخص نشده باشد، از .BR sethostent (3)، .BR gethostent (3) و .BR endhostent (3) برای شمارش پایگاه داده hosts استفاده می‌کند. این رفتار مشابه استفاده از .BR hosts (5) است. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت با خانواده نشانی .B AF_UNSPEC به .BR getaddrinfo (3) ارسال کرده و تک‌تک ساختارهای نشانی سوکت بازگردانده‌شده را برمی‌شمرد. .TP .B ahostsv4 مشابه .BR ahosts ، اما از خانواده نشانی .B AF_INET استفاده می‌کند. .TP .B ahostsv6 مشابه .BR ahosts ، اما از خانواده نشانی .B AF_INET6 استفاده می‌کند. فراخوانی .BR getaddrinfo (3) در این حالت شامل پرچم .B AI_V4MAPPED نیز می‌شود. .TP .B aliases هنگامی که هیچ .I key مشخص نشده باشد، از .BR setaliasent (3)، .BR getaliasent (3) و .BR endaliasent (3) برای شمارش پایگاه داده aliases استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت به .BR getaliasbyname (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B ethers هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت به .BR ether_aton (3) و .BR ether_hostton (3) ارسال می‌کند تا نتیجه‌ای حاصل شود، سپس نتیجه را نمایش می‌دهد. شمارش روی .B ethers پشتیبانی نمی‌شود، بنابراین باید یک .I key ارائه شود. .TP .B group هنگامی که هیچ .I key مشخص نشده باشد، از .BR setgrent (3)، .BR getgrent (3) و .BR endgrent (3) برای شمارش پایگاه داده group استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getgrgid (3) و هر .I key غیرعددی را به .BR getgrnam (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B gshadow هنگامی که هیچ .I key مشخص نشده باشد، از .BR setsgent (3)، .BR getsgent (3) و .BR endsgent (3) برای شمارش پایگاه داده gshadow استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت به .BR getsgnam (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B hosts هنگامی که هیچ .I key مشخص نشده باشد، از .BR sethostent (3)، .BR gethostent (3) و .BR endhostent (3) برای شمارش پایگاه داده hosts استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، بسته به اینکه آیا فراخوانی .BR inet_pton (3) مشخص کند که .I key یک نشانی IPv4 یا IPv6 است یا نه، هر .I key را به .BR gethostbyaddr (3) یا .BR gethostbyname2 (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B initgroups هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت به .BR getgrouplist (3) ارسال کرده و نتیجه را نمایش می‌دهد. شمارش روی .B initgroups پشتیبانی نمی‌شود، بنابراین باید یک .I key ارائه شود. .TP .B netgroup هنگامی که یک .I key ارائه شود، .I key را به .BR setnetgrent (3) می‌فرستد و با استفاده از .BR getnetgrent (3) سه‌تایی رشته‌ای حاصل یعنی .RI ( hostname ", " username ", " domainname ) را نمایش می‌دهد. در حالت دیگر می‌توان سه .I key ارائه داد که به عنوان .IR hostname ، .I username و .I domainname تفسیر می‌شوند تا از طریق .BR innetgr (3) با یک نام netgroup مطابقت داده شوند. شمارش روی .B netgroup پشتیبانی نمی‌شود، بنابراین باید یا یک یا سه .I key ارائه شود. .TP .B networks هنگامی که هیچ .I key مشخص نشده باشد، از .BR setnetent (3)، .BR getnetent (3) و .BR endnetent (3) برای شمارش پایگاه داده networks استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getnetbyaddr (3) و هر .I key غیرعددی را به .BR getnetbyname (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B passwd هنگامی که هیچ .I key مشخص نشده باشد، از .BR setpwent (3)، .BR getpwent (3) و .BR endpwent (3) برای شمارش پایگاه داده passwd استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getpwuid (3) و هر .I key غیرعددی را به .BR getpwnam (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B protocols هنگامی که هیچ .I key مشخص نشده باشد، از .BR setprotoent (3)، .BR getprotoent (3) و .BR endprotoent (3) برای شمارش پایگاه داده protocols استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getprotobynumber (3) و هر .I key غیرعددی را به .BR getprotobyname (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B rpc هنگامی که هیچ .I key مشخص نشده باشد، از .BR setrpcent (3)، .BR getrpcent (3) و .BR endrpcent (3) برای شمارش پایگاه داده rpc استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getrpcbynumber (3) و هر .I key غیرعددی را به .BR getrpcbyname (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B services هنگامی که هیچ .I key مشخص نشده باشد، از .BR setservent (3)، .BR getservent (3) و .BR endservent (3) برای شمارش پایگاه داده services استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key عددی را به .BR getservbynumber (3) و هر .I key غیرعددی را به .BR getservbyname (3) ارسال کرده و نتیجه را نمایش می‌دهد. .TP .B shadow هنگامی که هیچ .I key مشخص نشده باشد، از .BR setspent (3)، .BR getspent (3) و .BR endspent (3) برای شمارش پایگاه داده shadow استفاده می‌کند. هنگامی که یک یا چند آرگومان .I key ارائه شود، هر .I key را به نوبت به .BR getspnam (3) ارسال کرده و نتیجه را نمایش می‌دهد. .SH "گزینه‌ها (OPTIONS)" .TP .BI \-\-service\~ service .TQ .BI \-s\~ service .\" commit 9d0881aa76b399e6a025c5cf44bebe2ae0efa8af (glibc) جایگزین کردن سرویس مشخص‌شده برای تمام پایگاه‌های داده. (از glibc 2.2.5 به بعد.) .TP .BI \-\-service\~ database : service .TQ .BI \-s\~ database : service .\" commit b4f6f4be85d32b9c03361c38376e36f08100e3e8 (glibc) جایگزین کردن سرویس مشخص‌شده تنها برای پایگاه‌های داده معین. این گزینه می‌تواند چندین بار استفاده شود، اما تنها آخرین سرویس برای هر پایگاه داده اعمال خواهد شد. (از glibc 2.4 به بعد.) .TP .B \-\-no\-idn .TQ .B \-i .\" commit a160f8d808cf8020b13bd0ef4a9eaf3c11f964ad (glibc) غیرفعال کردن کدگذاری IDN در جستجوها برای .BR ahosts / getaddrinfo (3) (از glibc-2.13 به بعد.) .TP .B \-\-help .TQ .B \-? چاپ خلاصه راهنمای استفاده و خروج. .TP .B \-\-usage چاپ خلاصه کوتاهی از نحوه استفاده و خروج. .TP .B \-\-version .TQ .B \-V چاپ شماره نسخه، مجوز و سلب مسئولیت ضمانت برای .BR getent . .SH "وضعیت خروج (EXIT STATUS)" یکی از مقادیر خروج زیر می‌تواند توسط .B getent بازگردانده شود: .TP .B 0 دستور با موفقیت به پایان رسید. .TP .B 1 آرگومان‌های ورودی ناقص است، یا .I database ناشناخته است. .TP .B 2 یک یا چند .I key ارائه‌شده در .IR database یافت نشد. .TP .B 3 شمارش در این .IR database پشتیبانی نمی‌شود. .SH "همچنین ببینید (SEE ALSO)" .BR nsswitch.conf (5)