View source for LD LIBRARY PATH

{{Infobox
| title = LD_LIBRARY_PATH
| label1 = Tipe        | data1 = Environment variable
| label2 = Platform    | data2 = Linux / Unix-like (glibc, dll.)
| label3 = Dibaca oleh | data3 = Dynamic linker/loader (<code>ld.so</code> / <code>ld-linux.so</code>)
| label4 = Pemisah     | data4 = Titik dua (<code>:</code>)
}}

'''<code>LD_LIBRARY_PATH</code>''' adalah sebuah ''environment variable'' di sistem Linux/Unix yang berisi daftar direktori (dipisah dengan titik dua <code>:</code>) tempat ''dynamic linker'' mencari ''[[shared library]]'' (<code>.so</code>) saat program dijalankan, '''sebelum''' linker mengecek lokasi default sistem.

== Latar belakang ==

Program yang di-''link'' secara dinamis tidak menyimpan kode library di dalam binary-nya, melainkan hanya menyimpan ''nama'' library yang dibutuhkan. Saat program dijalankan, ''dynamic linker'' (misalnya <code>ld-linux.so.2</code>) bertugas mencari dan memuat file <code>.so</code> tersebut ke dalam memori. <code>LD_LIBRARY_PATH</code> memberi cara untuk menyisipkan direktori pencarian tambahan tanpa harus mengubah binary atau konfigurasi sistem.

Karena nilainya bisa diganti setiap kali program dijalankan, variable ini fleksibel untuk ''testing'' — berbeda dengan <code>RPATH</code>/<code>RUNPATH</code> yang tertanam permanen di dalam binary saat ''compile''.

== Urutan pencarian library ==

Pada glibc, ''dynamic linker'' mencari ''shared library'' dengan urutan berikut:

# Library dari <code>LD_PRELOAD</code> dan <code>/etc/ld.so.preload</code> (dimuat lebih dulu, bukan bagian dari pencarian dependency biasa).
# <code>DT_RPATH</code> di binary — '''hanya jika''' atribut <code>DT_RUNPATH</code> tidak ada.
# '''<code>LD_LIBRARY_PATH</code>''' — kecuali binary berstatus ''setuid''/''setgid'' (lihat [[#Keamanan|Keamanan]]).
# <code>DT_RUNPATH</code> di binary (jika ada).
# Cache <code>/etc/ld.so.cache</code>, di-''generate'' oleh <code>ldconfig</code> dari direktori di <code>/etc/ld.so.conf</code>.
# Direktori default sistem: <code>/lib</code> lalu <code>/usr/lib</code> (di-skip jika binary di-link dengan <code>-z nodefaultlib</code>).

Jika library tetap tidak ditemukan di semua lokasi tersebut, muncul error:

<pre>
error while loading shared libraries: libfoo.so: cannot open shared object file: No such file or directory
</pre>

{{Catatan|Poin penting yang sering bikin bingung: kalau binary punya <code>DT_RUNPATH</code> (umum di linker modern dengan <code>--enable-new-dtags</code>), maka <code>DT_RPATH</code> '''diabaikan''' dan <code>LD_LIBRARY_PATH</code> dicek '''sebelum''' <code>RUNPATH</code>. Tapi kalau yang ada cuma <code>DT_RPATH</code> (gaya lama), maka <code>RPATH</code> dicek '''sebelum''' <code>LD_LIBRARY_PATH</code>.}}

== Penggunaan ==

=== Set untuk satu sesi shell ===

<syntaxhighlight lang="bash">
export LD_LIBRARY_PATH=/opt/mylibs:$LD_LIBRARY_PATH
./my_program
</syntaxhighlight>

=== Set untuk satu kali eksekusi (lebih disarankan) ===

Cara ini tidak "mengotori" ''environment'' shell dan hanya berlaku untuk proses tersebut:

