Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] get_user, put_user, copy_from_user, copy_to_user - copie des données entre l'espace mémoire du noyau et la mémoire utilisateur [size=18] [b]Résumé[/b] [/size] [b]#include <asm/uaccess.h>[/b] .nf [b][i]err = get_user ( x , addr );[/i][/b] [b][i]err = put_user ( x , addr );[/i][/b] [b][i]bytes_left = copy_from_user(void* to , const void * from ,[/i][/b] [b][i] unsigned long n );[/i][/b] [b][i]bytes_left = copy_to_user(void* to , const void * from ,[/i][/b] [b][i] unsigned long n );[/i][/b] [size=18] [b]Description[/b] [/size] Ces macros transfèrent des données entre les espaces mémoire du noyau et des processus (mémoire utilisateur). Dans le premier exemple, la variable du noyau [i]x[/i] reçoit la valeur de ce qui à l'adresse [i]addr[/i] (dans la mémoire utilisateur). [b]put_user[/b] écrit la valeur de la variable [i]x[/i] à l'adressse [i]addr[/i]. NN : [i]x[/i] est une [b]variable[/b], et non un pointeur ! [i]addr[/i] doit absolument être un pointeur correctement typé car ce type détermine le nombre d'octets à copier. [b]copy_from_user[/b] copie [i]n[/i] octets depuis l'adresse [i]from[/i] dans l'espace mémoire utilisateur à l'adresse [i]to[/i] dans l'espace mémoire du noyau. [b]copy_to_user[/b] copie dans l'autre sens. Aucune de ces macros ne nécessite l'antique appel [b]verify_area[/b](), car toutes les vérifications sont assurées par l'unité de pagination du microprocesseur. [ NdT : dans la version 2.1.2 les changements suivant ont été opérés : [b][/b] x = get_user(addr) => err = get_user(x,addr); [b][/b] put_user(x,addr) => err = put_user(x,addr); [b][/b] memcpy_fromfs(...) => bytes_left = copy_from_user(...); [b][/b] memcpy_tofs(...) => bytes_left = copy_to_user(...); [b][/b] Au lieu de vérifier à chaque transfert mémoire que les zones cibles et destinations ont été correctement alloués, Linus a décidé de supprimer tous ces tests. Les accès incorrects sont gérés via le mécanisme des exceptions : en cas d'erreur, le CPU passe la main au VM. Je ne peux pas l'assurer, mais je crois que les autres architectures supportées disposent d'un mécanisme analogue au mode protégé des ix86. ] [b][/b] [b][/b] Il y a ainsi moins de risque d'utiliser une adresse non valide. De plus, le nouveau mécanisme est beaucoup plus rapide [Ndt : avec la gestion des dentries apparues dans les 2.1.4x, c'est l'une des deux plus importantes accélérations apportées au noyau]. [size=18] [b]Valeur renvoyée[/b] [/size] [b]get_user[/b] et put_user retournent [b]0[/b] an cas de succès et -EFAULT en cas d'accès mémoire erroné. [b]copy_from_user[/b] et [b]copy_to_user[/b] retournent le nombre d'octets qui [b]n'a[/b] pas pu être copié (de nouveau, 0 est une valeur de retour signifiant un succès). [size=18] [b]Exemples[/b] [/size] [cpp] if (get_user(type, (char *)arg)) return -EFAULT; switch (type) { b.maxwidth = 768; b.maxheight = 576; b.minwidth = 32; b.minheight = 32; if(copy_to_user(arg, &b, sizeof(b))) return -EFAULT; return 0; ... [/cpp] [size=18] [b]Disponibilité[/b] [/size] Linux 2.1.4+ [size=18] [b]Voir aussi[/b] [/size] [b]verify_area (9)[/b] [size=18] [b]Auteur[/b] [/size] Page de manuel par Jim Van Zandt <jrv@vanzandt.mv.com> [size=18] [b]Traduction[/b] [/size] [i]Thierry Vignaud < tvignaud@mandrakesoft.com >, 1999[/i]
Fichier