guestmount - Online in de cloud

PROGRAMMA:

NAAM

guestmount - Mount een gastbestandssysteem op de host met behulp van FUSE en libguestfs

KORTE INHOUD

guestmount [--options] -a disk.img -m apparaat [--ro] mountpoint

guestmount [--options] -a disk.img -i [--ro] mountpoint

guestmount [--opties] -d Gast -i [--ro] koppelpunt

WAARSCHUWING

"guestmount" gebruiken in de schrijfmodus op live virtuele machines, of gelijktijdig met een andere schijf
bewerkingstools kunnen gevaarlijk zijn en mogelijk schijfbeschadiging veroorzaken. De virtuele machine
moet worden afgesloten voordat u deze opdracht gebruikt, en schijfkopieën mogen niet worden bewerkt
gelijktijdig.

Gebruik de --ro (alleen-lezen) optie om "guestmount" veilig te gebruiken als de schijfkopie of virtueel
machine staat mogelijk onder spanning. Tijdens het uitvoeren kunt u vreemde of inconsistente resultaten zien
gelijktijdig met andere wijzigingen, maar met deze optie loop je geen risico op schijfbeschadiging.

PRODUCTBESCHRIJVING

Het guestmount-programma kan worden gebruikt om bestandssystemen van virtuele machines en andere schijven te mounten
afbeeldingen op de host. Het gebruikt libguestfs voor toegang tot het gastbestandssysteem, en FUSE (de
"bestandssysteem in gebruikersruimte") om het te laten verschijnen als een monteerbaar apparaat.

Naast andere opties moet u ten minste één apparaat opgeven (-a optie) of libvirt
domein (-d optie), en minstens één mountpoint (-m optie) of gebruik de -i inspectie
optie of de --live keuze. Hoe dit werkt, wordt beter uitgelegd in de gastvis(1)
handleiding, of door naar de onderstaande voorbeelden te kijken.

Met FUSE kunt u bestandssystemen als niet-root mounten. Het mountpoint moet uw eigendom zijn, en de
bestandssysteem zal niet zichtbaar zijn voor andere gebruikers, tenzij u bepaalde global
configuratiewijzigingen naar /etc/fuse.conf. Om het bestandssysteem te ontkoppelen, gebruikt u de
gast ontkoppelen(1) opdracht.

Voorbeelden

Voor een typische Windows-gast waarvan het hoofdbestandssysteem op de eerste partitie staat:

guestmount -a windows.img -m /dev/sda1 --ro / mnt

Voor een typische Linux-gast die een /bagageruimte bestandssysteem op de eerste partitie, en het
rootbestandssysteem op een logisch volume:

guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/bagageruimte --ro / mnt

Om ervoor te zorgen dat libguestfs gastkoppelpunten voor u detecteert:

guestmount -a gast.img -i --ro / mnt

Voor een libvirt-gast genaamd "Gast" zou je het volgende kunnen doen:

gastmount -d Gast -i --ro / mnt

Als u niet weet welke bestandssystemen zich in een gast- of schijfkopie bevinden, gebruikt u
virt-bestandssystemen(1) eerst:

virt-bestandssystemen -d MyGuest

Als u de libguestfs-aanroepen wilt traceren, maar zonder overmatige foutopsporingsinformatie, kunnen wij
adviseren:

gastmount [...] --trace / mnt

Als u het programma wilt debuggen, raden wij u aan:

guestmount [...] --trace --verbose / mnt

Om het bestandssysteem te ontkoppelen na gebruik:

gast ontkoppelen / mnt

OPMERKINGEN

Overige gebruikers kan niet zien the bestandssysteem by verzuim
Als u een bestandssysteem als één gebruiker (bijvoorbeeld root) aankoppelt, kunnen andere gebruikers het niet zien
het standaard. De oplossing is om de FUSE "allow_other" optie toe te voegen tijdens het mounten:

sudo guestmount [...] -o allow_other / mnt

