Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

dd

Some strings on this page have not been translated yet. You can help by translating them on Weblate.
v(uutils coreutils) 0.8.0
dd [OPÉRANDE]...
dd OPTION

Copier, et optionnellement convertir, une ressource du système de fichiers

Options

Opérandes

  • bs=OCTETS : lire et écrire jusqu’à OCTETS octets à la fois (par défaut : 512) ; remplace ibs et obs.

  • cbs=OCTETS : la ‘taille de bloc de conversion’ en octets. S’applique aux opérations conv=block et conv=unblock.

  • conv=CONVS : une liste séparée par des virgules d’options de conversion ou (pour des raisons historiques) d’indicateurs de fichier.

  • count=N : arrêter la lecture de l’entrée après N opérations de lecture de taille ibs plutôt que de continuer jusqu’à EOF. Voir iflag=count_bytes si l’arrêt après N octets est préféré

  • ibs=N : la taille du tampon utilisé pour les lectures (par défaut : 512)

  • if=FICHIER : le fichier utilisé pour l’entrée. Quand non spécifié, stdin est utilisé à la place

  • iflag=INDICATEURS : une liste séparée par des virgules d’indicateurs d’entrée qui spécifient comment la source d’entrée est traitée. INDICATEURS peut être n’importe lequel des indicateurs d’entrée ou indicateurs généraux spécifiés ci-dessous.

  • skip=N (ou iseek=N) : ignorer N enregistrements de taille ibs dans l’entrée avant de commencer les opérations de copie/conversion. Voir iflag=seek_bytes si la recherche de N octets est préférée.

  • obs=N : la taille du tampon utilisé pour les écritures (par défaut : 512)

  • of=FICHIER : le fichier utilisé pour la sortie. Quand non spécifié, stdout est utilisé à la place

  • oflag=INDICATEURS : liste séparée par des virgules d’indicateurs de sortie qui spécifient comment la source de sortie est traitée. INDICATEURS peut être n’importe lequel des indicateurs de sortie ou indicateurs généraux spécifiés ci-dessous

  • seek=N (ou oseek=N) : recherche N enregistrements de taille obs dans la sortie avant de commencer les opérations de copie/conversion. Voir oflag=seek_bytes si la recherche de N octets est préférée

  • status=NIVEAU : contrôle si les statistiques de volume et de performance sont écrites sur stderr.

    Quand non spécifié, dd affichera les statistiques à la fin. Un exemple est ci-dessous.

      6+0 enregistrements en entrée
      16+0 enregistrements en sortie
      8192 octets (8.2 kB, 8.0 KiB) copiés, 0.00057009 s,
      14.4 MB/s
    
    Les deux premières lignes sont les statistiques de 'volume' et la dernière ligne est les
    statistiques de 'performance'.
    Les statistiques de volume indiquent le nombre de lectures complètes et partielles de taille ibs,
    ou d'écritures de taille obs qui ont eu lieu pendant la copie. Le format des statistiques de
    volume est <complètes>+<partielles>. Si des enregistrements ont été tronqués (voir
    conv=block), les statistiques de volume contiendront le nombre d'enregistrements tronqués.
    
    Les valeurs possibles de NIVEAU sont :
    - progress : Afficher les statistiques de performance périodiques pendant la copie.
    - noxfer : Afficher les statistiques de volume finales, mais pas les statistiques de performance.
    - none : N'afficher aucune statistique.
    
    L'affichage des statistiques de performance est aussi déclenché par le signal INFO (quand supporté),
    ou le signal USR1. Définir la variable d'environnement POSIXLY_CORRECT à n'importe quelle valeur
    (y compris une valeur vide) fera ignorer le signal USR1.
    
    

