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