inschakelen FUSE
Op sommige distributies moet je jezelf mogelijk toevoegen aan een speciale groep (bijvoorbeeld 'fuse').
kan elk FUSE-bestandssysteem gebruiken. Dit is nodig op Debian en derivaten.

Op andere distributies is geen speciale groep vereist. Het is niet nodig op Fedora of Red Hat
Enterprise-Linux.

fusermontage fout: "Apparaat or hulpbron druk bezig"
U kunt deze fout zien wanneer een ander proces op het systeem naar het mountpoint springt
die u zojuist hebt gemaakt, houdt deze open en voorkomt dat u deze kunt ontkoppelen. Het gebruikelijke
De boosdoeners zijn verschillende GUI-"indexerings"-programma's.

De populaire oplossing voor dit probleem is om de opdracht "fusermount -u" een paar keer opnieuw uit te voeren
keer totdat het werkt (gast ontkoppelen(1) doet dit voor u). Helaas is dit geen
betrouwbare oplossing als (bijvoorbeeld) het aangekoppelde bestandssysteem bijzonder groot is en de
indringend programma bijzonder hardnekkig.

Een goede oplossing is om een ​​privé mountpoint te gebruiken door een nieuwe mount-naamruimte te maken met behulp van de
Linux-specifiek klonen(2) /delen ongedaan maken(2) markeer "CLONE_NEWNS". Helaas op dit moment dit
vereist root en we zouden het waarschijnlijk ook als een functie aan guestmount moeten toevoegen.

Race voorwaarden mogelijk wanneer af te sluiten beneden the versterken
. gast ontkoppelen(1) /fusermontage(1) wordt afgesloten, het is mogelijk dat guestmount nog actief is en bezig is met opruimen
het montagepunt. De schijfkopie wordt niet volledig voltooid.

Dit betekent dat scripts zoals de volgende een vervelende raceconditie hebben:

guestmount -a schijf.img -i / mnt
# kopieer dingen naar / mnt
gast ontkoppelen / mnt
# probeer onmiddellijk 'disk.img' te gebruiken ** ONVEILIG **

De oplossing is om de --pid-bestand optie om vervolgens de guestmount PID naar een bestand te schrijven
na het ontkoppelen van de gast, wacht u tot deze PID wordt afgesloten.

guestmount -a schijf.img -i --pid-bestand guestmount.pid / mnt

#...
#...

# Bewaar de PID van guestmount *voor* dat u guestunmount aanroept.
pid="$(cat gastmount.pid)"

# Ontkoppel het bestandssysteem.
gast ontkoppelen / mnt

timeout = 10

count=$time-out
while kill -0 "$pid" 2>/dev/null && [$count -gt 0 ]; Doen
slaap 1
((graaf--))
gedaan
if [$count -eq 0]; Dan
echo "$0: wachten tot afsluiten van guestmount mislukt na $timeout seconden"
verlaat 1
fi

# Nu is het veilig om de schijfkopie te gebruiken.

Houd er rekening mee dat als u de API "guestfs_mount_local" rechtstreeks gebruikt (zie "MOUNT LOCAL" in
gastfs(3)) dan is het veel gemakkelijker om een ​​veilig, racevrij programma te schrijven.

OPTIES

-a beeld
--toevoegen beeld
Voeg een blokapparaat of virtuele machine-image toe.

Het formaat van de schijfkopie wordt automatisch gedetecteerd. Om dit op te heffen en a . te forceren
bepaald formaat gebruik de --formaat=.. optie.

-a URI
--toevoegen URI
Voeg een externe schijf toe. Zie "OPSLAG OP AFSTAND TOEVOEGEN" in gastvis(1).

-c URI
--aansluiten URI
Bij gebruik in combinatie met de -d optie specificeert dit de libvirt URI die moet worden gebruikt.
De standaard is om de standaard libvirt-verbinding te gebruiken.

