virt-edit - En ligne dans le Cloud

PROGRAMME:

Nom

virt-edit - Modifier un fichier dans une machine virtuelle

SYNOPSIS

virt-edit [--options] -d domname fichier [fichier ...]

virt-edit [--options] -a disk.img [-a disk.img ...] fichier [fichier ...]

virt-edit [-d domname|-a disk.img] fichier -e 'expr'

À l'ancienne :

virt-edit fichier domname

fichier virt-edit disk.img [disk.img ...]

ATTENTION

En utilisant "virt-edit" sur des machines virtuelles en direct, ou en parallèle avec d'autres outils d'édition de disque,
peut être dangereux et potentiellement endommager le disque. La machine virtuelle doit être fermée
down avant d'utiliser cette commande, et les images disque ne doivent pas être modifiées simultanément.

DESCRIPTION

"virt-edit" est un outil en ligne de commande pour éditer un "fichier" où chaque "fichier" existe dans le nom
machine virtuelle (ou image disque).

Plusieurs noms de fichiers peuvent être donnés, auquel cas ils sont chacun édités à tour de rôle. Chaque
le nom de fichier doit être un chemin complet, commençant au répertoire racine (commençant par '/').

Si vous souhaitez simplement afficher un fichier, utilisez chat-virt (1).

Pour les cas plus complexes, vous devriez regarder le poisson invité(1) outil (voir "UTILISATION DE GUESTFISH"
ci-dessous).

"virt-edit" ne peut pas être utilisé pour créer un nouveau fichier. poisson invité(1) peut faire cela et bien plus encore.

EXEMPLES

Modifiez les fichiers nommés de manière interactive :

virt-edit -d mondomaine /boot/grub/grub.conf

virt-edit -d mondomaine / Etc / passwd

Pour les invités Windows, certains chemins Windows sont compris :

virt-edit -d mondomainewin 'c:\autoexec.bat'

