sk98lin(4) Device Drivers Manual sk98lin(4) NOM sk98lin - Pilote Gigabit Ethernet v6.21 pour Marvell/SysKonnect SYNOPSIS insmod sk98lin.o [Speed_A= i,j,...] [Speed_B= i,j,...] [AutoNeg_A= i,j,...] [AutoNeg_B= i,j,...] [DupCap_A= i,j,...] [DupCap_B= i,j,...] [FlowCtrl_A= i,j,...] [FlowCtrl_B= i,j,...] [Role_A= i,j,...] [Role_B= i,j,...] [ConType= i,j,...] [Moderation= i,j,...] [IntsPerSec= i,j,...] [PrefPort= i,j,...] [RlmtMode= i,j,...] DESCRIPTION Note : ce pilote obsolete a ete retire dans Linux 2.6.26. sk98lin est le pilote Gigabit Ethernet pour les cartes coupleurs reseau de Marvell et SysKonnect. Il supporte les adaptateurs Gigabit Ethernet compatibles SK-98xx/SK-95xx de SysKonnect et tout jeu de puces compatibles Yukon. Lors du chargement du pilote avec insmod, les parametres des cartes coupleur reseau devraient etre declares comme une sequence de commandes separees par des virgules. Si, par exemple, deux coupleurs reseau sont installes avec l'auto-negociation sur le port A du premier coupleur positionnee a ON mais le port A du second coupleur positionne a OFF, on doit entrer : insmod sk98lin.o AutoNeg_A=On,Off Apres que sk98lin est attache a une ou plusieurs cartes coupleur et que le systeme de fichiers /proc est monte sur votre systeme, un fichier statistique dedie sera cree dans le repertoire /proc/net/sk98lin pour tous les ports des cartes coupleur reseau installees. Ces fichiers se nomment eth[x], ou x est le numero de l'interface qui a ete affecte par le systeme au port dedie. Lorsque le chargement est acheve, toute adresse IP desiree peut etre affectee a l'interface eth[x] respective en utilisant la commande ifconfig(8). Cela fait que le coupleur se connecte a Ethernet et affiche un message d'etat sur la console disant : << ethx: network connection up using port y >> (ethx : connexion reseau etablie utilisant le port y) suivi par les parametres de connexion configures ou detectes. Le pilote sk98lin supporte les grandes trames (egalement appelees trames jumbo). L'utilisation des trames jumbo peut grandement ameliorer le debit lors du transfert de grandes quantites de donnees. Pour activer les grandes trames, la taille de la MTU (maximum transfer unit) d'une interface doit etre positionnee a une grande valeur. La valeur par defaut de la MTU est de 1500 et peut etre portee a 9000 (octets). La configuration de la taille de la MTU peut etre effectuee lors de l'affectation de l'adresse IP a l'interface ou plus tard, en utilisant la commande ifconfig(8) avec le parametre mtu. Si, par exemple, eth0 a besoin d'une adresse IP et d'une taille de MTU pour grande trame, les deux commandes suivantes peuvent etre utilisees : ifconfig eth0 10.1.1.1 ifconfig eth0 mtu 9000 Ces deux commandes peuvent egalement etre concatenees en une seule : ifconfig eth0 10.1.1.1 mtu 9000 Veuillez noter que les grandes trames ne peuvent etre utilisees que si votre infrastructure reseau le permet. Cela signifie que tous les commutateurs (Ndt : switches) utilises sur votre reseau Ethernet doivent egalement supporter les grandes trames. Nul doute que certains commutateurs acceptent les grandes trames, mais il est necessaire qu'ils soient configures en consequence pour le permettre. La plupart du temps, leur configuration par defaut est de n'accepter que les trames standards avec une taille de MTU de 1500 (octets). En plus des commutateurs a l'interieur du reseau, tous les coupleurs reseau qui doivent etre utilises doivent egalement etre actives pour les trames jumbo. Si un coupleur n'est pas configure pour recevoir de grandes trames, il les rejettera tout simplement. Un retour a la taille standard de trame Ethernet peut etre effectue en utilisant a nouveau la commande ifconfig(8) : ifconfig eth0 mtu 1500 Le pilote Gigabit Ethernet de Marvell/SysKonnect pour Linux est capable de supporter les reseaux locaux virtuels (VLAN) et le << Link Aggregation >> conformement aux normes IEEE 802.1, 802.1q, et 802.3ad. Ces fonctionnalites ne sont disponibles qu'apres l'installation des modules open source que l'on peut trouver sur Internet : VLAN: Link Aggregation: Veuillez noter que Marvell/SysKonnect n'offre aucun support pour ces modules open source et n'accepte aucune responsabilite quels que soient les defaillances ou les problemes pouvant survenir de l'utilisation de ces modules. Parametres Speed_A=i,j,... Ce parametre est utilise pour configurer les possibilites de vitesse du port B d'une carte coupleur. Il est seulement valide pour les coupleurs cuivre de Yukon. Les valeurs possibles sont : 10, 100, 1000 ou Auto, ou Auto est la valeur par defaut. Habituellement, la vitesse est negociee entre les deux ports pendant l'etablissement du lien. Si cela echoue, un port peut etre force a une configuration particuliere avec ce parametre. Speed_B=i,j,... Ce parametre est utilise pour configurer les possibilites de vitesse du port B d'une carte coupleur. Il est seulement valide pour les coupleurs cuivre de Yukon. Les valeurs possibles sont : 10, 100, 1000 ou Auto, ou Auto est la valeur par defaut. Habituellement, la vitesse est negociee entre les deux ports pendant l'etablissement du lien. Si cela echoue, un port peut etre force a une configuration particuliere avec ce parametre. AutoNeg_A=i,j,... Active ou desactive l'utilisation de l'autonegociation du port A d'une carte coupleur. Les valeurs possibles sont : On, Off ou Sense, ou On est la valeur par defaut. Le mode Sense detecte automatiquement si le partenaire du lien gere l'autonegociation ou non. AutoNeg_B=i,j,... Active ou desactive l'utilisation de l'autonegociation du port B d'une carte coupleur. Les valeurs possibles sont : On, Off ou Sense, ou On est la valeur par defaut. Le mode Sense detecte automatiquement si le partenaire du lien gere l'autonegociation ou non. DupCap_A=i,j,... Ce parametre indique le mode duplex a utiliser pour le port A d'une carte coupleur. Les valeurs possibles sont : Half, Full ou Both, ou Both est la valeur par defaut. Ce parametre n'est pertinent que si AutoNeg_A du port A n'est pas positionne a Sense. Si AutoNeg_A est positionne a On, les trois valeurs de DupCap_A ( Half, Full ou Both ) peuvent etre declarees. Si AutoNeg_A est positionne a Off, seules les valeurs de DupCap_A Full et Half sont permises. Ce parametre DupCap_A est pratique si votre partenaire de lien ne gere pas toutes les combinaisons duplex possibles. DupCap_B=i,j,... Ce parametre indique le mode duplex a utiliser pour le port B d'une carte coupleur. Les valeurs possibles sont : Half, Full ou Both, ou Both est la valeur par defaut. Ce parametre n'est pertinent que si AutoNeg_B du port B n'est pas positionne a Sense. Si AutoNeg_B est positionne a On, les trois valeurs de DupCap_B (Half, Full ou Both) peuvent etre declarees. Si AutoNeg_B est positionne a Off, seules les valeurs de DupCap_B Full et Half sont permises. Ce parametre DupCap_B est pratique si votre partenaire de lien ne gere pas toutes les combinaisons duplex possibles. FlowCtrl_A=i,j,... Ce parametre peut etre utilise pour configurer les possibilites de controle de flux que le port signale pendant l'autonegociation. Les valeurs possibles sont : Sym, SymOrRem, LocSend ou None, ou SymOrRem est la valeur par defaut. Les differents modes ont les significations suivantes : Sym = Symmetric Les deux partenaires du lien sont autorises a emettre des trames PAUSE. SymOrRem = SymmetricOrRemote Les deux partenaires du lien ou bien seulement le distant sont autorises a emettre des trames PAUSE. LocSend = LocalSend Seul un partenaire local du lien est autorise a emettre des trames PAUSE. None = None Aucun partenaire du lien n'est autorise a emettre des trames PAUSE. Veuillez noter que ce parametre est ignore si AutoNeg_A est positionne a Off. FlowCtrl_B=i,j,... Ce parametre peut etre utilise pour configurer les possibilites de controle de flux que le port signale pendant l'autonegociation. Les valeurs possibles sont : Sym, SymOrRem, LocSend ou None, ou SymOrRem est la valeur par defaut. Les differents modes ont les significations suivantes : Sym = Symmetric Les deux partenaires du lien sont autorises a emettre des trames PAUSE. SymOrRem = SymmetricOrRemote Les deux partenaires du lien ou bien seulement le distant sont autorises a emettre des trames PAUSE. LocSend = LocalSend Seul un partenaire local du lien est autorise a emettre des trames PAUSE. None = None Aucun partenaire du lien n'est autorise a emettre des trames PAUSE. Veuillez noter que ce parametre est ignore si AutoNeg_B est positionne a Off. Role_A=i,j,... Ce parametre n'est valide que pour les cartes coupleurs 1000Base-T. Pour que deux ports 1000Base-T puissent communiquer, un doit tenir le role du maitre (fournissant l'information d'horloge) pendant que l'autre tient le role d'esclave. Les valeurs possibles sont : Auto, Master ou Slave, ou Auto est la valeur par defaut. Habituellement, le role d'un port est negocie entre deux ports pendant l'etablissement du lien, mais si cela echoue, le port A d'une carte coupleur peut etre force a une configuration specifique avec ce parametre. Role_B=i,j,... Ce parametre n'est valide que pour les cartes coupleurs 1000Base-T. Pour que deux ports 1000Base-T puissent communiquer, un doit tenir le role du maitre (fournissant l'information d'horloge) pendant que l'autre tient le role d'esclave. Les valeurs possibles sont : Auto, Master ou Slave, ou Auto est la valeur par defaut. Habituellement, le role d'un port est negocie entre deux ports pendant l'etablissement du lien, mais si cela echoue, le port B d'une carte coupleur peut etre force a une configuration specifique avec ce parametre. ConType=i,j,... Ce parametre est une combinaison des cinq parametres par port reunis dans un seul parametre. Cela simplifie la configuration des deux ports d'une carte coupleur. Les differentes valeurs de cette variable refletent les combinaisons les plus significatives des parametres des ports. Les valeurs possibles et leur combinaison correspondante de parametres par port sont : ConType DupCap AutoNeg FlowCtrl Role Speed Auto Both On SymOrRem Auto Auto 100FD Full Off Aucun Auto 100 100HD Half Off Aucun Auto 100 10FD Full Off Aucun Auto 10 10HD Half Off Aucun Auto 10 Declarer tout autre parametre de port avec le parametre ConType engendrera une fusion de la configuration de ces reglages. Cela est du au fait que les parametres par port (par exemple Speed_A) ont une priorite plus haute que la variable combinee ConType. Moderation=i,j,... La moderation d'interruption est utilisee pour limiter le nombre maximal d'interruptions que le pilote devra honorer. C'est-a-dire, une ou plusieurs interruptions (qui indique qu'un paquet en transmission ou reception doit etre traite) sont mises en file d'attente jusqu'a ce que le pilote les traite. Lorsque les interruptions mises en file d'attente sont pretes a etre honorees, cela est determine par le parametre IntsPerSec qui sera explique plus loin. Les modes de moderation possibles sont : None, Static ou Dynamic, ou None est la valeur par defaut. Les differents modes ont les significations suivantes : None Aucune moderation d'interruption n'est appliquee sur la carte coupleur. Aussi, chaque interruption en transmission ou reception est immediatement honoree aussitot qu'elle apparait sur la ligne d'interruption de la carte coupleur. Static La moderation d'interruption est appliquee sur la carte coupleur. Toutes les interruptions en transmission ou reception sont mises en file d'attente jusqu'a ce que l'intervalle complet de moderation prenne fin. Lorsqu'un tel intervalle de moderation s'acheve, toutes les interruptions mises en file d'attente sont traitees d'un seul coup, sans delai. Le terme Static reflete le fait que la moderation d'interruption est toujours activee, et ce quelle que soit la charge du reseau sur une interface particuliere. De plus, la duree de l'intervalle de moderation a une longueur fixe qui ne peut jamais etre modifiee tant que le pilote est operationnel. Dynamic La moderation d'interruption peut etre appliquee sur la carte coupleur, suivant la charge du systeme. Si le pilote detecte une charge systeme trop importante, le pilote essaie de proteger le systeme contre une charge reseau trop importante en activant la moderation d'interruption. Si, apres un certain temps, l'utilisation de la CPU decroit (ou si la charge reseau devient negligeable), la moderation d'interruption est automatiquement desactivee. La moderation d'interruption devrait etre utilisee lorsque le pilote doit gerer une ou plusieurs interfaces avec une charge reseau importante, laquelle entraine -- par consequent -- une utilisation importante du CPU. Lorsque la moderation est appliquee a de telles situations de forte charge reseau, la charge de la CPU peut etre reduite de 20 a 30% sur les ordinateurs lents. Veuillez noter que la contrepartie de l'utilisation de la moderation d'interruption est une augmentation du delai aller-retour (RTT), due a la mise en file d'attente et au service des interruptions a des moments de moderation dedies. IntsPerSec=i,j,... Ce parametre determine la longueur de chaque intervalle de moderation d'interruption. En supposant qu'une moderation d'interruption statique soit utilisee, une valeur de 2000 pour le parametre IntsPerSec conduira a un intervalle de moderation d'interruption de 500 microsecondes. Les valeurs possibles pour ce parametre sont comprises entre 30 et 40000 (interruptions par secondes). La valeur par defaut est 2000. Ce parametre n'est utilise que si une moderation d'interruption statique ou dynamique a ete activee sur la carte coupleur reseau. Ce parametre est ignore si aucune moderation n'est appliquee. Veuillez noter que la duree de l'intervalle de moderation doit etre choisie avec soin. Au premier coup d'oeil, choisir une tres longue duree de moderation (par exemple, seulement 100 interruptions par seconde) semble etre significatif, mais l'accroissement du delai de traitement des paquets est enorme. D'un autre cote, choisir un temps de moderation tres court peut compenser l'utilisation d'une moderation a appliquer. PrefPort=i,j,... Ce parametre est utilise pour forcer la preference sur l'un des deux ports A ou B (sur les coupleurs reseau a deux ports). Le port prefere est celui qui est utilise si les deux ports A et B sont detecte comme etant pleinement fonctionnel. Les valeurs possibles sont : A ou B, ou A est la valeur par defaut. RlmtMode=i,j,... RLMT surveille l'etat du port. Si le lien du port actif est defaillant, RLMT bascule immediatement sur le lien en attente. Le lien virtuel est maintenu aussi longtemps qu'au moins un des liens << physiques >> est etabli. Ce parametre declare comment RLMT doit surveiller les ports. Les valeurs possibles sont : CheckLinkState, CheckLocalPort, CheckSeg ou DualNet, ou CheckLinkState est la valeur par defaut. Les differents modes ont les significations suivantes : CheckLinkState Verifie l'etat du lien seulement : RLMT utilise l'etat du lien rapporte par la partie materielle du coupleur pour chacun des ports afin de determiner si un port peut etre utilise pour tout le trafic reseau ou non. CheckLocalPort Dans ce mode, RLMT surveille le lien reseau entre les deux ports d'un coupleur en echangeant de maniere reguliere des paquets entre eux. Ce mode necessite une configuration du reseau dans lequel les deux ports sont capables de se << voir >> mutuellement (c'est-a-dire qu'il ne doit pas y avoir de routeurs entre les ports). CheckSeg Surveille le port local et la segmentation : ce mode supporte les memes fonctions que le mode CheckLocalPort et verifie en plus la segmentation du reseau entre les ports. Ce mode n'est donc utilise que si des commutateurs Gigabit Ethernet sont installes sur le reseau et ont ete configures pour utiliser le protocole << Spanning Tree >>. DualNet Dans ce mode, les ports A et B sont utilises comme des peripheriques separes. Si vous possedez un coupleur avec deux ports, le port A devra etre configure comme eth[x] et le port B comme eth[x+1]. Les deux ports peuvent etre utilises de maniere independante avec des adresses IP distinctes. RLMT est desactive. Veuillez noter que les modes RLMT CheckLocalPort et CheckLinkState sont concus pour operer dans des configurations ou le lien reseau entre les ports d'un coupleur existe. De plus, ils ne sont pas concus pour fonctionner avec des coupleurs connectes dos-a-dos, c.-a-d. directement. FICHIERS /proc/net/sk98lin/eth[x] Le fichier de statistiques d'une interface particuliere d'une carte coupleur contient des informations generiques sur la carte coupleur, ainsi qu'un resume detaille de tous les compteurs de transmission et de reception. /usr/src/linux/Documentation/networking/sk98lin.txt C'est le fichier README du pilote sk98lin. Il contient un guide pratique d'installation detaille et decrit tous les parametres du pilote. Il indique egalement les problemes courants et fournit leurs solutions. BOGUES Signalez les bogues a linux@syskonnect.de (Ndt : en anglais !) VOIR AUSSI ifconfig(8), insmod(8), modprobe(8) TRADUCTION La traduction francaise de cette page de manuel a ete creee par Christophe Blaess , Stephan Rafin , Thierry Vignaud , Francois Micaux, Alain Portal , Jean-Philippe Guerard , Jean-Luc Coulon (f5ibh) , Julien Cristau , Thomas Huriaux , Nicolas Francois , Florentin Duneau , Simon Paillard , Denis Barbier , David Prevot , Cedric Boutillier , Frederic Hantrais et Jean-Pierre Giraud Cette traduction est une documentation libre ; veuillez vous reporter a la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE. Si vous decouvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message a . Pages du manuel de Linux 6.06 31 octobre 2023 sk98lin(4)