NUME¶

ioctl - controlează dispozitivul

BIBLIOTECA¶

Biblioteca C standard (libc, -lc)

SINOPSIS¶

#include <sys/ioctl.h>

int ioctl(int fd, unsigned long op, ...);  /* glibc, BSD */
int ioctl(int fd, int op, ...);            /* musl, alte UNIX */

DESCRIERE¶

Apelul de sistem ioctl() manipulează parametrii de dispozitiv subiacente ai fișierelor speciale. În special, multe dintre caracteristicile de funcționare ale fișierelor speciale de caractere (de exemplu, terminale) pot fi controlate cu ajutorul operațiilor ioctl(). Argumentul fd trebuie să fie un descriptor de fișier deschis.

Al doilea argument este un cod de operație care depinde de dispozitiv. Cel de-al treilea argument este un indicator de memorie fără tip. În mod tradițional, este char *argp (din zilele de dinainte ca void * să fie valabil în C) și va fi numit astfel pentru această discuție.

O operație, „op” ioctl() are codificată în ea însăși dacă argumentul este un parametru de intrare sau un parametru de ieșire, precum și dimensiunea argumentului argp în octeți. Macrocomenzile și definițiile utilizate în specificarea unei cerer ioctl() sunt localizate în fișierul <sys/ioctl.h>. A se vedea NOTE.

VALOAREA RETURNATö

De obicei, în caz de succes, se returnează zero. Câteva operații ioctl() utilizează valoarea de returnare ca parametru de ieșire și returnează o valoare nenegativă în caz de succes. În caz de eroare, se returnează -1, iar errno este configurată pentru a indica eroarea.

ERORI-IEȘIRE¶

EBADF

descriptor-fișier nu este un descriptor de fișier valid.

EFAULT

argp face referire la o zonă de memorie inaccesibilă.

EINVAL

op (operația) sau argp nu sunt valide.

ENOTTY

fd nu este asociat cu un dispozitiv special de caractere.

ENOTTY

Operația specificată nu se aplică tipului de obiect la care face referire descriptorul de fișier fd.

VERSIUNI¶

Argumentele, returnările și semantica lui ioctl() variază în funcție de controlorul de dispozitiv în cauză (apelul este utilizat ca o soluție de tip „catch-all” (capturează-tot) pentru operațiile care nu se încadrează în mod clar în modelul fluxului de In/Ieș UNIX).

STANDARDE¶

Niciunul.

ISTORIC¶

AT&T UNIX versiunea 7 are

ioctl(int fildes, int op, struct sgttyb *argp);

(unde struct sgttyb a fost folosită istoric de stty(2) și gtty(2) și este polimorfă în funcție de tipul de operație (așa cum ar fi fost un void *, dacă ar fi fost disponibil)).

SysIII documentează arg fără niciun tip.

4.3BSD are

ioctl(int d, unsigned long op, char *argp);

(cu char * în mod similar cu void *).

SysVr4 are

int ioctl(int fildes, int op, ... /* arg */);

NOTE¶

Pentru a utiliza acest apel, este nevoie de un descriptor de fișier deschis. Adesea, apelul open(2) are efecte secundare nedorite, care pot fi evitate în Linux prin aplicarea fanionului O_NONBLOCK.

CONSULTAȚI ȘI¶

execve(2), fcntl(2), ioctl_console(2), ioctl_fat(2), ioctl_ficlone(2), ioctl_ficlonerange(2), ioctl_fideduperange(2), ioctl_fslabel(2), ioctl_getfsmap(2), ioctl_iflags(2), ioctl_ns(2), ioctl_tty(2), ioctl_userfaultfd(2), open(2), sd(4), tty(4)

TRADUCERE¶

Traducerea în limba română a acestui manual a fost făcută de Remus-Gabriel Chelu <remusgabriel.chelu@disroot.org>

Această traducere este documentație gratuită; citiți Licența publică generală GNU Versiunea 3 sau o versiune ulterioară cu privire la condiții privind drepturile de autor. NU se asumă NICIO RESPONSABILITATE.

Dacă găsiți erori în traducerea acestui manual, vă rugăm să trimiteți un e-mail la translation-team-ro@lists.sourceforge.net.