-d libvirt-domein
--domein libvirt-domein
Voeg schijven toe van het genoemde libvirt-domein. Als de --ro optie ook wordt gebruikt, dan welke optie dan ook
libvirt-domein kan worden gebruikt. In de schrijfmodus zijn echter alleen libvirt-domeinen dat wel
afsluiten kan hier worden genoemd.

Domein-UUID's kunnen worden gebruikt in plaats van namen.

--dir-cache-time-out N
Stel de time-out van de readdir-cache in op N seconden, de standaardwaarde is 60 seconden. De leesdir
cache [eigenlijk zijn er verschillende semi-onafhankelijke caches] wordt gevuld na a
leesmap(2) bel met de statistische en uitgebreide attributen van de bestanden in de map,
in afwachting dat ze kort daarna zullen worden aangevraagd.

Er is ook een andere attribuutcache geïmplementeerd door FUSE (zie de FUSE-optie -o
attr_time-out), maar de FUSE-cache anticipeert niet op toekomstige verzoeken, alleen op cache
bestaande.

--echo-toetsen
Wanneer u om sleutels en wachtwoordzinnen vraagt, schakelt Guestfish normaal gesproken de echo uit
kan niet zien wat je typt. Als u zich geen zorgen maakt over Tempest-aanvallen en
er is niemand anders in de kamer, u kunt deze vlag specificeren om te zien wat u typt.

--fd=FD
Geef een pipe- of eventfd-bestandsdescriptor op. Wanneer het mountpoint klaar is voor gebruik,
guestmount schrijft een enkele byte naar deze bestandsdescriptor. Deze kan gebruikt worden
combinatie met --geen vork om guestmount captive onder een ander proces uit te voeren.

--format=rauw|qcow2|..
--formaat
De standaard voor de -a optie is om het formaat van de schijfkopie automatisch te detecteren. Gebruik makend van
dit dwingt het schijfformaat voor -a opties die volgen op de opdrachtregel. Gebruik makend van
--formaat zonder argument schakelt terug naar automatische detectie voor volgende -a opties.

Als u niet-vertrouwde gastschijfkopieën in onbewerkte indeling heeft, moet u deze optie gebruiken om:
specificeer het schijfformaat. Dit voorkomt een mogelijk beveiligingsprobleem met kwaadwillende
gasten (CVE-2010-3851). Zie ook "guestfs_add_drive_opts" in gastfs(3).

--zekering-help
Geef hulp weer over speciale FUSE-opties (zie -o hieronder).

--help
Korte hulp weergeven en afsluiten.

-i
--inspecteur
gebruik virt-inspecteur(1) code, inspecteer de schijven op zoek naar een besturingssysteem en
mount bestandssystemen zoals ze op de echte virtuele machine zouden worden gemount.

--sleutels-van-stdin
Lees sleutel- of wachtwoordzinparameters van stdin. De standaard is om te proberen te lezen
wachtwoordzinnen van de gebruiker door te openen /dev/tty.

--live
Maak verbinding met een live virtuele machine. (Experimenteel, zie "VASTMAKEN AAN RUNNING DAEMONS"
in gastfs(3)).

