ldconfig Command: Tutorial & Examples

ldconfig is a Linux command that is used primarily to create, update and remove the necessary links and cache (typically /etc/ld.so.cache) for the dynamic libraries. A dynamic library is a piece of code that can be loaded anywhere in memory and linked into an application at run-time. These libraries are essential for running software applications on a Linux system. You can learn more about the Linux dynamic linker from the ld.so page.

Why is ldconfig important?

ldconfig is a crucial command that helps the system to locate the shared libraries required by binary programs at runtime. If the system cannot find these libraries, the program will not run, leading to potential software failure. So, it's imperative to have an updated cache of shared libraries. This is where ldconfig comes in handy. It ensures that the dynamic linker/loader (ld.so or ld-linux.so) can locate and load the shared libraries required by the binary programs.

How does ldconfig work?

ldconfig works by scanning a predefined list of directories and optional directories listed in the /etc/ld.so.conf file. It then updates the symbolic links in the directories for the shared libraries. After updating the symbolic links, ldconfig creates a cache (/etc/ld.so.cache) that is used by the dynamic linker/loader to speed up the loading of programs.

How to use ldconfig?

Using ldconfig is pretty straightforward. The typical usage is to run it without any parameters. This will update the cache and the symbolic links for the shared libraries.

sudo ldconfig

In some cases, you might want to add a new directory to the list that ldconfig checks. You can do this by editing the /etc/ld.so.conf file and then running ldconfig to update the cache. Below is an example of how to add a directory:

echo '/usr/local/lib/newlib' | sudo tee -a /etc/ld.so.conf
sudo ldconfig

Common ldconfig parameters

Here are some common parameters you might use with ldconfig:

  • -v: Prints all directories as they are scanned, along with any symbolic links that are created.
  • -n: Only processes directories specified on the command line. Does not update the cache.
  • -X: Just rebuilds the cache, but does not update the symbolic links.
  • -p: Prints the contents of the current cache.

Potential problems and pitfalls

While ldconfig is a powerful command, improper use can lead to problems. For example, if you accidentally remove or overwrite the /etc/ld.so.cache file without understanding its importance, it could lead to system instability or even system failure.

Also, be careful when adding new directories to the /etc/ld.so.conf file. If you add a directory that doesn't exist or contains incompatible libraries, it could cause errors.

Finally, remember that ldconfig should be run with superuser privileges. Running it as a normal user may not update the cache or the symbolic links correctly.


Understanding and using the ldconfig command properly can help ensure that your Linux server operates smoothly. It helps to keep the dynamic libraries organized and ensures that all software applications can find the necessary libraries at runtime. However, like any powerful command, it should be used with caution.

Except where otherwise noted, content on this site is licensed under a CC BY-SA 4.0 license CC BY SA