ioctl(2) 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.

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/.