$ ldd /sbin/mke2fs libext2fs.so.2 => /lib/libext2fs.so.2 (0x40023000) libcom_err.so.2 => /lib/libcom_err.so.2 (0x40037000) libe2p.so.2 => /lib/libe2p.so.2 (0x40039000) libuuid.so.1 => /lib/libuuid.so.1 (0x4003e000) libc.so.6 => /lib/libc.so.6 (0x40041000) /lib/ld-linux.so.2 => /lib/ld-linux.so.2 (0x40000000)
Trying this on a statically linked program:
$ ldd /sbin/init not a dynamic executable
On Darwin, the corresponding program is called otool:
$ otool -L /bin/zsh /bin/zsh: /usr/lib/libncurses.5.dylib (compatibility version 5.0.0, current version 5.0.0) /usr/lib/libSystem.B.dylib (compatibility version 1.0.0, current version 60.0.0)
Assuming the source is in the files foo.c, bar.c, baz.c, you call GCC like so:
gcc -shared -Wl,-soname,libfoo.so -o libfoo.so.1.0.1 foo.c bar.c baz.c -lquux
This creates a SharedLibrary file libfoo.so.1.0.1, with shared object name ("soname") libfoo.so, dependent on libquux. To make libfoo usable, you need to put it someplace ldconfig(8) will find it, and SymLink it to libfoo.so.1 and libfoo.so.
So long as you don't change the call signature of one of the functions (or what they do, in a way that would break programs), you can just bump the minor version of the library and programs using the SharedLibrary will just work. If you do change call signatures on existing functions or change their semantics, bump the version, try to recompile the programs, and check that they work correctly once they pass. Another way to make it usable is to put it in a directory refered to in your LD_LIBRARY_PATH EnvironmentVariable.
You may wish to use -Wl,-O1 when linking too, it will optimise the hashtables used for symbol lookup making the startup time faster.
In some cases you may not want your shared library to have any extra dependencies. In such a case you want your shared library to have its dependencies statically linked in. Even a simple shared library will have a couple of dependences:
ldd ./libsam.so libc.so.6 => /lib/libc.so.6 (0x0000002a95675000) /lib64/ld-linux-x86-64.so.2 (0x000000552aaaa000)
The obvious way to statically link these dependencies would be:
gcc -shared -static -o libsam.so sam.c
This will either not work, or give an error message like:
gcc: -shared and -static|pie|fPIE|fpie|fno-PIC|fno-pic|nopie are incompatible
However, it is possible to directly tell the linker we want static linking, and then magic will happen:
gcc -shared -Wl,-static -o libsam.so sam.c ldd ./libsam.so statically linked
libsam.so is still a valid shared library, it just lacks any external dependency. In some cases you might need the command-line option -static-libgcc for this to work.
One of the advantages of libtool is that it will use the correct linker options on different platforms, instead of you having to learn them all and putting them in your MakeFile/configure script. (For example GCC uses </tt>-shared</tt>, -fPIC, -soname for certain options, Solaris's CC uses -G, -KPIC, and -h respectively for those same options).
If you have a .c file you wish to include in a library with libtool, you need to make a .lo file for it:
libtool --mode=compile gcc -c trace.c -o libtrace.lo
Once you have a .lo file, you need to make a .la file
LDLIBS=-lpcap -lz libtool --mode=link gcc -o libtrace.la libtrace.lo -rpath /usr/local/wand/lib \ $(LDLIBS) \ -version-info 1:2:0
One nice feature of libtool is that you can specify other shared libraries that this one will depend upon (in the LD_LIBS EnvironmentVariable above), and this will be included in the linker script -- any package linking against libtrace in the above example will automatically link against libpcap and libz as well.
To install the libraries, you use libtool once more:
libtool --mode=install install -c libtrace.la /usr/local/wand/lib/libtrace.la libtool --finish /usr/local/wand/lib/
As a final step, I make sure to install my header files somewhere useful!
cp ../include/libtrace.h /usr/local/wand/include/libtrace.h
There are excellent docs on using libtool supplied with the program.
Using nm(1) on dynamic libraries requires the --dynamic option:
nm /lib/libc.so.6 # doesn't work nm --dynamic /lib/libc.so.6 # does work
A misplaced / led me to moving everything from / to '/etc/old' - when you can't find the library loader, you can't even run bash builtins. Get around it like so:
/etc/old/lib/ld-linux.so.2 /etc/old/bin/mv /etc/old/bin /