Editer un article - Informaticien.be

Editer un article

Titre
Mots Clés
Texte	[size=18] [b]Nom[/b] [/size] ddp - Implémentation Linux du protocole AppleTalk. [size=18] [b]Résumé[/b] [/size] [b]#include <sys/socket.h>[/b] [b][/b] [b]#include <netatalk/at.h> [/b] [b][i]ddp_socket = socket(PF_APPLETALK, SOCK_DGRAM, 0);[/i][/b] [b][/b] [b][i]raw_socket = socket(PF_APPLETALK, SOCK_RAW, protocole );[/i][/b] [size=18] [b]Description[/b] [/size] Linux implémente le protocole AppleTalk décrit dans le document [b]Inside Appletalk .[/b] Seuls le niveau DDP et l'AARP sont présents dans le noyau, ils sont conçus pour être utilisés via les bibliothèques du protocole [b]netatalk .[/b] Cette page documente l'interface pour ceux qui ont envie (ou besoin) d'utiliser directement le niveau DDP. La communication entre Appletalk et le programme utilisateur fonctionne en utilisant une interface compatible avec les sockets BSD. Voir [b]socket (7). [/b] Une socket AppleTalk est créée en appelant la fonction [b]socket (2) [/b] avec un argument [b]PF_APPLETALK[/b] en famille de socket. Les types valides sont [b]SOCK_DGRAM[/b] pour ouvrir une socket [b]ddp [/b] ou [b]SOCK_RAW[/b] pour ouvrir une socket [b]raw . [/b] [i]protocol[/i] est le protocole Appletalk pour envoyer ou recevoir des données. Pour le type [b]SOCK_RAW [/b] il faut indiquer [b]ATPROTO_DDP .[/b] Les sockets Raw peuvent seulement être ouvertes par un processus ayant UID effectif nul ou ayant la capacité [b]CAP_NET_RAW .[/b] [size=18] [b]Format dadresse[/b] [/size] Une socket AppleTalk est définie comme la combinaison d'un numéro de réseau, d'un numéro de noeud et d'un numéro de port. [table][row][col]    [/col][col] .nf .ta 4n 20n 32n struct at_addr { u_short s_net; u_char s_node; }; struct sockaddr_atalk { sa_family_t sat_family; /* Famille d'adresse / u_char sat_port; / Port / struct at_addr sat_addr; / noeud / réseau / }; .ta .fi[/col][/row][/table] [i]sat_family[/i] doit toujours être rempli avec [b]AF_APPLETALK. [/b] [i]sat_port[/i] contient le numéro de port. Les numéros inférieurs à 129 sont réservés. Seuls les processus ayant un UID effectif nul ou la capacité [b]CAP_NET_BIND_SERVICE [/b] peut appeler [b]bind (2)[/b] sur ces sockets. [i]sat_addr [/i] est l'adresse de l'hôte. Le membre [i]net[/i] de la structure [b]at_addr[/b] contient le numéro de réseau dans l'ordre des octets du réseau. La valeur [b]AT_ANYNET [/b] est générique et correspond aussi à (lqce réseau(rq. Le membre [i]node[/i] de la structure [b]at_addr[/b] contient le numéro d'hôte. La valeur [b]AT_ANYNODE [/b] est générique, et correspond aussi à (lqcet hôte(rq. La valeur [b]ATADDR_BCAST [/b] est une adresse broadcast locale. [size=18] [b]Options[/b] [/size] Il n'y a pas d'options spécifiques au protocole sur les sockets. [size=18] [b]Sysctls[/b] [/size] Il y a une interface sysctls pour configurer certains paramètres AppleTalk globaux. On peut y accéder en lisant ou écrivant les fichiers [b]/proc/sys/net/atalk/ [/b] ou en utilisant l'appel-système [b]sysctl (2).[/b] [b]aarp-expiry-time[/b] [table][row][col]    [/col][col]L'intervalle de temps (en secondes) avant qu'une entrée du cache AARP expire.[/col][/row][/table] [b]aarp-resolve-time[/b] [table][row][col]    [/col][col]L'intervalle de temps (en secondes) avant qu'une entrée du cache AARP soit résolue.[/col][/row][/table] [b]aarp-retransmit-limit[/b] [table][row][col]    [/col][col]Le nombre de retransmissions d'une demande AARP avant de déclarer le noeud mort.[/col][/row][/table] [b]aarp-tick-time[/b] [table][row][col]    [/col][col]La période (en secondes) de la temporisation dirigeant l'AARP.[/col][/row][/table] Les valeurs par défaut correspondent aux spécifications et ne doivent normalement pas être modifiées. [size=18] [b]Ioctls[/b] [/size] Toutes les ioctls décrites dans la page [b]socket (7) [/b] s'appliquent au ddp. [size=18] [b]Notes[/b] [/size] Soyez très prudents avec l'option [b]SO_BROADCAST ,[/b] elle n'est pas privilégiée sous Linux. Il est facile de surcharger le réseau en écrivant sans faire attention vers des adresses broadcast. [size=18] [b]Versions[/b] [/size] Appletalk est supporté par Linux 2.0 et ultérieurs. L'interface [b]sysctl [/b] est nouvelle dans Linux 2.2. [size=18] [b]Erreurs[/b] [/size] [b]ENOTCONN[/b] [table][row][col]    [/col][col]L'opération n'est définie que sur une socket connectée et ce n'était pas le cas.[/col][/row][/table] [b]EINVAL[/b] [table][row][col]    [/col][col]Argument invalide.[/col][/row][/table] [b]EMSGSIZE [/b] [table][row][col]    [/col][col]Le datagramme est plus grand que le MTU DDP.[/col][/row][/table] [b]EACCES[/b] [table][row][col]    [/col][col]L'utilisateur a essayé d'exécuter une opération sans avoir les permissions adéquates. Ceci inclut l'envoi vers une adresse broadcast sans avoir l'attribut correspondant, ou la tentative d'utilisation de port réservé sans UID effectif nul et sans la capacité [b]CAP_NET_BIND_SERVICE . [/b][/col][/row][/table] [b]EADDRINUSE[/b] [table][row][col]    [/col][col]L'adresse est déjà utilisée.[/col][/row][/table] [b]ENOMEM et ENOBUFS[/b] [table][row][col]    [/col][col]Pas assez de mémoire[/col][/row][/table] [b]ENOPROTOOPT EOPNOTSUPP[/b] [table][row][col]    [/col][col]Option invalide.[/col][/row][/table] [b]EPERM[/b] [table][row][col]    [/col][col]L'utilisateur n'a pas les permissions nécessaires.[/col][/row][/table] [b]EADDRNOTAVAIL[/b] [table][row][col]    [/col][col]On a demandé une interface inexistante, ou l'adresse d'émission réclamée n'est pas locale.[/col][/row][/table] [b]EAGAIN[/b] [table][row][col]    [/col][col]L'opération bloquerait alors que la socket est non-bloquante.[/col][/row][/table] [b]ESOCKTNOSUPPORT[/b] [table][row][col]    [/col][col]La socket n'est pas configurée ou on a demandé un type inconnu.[/col][/row][/table] [b]EISCONN[/b] [table][row][col]    [/col][col]On appelle [b]connect (2)[/b] sur une socket déjà connectée.[/col][/row][/table] [b]EALREADY[/b] [table][row][col]    [/col][col]Une connexion est déjà en cours sur la socket non-bloquante.[/col][/row][/table] [b]ECONNABORTED[/b] [table][row][col]    [/col][col]Une connexion a été refermée pendant la durée de [b]accept (2). [/b][/col][/row][/table] [b]EPIPE[/b] [table][row][col]    [/col][col]La connexion a été fermée par l'interlocuteur.[/col][/row][/table] [b]ENOENT[/b] [b]SIOCGSTAMP [/b] [table][row][col]    [/col][col]a été appelée sur une socket où aucun paquet n'est arrivé.[/col][/row][/table] [b]EHOSTUNREACH[/b] [table][row][col]    [/col][col]Aucune entrée dans la table de routage ne correspond à l'adresse de destination.[/col][/row][/table] [b]ENODEV [/b] [table][row][col]    [/col][col]Périphérique réseau non disponible ou incapable d'envoyer en IP.[/col][/row][/table] [b]ENOPKG [/b] [table][row][col]    [/col][col]Un sous-système du noyau n'est pas configuré.[/col][/row][/table] [size=18] [b]Compatibilité[/b] [/size] L'interface socket AppleTalk de base est compatible avec [b]netatalk [/b] sur les systèmes dérivés de BSD. Plusieurs systèmes BSD peuvent échouer à vérifier [b]SO_BROADCAST[/b] lorsqu'ils envoient des trames broadcast. Ceci peut poser des problèmes de compatibilité. Le mode socket [b]raw[/b] est spécifique à Linux et existe pour supporter le paquetage CAP et les outils de supervision AppleTalk plus facilement. [size=18] [b]Bugs[/b] [/size] Il y a trop de valeurs d'erreurs incohérentes. Les ioctls utilisées pour configurer les tables de routage, les périphériques, et les tables AARP ne sont pas décrites encore. [size=18] [b]Voir aussi[/b] [/size] [b]sendmsg (2), [/b] [b]recvmsg (2), [/b] [b]socket (7)[/b] [size=18] [b]Traduction[/b] [/size] Christophe Blaess, 2000-2003.
Fichier