.\" -*- coding: UTF-8 -*- '\" t .\" Title: script .\" Author: [see the "AUTHOR(S)" section] .\" Generator: Asciidoctor 2.0.15 .\" Date: 2022-08-04 .\" Manual: User Commands .\" Source: util-linux 2.38.1 .\" Language: English .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH SCRIPT 1 "4 août 2022" "util\-linux 2.38.1" "Commandes de l'utilisateur" .ie \n(.g .ds Aq \(aq .el .ds Aq ' .ss \n[.ss] 0 .nh .ad l .de URL \fI\\$2\fP <\\$1>\\$3 .. .als MTO URL .if \n[.g] \{\ . mso www.tmac . am URL . ad l . . . am MTO . ad l . . . LINKSTYLE blue R < > .\} .SH NOM script \- Faire une transcription d'une session d'un terminal. .SH SYNOPSIS .sp \fBscript\fP [\fIoptions\fP] [\fIfichier\fP] .SH DESCRIPTION .sp \fBscript\fP effectue un tapuscrit de tout ce qu'il se passe dans la session de votre terminal. Les données du terminal sont stockées sous une forme brute dans le fichier journal et les informations de temps le sont dans un fichier journal structuré (optionnel). Le fichier journal de temps est nécessaire pour répéter la session, plus tard, avec \fBscriptreplay\fP(1) et pour stocker des informations supplémentaires sur la session. .sp Depuis la version\ 2.35, \fBscript\fP prend en charge plusieurs flux et permet d'enregistrer l'entrée et la sortie dans des fichiers séparés ou dans un seul fichier. Cette version gère aussi un nouveau fichier de temps qui enregistre des informations supplémentaires. La commande \fBscriptreplay\ \-\-summary\fP fournit ensuite toutes les informations. .sp Si le paramètre \fIfichier\fP ou l'option \fB\-\-log\-out\fP\ \fIfichier\fP est fourni, \fBscript\fP sauvegarde l’affichage dans ce \fIfichier\fP. Si aucun nom de fichier n'est fourni, l’affichage est sauvegardé dans le fichier \fItypescript\fP. .sp Remarquez que l'enregistrement des saisies avec \fB\-\-log\-in\fP ou \fB\-\-log\-io\fP peut être une opération sensible au plan de la sécurité, puisque le fichier journal contient toute la saisie de la session en terminal (cela veut dire y compris les mots de passe) indépendamment du positionnement du drapeau \fBECHO\fP du terminal. .SH OPTIONS .sp L’argument \fItaille\fP ci\-dessous peut être suivi des suffixes multiplicatifs KiB=1024, MiB=1024*1024,\ etc., pour GiO, TiO, PiO, EiO, ZiO et YiO (la partie «\ iB\ » est facultative, par exemple «\ K\ » est identique à «\ KiB\ ») ou des suffixes KB=1000, MB=1000*1000,\ etc., pour GO, TO, PO, EO, ZO et YO. .sp \fB\-a\fP, \fB\-\-append\fP .RS 4 Ajouter la transcription à la fin du \fIfichier\fP ou de \fItypescript\fP, en conservant le contenu précédent du fichier. .RE .sp \fB\-c\fP, \fB\-\-command\fP \fIcommande\fP .RS 4 Exécuter la \fIcommande\fP au lieu d’un interpréteur de commandes interactif. Cela facilite la capture de sortie d'un programme qui se comporte différemment si sa sortie est un terminal ou non. .RE .sp \fB\-E\fP, \fB\-\-echo\fP \fIquand\fP .RS 4 Cette option contrôle le drapeau \fBECHO\fP pour l'extrémité esclave du pseudo\-terminal de la session. Les modes pris en charge sont \fIalways\fP, \fInever\fP ou \fIauto\fP. .sp Le mode par défaut est \fIauto\fP \(em dans ce cas, \fBECHO\fP est activé pour l'esclave du pseudo\-terminal. Si l'entrée standard actuelle est un terminal, \fBECHO\fP est désactivé afin d’empêcher un double affichage. Si ce n'est pas un terminal (par exemple un tube\ : \fBecho date | script\fP), alors garder \fBECHO\fP activé pour l'esclave du pseudo\-terminal permet d'afficher les données d'entrée sur l'écran tandis qu'elles sont en même temps enregistrées dans le journal de la session. .sp Remarquez que le mode «\ never\ » affecte le contenu du journal de sortie de la session parce que l'entrée des utilisateurs n'est pas reprise sur la sortie. .RE .sp \fB\-e\fP, \fB\-\-return\fP .RS 4 Renvoyer le code de retour du processus enfant. Le format utilisé est le même que celui de sortie de bash quand il reçoit un signal de fin (c'est\-à\-dire quand le code de retour est 128\ +\ le numéro du signal). Le code de retour du processus enfant est également toujours stocké dans le fichier \fItypescript\fP. .RE .sp \fB\-f\fP, \fB\-\-flush\fP .RS 4 Vider la sortie après chaque demande d'écriture. C'est pratique pour une coopération à distance\ : une personne exécute «\ \fBmkfifo\fP \fItoto\fP; \fBscript \-f\fP\ \fItoto\fP\ » et une autre peut superviser en temps réel ce qui se passe avec «\ \fBcat\fP \fItoto\fP\ ». Remarquez que ce vidage peut impacter les performances, il est possible d'utiliser \fBSIGUSR1\fP pour vider les journaux à la demande. .RE .sp \fB\-\-force\fP .RS 4 Permettre à la destination par défaut, c'est\-à\-dire le fichier \fItypescript\fP, d'être un lien direct ou symbolique. La commande suivra le lien symbolique. .RE .sp \fB\-B\fP, \fB\-\-log\-io\fP \fIfichier\fP .RS 4 Enregistrer l'entrée et la sortie dans le même \fIfichier\fP. Remarquez que cette option n'a de sens que si \fB\-\-log\-timing\fP est également spécifié, sinon il n'est pas possible de séparer les flux d'entrée et de sortie à partir du \fIfichier\fP. .RE .sp \fB\-I\fP, \fB\-\-log\-in\fP \fIfichier\fP .RS 4 Enregistrer l'entrée dans le \fIfichier\fP. La journalisation de la sortie est désactivée si l'option \fB\-\-log\-in\fP est spécifiée seule. .sp Soyez prudent avec cette fonctionnalité de journalisation, car elle enregistre toutes les entrées, y compris lorsque le terminal a le drapeau \fBECHO\fP désactivé (par exemple lors de la saisie d'un mot de passe). .RE .sp \fB\-O\fP, \fB\-\-log\-out\fP \fIfichier\fP .RS 4 Enregistrer la sortie dans le \fIfichier\fP. Par défaut, l'enregistrement de la sortie se fait dans un fichier \fItypescript\fP si l'option \fB\-\-log\-out\fP ou \fB\-\-log\-in\fP n'est pas donnée. L'enregistrement de la sortie est désactivé si \fB\-\-log\-in\fP est spécifiée seule. .RE .sp \fB\-T\fP, \fB\-\-log\-timing\fP \fIfichier\fP .RS 4 Enregistrer les informations de temps dans le \fIfichier\fP. Deux formats de fichiers de temps sont désormais pris en charge. Le format classique est utilisé quand seul l'enregistrement d'un flux (entrée ou sortie) est activé. Le format multi\-flux est utilisé avec \fB\-\-log\-io\fP ou quand \fB\-\-log\-in\fP et \fB\-\-log\-out\fP sont spécifiées en même temps. Voir aussi \fB\-\-logging\-format\fP. .RE .sp \fB\-m\fP, \fB\-\-logging\-format\fP \fIformat\fP .RS 4 Forcer l'utilisation du format \fIadvanced\fP ou \fIclassic\fP. Par défaut, le format classique est utilisé pour n'enregistrer que la sortie et celui avancé l'est quand on veut enregistrer l'entrée et la sortie. .sp \fBLe format classique\fP .RS 4 Le journal contient deux champs séparés par des espaces. Le premier champ indique le temps passé depuis la dernière sortie. Le second champ indique le nombre de caractères ayant été sortis cette fois\-ci. .RE .sp \fBLe format avancé (multi\-flux)\fP .RS 4 Le premier champ est l'identifiant du type d'entrée (\(aqI\(cqnput, \(aqO\(cqutput, \(aqH\(cqeader, \(aqS\(cqignal). Le deuxième champ est la durée écoulée depuis la saisie précédente, et le reste de l’entrée contient des données spécifiques au type. .RE .RE .sp \fB\-o\fP, \fB\-\-output\-limit\fP \fItaille\fP .RS 4 Limiter la taille des fichiers \fItypescript\fP et de temps à \fItaille\fP et arrêter le processus enfant lorsque cette taille est dépassée. La taille du fichier calculée ne tient pas compte des messages de début et de fin ajoutés par la commande \fBscript\fP à la sortie du processus enfant. Du fait d'une mise en tampon («\ buffering\ »), la taille finale du fichier pourrait être plus grande que la valeur indiquée. .RE .sp \fB\-q\fP, \fB\-\-quiet\fP .RS 4 Être silencieux (ne pas écrire les messages de départ ni de fin sur la sortie standard). .RE .sp \fB\-t\fP[\fIfile\fP], \fB\-\-timing\fP[=\fIfichier\fP] .RS 4 Afficher les données de temps sur la sortie d'erreur standard ou dans \fIfichier\fP s'il est indiqué. Cette option est obsolète et remplacée par \fB\-\-log\-timing\fP, où le paramètre \fIfichier\fP n'est pas facultatif. .RE .sp \fB\-h\fP, \fB\-\-help\fP .RS 4 Afficher l’aide\-mémoire puis quitter. .RE .sp \fB\-V\fP, \fB\-\-version\fP .RS 4 Afficher la version puis quitter. .RE .SH SIGNAUX .sp Dès la réception de \fBSIGUSR1\fP, \fBscript\fP écrit immédiatement les fichiers de sortie. .SH ENVIRONNEMENT .sp Les variables d'environnement suivantes sont utilisées par \fBscript\fP\ : .sp \fBSHELL\fP .RS 4 Si la variable d'environnement \fBSHELL\fP existe, l'interpréteur de commandes engendré par \fBscript\fP (avec fork) sera cet interpréteur de commandes. Si \fBSHELL\fP n'est pas définie, l’interpréteur de commandes sera supposé de type Bourne (la plupart des interpréteurs de commandes définissent cette variable automatiquement). .RE .SH NOTES .sp Le script s'arrête quand le sous\-interpréteur de commandes exécuté se termine (un \fBCtrl\-D\fP pour l'interpréteur de commandes de type Bourne comme \fBsh\fP(1p) et \fBexit\fP, \fBlogout\fP ou \fBCtrl\-d\fP (si \fIignoreeof\fP n'est pas définie) pour les interpréteurs de commandes de type\ C comme \fBcsh\fP(1)). .sp Certaines commandes interactives, comme \fBvi\fP(1), créent des parasites dans le fichier de transcription. \fBscript\fP fonctionne mieux avec les commandes qui ne manipulent pas l'écran, les résultats cherchent à émuler un terminal brut. .sp Exécuter \fBscript\fP dans des interpréteurs de commandes non interactifs n’est pas recommandé. L’interpréteur de commandes interne de \fBscript\fP est toujours interactif, et cela pourrait avoir pour conséquence des résultats imprévus. Si vous utilisez \fBscript\fP dans le fichier d’initialisation de l’interpréteur de commandes, évitez d’entrer dans une boucle infinie. Utilisez par exemple le fichier \fB.profile\fP qui n’est lu que par les interpréteurs de commandes de connexion\ : .sp .if n .RS 4 .nf .fam C if test \-t 0 ; then script exit fi .fam .fi .if n .RE .sp Vous devriez aussi éviter l’utilisation de \fBscript\fP dans les tubes de commande, car \fBscript\fP peut lire plus d’entrées que vous pourriez en attendre. .SH HISTORIQUE .sp La commande \fBscript\fP est apparue pour la première fois dans BSD\ 3.0. .SH BOGUES .sp \fBscript\fP place \fItout\fP dans le fichier journal, dont les changements de ligne et les espaces arrière. Ce n'est pas ce à quoi un utilisateur pourrait naïvement s'attendre. .sp \fBscript\fP est d'abord conçu pour des sessions de terminal interactives. Quand l'entrée standard n'est pas un terminal, (par exemple \fIecho\ toto\ |\ script\fP), la session peut se bloquer car l'interpréteur interactif dans la session de script n'a pas de EOF et \fBscript\fP ne sait pas quand fermer la session. Voir la section \fBREMARQUES\fP pour plus d'informations. .SH "VOIR AUSSI" .sp \fBcsh\fP(1) (pour le mécanisme d’\fIhistorique\fP), \fBscriptreplay\fP(1), \fBscriptlive\fP(1), .SH "SIGNALER DES BOGUES" .sp Pour envoyer un rapport de bogue, utilisez le système de gestion des problèmes à l'adresse .URL https://github.com/util\-linux/util\-linux/issues "" . .SH DISPONIBILITÉ .sp La commande \fBscript\fP fait partie du paquet util\-linux, qui peut être téléchargé de .URL https://www.kernel.org/pub/linux/utils/util\-linux/ "Linux Kernel Archive" . .PP .SH TRADUCTION La traduction française de cette page de manuel a été créée par Christophe Blaess , Michel Quercia , Thierry Vignaud , Frédéric Delanoy , Thierry Vignaud , Christophe Sauthier , Sébastien Blanchet, Jérôme Perzyna , Aymeric Nys , Alain Portal , Thomas Huriaux , Yves Rütschlé , Jean-Luc Coulon (f5ibh) , Julien Cristau , Philippe Piette , Jean-Baka Domelevo-Entfellner , Nicolas Haller , Sylvain Archenault , Valéry Perrin , Jade Alglave , Nicolas François , Alexandre Kuoch , Lyes Zemmouche , Florentin Duneau , Alexandre Normand , David Prévot , Jean-Philippe MENGUAL et Jean-Pierre Giraud . .PP Cette traduction est une documentation libre ; veuillez vous reporter à la .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License version 3 .UE concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE. .PP Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à .MT debian-l10n-french@lists.debian.org .ME .