site officiel https://wimlib.net/

page des manuels en anglais (je met ici surtout leur traduction)

https://wimlib.net/man1/

• Disposer des droits d'administration.
• Disposer d'une connexion à Internet configurée et activée.
• installé les paquets suivants : wimtools libwim15t64 libwim-dev.

Wimlib contient plusieurs commande qui sont les suivantes

NOM

mkwinpeimg - Créer une image amorçable personnalisée de Windows PE

SYNOPSIS

mkwinpeimg [OPTIONS] IMAGE

DESCRIPTION

mkwinpeimg permet de créer une image amorçable de Windows PE à partir de fichiers extraits d'une image ISO d'installation Windows montée (Vista ou ultérieure), de l'image ISO montée du Kit d'installation automatisée de Windows (WAIK) ou de son supplément. Les options `--windows-dir` et `--waik-dir` permettent de spécifier l'emplacement de ces images ISO montées. Une seule option est nécessaire. mkwinpeimg récupère les fichiers suivants : boot.wim, bootmgr, boot.sdi et bcd. Lors de la création d'une image ISO, le fichier etfsboot.com est également récupéré. Ces fichiers appartiennent à Microsoft et ne sont pas distribués avec wimlib.

mkwinpeimg peut créer deux types d'images amorçables. Par défaut, il s'agit d'une image disque amorçable. Cette image n'est pas partitionnée et est formatée en FAT. La commande `syslinux(1)` est requise pour créer ce type d'image, car elle est utilisée pour le chaînage de bootmgr. De plus, mtools(1) est nécessaire pour créer le système de fichiers FAT sans privilèges root.

mkwinpeimg peut également créer des images amorçables de type ISO. Pour ce faire, utilisez l'option --iso. mkisofs(1) est requis. En mode --iso, vous pouvez spécifier IMAGE comme « - » pour écrire l'image ISO sur la sortie standard.

Une image disque peut être placée sur une clé USB, tandis qu'une image ISO peut être gravée sur un CD. Ces deux types d'images sont compatibles avec les chargeurs d'amorçage SYSLINUX et PXELINUX via le module MEMDISK.

Windows PE est contenu dans le fichier boot.wim. mkwinpeimg peut modifier ce fichier avant de l'intégrer à une image amorçable. La modification la plus utile consiste à spécifier un fichier exécutable ou un fichier batch que Windows PE lancera au démarrage. Utilisez l'option `--start-script FILE` pour spécifier un tel fichier. Vous pouvez également ajouter des fichiers arbitraires à `boot.wim` en les plaçant dans un répertoire, puis en spécifiant l'option `--overlay DIR`. Cependant, pour des modifications plus importantes, il est recommandé de modifier le fichier `boot.wim` séparément à l'aide de `wimmountrw(1)` ou `wimupdate(1)`, puis de le fournir à `mkwinpeimg` avec l'option `--wim`.

Si l'option `--only-wim` est spécifiée, `mkwinpeimg` peut également créer uniquement un fichier `boot.wim` modifié, sans image ISO ou disque amorçable.

OPTIONS

-i, --iso

Créer une image ISO au lieu d'une image disque.

-o, --only-wim

Ne créer ni image disque ni image ISO ; créer uniquement un fichier boot.wim modifié.

-W, --windows-dir=DIR

Utiliser DIR comme emplacement de l'image ISO d'installation Windows montée. Si ni --windows-dir ni --waik-dir ne sont spécifiés, le script recherche l'ISO montée dans les emplacements par défaut suivants : /mnt/windows, /mnt/windows7, /mnt/windows8 et /mnt/windows10.

-A, --waik-dir=DIR

Récupérer les fichiers de démarrage et le fichier boot.wim à partir de l'ISO du Kit d'installation automatisée de Windows (WAIK) monté dans DIR, au lieu d'une image ISO d'installation Windows. Ceci fonctionne également si l'ISO monté correspond au supplément WAIK et non au WAIK lui-même.

-s, --start-script=FICHIER

Ajoute le fichier FICHIER au répertoire racine de l'image Windows PE et modifie le fichier \Windows\System32\winpeshl.ini pour exécuter FICHIER au démarrage de Windows PE.

-w, --wim=WIM