Si Perl est installé, vous pouvez également éditer les fichiers de manière non interactive (voir "NON-INTERACTIVE
EDITING" ci-dessous). Pour changer le niveau d'initialisation par défaut à 5 :

virt-edit -d mondomaine /etc/inittab -e 's/^id:.*/id:5:initdefault:/'

OPTIONS

--Aidez-moi
Afficher une brève aide.

-a filet
--ajouter filet
Ajoutez des effets de filet qui devrait être une image disque d'une machine virtuelle. Si la machine virtuelle
a plusieurs périphériques de bloc, vous devez tous les fournir avec des -a options.

Le format de l'image disque est détecté automatiquement. Pour outrepasser cela et forcer un
format particulier utiliser le --format=.. option.

-a URI
--ajouter URI
Ajoutez un disque distant. Voir « AJOUT DE STOCKAGE À DISTANCE » dans poisson invité (1).

-b l'extension de
--sauvegarde l'extension de
Créer une sauvegarde du fichier d'origine in le invité disque image. La sauvegarde a le
nom de fichier d'origine avec "extension" ajouté.

Habituellement, le premier caractère de "extension" serait un point "." donc tu écrirais :

virt-edit -b .orig [etc]

Par défaut, aucun fichier de sauvegarde n'est créé.

-c URI
--relier URI
Si vous utilisez libvirt, connectez-vous au URI. S'il est omis, nous nous connectons au
hyperviseur libvirt par défaut.

Si vous spécifiez directement les périphériques de bloc invité, libvirt n'est pas du tout utilisé.

-d invité
--domaine invité
Ajoutez tous les disques de l'invité libvirt nommé. Les UUID de domaine peuvent être utilisés à la place de
des noms.

--echo-touches
Lorsque vous demandez des clés et des phrases de passe, virt-edit désactive normalement l'écho afin que vous
ne peut pas voir ce que vous tapez. Si vous ne vous inquiétez pas des attaques Tempest et
il n'y a personne d'autre dans la pièce, vous pouvez spécifier ce drapeau pour voir ce que vous tapez.

-e EXPR
--modifier EXPR
--expr EXPR
Au lieu de lancer l'éditeur externe, appliquez de manière non interactive l'expression Perl
"EXPR" à chaque ligne du fichier. Voir "MODIFICATION NON INTERACTIVE" ci-dessous.

Veillez à bien citer l'expression pour éviter qu'elle ne soit altérée par le
coquille.

Notez que cette option n'est disponible que lorsque Perl 5 est installé.

--format=brut|qcow2|..
--format
La valeur par défaut pour le -a L'option est de détecter automatiquement le format de l'image disque. À l'aide de
cela force le formatage du disque pour -a options qui suivent sur la ligne de commande. À l'aide de
--format sans argument revient à la détection automatique pour la suite -a options.

Par exemple :

virt-edit --format=raw -un fichier disk.img

force le format brut (pas de détection automatique) pour disque.img.

virt-edit --format=raw -a disk.img --format -a autre fichier.img

force le format brut (pas de détection automatique) pour disque.img et revient à la détection automatique pour
autre.img.

Si vous avez des images de disque invité au format brut non fiables, vous devez utiliser cette option pour
spécifiez le format du disque. Cela évite un éventuel problème de sécurité avec des logiciels malveillants
invités (CVE-2010-3851).

--clés-de-stdin
Lisez les paramètres de clé ou de phrase secrète à partir de stdin. La valeur par défaut est d'essayer de lire
mots de passe de l'utilisateur en ouvrant /dev/tty.

-m dev[:mountpoint[:options[:fstype]]]
--monter dev[:mountpoint[:options[:fstype]]]
Montez la partition ou le volume logique nommé sur le point de montage donné.

Si le point de montage est omis, la valeur par défaut est /.

La spécification d'un point de montage désactive l'inspection de l'invité et le montage de ses
root et tous ses points de montage, assurez-vous donc de monter tous les points de montage nécessaires pour
travailler avec les noms de fichiers donnés en arguments.

Si vous ne savez pas quels systèmes de fichiers une image disque contient, vous pouvez soit exécuter guestfish
sans cette option, puis listez les partitions, les systèmes de fichiers et les LV disponibles (voir
commandes "list-partitions", "list-filesystems" et "lvs"), ou vous pouvez utiliser le
systèmes de fichiers virt(1) programme.

La troisième (et rarement utilisée) partie du paramètre de montage est la liste des options de montage
utilisé pour monter le système de fichiers sous-jacent. Si ce n'est pas donné, alors les options de montage
sont soit la chaîne vide, soit "ro" (ce dernier si le --ro drapeau est utilisé). Par
en spécifiant les options de montage, vous remplacez ce choix par défaut. Probablement le seul
le temps que vous utiliseriez est d'activer les ACL et/ou les attributs étendus si le système de fichiers
peut les soutenir :

-m /dev/sda1:/:acl,user_xattr

L'utilisation de cet indicateur équivaut à l'utilisation de la commande "mount-options".

La quatrième partie du paramètre est le pilote du système de fichiers à utiliser, tel que "ext3" ou
"ntfs". Ceci est rarement nécessaire, mais peut être utile si plusieurs pilotes sont valides pour un
système de fichiers (par exemple : "ext2" et "ext3"), ou si libguestfs identifie mal un système de fichiers.

-v
--verbeux
Activez les messages détaillés pour le débogage.

-V
--version
Afficher le numéro de version et quitter.

-x Activez le traçage des appels d'API libguestfs.

A L'ANCIENNE COMMAND LINE ARGUMENTS

Les versions précédentes de virt-edit vous permettaient d'écrire soit :

fichier virt-edit disk.img [disk.img ...]

or

virt-edit fichier de nom d'invité

alors que dans cette version vous devez utiliser -a or -d respectivement pour éviter le cas confus
où une image disque peut avoir le même nom qu'un invité.

Pour la compatibilité, l'ancien style est toujours pris en charge.

NON INTERACTIF ÉDITION

"virt-edit" appelle normalement $EDITOR (ou vi) afin que l'administrateur système puisse
modifier de manière interactive le fichier.

Il existe également deux façons d'utiliser "virt-edit" à partir de scripts afin d'effectuer des modifications automatisées
aux fichiers. (Notez que bien que vous Vous pouvez utilisez "virt-edit" comme ceci, c'est moins sujet aux erreurs
écrire des scripts directement en utilisant l'API libguestfs et Augeas pour le fichier de configuration
édition.)

La première méthode consiste à définir temporairement $EDITOR sur n'importe quel script ou programme que vous souhaitez exécuter.
Le script est appelé en tant que "$EDITOR tmpfile" et il devrait cependant mettre à jour "tmpfile" en place
il aime.

La deuxième méthode consiste à utiliser le -e paramètre de "virt-edit" pour exécuter un court extrait de Perl dans
le style de sed(1). Par exemple, pour remplacer toutes les instances de "foo" par "bar" dans un fichier :

virt-edit -d domname nom de fichier -e 's/foo/bar/'

Toute la puissance des expressions régulières Perl peut être utilisée (voir perler(1)). Par exemple à
supprimez le mot de passe de root, vous pouvez le faire :

virt-edit -d nom_domaine / Etc / passwd -e 's/^root:.*?:/ Root::/'

Ce qui se passe réellement, c'est que l'extrait est évalué comme une expression Perl pour chaque ligne de
le fichier. La ligne, y compris le "\n" final, est passée dans $_ et l'expression doit
mettre à jour $_ ou le laisser inchangé.

Pour supprimer une ligne, définissez $_ sur la chaîne vide. Par exemple, pour supprimer l'utilisateur "apache"
compte à partir du fichier de mot de passe, vous pouvez faire :

virt-edit -d mondomaine / Etc / passwd -e '$_ = "" si /^apache:/'

Pour insérer une ligne, ajoutez-la au début ou à $_. Cependant, en ajoutant des lignes à la fin du
fichier est assez difficile de cette façon car il n'y a pas de concept de "dernière ligne du fichier" -
votre expression n'est tout simplement plus rappelée. Vous voudrez peut-être utiliser la première méthode
(réglage $EDITOR) si vous voulez faire cela.

La variable $lineno contient le numéro de la ligne courante. Comme il est de tradition, la première ligne
dans le fichier est le numéro 1.

La valeur de retour de l'expression est ignorée, mais l'expression peut appeler "die" dans
pour annuler l'ensemble du programme, en laissant le fichier d'origine intact.

Rappelez-vous lors de la correspondance de la fin d'une ligne que $_ peut contenir le "\n" final ou (pour DOS
files) "\r\n", ou si le fichier ne se termine pas par un saut de ligne, aucun de ceux-ci. Ainsi à
correspondre ou remplacer du texte à la fin d'une ligne, utilisez cette expression régulière :

