Man page 8 : rmt-tar

rmt - Module de gestion distante des bandes magnétiques

rmt

Rmt est un programme utilisé par tar, cpio, mt, et les versions distantes des programmes dump et restore pour la gestion des bandes magnétiques à travers une communication interprocessus. Rmt est généralement démarré avec un appel à rexec(3) ou rcmd(3) , ou bien par la commande rsh(1) .

Le programme rmt accepte les ordres spécifiques à la gestion des bandes magnétiques, exécute les commandes, puis en rend compte par un code de retour. Tous les comptes-rendus sont en .Tn ASCII et correspondent à une des deux formes décrites ci-après. Le résultat des commandes réalisées correctement est :

d -filled -offset indent .Sm off .Sy A Ar nombre No \n .Sm on

où Nombre est la représentation .Tn ASCII d'un nombre décimal. Le résultat des commandes qui ont échoué est :

d -filled -offset indent .Sm off .Xo Sy E Ar numéro_d'erreur \n Ar message_d'erreur \n .Xc .Sm on

numéro_d'erreur est un des numéros d'erreurs possibles, tels que décrit dans intro(2) . message_d'erreur représente la chaîne de caractères correspondant à celle résultant d'un appel à perror(3) . Le protocole est composé des commandes suivantes, qui sont envoyées comme indiqué. Aucune espace n'est insérée entre la commande et ses paramètres, ni entre les paramètres. .Ql \n indique qu'un retour à la ligne doit être inséré :

-tag -width Ds .Sm off
Sy O périphérique \n Ar mode No \n .Xc Ouvre le périphérique indiqué en utilisant le mode indiqué. Périphérique est un nom de chemin complet et mode est la représentation .Tn ASCII d'un nombre décimal accepté par open(2) . Si le périphérique est déjà ouvert, il est fermé avant qu'une nouvelle ouverture soit effectuée.
Sy C Périphérique No \n .Xc Ferme le périphérique actuellement ouvert. L'indication du Périphérique est ignorée.
Sy L déplacement No \n point-de-départ No \n .Xc .Sm on Exécute une opération lseek(2) en utilisant les paramètres indiqués. La valeur de retour est celle renvoyée par l'appel à lseek . .Sm off
Sy W nombre No \n .Sm on Écrit des données sur le périphérique ouvert. Rmt lit nombre d'octets depuis la connexion et abandonne si une fin-de-fichier prématurée est rencontrée. La valeur de retour est celle renvoyée par l'appel à write(2) . .Sm off
Sy R nombre No \n .Sm on Lit nombre d'octets sur le périphérique ouvert. Si nombre dépasse la taille du tampon (10 Kio), la lecture est tronquée à la taille du tampon. rmt exécute un read(2) et renvoie le .Sm off .Sy A Ar nombre-d'octets-lus No \n .Sm on si la lecture a réussi. En cas d'échec, une erreur au format standard est renvoyée. Si la lecture a réussi, les données lues sont ensuite transmises. .Sm off
Sy I opération \n Ar nombre No \n .Xc .Sm on Exécute une commande .Dv MTIOCOP ioctl(2) avec les paramètres spécifiés. Les paramètres sont interprétés en tant que représentation .Tn ASCII des valeurs attendues dans les champs mt_op et mt_count de la structure utilisée lors de l'appel à ioctl . La valeur de retour correspond au paramètre nombre si l'opération réussit.
Sy S Renvoie l'état du périphérique ouvert, comme avec un appel à .Dv MTIOCGET ioctl . Si l'opération réussit, un « ack » est envoyé avec la taille du tampon d'état, puis le tampon d'état est envoyé (en binaire). .Sm on

Toute autre commande provoque l'arrêt de rmt .

Toutes les valeurs de retour sont de la forme décrite ci-dessus.

tar(1) , cpio(1) , mt(1) , rsh(1) , rcmd(3) , rexec(3) , mtio(4) , rdump(8) , rrestore(8)

Les gens devraient éviter d'utiliser cette commande en tant que protocole d'accès distant aux fichiers.

La commande apparaît dans

x 4.2 .

Cette page de manuel a été traduite par Jérome Signouret en 2000 et mise à jour par Christophe Blaess en 2003. Elle a également été relue par Gérard Delafond. Elle est dorénavant maintenue par Valéry Perrin <valery DOT perrin DOT debian AT free DOT fr> et les membres de la liste <debian-l10n-french AT lists DOT debian DOT org>. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le paquet manpages-fr-extra.