Provided by: manpages-pl-dev_20060617-1_all bug

NAZWA
       confstr - pobranie zmiennych łańcuchowych zależnych od konfiguracji


SKŁADNIA
       #define _POSIX_C_SOURCE 2
       lub
       #define _XOPEN_SOURCE
       #include <unistd.h>

       size_t confstr(int name, char *buf, size_t len);


OPIS
       Funkcja  confstr()  pobiera wartość zależnych od konfiguracji zmiennych
       systemowych.

       Argument  name  wyznacza  pobieraną  zmienną  systemową.   Dostępne  są
       zmienne:

       _CS_PATH
              Wartość  zmiennej  PATH  zawierającej  ścieżkę, w której znaleźć
              można wszystkie standardowe programy narzędziowe POSIX.2.

       Jeśli argument buf buf nie jest równy NULL, a len nie  jest  zerem,  to
       funkcja  confstr()  kopiuje  wartość  zmiennej do łańcucha buf obciętą,
       jeśli to konieczne, do len - 1 znaków i zakończoną znakiem  NUL.   Może
       to zostać wykryte przez porównanie zwracanej przez confstr() wartości z
       argumentem len.  Jeśli len wynosi zero a buf jest równe  NULL,  funkcja
       confstr() po prostu zwraca wartość, tak jak podano poniżej.


WARTOŚĆ ZWRACANA
       Jeśli  name  nie  określa poprawnej zmiennej konfiguracyjnej, confstr()
       zwraca 0.


PRZYKŁADY
       Poniższy fragment kodu podaje ścieżkę, w której znaleźć  znaleźć  można
       programy systemowe POSIX.2:

          char *pathbuf; size_t n;

          n = confstr(_CS_PATH,NULL,(size_t)0);
          if ((pathbuf = malloc(n)) == NULL) abort();
          confstr(_CS_PATH, pathbuf, n);


BŁĘDY
       Jeśli  wartość name jest nieprawidłowa, errno jest ustawiane na EINVAL.


ZGODNE Z
       Propozycja POSIX.2


USTERKI
       POSIX.2 nie został jeszcze zatwierdzony jako  standard,  informacja  na
       tej stronie man może ulec zmianie.


ZOBACZ TAKŻE
       sh(1), exec(3), system(3)