Utilise le fichier WIM comme fichier « boot.wim ». Par défaut, il s'agit du fichier WIM approprié de l'ISO Windows, du WAIK ou du supplément WAIK.

-O, --overlay=RÉPERTOIRE

Ajoute tous les fichiers du répertoire RÉPERTOIRE à l'image Windows PE.

-t, --tmp-dir=RÉPERTOIRE

Utilise le répertoire RÉPERTOIRE pour les fichiers temporaires. Par défaut, il s'agit d'un répertoire créé avec la commande « mktemp -d ».

-a, --arch=ARCH

Utilise la version de Windows PE du Kit d'installation automatisée Windows (ou du supplément WAIK) correspondant à l'architecture du processeur ARCH. Valide uniquement avec l'option --waik-dir. Valeurs possibles : « x86 » ou « amd64 ». Valeur par défaut : « x86 ». Remarque : le WAIK contient également une image Windows PE pour l’architecture ia64 (Itanium) ; toutefois, ce script ne la prend pas en charge.

-h, --help

Afficher l’aide.

-v, --version

Afficher les informations de version.

EXAMPLES

Créez une image disque amorçable de Windows PE à partir du support d'installation de Windows (Vista ou version ultérieure) monté sur /media/windows :

mkwinpeimg --windows-dir=/media/windows winpe.img

Créez une image ISO amorçable de Windows PE à partir du WAIK (ou de son supplément) monté sur /media/waik, et ajoutez tous les fichiers du répertoire « winpe_overlay » au système de fichiers de Windows PE :

mkwinpeimg --iso --waik-dir=/media/waik --overlay=winpe_overlay winpe.iso

Créez une image amorçable de Windows PE à partir du support d'installation de Windows monté sur /media/windows, et configurez-la pour qu'elle exécute « install.cmd » au démarrage. Dans cet exemple, l'image est créée à la racine du serveur TFTP pour le démarrage réseau.

mkwinpeimg --start-script=install.cmd --windows-dir=/media/windows /var/tftpboot/winpe.img

NOM

wimappend - wimappend - ajouter une image WIM

SYNOPSIS

wimappend SOURCE WIMFILE [IMAGE_NAME [IMAGE_DESC]] [OPTION…]

DESCRIPTION

The wimcapture (equivalently: wimlib-imagex capture) and wimappend (equivalently: wimlib-imagex append) commands create ("capture") a new Windows Imaging (WIM) image. wimcapture creates a new WIM archive WIMFILE to contain the new image, while wimappend adds the image to the existing WIM archive WIMFILE (or with --create, creating it if needed).

SOURCE specifies the location of the files from which to create the WIM image. If SOURCE is a directory or a symbolic link pointing to a directory, then the image is captured from that directory as per DIRECTORY CAPTURE (UNIX) or DIRECTORY CAPTURE (WINDOWS). Alternatively, if --source-list is specified, then SOURCE is interpreted as a file containing a list of files and directories to include in the image. Still alternatively, if SOURCE is a UNIX block device, then an image is captured from the NTFS volume on it as per NTFS VOLUME CAPTURE (UNIX).

IMAGE_NAME and IMAGE_DESC specify the name and description to give the new image. If IMAGE_NAME is unspecified, it defaults to the filename component of SOURCE, appending a unique suffix if needed. Otherwise, IMAGE_NAME must be either a name not already used by an image in WIMFILE, or the empty string to create an unnamed image. If IMAGE_DESC is unspecified then the new image is given no description.

If WIMFILE is specified as "-", then the --pipable option is assumed and a pipable WIM is written to standard output (this is a wimlib extension).

OPTIONS

--boot

Marque la nouvelle image comme image « amorçable » du fichier WIM. L’image « amorçable » est celle que le chargeur de démarrage Windows utilisera pour charger Windows PE à partir du fichier WIM.

--check

Inclut des informations d’intégrité supplémentaires dans le fichier WIM résultant. Avec wimappend, vérifie également l’intégrité du fichier WIM avant d’y ajouter des données. Vérifie également l’intégrité des fichiers WIM spécifiés par --update-of et/ou --delta-from.

--include-integrity

Inclut des informations d’intégrité supplémentaires dans le fichier WIM résultant, comme avec --check, mais sans vérification préalable.

--compress=TYPE[:LEVEL]

