bionic (2) ioctl.2.gz

NAZWA

       ioctl - sterowanie urządzeniem

SKŁADNIA

       #include <sys/ioctl.h>

       int ioctl(int d, int request, ...);

OPIS

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

       Funkcja  ioctl  manipuluje  na  podległych jej parametrach urządzeń, do których dostęp odbywa się poprzez
       pliki specjalne. W szczególności, za pomocą żądań ioctl można kontrolować wiele właściwości  operacyjnych
       specjalnych plików znakowych (np. terminali). Argument d musi być otwartym deskryptorem pliku.

       Drugi  argument  jest  zależnym  od  urządzenia  kodem  polecenia.  Trzeci argument jest pozbawionym typu
       wskaźnikiem do obszaru pamięci, tradycyjnie char *argp (pochodzi z okresu zanim void * stało się poprawne
       w C) i tak będzie nazywany w niniejszej dyskusji.

       Ioctl  request  zawiera  w  sobie  zakodowaną  informację  czy  argument  jest  parametrem wejściowym czy
       wyjściowym oraz rozmiar argp tego argumentu w  bajtach.  Makra  i  definicje,  używane  do  przekazywania
       request do ioctl, znajdują się w pliku <sys/ioctl.h>.

WARTOŚĆ ZWRACANA

       Zazwyczaj, po pomyślnym zakończeniu zwracane jest zero.  Niektóre ioctl-e używają zwracanej wartości jako
       parametru wyjściowego i zwracają wówczas  pewną  wartość  nieujemną.   Po  błędzie  zwracane  jest  -1  i
       odpowiednio ustawiane errno.

BŁĘDY

       EBADF  d nie jest prawidłowym deskryptorem.

       EFAULT argp wskazuje na niedostępny obszar pamięci.

       ENOTTY d nie jest związane z urządzeniem znakowym.

       ENOTTY Podane żądanie nie ma zastosowania dla obiektu, na który wskazuje deskryptor d.

       EINVAL request lub argp są nieprawidłowe.

CONFORMING TO

       Brak  jednego  standardu.   Argumenty,  zwracane wartości i semantyka ioctl(2) różnią się w zależności od
       sterownika urządzenia, którego dotyczą (wywołanie jest używane jako uniwersalne dla operacji,  które  nie
       dają się ładnie dopasować do uniksowego modelu strumieni we/wy). W ioctl_list(2) znajduje się lista wielu
       znanych wywołań ioctl.  Funkcja ioctl pojawiła się w wersji 7 AT&T UNIX.

ZOBACZ TAKŻE

       execve(2), fcntl(2), ioctl_list(2), mt(4), sd(4), tty(4)

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 2 ioctl

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