Nomo
ioctl - kontrolo-aparato
Sinopsis
#include
int ioctl (int d , int peto , ...);
Priskribo
La ioctl- funkcio manipulas la submetajn aparatajn parametrojn de specialaj dosieroj. En aparta, multaj funkciaj karakterizaĵoj de karaktero specialaj dosieroj (ekz. Fina stacioj) povas esti kontrolitaj per ioctl- petoj. La argumento d devas esti malferma dosiero-priskribilo.
La dua argumento estas dependa peto-kodo. La tria argumento estas unipsa puntero al memoro. Ĝi estas tradicie char * argp (de la tagoj antaŭ void * estis valida C), kaj estos tiel nomata por ĉi tiu diskuto.
Ioctl- peto kodis en ĝi ĉu la argumento estas en parametro aŭ ekstere de parametro, kaj la grandeco de la argumento argumentas en bajtoj. Macros kaj difinoj uzataj en specifa ioctl- peto situas en la dosiero
Rezerva valoro
Kutime, sur sukceso nulo revenas. Kelkaj jodiloj uzas la rondan valoron kiel eliga parametro kaj redonas nevalivan valoron sur sukceso. En eraro, -1 estas redonita, kaj errno fiksas taŭge.
Eraroj
EBADF
d ne estas valida priskribilo.
EFAULT
argp referencas nealirebla memoro areo.
ENOTO
d ne estas asociita kun karaktero speciala aparato.
ENOTO
La specifa peto ne aplikas al la speco de objekto, kiun la priskribilo d aludas.
EINVALO
Peto aŭ argp ne validas.
Konformanta al
Neniu normo. Argumentoj, rondveturoj kaj semantikoj de ioctl (2) varias laŭ la aparato-ŝoforo en demando (la alvoko estas uzata kiel ĉifro por operacioj, kiuj tute ne taŭgas por la Unikso- rivereto I / O-modelo). Vidu ioctl_list (2) por listo de multaj de la konataj ioctl- alvokoj. La ioctl- funkcia voko aperis en Versio 7 AT & T Unikso.