virt-ls - En ligne dans le Cloud

PROGRAMME:

Nom

virt-ls - Liste des fichiers dans une machine virtuelle

SYNOPSIS

virt-ls [--options] -d domname répertoire [répertoire ...]

virt-ls [--options] -a disk.img [-a disk.img ...] répertoire [répertoire ...]

Style ancien:

virt-ls [--options] répertoire domname

répertoire virt-ls [--options] disk.img [disk.img ...]

DESCRIPTION

"virt-ls" répertorie les noms de fichiers, les tailles de fichiers, les sommes de contrôle, les attributs étendus et plus à partir d'un
machine virtuelle ou image disque.

Plusieurs noms de répertoire peuvent être donnés, auquel cas la sortie de chacun est concaténée.

Pour répertorier les répertoires d'un invité libvirt, utilisez le -d option pour spécifier le nom du
invité. Pour une image disque, utilisez le -a option.

"virt-ls" peut faire de nombreuses listes de fichiers simples. Pour les cas plus compliqués, vous devrez peut-être
utilisé poisson invité(1), ou écrire un programme directement sur le invités(3)API.

EXEMPLES

Obtenez une liste de tous les fichiers et répertoires d'une machine virtuelle :

virt-ls -R -d invité /

Répertoriez tous les programmes setuid ou setgid dans une machine virtuelle Linux :

virt-ls -lR -d invité / | grep '^- [42]'

Répertoriez tous les répertoires accessibles en écriture publique dans une machine virtuelle Linux :

virt-ls -lR -d invité / | grep '^d ...7'

Répertoriez tous les sockets de domaine Unix dans une machine virtuelle Linux :

virt-ls -lR -d invité / | grep '^s'

Répertoriez tous les fichiers normaux dont les noms se terminent par « .png » :

virt-ls -lR -d invité / | grep -i '^-.*\.png$'

Pour afficher des fichiers de plus de 10 Mo dans les répertoires personnels :

virt-ls -lR -d invité / home | awk '$3 > 10*1024*1024'

Trouvez tout ce qui a été modifié au cours des 7 derniers jours :

virt-ls -lR -d guest --time-days / | awk '$6 <= 7'

Trouvez les fichiers normaux modifiés au cours des dernières 24 heures :

virt-ls -lR -d guest --time-days / | grep '^-' | awk '$6 < 1'

DIFFÉRENCES IN INSTANTANÉS ET SUPPORT DES DOSSIERS
Bien qu'il soit possible d'utiliser virt-ls pour rechercher des différences, puisque libguestfs 1.26 a
un nouvel outil est disponible appelé virt-diff (1).

SORTIE MODES

"virt-ls" a quatre modes de sortie, contrôlés par différentes combinaisons du -l et mes -R
options.

SIMPLE INSCRIPTION
Une simple liste est comme l'ordinaire ls(1) commande :

$ virt-ls -d invité /
coffre
botte
[etc.]

LONGUE INSCRIPTION
Le -l (--longue), la sortie ressemble à la commande "ls -l" (plus précisément,
comme la fonction "guestfs_ll").

$ virt-ls -l -d invité /
Total des 204
dr-xr-xr-x. 2 racine racine 4096 2009-08-25 19:06 bin
dr-xr-xr-x. 5 racine racine 3072 2009-08-25 19:06 démarrage
[etc.]

Notez que bien que cela soit utile pour afficher un répertoire, n'essayez pas d'analyser cette sortie
dans un autre programme. Utilisez plutôt "LONG LISTING RECURSIVE".

RÉCURSIF INSCRIPTION
Le -R (--recursive), "virt-ls" répertorie les noms de fichiers et de répertoires
récursivement :

$ virt-ls -R -d invité / Tmp
foo
nourriture/bar
[etc.]

Pour générer cette sortie, "virt-ls" exécute la fonction "guestfs_find0" et convertit "\0"
caractères à "\n".

RÉCURSIF LONGUE INSCRIPTION
En utilisant -g / D options ensemble modifie la sortie pour afficher les répertoires de manière récursive, avec
les statistiques du fichier et éventuellement d'autres fonctionnalités telles que les sommes de contrôle et les attributs étendus.

La plupart des fonctionnalités intéressantes de "virt-ls" ne sont disponibles que lors de l'utilisation -g / D mode.

Les champs sont normalement séparés par des espaces. Les noms de fichiers sont pas cité, vous ne pouvez donc pas utiliser le
sortie dans un autre programme (car les noms de fichiers peuvent contenir des espaces et d'autres
personnages). Si l'invité n'était pas digne de confiance et que quelqu'un savait que vous utilisiez « virt-ls » pour
analyser l'invité, ils pourraient vous jouer des tours en créant des noms de fichiers avec
caractères de nouvelle ligne. À en toute sécurité analyser la sortie dans un autre programme, utilisez le --csv (Virgule-
Valeurs séparées).

Notez que ce format de sortie n'a aucun rapport avec la commande "ls -lR".

$ virt-ls -lR -d invité / bin
d 0555 4096 / bin
- 0755 123 /bin/alsaunmute
- 0755 28328/bac/arche
l 0777 4 /bin/awk -> gawk
- 0755 27216 /bin/nombase
- 0755 943360 / bin / bash
[etc.]

Ces champs de base sont toujours affichés :

