.\" Copyright 1999 SuSE GmbH Nuernberg, Germany .\" Author: Thorsten Kukuk .\" .\" SPDX-License-Identifier: GPL-2.0-or-later .\" .\" Modified, 6 May 2002, Michael Kerrisk, .\" Change listed order of /usr/lib and /lib .TH ldconfig 8 2024-05-02 "Linux man-pages 6.9.1" .SH "نام (NAME)" ldconfig \- پیکربندی اتصالات پیونددهنده پویا و کش کتابخانه‌ها .SH "خلاصه دستور (SYNOPSIS)" .SY /sbin/ldconfig .RB [ \-nNvVX ] .RB [ \-C\~\c .IR cache ] .RB [ \-f\~\c .IR conf ] .RB [ \-r\~\c .IR root ] .IR directory \~.\|.\|. .YS .SY /sbin/ldconfig .B \-l .RB [ \-v ] .IR library \~.\|.\|. .YS .SY /sbin/ldconfig .B \-p .YS .SH "توضیحات (DESCRIPTION)" دستور .B \%ldconfig پیوندها و کش لازم را برای جدیدترین کتابخانه‌های مشترک یافت‌شده در دایرکتوری‌های مشخص‌شده در خط فرمان، فایل .IR /etc/ld.so.conf و دایرکتوری‌های قابل اعتماد .I /lib و .I /usr/lib ایجاد می‌کند. در برخی از معماری‌های ۶۴ بیتی مانند x86-64، دایرکتوری‌های .I /lib و .I /usr/lib دایرکتوری‌های قابل اعتماد برای کتابخانه‌های ۳۲ بیتی هستند، در حالی که از .I /lib64 و .I /usr/lib64 برای کتابخانه‌های ۶۴ بیتی استفاده می‌شود. .P کش ایجادشده توسط پیونددهنده زمان اجرا، .I ld.so یا .IR ld\-linux.so استفاده می‌شود. دستور .B \%ldconfig هنگام تعیین این‌که پیوندهای کدام نسخه‌ها باید به‌روزرسانی شوند، هدر و نام فایل‌های کتابخانه‌هایی را که با آن‌ها مواجه می‌شود بررسی می‌کند. .P دستور .B \%ldconfig معمولاً باید توسط مدیر سیستم (کاربر ارشد یا ریشه) اجرا شود، زیرا ممکن است به دسترسی نوشتن روی برخی دایرکتوری‌ها و فایل‌های متعلق به ریشه نیاز داشته باشد. .P دستور .B \%ldconfig تنها فایل‌هایی را بررسی می‌کند که نام آن‌ها با الگوی .I lib*.so* (برای اشیای مشترک معمولی) یا .I ld\-*.so* (برای خودِ بارگذار پویا) مطابقت داشته باشد. سایر فایل‌ها نادیده گرفته می‌شوند. همچنین، .B \%ldconfig الگوی خاصی را برای نحوه برپایی پیوندهای نمادین انتظار دارد؛ مانند این مثال که در آن فایل میانی .RI ( libfoo.so.1 در اینجا) همان SONAME برای کتابخانه است: .P .in +4n .EX libfoo.so \-> libfoo.so.1 \-> libfoo.so.1.12 .EE .in .P عدم رعایت این الگو ممکن است پس از ارتقای سامانه به مشکلات سازگاری منجر شود. .SH "گزینه‌ها (OPTIONS)" .TP .BI \-\-format= fmt .TQ .BI \-c\~ fmt (از نسخه glibc 2.2) استفاده از قالب کش .IR fmt که یکی از مقادیر .BR old ، .B new یا .B \%compat است. از نسخه glibc 2.32 به بعد، مقدار پیش‌فرض .B new است؛ پیش از آن مقدار پیش‌فرض .B \%compat بود. .TP .BI \-C\~ cache استفاده از .I cache به‌جای .IR /etc/ld.so.cache . .TP .BI \-f\~ conf استفاده از .I conf به‌جای .IR /etc/ld.so.conf . .TP .B \-\-ignore\-aux\-cache .TQ .B \-i (از نسخه glibc 2.7) نادیده گرفتن فایل کش کمکی. .TP .B \-l (از نسخه glibc 2.2) تفسیر هر عملوند به‌صورت نام یک کتابخانه و پیکربندی پیوندهای آن. تنها برای استفاده توسط افراد متخصص در نظر گرفته شده است. .TP .B \-n تنها پردازش دایرکتوری‌های مشخص‌شده در خط فرمان؛ دایرکتوری‌های قابل اعتماد و دایرکتوری‌های مشخص‌شده در .I /etc/ld.so.conf پردازش نمی‌شوند. این گزینه متضمن .B \-N است. .TP .B \-N کش را دوباره نسازد. مگر این‌که .B \-X نیز مشخص شده باشد، پیوندها همچنان به‌روزرسانی می‌شوند. .TP .B \-\-print\-cache .TQ .B \-p چاپ فهرست دایرکتوری‌ها و کتابخانه‌های نامزد ذخیره‌شده در کش فعلی. .TP .BI \-r\~ root تغییر مسیر به .I root و استفاده از آن به‌عنوان دایرکتوری ریشه. .TP .B \-\-verbose .TQ .B \-v حالت پرگو (verbose). چاپ شماره نسخه فعلی، نام هر دایرکتوری در حین پویش آن، و پیوندهایی که ایجاد می‌شوند. این گزینه حالت بی‌صدا را لغو می‌کند. .TP .B \-\-version .TQ .B \-V چاپ نسخه برنامه. .TP .B \-X پیوندها را به‌روزرسانی نکند. مگر این‌که .B \-N نیز مشخص شده باشد، کش همچنان دوباره ساخته می‌شود. .SH "فایل‌ها (FILES)" .PD 0 .TP .I /lib/ld.so پیونددهنده و بارگذار زمان اجرا است. .TP .I /etc/ld.so.conf شامل فهرستی از دایرکتوری‌ها، هر کدام در یک سطر، برای جستجوی کتابخانه‌ها است. .TP .I /etc/ld.so.cache شامل فهرستی مرتب‌شده از کتابخانه‌های یافت‌شده در دایرکتوری‌های مشخص‌شده در .IR /etc/ld.so.conf و همچنین دایرکتوری‌های قابل اعتماد است. .PD .SH "همچنین ببینید (SEE ALSO)" .BR ldd (1), .BR ld.so (8)