Manpages

NOM

cytune − Configurer les paramètres du pilote pour cartes séries multiports Cyclades−Z.

SYNOPSIS

cytune [−q [−i intervalle]] [{−s|−S} valeur] [−g|−G] [{−t|−T} timeout] tty...

DESCRIPTION

cytune récupère et modifie le seuil d’interruptions du pilote Cyclades. Chaque ligne série d’une carte Cyclades possède une FIFO de 12 octets pour les entrées (et une autre FIFO de 12 octets pour les sorties). Le « seuil » spécifie combien de caractères doivent être présents dans la FIFO avant qu’une interruption soit levée. Quand un terminal (tty) Cyclades est ouvert, le seuil est remis à sa valeur par défaut, basée sur la vitesse de la ligne :

Baud Seuil

50−4800 10
9600 8
19200 4
38400 2
57600−150000 1

Si le seuil est fixé à une valeur trop basse, un grand nombre d’interruption peut charger la machine et réduire les performances globales du système. Si le seuil est trop haut, le tampon de la FIFO peut déborder et des caractères peuvent être perdus. Les machines les plus lentes ne peuvent pas prendre en charge un taux d’interruption trop élevé et nécessiteront que le seuil soit ajusté vers le haut.

Si le pilote cyclades a été compilé avec ENABLE_MONITORING de définie, la commande cytune peut être utilisée avec l’option −q pour surveiller les interruptions et caractères reçus dans l’intervalle de surveillance. L’état de la FIFO sera également affiché. Le nombre maximum de caractères présents dans la FIFO quand les interruptions ont été levées, le nombre maximum de caractères trouvés dans la FIFO à un instant donné et le nombre de caractères se trouvant dans la FIFO. La sortie ressemblera à ceci :

/dev/cubC0: 830 ints, 9130 chars; fifo: 11 threshold, 11 max, 11 now
166.259866 interrupts/second, 1828.858521 characters/second

Cette sortie indique que pour cette période de surveillance, les interruptions étaient toujours traitées avant l’arrivée du caractère suivant puisque max n’est pas suppérieur au seuil (threshold). C’est bien, et vous pouvez probablement continuer de cette façon, en supposant que les caractères continueront à arriver de cette façon. Vous perdrez des caractères si la FIFO déborde, le matériel Cyclades ne supportant pas les signaux RTS des lignes RS−232 pour le contrôle de flux matériel entre le périphérique et l’ordinateur.

Quand il est utilisé pour récupérer les informations, cytune fournit un petit rapport quand il se termine par un SIGINT ou quand le seuil ou la temporisation est modifiée.

Il faut faire un choix entre le temps de réponse et le débit. La carte Cyclades, pour les vitesse les plus élevées, est capable de mettre une charge d’interruptions très élevée sur le système. Ceci réduira les ressources CPU disponibles pour les autres tâches du système. Cependant, le temps mis pour répondre à un caractère peut être augmenté si vous augmentez le seuil. Ceci peut être visualisé en observant les temps de ping(8) sur un lien SLIP contrôlé par une carte Cyclades. Si votre lien SLIP est généralement utilisé pour des travaux interactifs tels que telnet(1), vous pouvez vouloir un seuil bas, de telle sorte que les réponses aux caractères soient aussi rapide que possible. Si votre lien SLIP est généralement utilisé pour transférer des fichiers, naviguer sur le WEB et autres, augmenter la valeur permettra de limiter la charge sur le système, sans pour autant réduire le débit significativement. Autrement, consultez les options −t ou −T pour ajuster le temps que le pilote Cyclades doit attendre avant de vider sa mémoire tampon. L’unité est de 5 ms.

Si vous utilisez une souris sur un port Cyclades, vous souhaiterez certainement maintenir un seuil et une temporisation basse.

OPTIONS

−s valeur

Fixer le seuil courant à valeur caractères. Notez que si le tty n’est pas maintenu ouvert par un autre processus, le seuil sera remis à zéro à la prochaine ouverture. Seules les valeurs entre 1 et 12, incluses, sont autorisées.

−t valeur

Définir la temporisation pour le vidage à valeur unités. Notez que si le tty n’est pas maintenu ouvert par un autre processus, le seuil sera remis à zéro à la prochaine ouverture. Seules les valeurs entre 0 et 255, incluses, sont permises. Fixer la valeur à zéro force la valeur par défaut, actuellement 0x20 (160ms), mais elle devrait passer à 0x02 (10ms). L’unité est de 5 ms.

−S valeur

Fixer le seuil courant à valeur caractères. Notez que si le tty est de nouveau ouvert, cette valeur sera utilisée à la place de la valeur par défaut. Seules les valeurs entre 1 et 12, incluses, sont autorisées.

−T valeur

Définir la temporisation pour le vidage à valeur unités. Quand le tty est ouvert par la suite, cette valeur sera utilisée à la place de la valeur par défaut. Si la valeur est zéro, alors la valeur par défaut 0x20 (160ms) sera utilisée ; cette valeur sera prochainement 0x02 (10ms).

−i intervalle

La récupération des statistiques se fera toutes les intervalle secondes.

BOGUES

Si vous exécutez deux copies de cytune en même temps pour afficher les statistiques du même port, les valeurs de « ints », « chars » et « max » seront remises à zéro et ne seront pas correctes. cytune devrait se protéger contre cela, mais ne le fait pas.

FICHIERS

/dev/ttyC[0−8]
/dev/cubC[0−8]

VOIR AUSSI

setserial(8)

DISPONIBILITÉ

La commande cytune fait partie du paquet util−linux−ng, elle est disponible sur ftp://ftp.kernel.org/pub/linux/utils/util−linux−ng/.