Provided by: manpages-pl-dev_0.5-1_all bug

NAZWA

       dlclose,  dlerror,  dlopen,  dlsym - interfejs programisty dla dynamicznie konsolidującego
       loadera

SKŁADNIA

       #include <dlfcn.h>

       void *dlopen(const char *filename, int flag);
       const char *dlerror(void);
       void *dlsym(void *handle, char *symbol);
       int dlclose(void *handle);

       Symbole specjalne: _init, _fini.

OPIS

        Uwaga! To tłumaczenie może być nieaktualne!

       dlopen ładuje bibliotekę dynamiczną z pliku, o nazwie zawartej w zakończonym  znakiem  NUL
       łańcuchu  filename  i  zwraca  nieprzezroczysty  "uchwyt"  dla tej biblioteki dynamicznej.
       Jeśli filename nie jest ścieżką absolutną (np. nie rozpoczyna się od "/"),  to  plik  jest
       poszukiwany w następujących miejscach:

              Rozdzielonej  dwukropkami  liście katalogów, zdefiniowanej w zmiennej środowiskowej
              LD_LIBRARY_PATH.

              Liście bibliotek podanej w /etc/ld.so.cache.

              /lib, a potem w /usr/lib.

       Jeśli filename jest wskaźnikiem NULL, to zwracany uchwyt wskazuje na program główny.

       Zewnętrzne odniesienia biblioteki są rozstrzygane przy użyciu bibliotek z listy zależności
       danej  biblioteki,  oraz  przy  użyciu wszystkich innych bibliotek, otwartych wcześniej ze
       znacznikiem RTLD_GLOBAL.  Jeśli plik wykonywalny był skonsolidowany z  opcją  "-rdynamic",
       to  globalne  symbole  pliku  wykonywalnego  będą także używane do rozstrzygania odniesień
       dynamicznie załadowanych bibliotek.

       flag powinna być albo  RTLD_LAZY,  oznaczającym  rozwiązywanie  niezdefiniowanych  symboli
       podczas  wywoływania  biblioteki  dynamicznej,  albo  RTLD_NOW,  oznaczającym  rozwiązanie
       wszystkich niezdefiniowanych symboli zanim dlopen powróci i nie powiedzie się,  jeśli  nie
       można  tego  dokonać.  Ewentualnie można wykonać operację OR na parametrze flag, i symbolu
       RTLD_GLOBAL,  oznaczającym,  że  symbole  zewnętrzne,  zdefiniowane  w   bibliotece   będą
       udostępniane kolejno ładowanym bibliotekom.

       Jeśli  biblioteka  eksportuje  funkcję  o  nazwie  _init, to jej kod jest wykonywany przed
       powrotem dlopen. Jeśli ta sama biblioteka jest załadowana przez  dlopen()  dwukrotnie,  to
       zwracany  jest  ten  sam  uchwyt.  Biblioteka  dl obsługuje liczniki dowiązań dla uchwytów
       plików  dynamicznych,  tak  więc  biblioteka  dynamiczna  nie  będzie   zdealokowana   nim
       tylokrotnie nie zostanie wywołana funkcja dlclose, ilokrotnie użyto dlopen.

       Jeśli dlopen z jakiejś przyczyny zawiedzie, to zwraca NULL.  Czytelny dla człowieka napis,
       zawierający opis ostatniego błędu, który pojawił się w którejś z funkcji dl (dlopen, dlsym
       lub  dlclose), można wyciągnąć przy użyciu dlerror().  dlerror zwraca NULL, jeśli od czasu
       inicjalizacji lub poprzedniego wywołania dlerror nie wystąpił błąd.  (Wywołanie  dlerror()
       dwa razy pod rząd zawsze spowoduje, że drugie wywołanie zwróci NULL.)

       dlsym  pobiera "uchwyt" biblioteki dynamicznej, zwrócony przez dlopen i zakończoną znakiem
       NUL nazwę symbolu. Zwraca adres, pod którym załadowany jest ten symbol. Jeśli  symbol  nie
       zostanie  znaleziony,  to  dlsym  zwraca NULL; jednak prawidłowym sposobem sprawdzenia czy
       podczas wykonania dlsym wystąpił  błąd,  jest  zapisanie  wyniku  dlerror  do  zmiennej  i
       sprawdzenie,  czy  wartość  ta  nie jest równa NULL.  Jest tak dlatego, że wartość symbolu
       może w rzeczywistości wynosić NULL.  Konieczne jest też zachowywanie wyników dlerror, gdyż
       ponowne wywołanie dlerror zwróci NULL.

       Istnieją dwa specialne pseudo-uchwyty: RTLD_DEFAULT i RTLD_NEXT.  Pierwszy z nich znajdzie
       pierwsze wystąpienie żądanego symbolu korzystając z domyślnego dla  biblioteki  kolejności
       poszukiwania.  Drugi  z  nich,  przydatny  tylko wewnątrz bibliotek dynamicznych, znajdzie
       następne wystąpienie funkcji dla  kolejności  poszukiwania  obowiązującej  po  załadowaniu
       bieżącej biblioteki.  Pozwala to zastąpienie funkcji w innej bibliotece dzielonej.

       dlclose  zmniejsza  o  jeden  licznik  odniesień w uchwycie bibliotek dynamicznych handle.
       Jeśli licznik spada do zera a inne załadowane  biblioteki  nie  używają  jej  symboli,  to
       biblioteka  dynamiczna  jest  zwalniana.  Jeśli biblioteka dynamiczna eksportuje funkcję o
       nazwie _fini, to jest ona wykonywana bezpośrednio przed zwolnieniem tej biblioteki.