<syntaxhighlight lang="bash">
LD_LIBRARY_PATH=/opt/mylibs ./my_program
</syntaxhighlight>

=== Beberapa direktori ===

<syntaxhighlight lang="bash">
export LD_LIBRARY_PATH=/opt/cuda/lib64:/usr/local/lib:$LD_LIBRARY_PATH
</syntaxhighlight>

== Kasus penggunaan umum ==

* Library <code>.so</code> berada di lokasi non-standar yang belum terdaftar di <code>ldconfig</code>.
* Menguji library versi baru tanpa meng-''install'' ke sistem (''system-wide'').
* Workflow GPU/ML — menunjuk ke library vendor seperti <code>libcudart.so</code>, <code>libnvinfer.so</code> (TensorRT), atau ''ICD loader'' OpenCL yang tidak ada di ''default path''.

== Keamanan ==

Untuk binary ber-bit ''setuid'' atau ''setgid'', ''dynamic linker'' '''mengabaikan''' <code>LD_LIBRARY_PATH</code> (dan juga membatasi <code>LD_PRELOAD</code>). Ini disebut ''secure-execution mode'' dan mencegah serangan ''library hijacking'', di mana ''attacker'' bisa memaksa program istimewa memuat <code>.so</code> jahat.

Beberapa risiko penggunaan sembarangan:

* '''Konflik versi''' — binary lain bisa salah memuat <code>.so</code> versi yang tidak diinginkan.
* '''Degradasi performa''' — direktori tambahan ikut di-''scan'' untuk semua program yang mewarisi ''environment'' tersebut.
* '''Vektor serangan''' — jika ada direktori ''writable'' oleh user lain di dalam path.

== Alternatif yang lebih baik ==

Untuk solusi permanen, hindari menaruh <code>LD_LIBRARY_PATH</code> di <code>.bashrc</code>. Sebagai gantinya:

* Tambahkan path ke file di <code>/etc/ld.so.conf.d/*.conf</code> lalu jalankan <code>sudo ldconfig</code>.
* Atau tanamkan <code>RUNPATH</code> saat ''compile'' menggunakan ''linker flag'':

<syntaxhighlight lang="bash">
gcc main.c -o my_program -Wl,-rpath,/opt/mylibs -L/opt/mylibs -lmylib
</syntaxhighlight>

: Pendekatan <code>RUNPATH</code> lebih portabel karena path menempel di binary, tidak bergantung pada ''environment variable''. Token khusus <code>$ORIGIN</code> bisa dipakai untuk path relatif terhadap lokasi binary, misalnya <code>-Wl,-rpath,'$ORIGIN/../lib'</code>.

== Tooling terkait ==

{| class="wikitable"
! Perintah !! Fungsi
|-
| <code>ldd ./my_program</code> || Menampilkan library apa saja yang dibutuhkan dan ke mana resolusinya
|-
| <code>readelf -d ./my_program {{!}} grep PATH</code> || Melihat <code>RPATH</code>/<code>RUNPATH</code> yang tertanam
|-
| <code>ldconfig -p</code> || Menampilkan isi cache <code>/etc/ld.so.cache</code>
|-
| <code>LD_DEBUG=libs ./my_program</code> || Men-''debug'' proses pencarian library oleh linker
|-
| <code>patchelf --set-rpath</code> || Mengubah <code>RPATH</code>/<code>RUNPATH</code> binary yang sudah jadi
|}

== Lihat pula ==

* [[rpath]] (<code>DT_RPATH</code> / <code>DT_RUNPATH</code>)
* <code>[[LD_PRELOAD]]</code>
* <code>[[ldconfig]]</code>
* <code>[[ld.so]]</code>

== Referensi ==

* {{cite web |title=ld.so(8) — Linux manual page |url=https://www.man7.org/linux/man-pages/man8/ld.so.8.html}}
* {{cite web |title=rpath |publisher=Wikipedia |url=https://en.wikipedia.org/wiki/Rpath}}