type
Le type de fichier, l'un des suivants : "-" (fichier normal), "d" (répertoire), "c" (caractère périphérique),
"b" (dispositif bloc), "p" (tube nommé), "l" (lien symbolique), "s" (socket) ou "u"
(inconnu).

autorisations
Les autorisations Unix, affichées sous la forme d'un nombre octal à 4 chiffres.

Taille
La taille du fichier. Ceci est affiché en octets à moins que -h or --lisible par l'homme option est
donné, auquel cas il s'agit d'un nombre lisible par l'homme.

chemin
Le chemin complet du fichier ou du répertoire.

lien
Pour les liens symboliques uniquement, la cible du lien.

In -g / D mode, des options de ligne de commande supplémentaires permettent l'affichage de plus de champs.

Le --uids flag, ces champs supplémentaires sont affichés avant le chemin :

uid
gid L'UID et le GID du propriétaire du fichier (affichés numériquement). Notez ces seulement
avoir un sens dans le contexte d'un invité de type Unix.

Le --fois flag, ces champs supplémentaires s'affichent :

Atime
L'heure du dernier accès.

mtime
L'heure de la dernière modification.

temps
L'heure du dernier changement d'état.

Les champs d'heure sont affichés sous forme de chaînes de dates et d'heures, à moins que l'un des --temps-t,
--temps-relatif or --temps-jours drapeaux est donné.

Le --extra-statistiques flag, ces champs supplémentaires s'affichent :

dispositif
Le périphérique contenant le fichier (affiché sous la forme major:minor). Cela peut ne pas correspondre aux appareils
comme connu de l'invité.

inode
Le numéro d'inode.

lien
Le nombre de liens physiques.

rdv
Pour les fichiers spéciaux block et char, le périphérique (affiché comme major:minor).

blocs
Le nombre de blocs de 512 octets alloués au fichier.

Le --somme de contrôle flag, la somme de contrôle du contenu du fichier est affichée (uniquement pour les
des dossiers). Le calcul des sommes de contrôle des fichiers peut prendre un temps considérable.

OPTIONS

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

-a filet
--ajouter filet
Ajouter 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).

--somme de contrôle
--checksum=crc|md5|sha1|sha224|sha256|sha384|sha512
Afficher la somme de contrôle sur le contenu du fichier pour les fichiers normaux. Sans argument, ce
utilise par défaut md5. À l'aide d'un argument, vous pouvez sélectionner le type de somme de contrôle à utiliser.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

-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 blocage d'invité (-a), alors libvirt n'est pas du tout utilisé.

--csv
Écrivez les résultats au format CSV (valeurs séparées par des virgules). Ce format peut être
importé facilement dans des bases de données et des feuilles de calcul, mais lisez "REMARQUE SUR LE FORMAT CSV"
ci-dessous.

-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-ls 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.

--extra-statistiques
Afficher des statistiques supplémentaires.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--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-ls --format=raw -a disk.img /dir

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

virt-ls --format=raw -a disk.img --format -a another.img /dir

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).

-h
--lisible par l'homme
Affichez la taille des fichiers dans un format lisible par l'homme.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--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.

-l
--longue
-R
--recursive
Sélectionnez le mode. Sans aucune de ces options, "virt-ls" produit un simple, plat
liste des fichiers dans le répertoire nommé. Voir "LISTE SIMPLE".

"virt-ls -l" produit une "longue liste", qui montre plus de détails. Voir "LONG LISTE".

"virt-ls -R" produit une liste récursive de fichiers à partir du répertoire nommé. Voir
"LISTE RÉCURSIVE".

"virt-ls -lR" produit une longue liste récursive qui peut être plus facilement analysée. Voir
"LONGUE LISTE RECURSIVE".

--fois
Afficher les champs de temps.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--temps-jours
Afficher les champs de temps en jours avant maintenant (négatif si dans le futur).

Notez que 0 en sortie signifie "jusqu'à 1 jour avant maintenant", ou que l'âge du fichier est
entre 0 et 86399 secondes.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--temps-relatif
Afficher les champs de temps en secondes avant maintenant (négatif si dans le futur).

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--temps-t
Afficher les champs de temps en secondes depuis l'époque Unix.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

--uids
Afficher les champs UID et GID.

Cette option n'a d'effet que dans -g / D mode de sortie. Voir « LONGUE LISTE RÉCURSIVE » ci-dessus.

-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-ls vous permettaient d'écrire soit :

virt-ls disque.img [disque.img ...] /dir

or

virt-ls nom d'invité /rép

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.

REMARQUE À PROPOS CSV Format

Les valeurs séparées par des virgules (CSV) sont un format trompeur. Ce semble comme ça devrait être facile à
parse, mais ce n'est certainement pas facile à analyser.

Mythe : divisez simplement les champs par des virgules. Réalité : pas travailler de manière fiable. Cet exemple
a deux colonnes :

"foo, bar", baz

Mythe : Lisez le fichier une ligne à la fois. Réalité : pas travailler de manière fiable. Cette
l'exemple a une ligne :

"toto
bar", baz

Pour les scripts shell, utilisez "csvtool" (http://merjis.com/developers/csv également emballé dans les principaux
distributions Linux).

Pour les autres langages, utilisez une bibliothèque de traitement CSV (par exemple "Text::CSV" pour Perl ou Python's
bibliothèque csv intégrée).

La plupart des feuilles de calcul et des bases de données peuvent importer directement des fichiers CSV.

EXIT STATUT

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

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