WARTOŚĆ ZWRACANA

       dlclose zwraca 0 przy pomyślnym zakończeniu, z wartość niezerową w przypadku błędu.

PRZYKŁAD

       Załadowanie biblioteki matematycznej i wypisanie cosinusa liczby 2.0:
              #include <stdio.h>
              #include <dlfcn.h>

              int main(int argc, char **argv) {
                  void *handle;
                  double (*cosine)(double);
                  char *error;

                  handle = dlopen ("libm.so", RTLD_LAZY);
                  if (!handle) {
                      fprintf(stderr, "%s\n", dlerror());
                      exit(1);
                  }

                  cosine = dlsym(handle, "cos");
                  if ((error = dlerror()) != NULL)  {
                      fprintf (stderr, "%s\n", error);
                      exit(1);
                  }

                  printf ("%f\n", (*cosine)(2.0));
                  dlclose(handle);
                  return 0;
              }

       Gdyby ten program znajdował się w pliku o nazwie "foo.c", można by go zbudować  za  pomocą
       następującego polecenia:

              gcc -rdynamic -o foo foo.c -ldl

UWAGI

       Symbole  RTLD_DEFAULT i RTLD_NEXT są zdefiniowane w <dlfcn.h> tylko wtedy, gdy _GNU_SOURCE
       było zdefiniowane przed jego włączeniem.  Standard interfejsu dlopen pochodzi z SunOS.

ZOBACZ TAKŻE

       ld(1), ld.so(8), ldconfig(8), ldd(1), ld.so.info

INFORMACJE O TŁUMACZENIU

       Powyższe tłumaczenie pochodzi z nieistniejącego już Projektu Tłumaczenia  Manuali  i  może
       nie  być  aktualne.  W  razie  zauważenia  różnic  między  powyższym opisem a rzeczywistym
       zachowaniem opisywanego programu lub  funkcji,  prosimy  o  zapoznanie  się  z  oryginalną
       (angielską) wersją strony podręcznika za pomocą polecenia:

              man --locale=C 3 dlopen

       Prosimy  o  pomoc  w  aktualizacji stron man - więcej informacji można znaleźć pod adresem
       http://sourceforge.net/projects/manpages-pl/.