Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] sendfile - Transfert de données entre descripteurs de fichiers. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/sendfile.h>[/b] [b][i]size_t sendfile(int out_fd , int in_fd , off_t * offset , size_t count );[/i][/b] [size=18] [b]Description[/b] [/size] Cet appel-système copie des données entre un descripteur de fichier et un autre. L'un ou l'autre de ces descripteurs peuvent être une socket (voir plus bas). Le descripteur [i]in_fd[/i] doit être ouvert en lecture, et [i]out_fd[/i] en écriture. Le pointeur [i]offset[/i] doit correspondre à une variable contenant la position dans le fichier d'entrée à partir de laquelle [b]sendfile ()[/b] commencera la lecture. Lorsque la routine se termine, la variable est remplie avec la position de l'octet immédiatement après le dernier octet lu. L'argument [i]count[/i] est le nombre d'octets à copier entre les descripteurs de fichiers. Comme la copie est assurée à l'intérieur du noyau, [b]sendfile ()[/b] ne perd pas de temps à transférer des données entre l'espace noyau et l'espace utilisateur. [size=18] [b]Notes[/b] [/size] L'appel [b]sendfile ()[/b] ne modifie pas la position courante dans le fichier [b]in_fd ,[/b] mais modifie celle de [b]out_fd .[/b] Si vous voulez utiliser [b]senbdfile[/b]() pour envoyer un fichier au travers d'une socket TCP, tout en le précédant de données d'en-tête, voyez l'option [b]TCP_CORK [/b] de [b]tcp (7)[/b] pour minimiser le nombre de paquets, et optimiser les performances. Actuellement, le descripteur depuis lequel les données sont lues ne peut pas être une socket, il doit s'agir d'un fichier supportant les opérations de type mmap(). [size=18] [b]Valeur renvoyée[/b] [/size] Si le transfert a réussi, le nombre d'octets écrits dans [i]out_fd[/i] est renvoyé. Sinon, [b]sendfile[/b]() renvoie -1, et [i]errno[/i] est configuré. [size=18] [b]Erreurs[/b] [/size] [b]EBADF[/b] [table][row][col]    [/col][col]Le fichier d'entrée n'est pas ouvert en lecture, ou celui de sortie en écriture.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Le descripteur est invalide ou verrouillé.[/col][/row][/table] [b]ENOMEM[/b] [table][row][col]    [/col][col]Mémoire insuffisante pour lire depuis [b]in_fd .[/b][/col][/row][/table] [b]EIO[/b] [table][row][col]    [/col][col]Erreur d'entrée-sortie pendant la lecture depuis [b]in_fd .[/b][/col][/row][/table] [size=18] [b]Versions[/b] [/size] L'appel-système [b]sendfile ()[/b] est une nouveauté de Linux 2.2. Le fichier d'en-tête <sys/sendfile.h> est présent depuis la GlibC 2.1. Les autres Unix implémentent [b]sendfile[/b]() avec d'autres sémantiques, et d'autres prototypes. Il ne faut pas l'utiliser dans un programme portable. [size=18] [b]Voir aussi[/b] [/size] [b]socket (2),[/b] [b]open (2)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 1996-2003.
Fichier