-m dev[:mountpoint[:opties[:fstype]]
--monteer dev[:mountpoint[:opties[:fstype]]]
Koppel de genoemde partitie of het logische volume op het opgegeven koppelpunt in the gast (deze
heeft niets te maken met mountpoints in de host).

Als het koppelpunt wordt weggelaten, is het standaard /. Je moet er iets op monteren /.

Het derde (en zelden gebruikte) deel van de mount-parameter is de lijst met mount-opties
gebruikt om het onderliggende bestandssysteem te mounten. Als dit niet wordt gegeven, dan zijn de mount-opties
zijn ofwel de lege string of "ro" (de laatste als de --ro vlag wordt gebruikt). Door
door de aankoppelopties op te geven, negeert u deze standaardkeuze. Waarschijnlijk de enige
keer dat u dit zou gebruiken, is om ACL's en/of uitgebreide attributen in te schakelen als het bestandssysteem
kan hen ondersteunen:

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

Het vierde deel van de parameter is het te gebruiken stuurprogramma voor het bestandssysteem, zoals "ext3" of
"ntfs". Dit is zelden nodig, maar kan handig zijn als meerdere stuurprogramma's geldig zijn voor een
bestandssysteem (bijvoorbeeld: "ext2" en "ext3"), of als libguestfs een bestandssysteem verkeerd identificeert.

--geen vork
Niet demoniseren (of naar de achtergrond gaan).

-n
--geen synchronisatie
Standaard proberen we de gastschijf te synchroniseren wanneer het FUSE-koppelpunt is ontkoppeld.
Als u deze optie opgeeft, proberen we de schijf niet te synchroniseren. Zie de
bespreking van autosynchronisatie in de gastfs(3) manpagina.

-o optie
--optie optie
Geef extra opties door aan FUSE.

Gebruik de onderstaande opdracht om een ​​lijst te krijgen van alle extra opties die door FUSE worden ondersteund. Opmerking
dat alleen de ZEKERING -o opties kunnen worden doorgegeven, en slechts enkele daarvan zijn een goed idee.

guestmount --fuse-help

Enkele potentieel nuttige FUSE-opties:

-o toestaan_andere
Sta andere gebruikers toe het bestandssysteem te zien.

-o attr_timeout=N
Schakel attribuutcaching door FUSE in en stel de time-out in op N seconden.

-o kernel_cache
Sta de kernel toe om bestanden in de cache op te slaan (vermindert het aantal leesbewerkingen dat moet worden uitgevoerd
door de gastfs(3)API). Dit is over het algemeen een goed idee als u het zich kunt veroorloven
extra geheugengebruik.

-o vloeistof=N -o gid=N
Gebruik deze opties om alle UID's en GID's binnen het gastbestandssysteem toe te wijzen aan de
gekozen waarden.

-o gebruik_ino
Behoud inodenummers van het onderliggende bestandssysteem.

Zonder deze optie maakt FUSE zijn eigen inodenummers. De inode nummert jou
zien in staat(2), "ls -i" enz. zijn niet de inodenummers van het onderliggende bestandssysteem.

Note deze optie is potentieel gevaarlijk als het onderliggende bestandssysteem bestaat uit
meerdere mountpoints, omdat je mogelijk dubbele inodenummers ziet verschijnen
SAMENSMELTEN. Het gebruik van deze optie kan sommige software in verwarring brengen.

--pid-bestand bestandsnaam
Schrijf de PID van het guestmount-werkproces naar "bestandsnaam".

-r
--ro
Voeg apparaten toe en koppel alles alleen-lezen. Sta ook schrijfbewerkingen toe en maak de schijf
verschijnen als alleen-lezen voor FUSE.

Dit wordt ten zeerste aanbevolen als u de gastschijf niet gaat bewerken. Als de gast
actief is en deze optie is niet geleverd, dan is er een groot risico op schijf
corruptie bij de gast. Wij proberen dit te voorkomen, maar dat lukt niet altijd
mogelijk.

Zie ook "SCHIJVEN OPENEN VOOR LEZEN EN SCHRIJVEN" in gastvis(1).

--selinux
Schakel SELinux-ondersteuning voor de gast in.

-v
--uitgebreid
Schakel uitgebreide berichten van onderliggende libguestfs in.

-V
--versie
Geef de programmaversie weer en sluit af.

-w
--rw
Dit verandert de -a, -d en -m opties zodat schijven worden toegevoegd en mounts worden uitgevoerd
lezen schrijven.

Zie "SCHIJVEN OPENEN VOOR LEZEN EN SCHRIJVEN" in gastvis(1).

-x
--spoor
Traceer libguestfs-aanroepen en toegang tot elke FUSE-functie.

Dit voorkomt ook dat de daemon naar de achtergrond gaat (zie --geen vork).

Gebruik guestmount online met behulp van onworks.net-services