NAZWA

       getpass - wczytanie hasła

SKŁADNIA

       #include <unistd.h>

       char *getpass( const char * prompt );

OPIS

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

       Funkcja ta jest przestarzała. Nie należy jej używać.

       Funkcja  getpass() otwiera /dev/tty (terminal sterujący procesu), wyprowadza napis prompt,
       wyłącza echo, odczytuje jedną linię ("hasło"), odtwarza stan terminala i zamyka /dev/tty.

WARTOŚĆ ZWRACANA

       Funkcja getpass zwraca  wskaźnik  do  statycznego  bufora  zawierającego  hasło  (pierwsze
       PASS_MAX bajtów) bez kończącego znaku nowej linii, zakończone znakiem NUL.  Bufor ten może
       zostać nadpisany przez późniejsze wywołania funkcji.  W przypadku błędu,  odtwarzany  jest
       stan terminala, odpowiednio ustawiane errno, i zwracane NULL.

BŁĘDY

       Funkcja może zakończyć się niepomyślnie, gdy

       ENXIO  Proces nie posiada terminala sterującego.

UWAGI

       Dla libc4 i libc5 tekst zachęty ("prompt") nie jest wypisywany na /dev/tty, ale na stderr.
       Ponadto, jeśli nie można otworzyć /dev/tty, to hasło  jest  odczytywane  z  stdin.   Bufor
       statyczny  ma długość 128, więc zwracanych jest tylko pierwszych 127 bajtów hasła. Podczas
       odczytywania  hasła  wyłączone  jest  generowanie  sygnałów  (SIGINT,  SIGQUIT,   SIGSTOP,
       SIGTSTOP),  a  odpowiadające im znaki (zwykle control-C, control-\, control-Z i control-Y)
       są przesyłane jako część hasła.  Począwszy od libc 5.4.19, wyłączona  jest  edycja  linii,
       tak więc również cofanie (backspace) i jemu podobne będą widziane jako część hasła.

       Dla glibc2, jeśli nie można otworzyć /dev/tty, to tekst zachęty jest wypisywany na stderr,
       a hasło jest odczytywane z  stdin.   Nie  ma  natomiast  ograniczenia  na  długość  hasła.
       Wyłączona jest edycja linii.

       Zgodnie  z  SUSv2,  jeśli wartość PASS_MAX jest mniejsza niż 8, to musi być zdefiniowana w
       <limits.h>, a w każdym  przypadku  można  ją  otrzymać  za  pomocą  sysconf(_SC_PASS_MAX).
       Jednakże,  POSIX.2 odchodzi od stałych PASS_MAX i _SC_PASS_MAX oraz od funkcji getpass ().
       Libc4  i  libc5  nigdy  nie  wspierały  PASS_MAX  ani  _SC_PASS_MAX.    Glibc2   akceptuje
       _SC_PASS_MAX i zwraca BUFSIZ (np. 8192).

PLIKI

       /dev/tty

ZOBACZ TAKŻE

       crypt(3)

HISTORIA

       Funkcja getpass pojawiła się w Wersji 7 AT&T UNIX.

USTERKI

       Proces  wywołujący  funkcję  powinien  wyzerować  hasło  natychmiast,  gdy tylko będzie to
       możliwe, aby uniknąć pozostawania jawnego hasła widocznym w przestrzeni adresowej procesu.

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 getpass

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