/du texte(\r?\n)?$/

Alternativement, utilisez la fonction "chomp" de perl, en faisant attention à ne pas ronger $_ lui-même (puisque
cela supprimerait toutes les nouvelles lignes du fichier):

mon $m = $_ ; mâcher $m ; $m =~ /du texte$/

FENÊTRES Les chemins

"virt-edit" a une capacité limitée à comprendre les lettres et les chemins de lecteur Windows (par exemple.
E:\foo\bar.txt).

Si et seulement si l'invité exécute Windows alors :

· Les préfixes de lettres de lecteur tels que "C:" sont résolus par rapport au registre Windows au
système de fichiers correct.

· Tous les caractères de barre oblique inverse ("\") dans le chemin sont remplacés par des barres obliques afin que
libguestfs peut le traiter.

· Le chemin est résolu de manière insensible à la casse pour localiser le fichier qui doit être modifié.

Il y a quelques défauts connus :

· Certains liens symboliques NTFS peuvent ne pas être suivis correctement.

· Les points de jonction NTFS qui traversent les systèmes de fichiers ne sont pas suivis.

EN UTILISANT POISSON INVITÉ

poisson invité(1) est un outil de niveau inférieur plus puissant que vous pouvez utiliser lorsque "virt-edit"
ne fonctionne pas.

Utiliser "virt-edit" équivaut approximativement à faire :

guestfish --rw -i -d domname modifier /fichier

où "domname" est le nom de l'invité libvirt, et /déposer est le chemin complet du fichier.

La commande ci-dessus utilise la fonction d'inspection des invités de libguestfs et ne fonctionne donc pas sur
invités que libguestfs ne peut pas inspecter, ou sur des choses comme des images disque arbitraires qui ne
contenir des invités. Pour éditer directement un fichier sur une image disque, utilisez :

guestfish --rw -a disk.img -m /dev/sda1 modifier /fichier

où disque.img est l'image disque, / Dev / sda1 est le système de fichiers dans l'image disque à
modifier, et /déposer est le chemin complet du fichier.

"virt-edit" ne peut pas créer de nouveaux fichiers. Utilisez les commandes guestfish « toucher », « écrire » ou
"télécharger" à la place :

guestfish --rw -i -d domname touch /nouveaufichier

guestfish --rw -i -d domname write /newfile "nouveau contenu"

guestfish --rw -i -d domname téléverser le fichier local /nouveaufichier

ENVIRONNEMENT VARIABLES

"ÉDITEUR"
Si elle est définie, cette chaîne est utilisée comme éditeur. Il peut contenir des arguments, par ex. "emacs -nw"

S'il n'est pas défini, "vi" est utilisé.

EXIT STATUT

Ce programme renvoie 0 en cas de succès, ou différent de zéro en cas d'erreur.

Utilisez virt-edit en ligne en utilisant les services onworks.net