Avec wimcapture, utilise le format de compression spécifié dans le nouveau fichier WIM. TYPE peut être « none », « XPRESS » (alias : « fast »), « LZX » (alias : « maximum ») ou « LZMS » (alias : « recovery »). La casse n’est pas prise en compte. La valeur par défaut est « LZX ».

Vous pouvez également spécifier un niveau de compression entier. Ce niveau détermine l'intensité de la compression appliquée aux données par l'algorithme de compression du type spécifié. Les valeurs sont graduées de la manière suivante : 20 correspond à une compression rapide, 50 à une compression moyenne et 100 à une compression élevée. Vous pouvez toutefois choisir n'importe quelle valeur. La valeur par défaut est 50.

Cette option affecte uniquement le type de compression utilisé pour les ressources WIM non solides. Si vous créez un fichier WIM solide (avec l'option `--solid`), il est préférable d'utiliser `--solid-compress`.

Soyez prudent si vous choisissez la compression LZMS. Elle n'est pas compatible avec wimlib avant la version 1.6.0, WIMGAPI avant Windows 8, DISM avant Windows 8.1 et 7-Zip avant la version 15.12. Notez également que le choix de la compression LZMS n'implique pas automatiquement une compression en mode solide, contrairement à DISM. Utilisez `--solid` si vous souhaitez créer un fichier WIM solide (ou fichier ESD).

--chunk-size=SIZE

Avec wimcapture, utilisez une taille de bloc de compression de SIZE octets. Une taille de bloc plus importante offre un meilleur taux de compression. wimlib prend en charge différentes tailles de blocs selon le type de compression :

•

XPRESS : 4K, 8K, 16K, 32K, 64K

•

LZX : 32K, 64K, 128K, 256K, 512K, 1M, 2M

•

LZMS : 32K, 64K, 128K, 256K, 512K, 1M, 2M, 4M, 8M, 16M, 32M, 64M, 128M, 256M, 512M, 1G

Vous pouvez indiquer le nombre complet (par exemple, 32768) ou utiliser l’un des suffixes K, M ou G. Les unités KiB, MiB et GiB sont également acceptées.

Cette option affecte uniquement la taille des blocs utilisés dans les ressources WIM non solides. Si vous créez un fichier WIM compact (avec l'option `--solid`), l'option `--solid-chunk-size` est probablement plus adaptée.

Utilisez cette option avec précaution si vous souhaitez une compatibilité avec le logiciel WIM de Microsoft, car ce dernier ne prend en charge que partiellement les tailles de blocs non standard.

--solid

Avec `wimcapture`, créez un fichier WIM « compact » qui compresse les fichiers ensemble plutôt qu'indépendamment. Le taux de compression est ainsi nettement supérieur, mais la compression est lente, avec une consommation de mémoire très élevée, une compatibilité réduite et un accès aléatoire lent au fichier WIM résultant.

Par défaut, cette option active la compression LZMS complète, créant ainsi un fichier équivalent à celui créé avec l'option `/compress:recovery` de DISM. Ces fichiers sont également appelés « fichiers ESD » et ont été pris en charge pour la première fois par WIMGAPI sous Windows 8, par DISM sous Windows 8.1 et par 7-Zip 15.12.

--solid-compress=TYPE[:LEVEL]

Comme --compress, mais définit le type de compression utilisé pour les ressources solides. Par défaut, il s'agit de la compression LZMS. Cette option n'est effective que si --solid est également spécifié.

--solid-chunk-size=SIZE

Comme --chunk-size, mais définit la taille des blocs utilisés pour les ressources solides. Par défaut, avec la compression LZMS, elle est de 64 Mio (67 108 864 octets) ; cela nécessite environ 640 Mio de mémoire par thread. Cette option n'est effective que si --solid est également spécifié. Remarque : le logiciel WIM de Microsoft n'est pas compatible avec les blocs LZMS de taille supérieure à 64 Mio.

--threads=NUM_THREADS

Nombre de threads à utiliser pour la compression des données. Par défaut : détection automatique (nombre de cœurs disponibles).

--rebuild

Avec wimappend, reconstruit l'intégralité du fichier WIM au lieu d'ajouter les nouvelles données à la fin. La reconstruction du fichier WIM est plus lente, mais permet d'économiser de l'espace qui serait autrement perdu. Voir également wimoptimize(1).

--flags=EDITIONID

Spécifiez une chaîne de caractères à utiliser dans l'élément <FLAGS> des données XML de la nouvelle image.

--image-property NAME=VALUE

Attribuez une propriété arbitraire à la nouvelle image dans le document XML du fichier WIM. VALUE est la chaîne de caractères qui définira la valeur de la propriété. NAME est le nom de la propriété de l'image, par exemple « NAME », « DESCRIPTION » ou « TOTALBYTES ». Le nom peut contenir des barres obliques pour indiquer un élément XML imbriqué ; par exemple, « WINDOWS/VERSION/BUILD » indique l'élément BUILD imbriqué dans l'élément VERSION, lui-même imbriqué dans l'élément WINDOWS. Un nombre entre crochets peut être utilisé pour indiquer l'un des nombreux éléments portant le même nom. Par exemple, « WINDOWS/LANGUAGES/LANGUAGE[2] » indique le deuxième élément « LANGUAGE » imbriqué dans l’élément « WINDOWS/LANGUAGES ». Lors de l’ajout d’une liste d’éléments de cette manière, ceux-ci doivent être spécifiés dans l’ordre séquentiel. Notez que Les noms d'éléments sont sensibles à la casse. Cette option peut être spécifiée plusieurs fois.

--dereference

(Systèmes de type UNIX uniquement) Suivre les liens symboliques et archiver les fichiers qu'ils pointent, plutôt que les liens eux-mêmes.

--config=FICHIER

Spécifie un fichier de configuration (encodé en UTF-8 ou UTF-16LE ; l'ASCII simple est également accepté) pour la capture de la nouvelle image. Ce fichier spécifie les fichiers à traiter différemment lors de la capture.

Le format du fichier de configuration est de type INI ; il est donc organisé en sections entre crochets. Actuellement, les sections suivantes sont reconnues :

•

[ExclusionList] : contient une liste de caractères génériques de chemin à exclure de la capture. Si un répertoire correspond, le répertoire et son contenu sont exclus.

•

[ExclusionException] : contient une liste de caractères génériques de chemin à inclure, même si le fichier ou le répertoire correspond également à un caractère générique de [ExclusionList]. Si un répertoire est trouvé, tout son contenu est inclus. Les fichiers ou répertoires situés dans un répertoire exclu par [ExclusionList] peuvent même être inclus grâce à cette option, bien que celle-ci ne fonctionne actuellement qu'avec les correspondances absolues (celles qui commencent par « / » ou « \" »). Par exemple, « /dir/file » peut être inclus tandis que « /dir » peut être exclu, mais inclure simplement « file » ne fonctionnera pas dans ce cas.

•

[PrepopulateList] --- Cette option n'affecte pas la capture, mais si l'image est appliquée ultérieurement avec --wimboot, il s'agit de listes de fichiers qui seront extraits normalement, et non comme des « fichiers de pointage » WIMBoot. Si un répertoire est trouvé, tous les fichiers et sous-répertoires sont également inclus de manière récursive.

Les correspondances de chemin peuvent contenir les métacaractères « * » et « ? ». Les correspondances relatives (par exemple, *.mp3) correspondent à un nom de fichier dans n'importe quel répertoire. Les caractères génériques absolus (par exemple, /dir/file) sont interprétés comme des chemins commençant par le répertoire principal capturé, ou par la racine du volume NTFS en mode de capture de volume NTFS. N'utilisez pas de lettres de lecteur dans les chemins ; elles seront ignorées. Les séparateurs de chemin peuvent être des barres obliques (/) ou des barres obliques inverses (\).

Les lignes commençant par les caractères « # » ou « ; » sont considérées comme des commentaires et ignorées. Les caractères génériques contenant des espaces n'ont pas besoin d'être mis entre guillemets ; toutefois, s'ils le sont, les guillemets simples et doubles sont acceptés.

Si cette option n'est pas spécifiée, le fichier de configuration par défaut suivant est utilisé :

[ExclusionList]
\$ntfs.log
\hiberfil.sys
\pagefile.sys
\swapfile.sys
\System Volume Information
\RECYCLER
\$RECYCLE.BIN
\$Recycle.Bin
\Windows\CSC

Cependant, un comportement particulier s'applique si l'option --wimboot est également spécifiée. Par défaut, avec l'option `--wimboot`, le fichier `Windows/System32/WimBootCompress.ini` du répertoire capturé sera utilisé comme fichier de configuration. Cependant, ce comportement peut être modifié avec l'option `--config` ; celle-ci aura également pour effet d'enregistrer le fichier de configuration spécifié dans l'image WIM sous le nom `Windows/System32/WimBootCompress.ini`, remplaçant ainsi tout fichier de configuration présent sur le système de fichiers.

`--unix-data`

(Systèmes de type UNIX uniquement) : Stocker les métadonnées et fichiers spéciaux spécifiques à UNIX. Cela inclut : les permissions de fichiers UNIX standard (propriétaire, groupe et mode) ; les nœuds de périphériques, les tubes nommés et les sockets ; et les attributs étendus (Linux uniquement). Ces informations peuvent être restaurées ultérieurement par `wimapply` avec l'option `--unix-data`.

Les informations spécifiques à UNIX sont ignorées par le logiciel WIM de Microsoft et par la version Windows de `wimlib`.

`--no-acls`

Ne pas capturer les descripteurs de sécurité des fichiers.

--strict-acls

Échec immédiat si le descripteur de sécurité complet d'un fichier est illisible. Sous Windows, sans cette option, le comportement par défaut consiste d'abord à omettre la liste de contrôle d'accès (SACL) du descripteur de sécurité, puis à omettre complètement le descripteur. L'objectif est de capturer un maximum de données sans exiger systématiquement des privilèges d'administrateur. Toutefois, si vous souhaitez que tous les descripteurs de sécurité soient capturés avec exactitude, vous pouvez activer cette option, même si l'administrateur doit de toute façon disposer des autorisations de lecture nécessaires.

--rpfix, --norpfix

Indique si les cibles des liens symboliques absolus (points de réanalyse dans la terminologie Windows) doivent être corrigées. Activée (--rpfix), cette option ajuste les liens symboliques absolus pointant à l'intérieur de l'arborescence de répertoires capturée pour qu'ils soient absolus par rapport à la racine de cette arborescence. Désactivée (--norpfix), cette option capture les liens symboliques absolus tels quels.

Le comportement par défaut de wimcapture est équivalent à celui de l'option --rpfix. Le comportement par défaut de wimappend est équivalent à --rpfix si des corrections de points de réanalyse ont été préalablement effectuées sur le fichier WIM, sinon à --norpfix.

Dans le cas d'une capture multi-sources (--source-list spécifié), l'utilisation de --norpfix est recommandée. Sinon, les corrections de points de réanalyse seront désactivées pour toutes les sources de capture destinées à des emplacements autres que la racine de l'image WIM, tandis que les sources de capture destinées à la racine du fichier WIM conserveront le comportement par défaut décrit précédemment.

--source-list

wimcapture et wimappend permettent de créer une image WIM à partir de plusieurs fichiers ou répertoires distincts. Lorsque --source-list est spécifié… L'argument SOURCE spécifie le nom d'un fichier texte, dont chaque ligne contient un ou deux chemins de fichiers séparés par des espaces. Le premier chemin, la source, indique le chemin d'accès au fichier ou au répertoire à inclure dans l'image WIM. Il peut être absolu ou relatif au répertoire de travail courant. Le second chemin, s'il est fourni, est la cible et indique le chemin dans l'image WIM où ce fichier ou répertoire sera enregistré. Les barres obliques en début et en fin de la cible sont ignorées, sauf si elle ne contient que des barres obliques (par exemple, « / »), auquel cas le répertoire doit devenir la racine de l'image WIM. Si cet argument est omis, la cible prend par défaut la même valeur que la source.

Voici un exemple de fichier de liste de sources :

# Créer l’image WIM à partir du répertoire « winpe »

winpe

/

# Envoyer le répertoire « overlay » vers « /overlay » dans l’image WIM

overlay

/overlay

# Superposer un répertoire distinct directement à la racine de l’image WIM.

/data/stuff

/
Les sous-répertoires dans l’image WIM sont créés selon les besoins. Plusieurs répertoires sources peuvent partager la même cible, ce qui implique une superposition. Si cela a pour conséquence l’ajout multiple d’un fichier non-répertoire à l’image WIM, la dernière version (telle qu’indiquée dans le fichier de liste de sources) remplace toute version antérieure.

Les chemins de fichiers contenant des espaces peuvent être encadrés par des guillemets simples ou doubles. Les guillemets ne peuvent pas être échappés.

Les lignes ne contenant que des espaces et les lignes commençant par « # » précédé d’espaces facultatifs sont ignorées.

Dans le cas particulier où SOURCE est défini sur « - », la liste des sources est lue depuis l'entrée standard plutôt que depuis un fichier externe.

Le mode de capture de volume NTFS sur les systèmes de type UNIX ne peut pas être utilisé avec l'option --source-list, car seule la capture d'un volume NTFS complet est prise en charge.

--pipable

Avec wimcapture, crée un fichier WIM « pipable » spécifique à wimlib, qui peut être capturé et appliqué de manière entièrement séquentielle. Si WIMFILE est spécifié comme « - », le fichier WIM pipable est écrit directement sur la sortie standard ; sinon, il est écrit sur le disque comme d'habitude. L'image contenue dans le fichier WIM pipable peut ensuite être appliquée avec wimapply, soit depuis le disque, soit depuis l'entrée standard. Une utilisation typique des fichiers WIM pipables consiste à diffuser l'image WIM vers un serveur distant lors de sa capture et/ou à diffuser l'image WIM depuis un serveur distant lors de son application.

De manière générale, toutes les commandes wimlib-imagex fonctionnent avec les fichiers WIM pipables et non pipables. Les fonctions `wimoptimize` et `wimexport` permettent également de convertir des fichiers WIM compatibles avec les flux de données (via `pipe`) en fichiers WIM non compatibles. Cependant, les fichiers WIM compatibles avec les flux de données présentent quelques limitations :

•

Les fichiers WIM compatibles avec les flux de données sont une extension de `wimlib` et ne sont pas compatibles avec le logiciel WIM de Microsoft ni avec d'autres programmes tels que 7-Zip.

•

La fonction `wimappend` permet d'ajouter plusieurs images à un fichier WIM compatible avec les flux de données. Bien que cette fonctionnalité soit prise en charge, elle est moins performante qu'avec les fichiers WIM non compatibles, car un fichier WIM compatible avec les flux de données est entièrement reconstruit à chaque ajout d'image. De plus, lors de l'extraction d'une image à partir d'un tel fichier WIM via `wimapply`, des données inutiles sont transmises via le flux.

•

Bien qu'une image WIM compatible avec les flux de données puisse être mise à jour à l'aide de `wimupdate`, cela nécessite une reconstruction complète du fichier WIM, ce qui la rend moins performante que la mise à jour d'un fichier WIM non compatible.

•

Les fichiers WIM solides compatibles avec les pipelines ne sont pas encore pris en charge.

--not-pipable

Avec wimappend, reconstruisez le fichier WIM au format standard (non compatible avec les pipelines). Cette option est utile uniquement si vous ajoutez une image à un fichier WIM compatible avec les pipelines (voir --pipable) et que vous souhaitez l'obtenir au format standard. Notez que wimoptimize(1) peut également être utilisé pour convertir des fichiers WIM compatibles avec les pipelines entre ces deux formats.

--update-of=[WIMFILE:]IMAGE

L'image capturée ou ajoutée depuis SOURCE est quasiment identique à l'image existante IMAGE dans WIMFILE, mais capturée ultérieurement, et peut-être modifiée entre-temps. Cette option est conçue pour les sauvegardes incrémentales du même système de fichiers ou de la même arborescence de répertoires. IMAGE peut être un index (à partir de 1) ou le nom d'une image existante dans WIMFILE. Il peut également s'agir d'un entier négatif pour remonter dans les images (par exemple, -1 désigne la dernière image présente dans le fichier WIM).

Lorsque cette option est fournie, la capture ou l'ajout de la nouvelle image est optimisé en évitant la lecture des fichiers qui, d'après leurs métadonnées (comme les horodatages), semblent ne pas avoir été modifiés depuis leur archivage dans l'image existante. Hormis la manipulation des horodatages, cette option n'affecte que les performances et ne modifie pas l'image WIM résultante (voir toutefois la note ci-dessous).

Comme indiqué, la syntaxe complète de l'argument de cette option consiste à spécifier le fichier WIM, deux points, puis l'image ; par exemple : « --update-of mywim.wim:1 ». Cependant, le fichier WIM et les deux points peuvent être omis si l'option `--delta-from` est spécifiée une seule fois, auquel cas le fichier WIM par défaut est celui spécifié dans `--delta-from`, ou si l'opération est `wimappend` plutôt que `wimcapture`, auquel cas le fichier WIM par défaut est celui auquel on ajoute l'image.

Remarque : dans la version Windows de wimlib, il a été observé que - Le mode `-update-of` n'est pas totalement fiable pour détecter les modifications de contenu des fichiers, ce qui peut parfois entraîner l'archivage de l'ancien contenu de certains fichiers au lieu du contenu actuel. Ce problème est dû au fait que Windows ne met pas à jour immédiatement l'horodatage de dernière modification d'un fichier après chaque écriture. Malheureusement, il n'existe aucun moyen connu pour les applications comme wimlib de contourner automatiquement ce bug. Des solutions manuelles sont possibles : en théorie, toute action entraînant la fermeture des fichiers concernés, comme le redémarrage des applications ou de l'ordinateur, devrait mettre à jour l'horodatage de dernière modification des fichiers. Notez également que wimlib compare la taille des fichiers autant que leur horodatage pour déterminer si un fichier a été modifié, ce qui contribue à réduire la probabilité d'apparition du problème ; ce problème ne se produit pas sur d'autres systèmes d'exploitation comme Linux, qui conservent correctement l'horodatage de dernière modification des fichiers.

--delta-from=WIMFILE

Capture ou ajoute la nouvelle image en tant que « delta » à partir de WIMFILE. Les données de fichiers qui devraient normalement être archivées dans le nouveau fichier WIM ou le fichier WIM mis à jour sont omises si elles sont déjà présentes dans le fichier WIM d'origine. Le fichier WIM résultant contiendra toujours une copie complète des métadonnées de l'image, mais cela ne représente généralement qu'une petite fraction de sa taille totale.

Cette option peut être spécifiée plusieurs fois ; dans ce cas, le fichier WIM delta résultant ne contiendra que les données de fichiers absentes des fichiers WIM d'origine spécifiés.

Pour utiliser d'autres commandes, telles que `wimapply`, sur le fichier WIM delta résultant, vous devez le spécifier comme fichier WIM cible, et référencer le ou les fichiers WIM d'origine avec l'option `--ref`. Attention : pour garantir le bon fonctionnement du fichier WIM delta, vous pouvez uniquement ajouter des fichiers et des images au(x) fichier(s) WIM d'origine après la capture d'un delta.

L'option `--delta-from` peut être combinée avec `--update-of` pour accélérer la capture d'un fichier WIM delta.

Prenons l'exemple de la séquence de sauvegarde et de restauration suivante :

(sauvegarde initiale)

$ wimcapture /some/directory bkup-base.wim

(quelques jours plus tard, création d'une seconde sauvegarde delta)

$ wimcapture /some/directory bkup-2013-08-20.dwm \

--update-of bkup-base.wim:-1 --delta-from bkup-base.wim

(restauration de la seconde sauvegarde)

$ wimapply bkup-2013-08-20.dwm --ref=bkup-base.wim 1 \

/some/directory

Notez toutefois qu'il est possible, en alternative à la séquence ci-dessus utilisant un fichier WIM delta, d'ajouter simplement la seconde sauvegarde à la fin du fichier WIM sous forme de nouvelle image à l'aide de la commande wimappend. Les fichiers WIM delta ne doivent être utilisés que si l'on souhaite baser les sauvegardes ou les images sur un fichier volumineux distinct, rarement modifié.

L'option `--delta-from` est prise en charge par `wimcapture` et `wimappend`.

Les fichiers WIM delta sont compatibles avec le logiciel WIM de Microsoft. Par exemple, vous pouvez utiliser l'option `/ref` d'ImageX pour référencer le ou les fichiers WIM de base, comme indiqué précédemment.

Remarque supplémentaire : `wimlib` est suffisamment généralisé pour permettre la combinaison des options `--pipable` et `--delta-from` afin de créer des fichiers WIM delta pouvant être transmis par tube. Dans ce cas, le ou les fichiers WIM de base doivent être capturés comme pouvant être transmis par tube, tout comme le fichier WIM delta. Lors de l'application d'une image, le ou les fichiers WIM de base doivent être envoyés par tube après le fichier WIM delta.

`--wimboot`

Indique que l'image est compatible avec WIMBoot. Consultez la documentation Microsoft pour plus d'informations sur WIMBoot. Avec `wimcapture`, cette option définit le type de compression sur XPRESS et la taille des blocs sur 4 096 octets ; ces valeurs peuvent toutefois être modifiées à l'aide des paramètres `--compress` et `--chunk-size`, respectivement. De plus, cette option définit le fichier de configuration sur SOURCE\Windows\System32\WimBootCompress.ini s'il existe et est accessible ; toutefois, ce comportement peut être modifié via le paramètre --config.

--unsafe-compact

Avec wimappend, la compression de l'archive WIM se fait sur place et les nouvelles données y sont ajoutées, éliminant ainsi les « trous ». Cette méthode est efficace, mais il est généralement déconseillé d'utiliser cette option, car une compression interrompue ou ayant échoué corrompt l'archive WIM. Pour plus d'informations, consultez la documentation de cette option sur wimoptimize(1).

--snapshot

Crée un instantané temporaire du système de fichiers du répertoire source et capture les fichiers à partir de cet instantané. Actuellement, cette option est uniquement prise en charge sous Windows, où elle utilise le service VSS (Volume Shadow Copy Service). Grâce à cette option, vous pouvez créer une sauvegarde cohérente du volume système d'un système Windows en cours d'exécution sans rencontrer de problèmes liés aux fichiers verrouillés. Pour que le snapshot VSS soit créé correctement, wimlib-imagex doit être exécuté en tant qu'administrateur et ne peut pas être exécuté en mode WoW64 (c'est-à-dire que si Windows est en 64 bits, wimlib-imagex doit également l'être).

--create

Avec wimappend, si le fichier WIM n'existe pas encore, il est créé (comme wimcapture).

EXAMPLES

Premier exemple : Créez un nouveau fichier WIM « mywim.wim » compressé en LZX (« maximum ») contenant une image de l’arborescence de répertoires « somedir ». Notez que le nom de l’image n’a pas besoin d’être spécifié et sera par défaut « somedir » :

wimcapture somedir mywim.wim

Ensuite, ajoutez l’image d’une autre arborescence de répertoires au fichier WIM créé précédemment :

wimappend anotherdir mywim.wim

C’est très simple, et les exemples ci-dessus de création d’images d’arborescences de répertoires fonctionnent aussi bien sur les systèmes de type UNIX que sur Windows. Ensuite, capturez un fichier WIM avec plusieurs options non standard, notamment la compression XPRESS (« rapide »), des informations d'intégrité supplémentaires, la préservation des liens symboliques absolus, ainsi qu'un nom et une description pour l'image :

wimcapture somedir mywim.wim --compress=fast \

--check --norpfix "Some Name" "Some Description"

Sur un système de type UNIX, capturez un volume NTFS complet dans un nouveau fichier WIM en utilisant le mode NTFS VOLUME CAPTURE (UNIX), et nommez l'image « Windows 7 » :

wimcapture /dev/sda2 windows7.wim "Windows 7"

Ou, sous Windows, pour capturer un volume NTFS complet, vous devez spécifier le répertoire racine du volume monté, par exemple :

wimcapture E:\ windows7.wim "Windows 7"

Identique à l'exemple UNIX ci-dessus, mais capturez le fichier WIM au format « pipable » spécifique à wimlib, qui peut être transmis à wimapply :

wimcapture /dev/sda2 windows7.wim "Windows 7" --pipable

Comme précédemment, mais au lieu d'écrire le fichier WIM pipable dans le fichier « windows7.wim », écrivez-le directement sur la sortie standard via un tube vers un autre programme « someprog », qui pourrait être, par exemple, un programme ou un script qui diffuse les données vers un serveur :

wimcapture /dev/sda2 - "Windows 7" | someprog