Options de conversion

  • ascii : convertir d’EBCDIC vers ASCII. C’est l’inverse de l’option ebcdic. Implique conv=unblock.

  • ebcdic : convertir d’ASCII vers EBCDIC. C’est l’inverse de l’option ascii. Implique conv=block.

  • ibm : convertir d’ASCII vers EBCDIC, en appliquant les conventions pour [, ] et ~ spécifiées dans POSIX. Implique conv=block.

  • ucase : convertir de minuscules vers majuscules.

  • lcase : convertir de majuscules vers minuscules.

  • block : pour chaque nouvelle ligne inférieure à la taille indiquée par cbs=OCTETS, supprimer la nouvelle ligne et remplir avec des espaces jusqu’à cbs. Les lignes plus longues que cbs sont tronquées.

  • unblock : pour chaque bloc d’entrée de la taille indiquée par cbs=OCTETS, supprimer les espaces de fin à droite et remplacer par un caractère de nouvelle ligne.

  • sparse : tente de rechercher la sortie quand un bloc de taille obs ne contient que des zéros.

  • swab : échange chaque paire d’octets adjacents. Si un nombre impair d’octets est présent, l’octet final est omis.

  • sync : remplit chaque bloc de taille ibs avec des zéros. Si block ou unblock est spécifié, remplit avec des espaces à la place.

  • excl : le fichier de sortie doit être créé. Échoue si le fichier de sortie est déjà présent.

  • nocreat : le fichier de sortie ne sera pas créé. Échoue si le fichier de sortie n’est pas déjà présent.

  • notrunc : le fichier de sortie ne sera pas tronqué. Si cette option n’est pas présente, la sortie sera tronquée à l’ouverture.

  • noerror : toutes les erreurs de lecture seront ignorées. Si cette option n’est pas présente, dd n’ignorera que Error::Interrupted.

  • fdatasync : les données seront écrites avant la fin.

  • fsync : les données et les métadonnées seront écrites avant la fin.

Indicateurs d’entrée

  • count_bytes : une valeur pour count=N sera interprétée comme des octets.
  • skip_bytes : une valeur pour skip=N sera interprétée comme des octets.
  • fullblock : attendre ibs octets de chaque lecture. les lectures de longueur zéro sont toujours considérées comme EOF.

Indicateurs de sortie

  • append : ouvrir le fichier en mode ajout. Considérez définir conv=notrunc aussi.
  • seek_bytes : une valeur pour seek=N sera interprétée comme des octets.

Indicateurs généraux

  • direct : utiliser les E/S directes pour les données.
  • directory : échouer sauf si l’entrée donnée (si utilisée comme iflag) ou la sortie (si utilisée comme oflag) est un répertoire.
  • dsync : utiliser les E/S synchronisées pour les données.
  • sync : utiliser les E/S synchronisées pour les données et les métadonnées.
  • nonblock : utiliser les E/S non-bloquantes.
  • noatime : ne pas mettre à jour l’heure d’accès.
  • nocache : demander au système d’exploitation de supprimer le cache.
  • noctty : ne pas assigner un tty de contrôle.
  • nofollow : ne pas suivre les liens système.

Examples

The examples have not been translated yet and are shown in English. You can help by translating them on tldr-pages.

Make a bootable USB drive from an isohybrid file (such as archlinux-xxx.iso) and show the progress:

dd if={{path/to/file.iso}} of={{/dev/usb_drive}} status=progress

Clone a drive to another drive with 4 MiB block size and flush writes before the command terminates:

dd bs=4194304 conv=fsync if={{/dev/source_drive}} of={{/dev/dest_drive}}

Generate a file with a specific number of random bytes by using kernel random driver:

dd bs={{100}} count={{1}} if=/dev/urandom of={{path/to/random_file}}

Benchmark the sequential write performance of a disk:

dd bs={{1024}} count={{1000000}} if=/dev/zero of={{path/to/file_1GB}}

Create a system backup, save it into an IMG file (can be restored later by swapping if and of), and show the progress:

dd if={{/dev/drive_device}} of={{path/to/file.img}} status=progress

The examples are provided by the tldr-pages project under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.