guestfish - Online in de cloud

PROGRAMMA:

NAAM

guestfish - de shell van het gastbestandssysteem

KORTE INHOUD

gastvis [--opties] [opdrachten]

gastvis

guestfish [--ro|--rw] -a schijf.img

guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]

guestfish -d libvirt-domein

gastvis [--ro|--rw] -a disk.img -i

guestfish -d libvirt-domein -i

WAARSCHUWING

Gebruik van "guestfish" 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 "guestfish" veilig te gebruiken als de schijfimage of virtueel is
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

Guestfish is een shell- en opdrachtregelprogramma voor het onderzoeken en wijzigen van virtuele machines
bestandssystemen. Het maakt gebruik van libguestfs en stelt alle functionaliteit van de guestfs API bloot,
zien gastfs(3).

Guestfish geeft u gestructureerde toegang tot de libguestfs API, vanuit shell-scripts of de
opdrachtregel of interactief. Als u een kapotte afbeelding van een virtuele machine wilt redden, kunt u dat doen
moet kijken naar de virt-redding(1) opdracht.

Voorbeelden

As an interactieve schelp
$ gastvis

Welkom bij guestfish, de shell van het gastbestandssysteem voor
bestandssystemen van virtuele machines bewerken.

Type: 'help' voor een lijst met opdrachten
'man' om de handleiding te lezen
'quit' om de shell te verlaten

> add-ro schijf.img
> loop
> list-bestandssystemen
/dev/sda1: ext4
/dev/vg_guest/lv_root: ext4
/dev/vg_guest/lv_swap: wisselen
> mount /dev/vg_guest/lv_root /
> kat / Etc / fstab
# / Etc / fstab
# Gemaakt door anaconda
[...]
> Uitgang

Vanaf schelp scripts
Maak een nieuw /etc/motd bestand in een gast- of schijfkopie:

gastvis <<_EOF_
voeg schijf.img toe
lopen
mount /dev/vg_guest/lv_root /
schrijf /etc/motd "Welkom, nieuwe gebruikers"
_EOF_

Maak een lijst van de logische LVM-volumes in een schijfkopie:

guestfish -a schijf.img --ro <<_EOF_
lopen
lvs
_EOF_

Maak een lijst van alle bestandssystemen in een schijfkopie:

guestfish -a schijf.img --ro <<_EOF_
lopen
list-bestandssystemen
_EOF_

On een commando lijn
bijwerken / Etc / resolv.conf bij een gast:

gastvis \
voeg disk.img toe: uitvoeren: mount /dev/vg_guest/lv_root /: \
schrijven / Etc / resolv.conf "naamserver 1.2.3.4"

Edit /boot/grub/grub.conf interactief:

guestfish --rw --add schijf.img \
--mount /dev/vg_guest/lv_root \
--mount /dev/sda1:/bagageruimte \
bewerk /boot/grub/grub.conf

berg schijven webmaster.
Gebruik de -i optie om de schijven automatisch te koppelen vanaf een virtuele machine:

guestfish --ro -a schijf.img -i cat / etc / group

guestfish --ro -d libvirt-domein -i cat / etc / group

Een andere manier van bewerken /boot/grub/grub.conf interactief is:

guestfish --rw -a disk.img -i bewerk /boot/grub/grub.conf

As a script tolk
Maak een schijf van 100 MB met daarin een ext2-geformatteerde partitie:

#!/usr/bin/guestfish -f
schaarse test1.img 100M
lopen
part-disk /dev/sda mbr
mkfs ext2 /dev/sda1

Start with a bereid schijf
Een alternatieve manier om een ​​schijf van 100 MB te maken heet test1.img met een enkele
ext2-geformatteerde partitie:

gastvis -N fs

Om te vermelden wat er beschikbaar is, doet u het volgende:

gastvis -N help | minder

Remote drives
Toegang krijgen tot een externe schijf met behulp van ssh:

guestfish -a ssh://example.com/pad/naar/schijf.img

Remote onder controle te houden
eval "`gastvis --luister`"
guestfish --remote add-ro schijf.img
guestfish - op afstand rennen
guestfish - externe lvs

OPTIES

--help
Geeft algemene hulp over opties weer.

-h
--cmd-help
Geeft een overzicht van alle beschikbare guestfish-opdrachten.

-h cmd
--cmd-help cmd
Geeft gedetailleerde hulp weer voor één enkele opdracht "cmd".

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

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

Het gebruik van deze vlag komt grotendeels overeen met het gebruik van de opdracht "add", met "readonly:true"
indien de --ro vlag werd gegeven, en met "format:..." als de --formaat=... vlag werd gegeven.

-a URI
--toevoegen URI
Voeg een externe schijf toe. Zie "AFSTANDSOPSLAG TOEVOEGEN".

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

--cs
Als u de --luisteren optie en een csh-achtige shell, gebruik deze optie. Zie sectie
"AFSTANDSBEDIENING EN CSH" hieronder.

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

Het gebruik van deze vlag komt grotendeels overeen met het gebruik van de opdracht "add-domain", with
"alleen-lezen: waar" als de --ro vlag werd gegeven, en met "format:..." als de --formaat=...
vlag werd gegeven.

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

-f filet
--het dossier filet
Lees opdrachten uit "bestand". Om pure guestfish-scripts te schrijven, gebruik je:

#!/usr/bin/guestfish -f

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

Bijvoorbeeld:

guestfish --format=raw -a schijf.img

dwingt onbewerkte indeling (geen automatische detectie) voor schijf.img.

guestfish --format=raw -a schijf.img --format -a andere.img

dwingt onbewerkte indeling (geen automatische detectie) voor schijf.img en keert terug naar automatische detectie voor
een andere.img.

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

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

Typisch gebruik is:

gastvis -d mijngast -i

(voor een inactief libvirt-domein genaamd mijn gast), of:

gastvis --ro -d mijngast -i

(voor actieve domeinen, alleen-lezen), of geef het blokapparaat rechtstreeks op:

guestfish --rw -a /dev/Guests/MyGuest -i

Merk op dat de syntaxis van de opdrachtregel enigszins is gewijzigd ten opzichte van oudere versies van guestfish.
U kunt nog steeds de oude syntaxis gebruiken:

gastvis [--ro] -i schijf.img

guestfish [--ro] -i libvirt-domein

Het gebruik van deze vlag komt grotendeels overeen met het gebruik van de opdracht "inspect-os" en vervolgens met behulp van
andere opdrachten om de gevonden bestandssystemen te mounten.

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

--luisteren
Ga naar de achtergrond en luister naar opdrachten op afstand. Zie paragraaf "AFSTANDSBEDIENING
GASTENVIS OVER EEN SOCKET" hieronder.

--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]]]
Monteer de genoemde partitie of het logische volume op het opgegeven koppelpunt.

Als het koppelpunt wordt weggelaten, is het standaard /.

Je moet er iets op monteren / voordat de meeste commando's zullen werken.

Als er een is -m or --monteer opties worden gegeven, wordt de gast automatisch gelanceerd.

Als u niet weet welke bestandssystemen een schijfkopie bevat, kunt u guestfish uitvoeren
zonder deze optie, maak dan een lijst van de beschikbare partities, bestandssystemen en LV's (zie
"list-partitions", "list-filesystems" en "lvs" commando's), of u kunt de
virt-bestandssystemen(1) programma.

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 gebruik van deze vlag is gelijk aan het gebruik van de opdracht "mount-options".

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.

--netwerk
Schakel QEMU-gebruikersnetwerken in de gast in.

-N [bestandsnaam=]type
--nieuwe [bestandsnaam=]type
-N uw
Bereid een nieuwe schijfkopie voor, geformatteerd als "type". Dit is een alternatief voor de -a
optie: overwegende dat -a voegt een bestaande schijf toe, -N creëert een vooraf geformatteerde schijf met een
bestandssysteem en voegt het toe. Zie "VOORBEREIDE SCHIJFBEELDEN" hieronder.

-n
--geen synchronisatie
Schakel automatische synchronisatie uit. Dit is standaard ingeschakeld. Zie de bespreking van autosync in de
gastfs(3) manpagina.

--geen-bestemmingspaden
Voer geen tab-complete paden in op het gastbestandssysteem. Het is handig om op de
tab-toets om paden op het gastbestandssysteem te voltooien, maar dit veroorzaakt extra "verborgen"
guestfs-aanroepen moeten worden gemaakt, dus deze optie is hier om deze functie uit te schakelen.

--pipe-fout
Als schrijfbewerkingen er niet in slagen om opdrachten door te voeren (zie "PIPES" hieronder), retourneert de opdracht een
fout.

De standaardinstelling (ook om historische redenen) is het negeren van dergelijke fouten, zodat:

> commando_met_veel_uitvoer | hoofd

geeft geen foutmelding.

--voortgangsbalken
Schakel voortgangsbalken in, zelfs als guestfish niet-interactief wordt gebruikt.

Voortgangsbalken zijn standaard ingeschakeld wanneer guestfish als interactieve shell wordt gebruikt.

--geen-voortgangsbalken
Schakel voortgangsbalken uit.

--op afstand[=pid]
Stuur externe opdrachten naar $GUESTFISH_PID of "pid". Zie paragraaf "AFSTANDSBEDIENING
GASTENVIS OVER EEN SOCKET" hieronder.

-r
--ro
Dit verandert de -a, -d en -m opties zodat schijven worden toegevoegd en mounts worden uitgevoerd
alleen lezen.

De optie moet altijd worden gebruikt als de schijfkopie of virtuele machine actief is,
en wordt over het algemeen aanbevolen in gevallen waarin u geen schrijftoegang tot de schijf nodig heeft.

Houd er rekening mee dat voorbereide schijfkopieën gemaakt met -N worden niet beïnvloed door deze optie. Ook
opdrachten zoals "add" worden niet beïnvloed - u moet de optie "readonly:true" opgeven
expliciet als je het nodig hebt.

Zie ook "SCHIJVEN OPENEN VOOR LEZEN EN SCHRIJVEN" hieronder.

--selinux
Schakel SELinux-ondersteuning voor de gast in. Zie "SELINUX" in gastfs(3).

-v
--uitgebreid
Schakel zeer uitgebreide berichten in. Dit is vooral handig als u een bug vindt.

-V
--versie
Geef het versienummer van guestfish / libguestfs 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" hieronder.

-x Echo elke opdracht voordat u deze uitvoert.

COMMANDO'S ON COMMAND LINE

Eventuele aanvullende (niet-optie)argumenten worden behandeld als uit te voeren opdrachten.

Uit te voeren opdrachten moeten worden gescheiden door een dubbele punt (:), waarbij de dubbele punt een aparte is
parameter. Dus:

guestfish cmd [args...] : cmd [args...] : cmd [args...] ...

Als er geen aanvullende argumenten zijn, voeren we een shell in, ofwel een interactieve shell
met een prompt (als de invoer een terminal is) of een niet-interactieve shell.

In zowel de opdrachtregelmodus als in de niet-interactieve shell is de eerste opdracht die een
fout zorgt ervoor dat de hele shell wordt afgesloten. In interactieve modus (met een prompt) als een commando
mislukt, kunt u doorgaan met het invoeren van opdrachten.

GEBRUIK MAKEND VAN lancering (OF loop)

Zoals met gastfs(3), u moet eerst uw gast configureren door schijven toe te voegen en deze vervolgens starten,
mount vervolgens alle schijven die je nodig hebt, en voer ten slotte acties/commando's uit. Dus de algemene volgorde
van de dag is:

· toevoegen of -a/--toevoegen

· lanceren (ook wel rennen genoemd)

· montage of -m/--montage

· eventuele andere opdrachten

"run" is een synoniem voor "lanceren". U moet uw gast "starten" (of "runnen") voordat u kunt mounten
of het uitvoeren van andere opdrachten.

De enige uitzondering is dat als een van de -i, -m, --monteer, -N or --nieuwe opties werden gegeven
dan wordt "run" automatisch gedaan, simpelweg omdat guestfish de actie die jij doet niet kan uitvoeren
gevraagd zonder dit te doen.

OPENING SCHIJVEN VOOR LEZEN EN SCHRIJVEN

De gastvis, gastberg(1) en virt-redding(1) opties --ro en --rw beïnvloeden of de
andere opdrachtregelopties -a, -c, -d, -i en -m open schijfkopieën alleen-lezen of voor
schrijven.

In libguestfs ≤ 1.10 stonden guestfish, guestmount en virt-rescue standaard op het openen van schijf
afbeeldingen geleverd op de opdrachtregel voor schrijven. Om een ​​schijfkopie alleen-lezen te openen, moet u dit doen
do -a beeld --ro.

Dit is van belang: als u per ongeluk een beschrijfbare live VM-schijfkopie opent, veroorzaakt u dit
onomkeerbare schijfcorruptie.

In een toekomstige libguestfs zijn we van plan de standaard in de andere richting te veranderen. Schijfkopieën zullen zijn
alleen-lezen geopend. U zult een van beide moeten specificeren gastvis --rw, gastberg --rw, deugd
redden --rwof wijzig het configuratiebestand om schrijftoegang voor schijfimages te krijgen
gespecificeerd door die andere opdrachtregelopties.

Deze versie van guestfish, guestmount en virt-rescue heeft een --rw optie die niets doet
(dit is al de standaard). Het wordt echter ten zeerste aanbevolen om deze optie te gebruiken
geef aan dat u schrijftoegang nodig heeft en bereid uw scripts voor op de dag waarop deze optie beschikbaar is
is vereist voor schrijftoegang.

Opmerking: Dit betekent niet invloed hebben op commando's zoals "add" en "mount", of andere libguestfs
programma behalve guestfish en guestmount.

CITAAT

U kunt gewone parameters citeren met enkele of dubbele aanhalingstekens. Bijvoorbeeld:

voeg "bestand met een spatie.img" toe

rm '/bestandsnaam'

rm '/"'

Voor een aantal opdrachten is het doorgeven van een lijst met tekenreeksen vereist. Gebruik hiervoor een witruimte-
gescheiden lijst, tussen aanhalingstekens. Tekenreeksen met witruimte die moeten worden doorgegeven
moet tussen enkele aanhalingstekens staan. Een letterlijk enkel aanhalingsteken moet worden geëscaped met een
terugslag.

vgcreate VG "/dev/sda1 /dev/sdb1"
commando "/bin/echo 'foo-bar'"
commando "/bin/echo \'foe\'"

ESCAPE OPEENVOLGINGEN IN DUBBELE GECITEERD ARGUMENTEN
Gebruik (alleen) in argumenten tussen dubbele aanhalingstekens een backslash om speciale tekens in te voegen:

"\A"
Alert (bel) karakter.

"\B"
Backspace-teken.

"\F"
Formulierfeed-teken.

"\n"
Newline-karakter.

"\R"
Koetsretourkarakter.

"\t"
Horizontaal tabteken.

"\v"
Verticaal tabteken.

"\""
Een letterlijk dubbel aanhalingsteken.

"\oooo"
Een teken met octale waarde ooo. Er moeten precies 3 octale cijfers zijn (in tegenstelling tot C).

"\xhh"
Een teken met hexadecimale waarde hh. Er moeten precies 2 hexadecimale cijfers zijn.

In de huidige implementatie kunnen "\000" en "\x00" niet in strings worden gebruikt.

"\\"
Een letterlijk backslash-personage.

OPTIONELE ARGUMENTEN

Sommige opdrachten gebruiken optionele argumenten. Deze argumenten verschijnen in deze documentatie als
"[argnaam:..]". U kunt ze gebruiken zoals in deze voorbeelden:

bestandsnaam toevoegen

voeg bestandsnaam alleen-lezen: waar toe

voeg bestandsnaamformaat toe:qcow2 alleen-lezen:false

Elk optioneel argument kan maximaal één keer voorkomen. Alle optionele argumenten moeten daarna verschijnen
de vereiste.

NUMBERS

Deze sectie is van toepassing op alle opdrachten die gehele getallen als parameters kunnen gebruiken.

SIZE ACHTERVOEGSEL
Wanneer de opdracht een parameter gebruikt, gemeten in bytes, kunt u een van de volgende gebruiken
achtervoegsels om kilobytes, megabytes en grotere formaten te specificeren:

k or K or KiB
De grootte in kilobytes (vermenigvuldigd met 1024).

KB De grootte in SI 1000 byte-eenheden.

M or Eb
De grootte in megabytes (vermenigvuldigd met 1048576).

MB De grootte in SI 1000000 byte-eenheden.

G or GiB
De grootte in gigabytes (vermenigvuldigd met 2**30).

GB De grootte in SI 10**9 byte-eenheden.

T or TiB
De grootte in terabytes (vermenigvuldigd met 2**40).

TB De grootte in SI 10**12 byte-eenheden.

P or bbp
De grootte in petabytes (vermenigvuldigd met 2**50).

PB De grootte in SI 10**15 byte-eenheden.

E or EiB
De grootte in exabytes (vermenigvuldigd met 2**60).

EB De grootte in SI 10**18 byte-eenheden.

Z or ZiB
De grootte in zettabytes (vermenigvuldigd met 2**70).

ZB De grootte in SI 10**21 byte-eenheden.

Y or jeB
De grootte in yottabytes (vermenigvuldigd met 2**80).

YB De grootte in SI 10**24 byte-eenheden.

Bijvoorbeeld:

afkappen /bestand 1G

zou het bestand afkappen tot 1 gigabyte.

Wees voorzichtig, want een paar opdrachten hebben een grootte in kilobytes of megabytes (bijvoorbeeld de parameter
naar "memsize" is al opgegeven in megabytes). Het toevoegen van een achtervoegsel is waarschijnlijk niet voldoende
wat je verwacht.

OCTAAL EN HEXADECIMAAL NUMBERS
Gebruik voor het specificeren van de radix (grondtal) de C-conventie: 0 om een ​​octaal getal of "0x" vooraf te voegen
om een ​​hexadecimaal getal vooraf te laten gaan. Bijvoorbeeld:

1234 decimaal getal 1234
02322 octaal getal, gelijk aan decimaal 1234
0x4d2 hexadecimaal getal, gelijk aan decimaal 1234

Wanneer u de opdracht "chmod" gebruikt, wilt u bijna altijd een octaal getal opgeven voor de
mode, en je moet het vooraf laten gaan door 0 (in tegenstelling tot de Unix chmod(1) programma):

chmod 0777 /public # OK
chmod 777 /public # FOUT! Dit is modus 777 decimaal = 01411 octaal.

Commando's die getallen retourneren, worden meestal in decimalen afgedrukt, maar sommige commando's worden afgedrukt
getallen in andere radices (bijv. "umask" drukt de modus in octaal af, voorafgegaan door 0).

WILDKAART EN GLOBBEN

Noch guestfish, noch de onderliggende guestfs API voert wildcard-uitbreiding (globbing) uit
standaard. Dus het volgende zal bijvoorbeeld niet doen wat je verwacht:

rm-rf /huis/*

Ervan uitgaande dat je geen directory hebt met de letterlijke naam /huis/* dan zal het bovenstaande commando dat doen
een fout retourneren.

Om wildcard-uitbreiding uit te voeren, gebruikt u de opdracht "glob".

glob rm-rf /huis/*

voert "rm-rf" uit op elk pad dat overeenkomt (dat wil zeggen dat de opdracht mogelijk vele malen wordt uitgevoerd),
gelijk aan:

rm-rf /home/jim
rm-rf /home/joe
rm-rf /home/maria

"glob" werkt alleen op eenvoudige gastpaden en niet op apparaatnamen.

Als je meerdere parameters hebt, die elk een jokerteken bevatten, dan zal glob een
Cartesiaans product.

OPMERKINGEN

Elke regel die begint met een # teken wordt behandeld als commentaar en genegeerd. De # blikje
eventueel voorafgegaan door witruimte, maar niet door een commando. Bijvoorbeeld:

# dit is een reactie
# dit is een reactie
foo # GEEN commentaar

Lege regels worden ook genegeerd.

RUNNING COMMANDO'S PLAATSELIJK

Elke regel die begint met een ! karakter wordt behandeld als een commando dat naar de lokale shell wordt verzonden
(/ Bin / sh of wat dan ook system(3) toepassingen). Bijvoorbeeld:

!mkdir lokaal
tgz-out /remote local/remote-data.tar.gz

zal een map "lokaal" op de host aanmaken en vervolgens de inhoud ervan exporteren /op afstand on
het aangekoppelde bestandssysteem naar lokaal/remote-data.tar.gz. (Zie "tgz-uit").

Gebruik de opdracht "lcd" om de lokale map te wijzigen. "!cd" heeft geen effect vanwege
de manier waarop subprocessen werken in Unix.

LOKALE COMMANDO'S MET IN LIJN EXECUTIE
Als een regel begint met <! vervolgens wordt het shell-commando uitgevoerd (zoals voor !), maar daarna
elke uitvoer (stdout) van het shell-commando wordt geparseerd en uitgevoerd als guestfish-opdrachten.

U kunt dus het shell-script gebruiken om willekeurige guestfish-opdrachten te construeren die vervolgens worden uitgevoerd
geparseerd door guestfish.

Het is bijvoorbeeld vervelend om een ​​reeks bestanden te maken (bijv. /foo.1 brengt /foo.100)
alleen met behulp van guestfish-opdrachten. Dit is echter eenvoudig als we een shellscript gebruiken om te maken
de guestfish-opdrachten voor ons:

<! for n in `seq 1 100`; do echo write /foo.$n $n; done

of met namen als /foo.001:

<! for n in `seq 1 100`; do printf "write /foo.%03d %d\n" $n $n; done

Bij interactief gebruik van guestfish kan het handig zijn om eerst het shellscript uit te voeren
(dat wil zeggen: verwijder het initiële teken "<", zodat het een gewoon teken is ! lokaal commando), kijk wat
guestfish-opdrachten die het zou uitvoeren, en als je daar tevreden mee bent, plaats dan de "<"
karakter om de guestfish-opdrachten echt uit te voeren.

PIJPEN

Gebruik "opdracht | command" om de uitvoer van het eerste commando (een guestfish
opdracht) naar de tweede opdracht (elke hostopdracht). Bijvoorbeeld:

hoe / Etc / passwd | awk -F: '$3 == 0 {afdrukken }'

(waarbij "cat" het guestfish cat-commando is, maar "awk" het host-awk-programma is). Bovenstaande
commando zou alle accounts in het gastbestandssysteem weergeven die UID 0 hebben, dwz. wortel
rekeningen inclusief achterdeurtjes. Andere voorbeelden:

hexdump /bin/ls | hoofd
lijst-apparaten | staart -1
tgz-uit / - | teer ztf -

De spatie vóór het pijpsymbool is vereist; elke spatie na het pijpsymbool is optioneel.
Alles na het pijpsymbool wordt gewoon rechtstreeks naar de hostshell doorgegeven, dus dat kan
bevatten omleidingen, klodders en al het andere dat zinvol is aan de hostkant.

Om een ​​letterlijk argument te gebruiken dat begint met een pijpsymbool, moet je het citeren, bijvoorbeeld:

echo "|"

HOME DIRECTIES

Als een parameter begint met het teken "~", dan kan de tilde worden uitgebreid als een thuis
mappad (ofwel "~" voor de thuismap van de huidige gebruiker, of "~user" voor een andere
gebruiker).

Houd er rekening mee dat uitbreiding van de thuismap plaatsvindt bij bekende gebruikers on the gastheer, niet in de gast
bestandssysteem.

Om een ​​letterlijk argument te gebruiken dat met een tilde begint, moet je het citeren, bijvoorbeeld:

echo "~"

VERSLEUTELD SCHIJVEN

Libguestfs heeft enige ondersteuning voor Linux-gasten gecodeerd volgens de Linux Unified Key
Setup-standaard (LUKS), die bijna alle coderingssystemen voor hele schijven omvat die worden gebruikt door
moderne Linux-gasten. Momenteel wordt alleen LVM-on-LUKS ondersteund.

Identificeer gecodeerde blokapparaten en partities met behulp van "vfs-type":

> vfs-type /dev/sda2
crypto_LUKS

Open vervolgens die apparaten met "luks-open". Hierdoor wordt een device-mapper-apparaat gemaakt met de naam
/dev/mapper/luksdev.

> luks-open /dev/sda2 luksdev
Voer sleutel of wachtwoordzin in ("sleutel"):

Ten slotte moet u LVM vertellen om te scannen naar volumegroepen op het nieuw gemaakte mapper-apparaat:

vgscan
vg-activeren-allemaal waar

De logische volume(s) kunnen nu op de gebruikelijke manier worden gemonteerd.

Voordat u een LUKS-apparaat sluit, moet u alle logische volumes erop ontkoppelen en het LUKS-apparaat deactiveren
volumegroepen door voor elke groep "vg-activate false VG" aan te roepen. Dan kun je de
mapper-apparaat:

vg-activate false /dev/VG
luks-close /dev/mapper/luksdev

WINDOWS PADEN

Als een pad wordt voorafgegaan door "win:", kunt u stationsletters en paden in Windows-stijl gebruiken
(met enkele beperkingen). De volgende opdrachten zijn gelijkwaardig:

bestand /WINDOWS/system32/config/system.LOG

bestand win:\windows\system32\config\system.log

bestand WIN:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG

De parameter wordt "achter de schermen" herschreven door de positie op te zoeken waar de aandrijving zich bevindt
is aangekoppeld, voorafgegaan door het pad, waarbij alle backslash-tekens worden gewijzigd in vooruit
slash en los het resultaat vervolgens op met behulp van "hoofdlettergevoelig pad". Bijvoorbeeld als de E: schijf
was gemonteerd op /e dan kan de parameter als volgt worden herschreven:

win:e:\foo\bar => /e/FOO/bar

Dit werkt alleen in argumentposities die een pad verwachten.

UPLOADEN EN DOWNLOADEN FILES

Voor opdrachten zoals "upload", "download", "tar-in", "tar-out" en andere die uploaden
van of downloaden naar een lokaal bestand, kunt u de speciale bestandsnaam "-" gebruiken in de betekenis van "van".
stdin" of "naar stdout". Bijvoorbeeld:

uploaden - /foo

leest stdin en maakt daarvan een bestand /foe in de schijfkopie, en:

teer-uit / Etc - | teer tf -

schrijft de tarball naar stdout en voert die vervolgens door naar het externe "tar"-commando (zie
"PIJPEN").

Wanneer u "-" gebruikt om vanaf stdin te lezen, wordt de invoer gelezen tot het einde van stdin. Je kan ook
gebruik een speciale "heredoc"-achtige syntaxis om tot een willekeurige eindmarkering te lezen:

uploaden -<
invoerlijn 1
invoerlijn 2
invoerlijn 3
EINDE

In plaats van "END" kan elke tekenreeks worden gebruikt. De eindmarkering moet op a staan
eigen regel, zonder voorafgaande of volgende tekens (zelfs geen spaties).

Houd er rekening mee dat de syntaxis "-<<" alleen van toepassing is op parameters die worden gebruikt om lokale bestanden te uploaden (dus-
zogenaamde "FileIn"-parameters in de generator).

EXIT ON FOUT GEDRAG

Standaard negeert guestfish eventuele fouten in de interactieve modus (dat wil zeggen bij het nemen van opdrachten).
van een mens over een tty), en wordt afgesloten bij de eerste fout in de niet-interactieve modus
(scripts, opdrachten gegeven op de opdrachtregel).

Als u een opdracht voorafgaat met een - karakter, dan zal dat commando er niet voor zorgen dat guestfish dit doet
exit, zelfs als dat (ene) commando een fout retourneert.

AFSTAND CONTROL GASTENVIS OVER A SOCKET

Guestfish kan op afstand worden bediend via een stopcontact. Dit is vooral handig in de shell
scripts waarbij u verschillende wijzigingen in een bestandssysteem wilt aanbrengen, maar dat niet doet
wil de overhead van het elke keer opstarten van een guestfish-proces.

Start een guestfish-serverproces met behulp van:

eval "`gastvis --luister`"

en stuur het vervolgens opdrachten door het volgende te doen:

guestfish --remote cmd [...]

Om ervoor te zorgen dat de server wordt afgesloten, stuurt u deze het exit-commando:

guestfish - externe uitgang

Houd er rekening mee dat de server normaal gesproken wordt afgesloten als er een fout in een opdracht zit. Je kan veranderen
dit op de gebruikelijke manier. Zie paragraaf "AFSLUITEN BIJ FOUTGEDRAG".

CONTROLEREN MEERDERE GASTENVIS PROCESSEN
De instructie "eval" stelt de omgevingsvariabele $GUESTFISH_PID in, en dat is hoe de
--op afstand optie weet waar de opdrachten naartoe moeten worden gestuurd. U kunt meerdere gastvisluisteraars hebben
processen die worden uitgevoerd met behulp van:

eval "`gastvis --luister`"
pid1=$GUESTFISH_PID
eval "`gastvis --luister`"
pid2=$GUESTFISH_PID
...
guestfish --remote=$pid1 cmd
guestfish --remote=$pid2 cmd

AFSTAND CONTROL EN CSH
Wanneer je csh-achtige shells gebruikt (csh, tcsh enz.) moet je de --cs optie:

eval "`gastvis --luister --csh`"

AFSTAND CONTROL DETAILS
Afstandsbediening vindt plaats via een Unix-domeinsocket genaamd /tmp/.guestfish-$UID/socket-$PID,
waarbij $UID de effectieve gebruikers-ID van het proces is, en $PID de proces-ID van het proces is
server.

Guestfish client- en serverversies moeten exact overeenkomen.

Oudere versies van guestfish waren kwetsbaar voor CVE-2013-4419 (zie "CVE-2013-4419" in
gastfs(3)). Dit is opgelost in de huidige versie.

GEBRUIK MAKEND VAN AFSTAND CONTROL ROBUUST NU SHELL SCRIPT
Vanuit Bash kun je de volgende code gebruiken die op de juiste manier een guestfish-instantie maakt
citeert de opdrachtregel, verwerkt mislukte startbewerkingen en ruimt guestfish op wanneer het script wordt uitgevoerd
uitgangen:

#!/ bin / bash -

stel -e

gastvis[0]="gastvis"
gastvis[1]="--luister"
gastvis[2]="--ro"
gastvis[3]="-a"
guestfish[4]="schijf.img"

GASTVIS_PID=
eval $("${gastvis[@]}")
if [ -z "$GUESTFISH_PID" ]; Dan
echo "fout: guestfish is niet opgestart, zie foutmeldingen hierboven"
verlaat 1
fi

cleanup_guestfish ()
{
guestfish --remote -- exit >/dev/null 2>&1 ||:
}
trap cleanup_guestfish EXIT ERR

guestfish --remote -- uitvoeren

#...

AFSTAND CONTROL DOET NIET WERKEN MET -a ETC. OPTIES
Opties zoals -a, --toevoegen, -N, --nieuwe enz. werken niet goed samen met ondersteuning op afstand.
Ze worden lokaal verwerkt en niet doorgestuurd naar de externe gastvis. In het bijzonder
dit doet niet wat je verwacht:

guestfish --remote --add schijf.img

Gebruik deze opties niet. Gebruik in plaats daarvan de equivalente opdrachten, bijvoorbeeld:

guestfish --remote schijf toevoegen disk.img

of:

gastvis --op afstand
> voeg schijf.img toe

AFSTAND CONTROL VLUCHTEN COMMAND HANGEND
Het op afstand gebruiken van de opdracht "run" (of "launch") in een context voor opdrachtvervanging loopt vast,
d.w.z. niet doen (let op de aanhalingstekens):

a=`guestfish --remote run`

Omdat het commando "run" geen uitvoer op stdout produceert, is dit sowieso niet nuttig. Voor
zie https://bugzilla.redhat.com/show_bug.cgi?id=592910 voor meer informatie.

BEREID SCHIJF AFBEELDINGEN

Gebruik de -N [bestandsnaam=]type or --nieuwe [bestandsnaam=]type parameter om één uit een set te selecteren
vooraf geformatteerde schijfkopieën die guestfish voor u kan maken, zodat u niet hoeft te typen. Dit is
vooral handig voor testdoeleinden. Deze optie wordt gebruikt in plaats van de -a keuze,
en zoals -a kan meerdere keren voorkomen (en kan gemengd worden met -a).

De nieuwe schijf wordt aangeroepen test1.img voor het eerst -N, test2.img voor de tweede enzovoort.
Bestaande bestanden in de huidige map zijn overschreven. U kunt een andere bestandsnaam gebruiken
door "filename=" op te geven vóór het type (zie onderstaande voorbeelden).

Het type beschrijft kort hoe de schijf moet worden gedimensioneerd, gepartitioneerd, hoe bestandssysteem(en)
moet worden gemaakt en hoe inhoud moet worden toegevoegd. Optioneel kan het type gevolgd worden
door extra parameters, gescheiden door tekens (dubbele punt). Bijvoorbeeld, -N fs creëert een
standaard 100 MB, spaarzaam toegewezen schijf, met daarin een enkele partitie, met de partitie
geformatteerd als ext2. -N fs:ext4:1G is hetzelfde, maar dan voor een ext4-bestandssysteem op een schijf van 1 GB
gebruiken.

Merk op dat het voorbereide bestandssysteem niet is aangekoppeld. Meestal zou je gebruik moeten maken van de
"mount /dev/sda1 //" commando of voeg de -m / Dev / sda1 optie.

Als er een is -N or --nieuwe opties worden gegeven, wordt het libguestfs-apparaat automatisch gestart.

Voorbeelden
Maak een schijf van 100 MB met een ext4-geformatteerde partitie, genaamd test1.img in de huidige
directory:

gastvis -N fs:ext4

Maak een schijf van 32 MB met een VFAT-geformatteerde partitie en koppel deze:

gastvis -N fs:vfat:32M -m /dev/sda1

Maak een lege schijf van 200 MB:

gastvis -N schijf: 200M

Maak een lege schijf van 200 MB genaamd lege schijf.img (in plaats van test1.img):

guestfish -N blankdisk.img=schijf:200M

-N schijf - en je merk te creëren a blanco schijf
"gastvis -N [bestandsnaam=]schijf[:grootte]"

Maak een lege schijf van 100 MB (standaard).

De standaardgrootte kan worden gewijzigd door een optionele parameter op te geven.

De optionele parameters zijn:

Naam Standaardwaarde
size 100M de grootte van de schijfimage

-N deel - en je merk te creëren a gepartitioneerd schijf
"gastvis -N [bestandsnaam=]deel[:grootte[:partitie]]"

Maak een schijf met één partitie. Standaard is de grootte van de schijf 100 MB (de
beschikbare ruimte in de partitie zal een klein beetje kleiner zijn) en de partitietabel zal dat ook zijn
wees MBR (oude DOS-stijl).

Deze standaardinstellingen kunnen worden gewijzigd door optionele parameters op te geven.

De optionele parameters zijn:

Naam Standaardwaarde
size 100M de grootte van de schijfimage
partitie mbr partitietabeltype

-N fs - en je merk te creëren a bestandssysteem
"gastvis -N [bestandsnaam=]fs[:bestandssysteem[:grootte[:partitie]]]"

Maak een schijf met een enkele partitie, waarbij de partitie een leeg bestandssysteem bevat.
Standaard wordt hier een schijf van 100 MB gemaakt (de beschikbare ruimte in het bestandssysteem is a
klein beetje kleiner) met een MBR (oude DOS-stijl) partitietabel en een ext2 bestandssysteem.

Deze standaardinstellingen kunnen worden gewijzigd door optionele parameters op te geven.

De optionele parameters zijn:

Naam Standaardwaarde
bestandssysteem ext2 het type bestandssysteem dat moet worden gebruikt
size 100M de grootte van de schijfimage
partitie mbr partitietabeltype

-N lv - en je merk te creëren a schijf with logisch volume
"gastvis -N [bestandsnaam=]lv[:naam[:grootte[:partitie]]]"

Maak een schijf met één enkele partitie, stel de partitie in als een LVM2 fysiek volume,
en plaats daar een volumegroep en een logisch volume. Standaard wordt hier een bestand van 100 MB gemaakt
schijf met de VG en LV genaamd "/dev/VG/LV". U kunt de naam van de VG en LV wijzigen met
het opgeven van een alternatieve naam als de eerste optionele parameter.

Merk op dat hierdoor geen bestandssysteem wordt aangemaakt. Gebruik hiervoor 'lvfs'.

De optionele parameters zijn:

Naam Standaardwaarde
naam /dev/VG/LV de naam van de te gebruiken VG en LV
size 100M de grootte van de schijfimage
partitie mbr partitietabeltype

-N lvfs - en je merk te creëren a schijf with logisch volume en bestandssysteem
"gastvis -N [bestandsnaam=]lvfs[:naam[:bestandssysteem[:grootte[:partitie]]]]"

Maak een schijf met één enkele partitie, stel de partitie in als een LVM2 fysiek volume,
en plaats daar een volumegroep en een logisch volume. Formatteer vervolgens de LV met a
bestandssysteem. Standaard wordt hier een schijf van 100 MB gemaakt met de VG en LV aangeroepen
"/dev/VG/LV", met een ext2 bestandssysteem.

De optionele parameters zijn:

Naam Standaardwaarde
naam /dev/VG/LV de naam van de te gebruiken VG en LV
bestandssysteem ext2 het type bestandssysteem dat moet worden gebruikt
size 100M de grootte van de schijfimage
partitie mbr partitietabeltype

-N bootroot - en je merk te creëren a laarsje en wortel bestandssysteem
"gastvis -N [bestandsnaam=]bootroot[:bootfs[:rootfs[:size[:bootsize[:partitie]]]]]"

Maak een schijf met twee partities, voor het opstart- en rootbestandssysteem. Formatteer de twee
bestandssystemen onafhankelijk. Er zijn verschillende optionele parameters die de exacte instellingen bepalen
lay-out en bestandssysteemtypen.

De optionele parameters zijn:

Naam Standaardwaarde
bootfs ext2 het type bestandssysteem dat moet worden gebruikt voor het opstarten
rootfs ext2 het type bestandssysteem dat voor root moet worden gebruikt
size 100M de grootte van de schijfimage
bootsize 32M de grootte van het opstartbestandssysteem
partitie mbr partitietabeltype

-N bootrootlv - en je merk te creëren a laarsje en wortel bestandssysteem gebruik LVM
"gastvis -N
[bestandsnaam=]bootrootlv[:naam[:bootfs[:rootfs[:size[:bootsize[:partitie]]]]]]"

Dit is hetzelfde als "bootroot", maar het rootbestandssysteem (alleen) wordt op een logisch bestand geplaatst
volume, standaard genaamd "/dev/VG/LV". Er zijn verschillende optionele parameters die
controleer de exacte lay-out.

De optionele parameters zijn:

Naam Standaardwaarde
naam /dev/VG/LV de naam van de VG en LV voor root
bootfs ext2 het type bestandssysteem dat moet worden gebruikt voor het opstarten
rootfs ext2 het type bestandssysteem dat voor root moet worden gebruikt
size 100M de grootte van de schijfimage
bootsize 32M de grootte van het opstartbestandssysteem
partitie mbr partitietabeltype

TOEVOEGEN AFSTAND STORAGE

Voor API-niveau documentatie on dit onderwerp, zien "guestfs_add_drive_opts" in gastfs(3) en
"OP AFSTAND OPSLAG" in gastfs(3).

Op de opdrachtregel kunt u de -a optie om netwerkblokapparaten toe te voegen met behulp van een URI-
stijlformaat, bijvoorbeeld:

gastvis -a ssh://[e-mail beveiligd]/schijf.img

URI's kan niet worden gebruikt met het commando "add". Het equivalente commando dat rechtstreeks de API gebruikt
is:

> voeg /disk.img protocol:ssh server:tcp:example.com gebruikersnaam:root toe

Het mogelijke -a URI formaten worden hieronder beschreven.

-a schijf.img
-a bestand:///pad/naar/schijf.img
Voeg de lokale schijfkopie (of het apparaat) toe die wordt genoemd schijf.img.

-a ftp://[gebruiker@]example.com[:port]/disk.img
-a ftps://[gebruiker@]example.com[:port]/disk.img
-a http://[user@]example.com[:port]/disk.img
-a https://[user@]example.com[:port]/disk.img
-a tftp://[gebruiker@]example.com[:port]/disk.img
Voeg een schijf toe die zich op een externe FTP-, HTTP- of TFTP-server bevindt.

Het equivalente API-commando zou zijn:

> voeg /disk.img protocol:(ftp|...) server:tcp:example.com toe

-a gluster://example.com[:port]/volname/image
Voeg een schijfkopie toe die zich op GlusterFS-opslag bevindt.

De server is degene die "glusterd" draait en kan "localhost" zijn.

Het equivalente API-commando zou zijn:

> voeg volname/image toe protocol:gluster server:tcp:example.com

-a iscsi://voorbeeld.com[:poort]/doel-iqn-naam[/lun]
Voeg een schijf toe die zich op een iSCSI-server bevindt.

Het equivalente API-commando zou zijn:

> voeg doel-iqn-naam/lun protocol:iscsi server:tcp:example.com toe

-a nbd://voorbeeld.com[:poort]
-a nbd://voorbeeld.com[:poort]/exportnaam
-a nbd://?socket=/socket
-a nbd:///exportnaam?socket=/socket
Voeg een schijf toe die zich op de Network Block Device (nbd)-opslag bevindt.

De /exportnaam een deel van de URI specificeert een NBD-exportnaam, maar wordt meestal leeg gelaten.

De optionele ?stopcontact parameter kan worden gebruikt om een ​​Unix-domeinsocket te specificeren waarmee we praten
de NBD-server voorbij. Houd er rekening mee dat u de servernaam (bijv. TCP/IP) en socketpad niet kunt combineren.

Het equivalente API-commando zou zijn (geen exportnaam):

> voeg "" toe protocol:nbd server:[tcp:example.com|unix:/socket]

-a rbd:///pool/schijf
-a rbd://voorbeeld.com[:poort]/pool/schijf
Voeg een schijfimage toe die zich op een Ceph-opslagvolume (RBD/librbd) bevindt.

Hoewel libguestfs en Ceph meerdere servers ondersteunen, kan slechts één server dat zijn
opgegeven bij gebruik van deze URI-syntaxis.

Het equivalente API-commando zou zijn:

> voeg pool/schijf toe protocol:rbd server:tcp:example.com:port

-a herdershond://[example.com[:port]]/volume/image
Voeg een schijfkopie toe die zich op een Sheepdog-volume bevindt.

De servernaam is optioneel. Hoewel libguestfs en Sheepdog meerdere servers ondersteunen,
bij gebruik van deze URI-syntaxis kan er maximaal één server worden opgegeven.

Het equivalente API-commando zou zijn:

> volume toevoegen protocol:sheepdog [server:tcp:example.com]

-a ssh://[gebruiker@]example.com[:port]/disk.img
Voeg een schijfkopie toe die zich op een externe server bevindt en waartoe u toegang krijgt via de Secure Shell (ssh) SFTP
protocol. SFTP wordt standaard ondersteund door alle grote SSH-servers.

Het equivalente API-commando zou zijn:

> voeg /disk toe protocol:ssh server:tcp:example.com [gebruikersnaam:gebruiker]

VOORUITGANG BARS

Sommige (niet alle) langlopende opdrachten sturen voortgangsmeldingen zoals ze zijn
rennen. Guestfish zet deze berichten om in voortgangsbalken.

Wanneer het langer dan twee seconden duurt om een ​​opdracht uit te voeren die voortgangsbalken ondersteunt, en if
voortgangsbalken zijn ingeschakeld, dan ziet u er een verschijnen onder de opdracht:

> kopieergrootte /groot bestand /ander bestand 2048M
/ 10% [#####--------------------------------------- ] 00:30

De spinner aan de linkerkant beweegt één keer rond voor elke voortgangsmelding
ontvangen van de backend. Dit is een (redelijk) gouden garantie dat het bevel is
"iets doen", zelfs als de voortgangsbalk niet beweegt, omdat het commando daartoe in staat is
stuur de voortgangsmeldingen. Wanneer de balk 100% bereikt en de opdracht is voltooid, wordt de
spinner verdwijnt.

Voortgangsbalken zijn standaard ingeschakeld wanneer guestfish interactief wordt gebruikt. Je kunt inschakelen
ze zelfs voor niet-interactieve modi --voortgangsbalkenen u kunt ze uitschakelen
volledig gebruiken --geen-voortgangsbalken.

PROMPT

U kunt kleuren wijzigen of toevoegen aan de standaardprompt ("> ") door het instellen van de
Omgevingsvariabele 'GUESTFISH_PS1'. Er wordt een tweede string ("GUESTFISH_OUTPUT") afgedrukt
nadat het commando is ingevoerd en vóór de uitvoer, zodat u de
kleur van de uitvoer. Vóór het welkom wordt een derde tekenreeks ("GUESTFISH_INIT") afgedrukt
bericht, zodat u de kleur van dat bericht kunt bepalen. Een vierde snaar
("GUESTFISH_RESTORE") wordt afgedrukt voordat de gastvis wordt verlaten.

Een eenvoudige prompt kan worden ingesteld door "GUESTFISH_PS1" in te stellen op een alternatieve tekenreeks:

$ GUESTFISH_PS1='(typ een commando) '
$ exporteren GUESTFISH_PS1
$ gastvis
[...]
(typ een opdracht) ▂

U kunt ook speciale ontsnappingsreeksen gebruiken, zoals beschreven in de onderstaande tabel:

\\ Een letterlijk backslash-teken.

\[
\] (Deze mogen alleen worden gebruikt in "GUESTFISH_PS1".)

Plaats niet-afdrukbare tekens (bijvoorbeeld terminalcontrolecodes voor kleuren) ertussen
"\[...\]". Wat dit doet om de readline(3) bibliotheek die moet worden behandeld
deze subreeks als nulbreedte, zodat het opnieuw weergeven, bewerken enz. van de opdrachtregel werkt.

\a Een belkarakter.

\e Een ASCII ESC-teken (escape).

\n Een nieuwe regel.

\r Een regelterugloop.

\NNN
Het ASCII-teken waarvan de code de octale waarde NNN is.

\xNN
Het ASCII-teken waarvan de code de hexadecimale waarde NN is.

Voorbeelden OF MELDINGEN
Houd er rekening mee dat deze een terminal vereisen die ANSI-escape-codes ondersteunt.

·

GUESTFISH_PS1='\[\e[1;30m\]><fs>\[\e[0;30m\] '

Een gewaagde zwarte versie van de gewone prompt.

·

GUESTFISH_PS1='\[\e[1;32m\]><fs>\[\e[0;31m\] '
GUESTFISH_OUTPUT='\e[0m'
GUESTFISH_RESTORE="$GUESTFISH_OUTPUT"
GUESTFISH_INIT='\e[1;34m'

Blauwe welkomsttekst, groene prompt, rode opdrachten, zwarte opdrachtuitvoer.

WINDOWS 8

Windows 8 "snel opstarten" kan voorkomen dat guestfish NTFS-partities aankoppelt. Zien
"WINDOWS-HIBERNATION EN WINDOWS 8 SNEL OPSTARTEN" in gastfs(3).

GASTENVIS COMMANDO'S

De commando's in deze sectie zijn 'guestfish'-gemakscommando's, met andere woorden, dat zijn ze ook
maakt geen deel uit van de gastfs(3) API.

uw
uw
help cmd

Zonder enige parameter biedt dit algemene hulp.

Met een parameter "cmd" wordt gedetailleerde hulp voor die opdracht weergegeven.

afrit
ophouden
Dit verlaat de gastvis. U kunt ook de "^D"-toets gebruiken.

toewijzen
toewijzen
bestandsnaamgrootte toewijzen

Hierdoor wordt een leeg (op nul gezet) bestand van de opgegeven grootte gemaakt en vervolgens toegevoegd zodat het verder kan
onderzocht.

Voor meer geavanceerd maken van afbeeldingen, zie "disk-create".

De grootte kan worden opgegeven met behulp van standaardachtervoegsels, bijv. "1M".

Als u een sparse-bestand wilt maken, gebruikt u in plaats daarvan 'sparse'. Om een ​​voorbereide schijfkopie te maken, zie
"VOORBEREIDE SCHIJFBEELDEN".

kopie-in
kopieer lokaal [lokaal ...] /remotedir

"copy-in" kopieert lokale bestanden of mappen recursief naar de schijfkopie en plaatst ze
in de map die wordt gebeld /op afstandir (die moet bestaan). Dit gastvis-metacommando draait
indien nodig in een reeks "tar-in" en andere opdrachten.

Er kunnen meerdere lokale bestanden en mappen worden opgegeven, maar de laatste parameter moet altijd worden opgegeven
een externe map zijn. Jokertekens kunnen niet worden gebruikt.

kopiëren
kopiëren op afstand [op afstand ...] localdir

"copy-out" kopieert externe bestanden of mappen recursief uit de schijfimage en plaatst
ze op de hostschijf in een lokale map genaamd "localdir" (die moet bestaan). Dit
guestfish meta-commando verandert in een reeks "download", "tar-out" en andere commando's
als nodig.

Er kunnen meerdere externe bestanden en mappen worden opgegeven, maar de laatste parameter moet altijd worden opgegeven
een lokale map zijn. Om naar de huidige map te downloaden, gebruikt u "." als in:

kopiëren / Home .

Jokertekens kunnen niet worden gebruikt in de gewone opdracht, maar u kunt ze wel gebruiken met behulp van
"glob" zoals dit:

globaal kopiëren /huis/*.

delete-gebeurtenis
verwijder-gebeurtenisnaam

Verwijder de gebeurtenishandler die eerder was geregistreerd als "naam". Indien meerdere evenementen
handlers zijn geregistreerd met dezelfde naam, ze zijn allemaal verwijderd.

Zie ook de guestfish-opdrachten "event" en "list-events".

tonen
bestandsnaam weergeven

Gebruik "display" (een grafisch weergaveprogramma) om een ​​afbeeldingsbestand weer te geven. Het downloadt de
bestand en voert "display" uit.

Om een ​​alternatief programma te gebruiken, stelt u de omgevingsvariabele "GUESTFISH_DISPLAY_IMAGE" in.
Om bijvoorbeeld het GNOME-weergaveprogramma te gebruiken:

export GUESTFISH_DISPLAY_IMAGE=bijv

Zie ook tonen(1).

echo
echo [parameters ...]

Dit echoot de parameters naar de terminal.

Bewerken
vi
emacs
bestandsnaam bewerken

Dit wordt gebruikt om een ​​bestand te bewerken. Het downloadt het bestand, bewerkt het lokaal met uw editor,
uploadt vervolgens het resultaat.

De editor is $EDITOR. Als u echter de alternatieve commando's "vi" of "emacs" gebruikt, zult u dat wel doen
haal de corresponderende editors.

gebeurtenis
gebeurtenisnaam evenementenset "shellscript ..."

Registreer een shellscriptfragment dat wordt uitgevoerd wanneer een gebeurtenis wordt gegenereerd. Zien
"guestfs_set_event_callback" in gastfs(3) voor een bespreking van de gebeurtenis-API in
libguestfs.

De parameter "name" is een naam die u aan deze gebeurtenishandler geeft. Het kan elke string zijn
(zelfs de lege string) en is er gewoon, zodat u de handler kunt verwijderen met behulp van de
guestfish "delete-event" commando.

De parameter "eventset" is bijvoorbeeld een door komma's gescheiden lijst van een of meer gebeurtenissen
"sluiten" of "sluiten, traceren". De speciale waarde "*" betekent alle gebeurtenissen.

De derde en laatste parameter is het shellscriptfragment (of een extern commando) dat
wordt uitgevoerd wanneer een van de gebeurtenissen in de gebeurtenissenset plaatsvindt. Het wordt uitgevoerd met behulp van "$SHELL
-c", of als $SHELL dan niet is ingesteld / Bin / sh -c.

Het shellscriptfragment ontvangt callback-parameters als argumenten $1, $2 enz
de daadwerkelijke gebeurtenis die is aangeroepen, is beschikbaar in de omgevingsvariabele $EVENT.

evenement "" sluiten "echo gesloten"
gebeurtenisberichten apparaat,bibliotheek,trace "echo $@"
evenement "" voortgang "echo voortgang: $3/$4"
evenement "" * "echo $EVENT $@"

Zie ook de guestfish-opdrachten "delete-event" en "list-events".

glob
glob commando args...

Vouw jokertekens uit in alle paden in de argumentenlijst en voer herhaaldelijk "command" uit op elk pad
bijpassende pad.

Zie "WILDCARDS EN GLOBBING".

hexedit
hexedit
hexedit
hexedit

Gebruik hexedit (een hex-editor) om een ​​binair bestand of een blokapparaat geheel of gedeeltelijk te bewerken.

Deze opdracht werkt door mogelijk het hele bestand of apparaat te downloaden en te bewerken
lokaal en upload het vervolgens. Als het bestand of apparaat groot is, moet u opgeven welke
gedeelte dat u wilt bewerken met behulp van de "max" en/of "start" "max" parameters. "begin" en "max"
worden gespecificeerd in bytes, waarbij de gebruikelijke modificatoren zijn toegestaan, zoals "1M" (1 megabyte).

Om bijvoorbeeld de eerste paar sectoren van een schijf te bewerken, kunt u het volgende doen:

hexedit /dev/sda 1M

waarmee u overal binnen de eerste megabyte van de schijf kunt bewerken.

Om het superblok van een ext2-bestandssysteem te bewerken op / Dev / sda1, Doen:

hexedit /dev/sda1 0x400 0x400

(ervan uitgaande dat het superblok zich op de standaardlocatie bevindt).

Voor deze opdracht is het externe vereist hexedit(1) programma. U kunt een ander programma opgeven
gebruiken door de omgevingsvariabele "HEXEDITOR" in te stellen.

Zie ook "hexadump".

lcd
lcd-map

Wijzig de lokale map, dwz. de huidige directory van guestfish zelf.

Houd er rekening mee dat "!cd" niet zal doen wat u zou verwachten.

lijst-evenementen
lijst-evenementen

Maak een lijst van de gebeurtenishandlers die zijn geregistreerd met het guestfish "event"-commando.

man
handboek
man

Opent de handleidingpagina voor guestfish.

meer
minder
meer bestandsnaam

minder bestandsnaam

Dit wordt gebruikt om een ​​bestand te bekijken.

De standaardviewer is $PAGER. Als u echter het alternatieve commando "less" gebruikt, zult u dat wel doen
krijg specifiek het commando "minder".

heropenen
heropenen

Sluit de libguestfs-handle en open deze opnieuw. Het is niet nodig om dit normaal te gebruiken, omdat
de hendel is goed gesloten als de gastvis eruit komt. Toch is dit af en toe handig
om uit te proberen.

settenv
setenv VAR-waarde

Stel de omgevingsvariabele "VAR" in op de tekenreeks "waarde".

Om de waarde van een omgevingsvariabele af te drukken, gebruikt u een shell-opdracht zoals:

!echo $VAR

dun
schaarse bestandsnaamgrootte

Hierdoor wordt een leeg sparse-bestand van de opgegeven grootte gemaakt en vervolgens toegevoegd, zodat het verder kan
onderzocht.

In alle opzichten werkt het hetzelfde als het commando "alloc", behalve dat het afbeeldingsbestand dat wel is
spaarzaam toegewezen, wat betekent dat schijfblokken pas aan het bestand worden toegewezen
zijn nodig. Sparse schijfbestanden gebruiken alleen ruimte wanneer ze worden geschreven, maar ze zijn langzamer en
Er bestaat een gevaar dat u tijdens een schrijfbewerking geen echte schijfruimte meer heeft.

Voor meer geavanceerd maken van afbeeldingen, zie "disk-create".

De grootte kan worden opgegeven met behulp van standaardachtervoegsels, bijv. "1M".

Zie ook het guestfish-commando "scratch".

ondersteund
ondersteund

Deze opdracht retourneert een lijst met de optionele groepen die bekend zijn bij de daemon, en geeft aan
welke worden ondersteund door deze build van het libguestfs-apparaat.

Zie ook "BESCHIKBAARHEID" in gastfs(3).

Time to
tijdcommando args...

Voer de opdracht uit zoals gewoonlijk, maar druk daarna de verstreken tijd af. Dit kan handig zijn voor
benchmarking-activiteiten.

onrustigv
niet ingestelde VAR

Verwijder "VAR" uit de omgeving.

COMMANDO'S

acl-delete-def-bestand
acl-delete-def-bestand map

Deze functie verwijdert de standaard POSIX Access Control List (ACL) die aan de map is gekoppeld
"direct".

acl-get-bestand
acl-get-bestandspad acltype

Deze functie retourneert de POSIX Access Control List (ACL) gekoppeld aan "pad". De ACL is
geretourneerd in "lange tekstvorm" (zie acl(5)).

De parameter "acltype" kan zijn:

"toegang"
Retourneert de gewone (toegangs-) ACL voor elk bestand, map of ander bestandssysteemobject.

"standaard"
Retourneert de standaard-ACL. Normaal gesproken heeft dit alleen zin als "pad" een directory is.

acl-set-bestand
acl-set-bestandspad acltype acl

Met deze functie wordt de POSIX Access Control List (ACL) ingesteld die is gekoppeld aan "pad".

De parameter "acltype" kan zijn:

"toegang"
Stel de gewone (toegangs) ACL in voor elk bestand, map of ander bestandssysteemobject.

"standaard"
Stel de standaard ACL in. Normaal gesproken heeft dit alleen zin als "pad" een directory is.

De parameter "acl" is de nieuwe ACL in "lange tekstvorm" of "korte tekstvorm" (zie
acl(5)). De nieuwe ACL vervangt alle eerdere ACL's in het bestand volledig. De ACL moet
de volledige Unix-rechten bevatten (bijv. "u::rwx,g::rx,o::rx").

Als u individuele gebruikers of groepen opgeeft, is het maskerveld ook vereist
(bijv. "m::rwx"), gevolgd door de "u:ID KAART:..." en/of "g:ID KAART:..." veld(en). Een volledige ACL-tekenreeks
zou er daarom zo uit kunnen zien:

u::rwx,g::rwx,o::rwx,m::rwx,u:500:rwx,g:500:rwx
\ Unix-rechten / \mask/ \ ACL /

U moet numerieke UID's en GID's gebruiken. Om gebruikersnamen en groepsnamen aan de juiste toe te wijzen
numerieke ID in de context van de gast, gebruik de Augeas-functies (zie "aug-init").

add-cdrom
add-cdrom bestandsnaam

Deze functie voegt een virtuele CD-ROM-schijfimage toe aan de gast.

De afbeelding wordt toegevoegd als alleen-lezen schijf, dus deze functie is equivalent aan "add-drive-ro".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "add-drive-ro".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

domein toevoegen
domein
add-domain dom [libvirturi:..] [readonly:true|false] [iface:..] [live:true|false] [allowuuid:true|false] [readonlydisk:..] [cachemode:..] [ weggooien:..] [copyonread:true|false]

Deze functie voegt de schijf(s) toe die zijn gekoppeld aan het genoemde libvirt-domein "dom". Het werkt door
verbinding maken met libvirt, het domein en de domein-XML opvragen bij libvirt, en deze parseren
schijven, en op elke schijf "add-drive-opts" aanroepen.

Het aantal toegevoegde schijven wordt geretourneerd. Deze bewerking is atomair: als er een fout wordt geretourneerd,
dan worden er geen schijven toegevoegd.

Deze functie voert enkele minimale controles uit om er zeker van te zijn dat het libvirt-domein niet actief is
(tenzij "alleen-lezen" waar is). In een toekomstige versie zullen we proberen het libvirt-slot te verkrijgen
op elke schijf.

Schijven moeten lokaal toegankelijk zijn. Dit betekent vaak dat het toevoegen van schijven vanaf een afstandsbediening
libvirt-verbinding (zie http://libvirt.org/remote.html) zal mislukken, tenzij deze schijven dat wel zijn
ook lokaal toegankelijk via hetzelfde apparaatpad.

De optionele parameter "libvirturi" stelt de libvirt URI in (zie
http://libvirt.org/uri.html). Als dit niet is ingesteld, maken we verbinding met de standaardlibvirt
URI (of één ingesteld via een omgevingsvariabele, zie de libvirt-documentatie voor de volledige versie).
details).

De optionele "live"-vlag bepaalt of deze oproep verbinding probeert te maken met een running
virtuele machine "guestfsd"-proces als het een geschikt bestand ziet element in de libvirt
XML-definitie. De standaardinstelling (als de vlag wordt weggelaten) is om het nooit te proberen. Zie "BEVESTIGEN AAN
RUNNING DAEMONS" in gastfs(3) voor meer informatie.

Als de vlag "allowuuid" waar is (standaard is onwaar), dan is er een UUID mei worden doorgegeven in plaats van
de domeinnaam. De "dom"-reeks wordt eerst als een UUID behandeld en opgezocht, en zo ja
opzoeken mislukt, dan behandelen we "dom" zoals gewoonlijk als een naam.

De optionele parameter "readonlydisk" bepaalt wat we doen voor schijven die zijn gemarkeerd
in de libvirt-XML. Mogelijke waarden zijn:

readonlydisk = "fout"
Als 'alleen-lezen' onwaar is:

De hele oproep wordt afgebroken met een foutmelding als een schijf met de vlag is
gevonden.

Als 'alleen-lezen' waar is:

Schijven met de vlag zijn alleen-lezen toegevoegd.

readonlydisk = "lezen"
Als 'alleen-lezen' onwaar is:

Schijven met de vlag zijn alleen-lezen toegevoegd. Andere schijven worden toegevoegd
lezen schrijven.

Als 'alleen-lezen' waar is:

Schijven met de vlag zijn alleen-lezen toegevoegd.

readonlydisk = "schrijven" (standaard)
Als 'alleen-lezen' onwaar is:

Schijven met de vlag zijn toegevoegd lezen/schrijven.

Als 'alleen-lezen' waar is:

Schijven met de vlag zijn alleen-lezen toegevoegd.

readonlydisk = "negeren"
Als 'alleen-lezen' waar of onwaar is:

Schijven met de vlag worden overgeslagen.

De andere optionele parameters worden rechtstreeks doorgegeven aan "add-drive-opts".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

schijf toevoegen
toevoegen
add-drive-opts
add-drive bestandsnaam [readonly:true|false] [format:..] [iface:..] [naam:..] [label:..] [protocol:..] [server:..] [gebruikersnaam: ..] [geheim:..] [cachemode:..] [weggooien:..] [copyonread:true|false]

Deze functie voegt een schijfkopie toe met de naam bestandsnaam naar het handvat. bestandsnaam kan een normale zijn
hostbestand of een hostapparaat.

Wanneer deze functie wordt aangeroepen vóór de "lancering" (het gebruikelijke geval), dan belt u de eerste keer
deze functie verschijnt de schijf in de API als / Dev / sda, de tweede keer als / Dev / sdben
spoedig.

In libguestfs ≥ 1.20 kun je deze functie ook aanroepen na het opstarten (bij sommige
beperkingen). Dit heet ‘hotpluggen’. Bij hotplugging moet u een
"label" zodat de nieuwe schijf een voorspelbare naam krijgt. Voor meer informatie zie
"HOTPLUGGING" in gastfs(3).

Je hoeft niet per se root te zijn als je libguestfs gebruikt. Maar dat doe je duidelijk wel
voldoende machtigingen nodig hebben om toegang te krijgen tot de bestandsnaam voor welke bewerkingen u maar wilt
uitvoeren (dwz leestoegang als u alleen de afbeelding wilt lezen of schrijftoegang als u dat wilt
wijzig de afbeelding).

Deze oproep controleert dat bestandsnaam bestaat.

bestandsnaam kan de speciale tekenreeks "/dev/null" zijn. Zie "NULL-SCHIJVEN" in gastfs(3).

De optionele argumenten zijn:

"alleen lezen"
Als dit waar is, wordt de afbeelding behandeld als alleen-lezen. Schrijven is nog steeds toegestaan, maar zij
worden opgeslagen in een tijdelijke snapshot-overlay die aan het einde wordt weggegooid. De schijf
die u toevoegt, wordt niet gewijzigd.

"formaat"
Dit forceert het beeldformaat. Als u dit weglaat (of "add-drive" of "add-drive-ro" gebruikt)
dan wordt het formaat automatisch gedetecteerd. Mogelijke formaten zijn onder meer "raw" en
"qkoe2".

Automatische detectie van het formaat stelt u bloot aan een potentieel beveiligingslek
omgaan met onbetrouwbare afbeeldingen in raw-formaat. Zie CVE-2010-3851 en RHBZ#642934.
Door het formaat op te geven, wordt dit beveiligingslek gedicht.

"iface"
Met deze zelden gebruikte optie kunt u het gedrag van de verouderde "add-drive-
met-als"-aanroep (zie aldaar)

"naam"
De naam die de schijf had in de oorspronkelijke gast, bijvoorbeeld / Dev / sdb. Dit wordt gebruikt als hint
aan het gastinspectieproces, indien beschikbaar.

"label"
Geef de schijf een label. Het label moet een unieke, korte tekenreeks zijn Slechts ASCII
tekens "[a-zA-Z]". Evenals de gebruikelijke naam in de API (zoals / Dev / sda), De
schijf zal ook een naam krijgen /dev/disk/guestfs/label.

Zie "SCHIJFLABELS" in gastfs(3).

"protocol"
Het optionele protocolargument kan worden gebruikt om een ​​alternatief bronprotocol te selecteren.

Zie ook: "OPSLAG OP AFSTAND" in gastfs(3).

"protocol = "bestand""
bestandsnaam wordt geïnterpreteerd als een lokaal bestand of apparaat. Dit is de standaardinstelling als de
optionele protocolparameter wordt weggelaten.

"protocol = "ftp"|"ftps"|"http"|"https"|"tftp""
Maak verbinding met een externe FTP-, HTTP- of TFTP-server. De parameter "server" moet ook zijn
meegeleverd - zie hieronder.

Zie ook: "FTP, HTTP EN TFTP" in gastfs(3)

"protocol = "glans""
Maak verbinding met de GlusterFS-server. De parameter "server" moet ook worden opgegeven -
zie hieronder.

Zie ook: "GLUSTER" in gastfs(3)

"protocol = "iscsi""
Maak verbinding met de iSCSI-server. De parameter "server" moet ook worden opgegeven - zie
onderstaand. De parameter "gebruikersnaam" kan worden opgegeven. Zie hieronder. Het geheim"
parameter kan worden geleverd. Zie hieronder.

Zie ook: "ISCSI" in gastfs(3).

"protocol = "nbd""
Maak verbinding met de Network Block Device-server. De parameter "server" moet ook zijn
meegeleverd - zie hieronder.

Zie ook: "NETWERKBLOKAPPARAAT" in gastfs(3).

"protocol = "rbd""
Maak verbinding met de Ceph-server (librbd/RBD). De parameter "server" moet ook zijn
meegeleverd - zie hieronder. De parameter "gebruikersnaam" kan worden opgegeven. Zie hieronder. De
De parameter "geheim" kan worden opgegeven. Zie hieronder.

Zie ook: "CEPH" in gastfs(3).

"protocol = "herdershond""
Maak verbinding met de Sheepdog-server. De parameter "server" kan ook worden opgegeven - zie
hieronder.

Zie ook: "HERDERHOND" in gastfs(3).

"protocol = "ssh""
Maak verbinding met de Secure Shell-server (ssh).

De parameter "server" moet worden opgegeven. De parameter "gebruikersnaam" kan zijn
geleverd. Zie hieronder.

Zie ook: "SSH" in gastfs(3).

"server"
Voor protocollen die toegang tot een externe server vereisen, is dit een lijst met server(s).

Protocol Aantal benodigde servers
----------------------- --------------------------
bestandslijst moet leeg zijn of de parameter moet helemaal niet worden gebruikt
ftp|ftps|http|https|tftp Precies één
glans Precies één
iscsi Precies één
nb Precies één
rbd Nul of meer
herdershond Nul of meer
ssh Precies één

Elk lijstelement is een tekenreeks die een server specificeert. De tekenreeks moet zich in een van de
volgende formaten:

hostname
hostnaam:poort
tcp:hostnaam
tcp:hostnaam:poort
unix:/pad/naar/socket

Als het poortnummer wordt weggelaten, wordt het standaardpoortnummer voor het protocol gebruikt
(Zie / Etc / services).

"gebruikersnaam"
Voor de protocollen "ftp", "ftps", "http", "https", "iscsi", "rbd", "ssh" en "tftp",
dit specificeert de externe gebruikersnaam.

Indien niet opgegeven, wordt de lokale gebruikersnaam gebruikt voor "ssh", en is er geen sprake van authenticatie
geprobeerd voor ceph. Maar let op: dit kan bijvoorbeeld soms onverwachte resultaten opleveren
als u de libvirt-backend gebruikt en als de libvirt-backend is geconfigureerd om het
qemu-apparaat als een speciale gebruiker, zoals "qemu.qemu". Geef bij twijfel de afstandsbediening op
gewenste gebruikersnaam.

"geheim"
Alleen voor het "rbd"-protocol specificeert dit het 'geheim' dat moet worden gebruikt bij het verbinden met de
apparaat op afstand. Het moet base64-gecodeerd zijn.

Als dit niet wordt opgegeven, wordt er een geheim opgezocht dat overeenkomt met de opgegeven gebruikersnaam
standaard sleutelhangerlocaties, of als er geen gebruikersnaam is opgegeven, zal er geen authenticatie plaatsvinden
gebruikt.

"cachemodus"
Kies of libguestfs al dan niet synchronisatiebewerkingen zal uitvoeren (veilig maar langzaam) of niet
(onveilig maar snel). De mogelijke waarden voor deze tekenreeks zijn:

"cachemode = "terugschrijven""
Dit is de standaardinstelling.

Schrijfbewerkingen in de API komen pas terug als a schrijven(2) oproep is voltooid
de host [maar merk op dat dit niet betekent dat er iets naar de schijf wordt geschreven].

Synchronisatiebewerkingen in de API, inclusief impliciete synchronisaties veroorzaakt door het bestandssysteem
journalling, zal niet terugkeren tot een fdatasync(2) oproep is voltooid in de host,
wat aangeeft dat gegevens op schijf zijn opgeslagen.

"cachemode = "onveilig""
In deze modus zijn er geen garanties. Libguestfs kan alles in de cache opslaan en negeren
synchronisatieverzoeken. Dit is alleen geschikt voor scratch- of tijdelijke schijven.

"weggooien"
Schakel ondersteuning voor weggooien (ook wel trimmen of unmap genoemd) op deze schijf in of uit. Indien ingeschakeld,
operaties zoals "fstrim" zullen in staat zijn om gaten in de
het onderliggende hostbestand of apparaat.

Mogelijke verwijderinstellingen zijn:

"weggooien = "uitschakelen""
Schakel ondersteuning voor weggooien uit. Dit is de standaardinstelling.

"weggooien = "inschakelen""
Schakel ondersteuning voor weggooien in. Mislukt als weggooien niet mogelijk is.

"weggooien = "besteffort""
Schakel indien mogelijk ondersteuning voor weggooien in, maar faal niet als dit niet wordt ondersteund.

Omdat niet alle backends en niet alle onderliggende systemen het weggooien ondersteunen, is dit een
goede keuze als je indien mogelijk weggooien wilt gebruiken, maar vind het niet erg als dat niet het geval is
werken.

"kopiërenlezen"
De booleaanse parameter "copyonread" maakt ondersteuning voor kopiëren bij lezen mogelijk. Dit heeft alleen invloed
schijfformaten die back-upbestanden hebben, en zorgt ervoor dat leesbewerkingen in de overlay worden opgeslagen
laag, waardoor meerdere leesbewerkingen van hetzelfde schijfgebied worden versneld.

De standaardwaarde is onwaar.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

add-drive-ro
add-ro
add-drive-ro bestandsnaam

Deze functie is het equivalent van het aanroepen van "add-drive-opts" met de optionele parameter
"GUESTFS_ADD_DRIVE_OPTS_READONLY" ingesteld op 1, zodat de schijf alleen-lezen wordt toegevoegd, met de
formaat automatisch gedetecteerd.

add-drive-ro-met-if
add-drive-ro-with-if bestandsnaam iface

Dit is hetzelfde als "add-drive-ro", maar u kunt hiermee de QEMU-interface specificeren
emulatie om tijdens runtime te gebruiken.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "add-drive".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

add-drive-scratch
krassen
add-drive-scratch-grootte [naam:..] [label:..]

Met deze opdracht wordt een tijdelijke werkdrive aan de handle toegevoegd. De parameter "grootte" is de
virtuele grootte (in bytes). De scratchdrive is aanvankelijk leeg (alle lezingen retourneren nullen
totdat je ernaar begint te schrijven). Bij het sluiten van de handgreep wordt de aandrijving verwijderd.

De optionele argumenten "naam" en "label" worden doorgegeven aan "add-drive".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

voeg-drive-met-if toe
add-drive-with-if bestandsnaam iface

Dit is hetzelfde als "add-drive", maar u kunt hiermee de QEMU-interface-emulatie specificeren
te gebruiken tijdens runtime.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "add-drive".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

aug-duidelijk
aug-clear augpath

Stel de waarde die is gekoppeld aan "path" in op "NULL". Dit is hetzelfde als de vergrootglas(1)
commando "duidelijk".

aug-sluiten
aug-sluiten

Sluit de huidige Augeas-handle en maak alle bronnen vrij die erdoor worden gebruikt. Na dit gebeld te hebben,
je moet opnieuw "aug-init" aanroepen voordat je andere Augeas-functies kunt gebruiken.

aug-defnode
aug-defnode naam expr val

Definieert een variabele "naam" waarvan de waarde het resultaat is van de evaluatie van "expr".

Als "expr" resulteert in een lege knooppuntenset, wordt er een knooppunt gemaakt, wat overeenkomt met het aanroepen van "aug-
set" "expr", "value". "name" zal de knooppuntset zijn die dat enkele knooppunt bevat.

Bij succes retourneert dit een paar met het aantal knooppunten in de knooppuntenset, en a
Booleaanse vlag als er een knooppunt is gemaakt.

aug-defvar
aug-defvar naam expr

Definieert een Augeas-variabele "naam" waarvan de waarde het resultaat is van de evaluatie van "expr". Als
"expr" is NULL, daarna is "naam" ongedefinieerd.

Bij succes retourneert dit het aantal knooppunten in "expr", of 0 als "expr" resulteert in
iets dat geen knooppuntset is.

aug-krijg
aug-get augpath

Zoek de waarde op die is gekoppeld aan 'pad'. Als 'pad' precies met één knooppunt overeenkomt, wordt de 'waarde'
wordt geretourneerd.

aug-init
aug-init root-vlaggen

Maak een nieuwe Augeas-handle voor het bewerken van configuratiebestanden. Als er een eerdere was
Als de Augeas-handle aan deze guestfs-sessie is gekoppeld, wordt deze gesloten.

U moet dit aanroepen voordat u andere "aug-*"-opdrachten gebruikt.

"root" is de root van het bestandssysteem. "root" mag niet NULL zijn, gebruik / gebruiken.

De vlaggen zijn dezelfde als de vlaggen gedefinieerd in , het logische or van de volgende
gehele getallen:

"AUG_SAVE_BACKUP" = 1
Bewaar het originele bestand met de extensie ".augsave".

"AUG_SAVE_NEWFILE" = 2
Sla de wijzigingen op in een bestand met de extensie ".augnew", en overschrijf het origineel niet.
Overschrijft 'AUG_SAVE_BACKUP'.

"AUG_TYPE_CHECK" = 4
Typecheck lenzen.

Deze optie is alleen nuttig bij het debuggen van Augeas-lenzen. Het gebruik van deze optie mag
extra geheugen nodig voor het libguestfs-apparaat. Mogelijk moet u de
"LIBGUESTFS_MEMSIZE" omgevingsvariabele of roep "set-memsize" aan.

"AUG_NO_STDINC" = 8
Gebruik geen standaard laadpad voor modules.

"AUG_SAVE_NOOP" = 16
Maak van opslaan een no-op, registreer gewoon wat er zou zijn veranderd.

"AUG_NO_LOAD" = 32
Laad de boom niet in "aug-init".

Om de hendel te sluiten, kunt u "aug-close" oproepen.

Voor meer informatie over Augeas, zie http://augeas.net/.

aug-invoegen
aug-insert augpath-label true|false

Maak een nieuw "label" voor "pad" en plaats dit in de boomstructuur voor of na "pad"
(afhankelijk van de Booleaanse vlag "before").

"pad" moet exact overeenkomen met één bestaand knooppunt in de boom, en "label" moet een label zijn, dwz.
bevat niet /, "*" of eindig met een index tussen haakjes "[N]".

aug-label
aug-label augpad

Het label (naam van het laatste element) van de Augeas-padexpressie "augpath" wordt geretourneerd.
"augpath" moet exact overeenkomen met één knooppunt, anders retourneert deze functie een fout.

aug-lading
aug-lading

Bestanden in de boom laden.

Zie "aug_load" in de Augeas-documentatie voor de volledige bloederige details.

aug-ls
aug-ls augpath

Dit is slechts een snelkoppeling voor het weergeven van "aug-match" "path/*" en het sorteren van de resulterende knooppunten
in alfabetische volgorde.

aug-wedstrijd
aug-match augpad

Retourneert een lijst met paden die overeenkomen met de padexpressie "pad". De geretourneerde paden zijn
voldoende gekwalificeerd zodat ze precies overeenkomen met één knooppunt in de huidige boom.

aug-mv
aug-mv src bestem

Verplaats het knooppunt "src" naar "dest". "src" moet exact overeenkomen met één knooppunt. "dest" wordt overschreven
als het bestaat.

augustus-rm
aug-rm augpad

Verwijder "pad" en al zijn kinderen.

Bij succes retourneert dit het aantal verwijderde vermeldingen.

aug-opslaan
aug-opslaan

Hiermee worden alle openstaande wijzigingen naar schijf geschreven.

De vlaggen die zijn doorgegeven aan "aug-init" hebben precies invloed op de manier waarop bestanden worden opgeslagen.

aug-set
aug-set augpath val

Stel de waarde die is gekoppeld aan "path" in op "val".

In de Augeas API is het mogelijk een knooppunt te wissen door de waarde in te stellen op NULL. Vanwege een
toezicht in de libguestfs API kun je met deze aanroep niet doen. In plaats daarvan moet u gebruiken
de "augustus-clear" oproep.

aug-setm
aug-setm basis sub val

Wijzig meerdere Augeas-knooppunten in één handeling. "basis" is een overeenkomende uitdrukking
meerdere knooppunten. "sub" is een padexpressie ten opzichte van "base". Alle knooppunten die overeenkomen met "basis"
worden gevonden, en vervolgens wordt voor elk knooppunt "sub" gewijzigd in "val". "sub" kan ook "NULL" zijn
in welk geval de "basis" -knooppunten worden gewijzigd.

Dit retourneert het aantal gewijzigde knooppunten.

Beschikbaar
beschikbare 'groepen...'

Deze opdracht wordt gebruikt om de beschikbaarheid van bepaalde functionaliteitsgroepen in het
device, die niet alle builds van het libguestfs-apparaat kunnen bieden.

De libguestfs-groepen en de functies waarmee deze groepen corresponderen, worden vermeld in
"BESCHIKBAARHEID" in gastfs(3). U kunt deze lijst ook tijdens runtime ophalen door te bellen
"beschikbaar-alle-groepen".

Het argument "groepen" is een lijst met groepsnamen, bijvoorbeeld: "["inotify", "augeas"]" zou controleren
voor de beschikbaarheid van de Linux inotify-functies en Augeas (configuratiebestand
bewerken) functies.

De opdracht retourneert geen fout if allen gevraagde groepen zijn beschikbaar.

Het mislukt met een foutmelding als een of meer van de aangevraagde groepen niet beschikbaar zijn in de
apparaat.

Als er een onbekende groepsnaam in de lijst met groepen staat, is er altijd een fout
teruggekeerd.

Opmerkingen:

· "feature-available" is hetzelfde als deze aanroep, maar met een iets eenvoudiger te gebruiken API:
die aanroep retourneert een booleaanse waarde waar/onwaar in plaats van een fout te genereren.

· U moet "launch" aanroepen voordat u deze functie oproept.

De reden is dat we niet weten welke groepen door het apparaat/de daemon worden ondersteund
totdat het actief is en kan worden opgevraagd.

· Als een groep functies beschikbaar is, betekent dit niet noodzakelijkerwijs dat deze ook beschikbaar zijn
werk. Zelfs bij het aanroepen van afzonderlijke API-functies moet u nog steeds op fouten controleren
als ze beschikbaar zijn.

· Het is meestal de taak van distributieverpakkers om volledige functionaliteit in het
libguestfs-apparaat. Upstream libguestfs, indien gebouwd vanuit de broncode en met alle vereisten
tevreden, zal alles ondersteunen.

· Deze oproep is toegevoegd in versie 1.0.80. In eerdere versies van libguestfs all you
zou kunnen doen, zou zijn om speculatief een commando uit te voeren om erachter te komen of de daemon
implementeerde het. Zie ook "versie".

Zie ook "bestandssysteem beschikbaar".

beschikbare-alle-groepen
beschikbare-alle-groepen

Deze opdracht retourneert een lijst met alle optionele groepen waarvan deze daemon op de hoogte is. Opmerking
dit retourneert zowel ondersteunde als niet-ondersteunde groepen. Om erachter te komen welke de daemon kan
eigenlijk ondersteuning moet je "beschikbaar" / "functie-beschikbaar" noemen voor elk lid van de
geretourneerde lijst.

Zie ook "beschikbaar", "beschikbare functies" en "BESCHIKBAARHEID" in gastfs(3).

basis64-in
base64-in (base64file|-) bestandsnaam

Met deze opdracht worden met base64 gecodeerde gegevens van "base64file" geüpload naar bestandsnaam.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

honk64-uit
base64-out bestandsnaam (base64file|-)

Met deze opdracht wordt de inhoud van bestandsnaam, door het uit te schrijven naar het lokale bestand "base64file"
gecodeerd als base64.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

blkweggooien
blkdiscard-apparaat

Hierdoor worden alle blokken op het blokapparaat "apparaat" weggegooid, waardoor de vrije ruimte teruggaat naar de
gastheer.

Deze operatie vereist ondersteuning in libguestfs, het hostbestandssysteem, qemu en de host
kern. Als deze ondersteuning niet aanwezig is, kan het een foutmelding geven of zelfs lijken te werken, maar dat gebeurt wel
Niets. U moet ook het kenmerk "discard" instellen op de onderliggende schijf (zie "add-
drive-opts").

blkweggooinullen
blkdiscardzeroes-apparaat

Deze oproep retourneert waar als er blokken op "apparaat" zijn verwijderd door een oproep
"blkdiscard" wordt bij de volgende keer lezen geretourneerd als blokken van nul bytes.

Als het false retourneert, kan het zijn dat weggegooide blokken als oud of willekeurig worden gelezen
data.

blkid
blkid-apparaat

Deze opdracht retourneert blokapparaatkenmerken voor "apparaat". De volgende velden zijn
meestal aanwezig in de geretourneerde hash. Er kunnen ook andere velden aanwezig zijn.

"UUID"
De uuid van dit apparaat.

"ETIKET"
Het label van dit apparaat.

"VERSIE"
De versie van de blkid-opdracht.

"TYPE"
Het bestandssysteemtype of RAID van dit apparaat.

"GEBRUIK"
Het gebruik van dit apparaat, bijvoorbeeld "bestandssysteem" of "raid".

blockdev-flushbufs
blockdev-flushbufs-apparaat

Dit vertelt de kernel om interne buffers te spoelen die geassocieerd zijn met "device".

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-getbsz
blockdev-getbsz-apparaat

Dit retourneert de blokgrootte van een apparaat.

Let op: dit is bij beide verschillend lengte van de duwkabel in blokken en bestandssysteem blok lengte van de duwkabel. Dit ook
instelling wordt door niets echt gebruikt. Je moet het waarschijnlijk nergens voor gebruiken.
Bestandssystemen hebben hun eigen idee over welke blokgrootte ze moeten kiezen.

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-getro
blockdev-getro-apparaat

Retourneert een Booleaanse waarde die aangeeft of het blokapparaat alleen-lezen is (true als alleen-lezen, false als
niet).

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-getsize64
blockdev-getsize64-apparaat

Dit retourneert de grootte van het apparaat in bytes.

Zie ook "blockdev-getsz".

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-getss
blockdev-getss-apparaat

Dit retourneert de grootte van sectoren op een blokapparaat. Meestal 512, maar kan ook groter zijn
moderne apparaten.

(Let op, dit is niet de grootte in sectoren, gebruik daarvoor "blockdev-getsz").

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-getsz
blockdev-getsz-apparaat

Dit retourneert de grootte van het apparaat in eenheden van sectoren van 512 bytes (zelfs als de sectorsize
is niet 512 bytes ... raar).

Zie ook "blockdev-getss" voor de werkelijke sectorgrootte van het apparaat, en "blockdev-getsize64"
voor de nuttiger lengte van de duwkabel in bytes.

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-herleespt
blockdev-rereadpt-apparaat

Lees de partitietabel op "apparaat" opnieuw.

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-setbsz
blockdev-setbsz apparaatblokgrootte

Deze oproep doet niets en heeft nooit iets gedaan vanwege een bug in blockdev. Do niet
. het.

Als u de blokgrootte van het bestandssysteem moet instellen, gebruikt u de "blocksize" optie van "mkfs".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mkfs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

blockdev-setra
blockdev-setra apparaatsectoren

Stel de leesvoorwaarde in (in sectoren van 512 bytes) voor het apparaat.

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-setro
blockdev-setro-apparaat

Stelt het blokapparaat met de naam "device" in op alleen-lezen.

Dit maakt gebruik van de blokdev(8) opdracht.

blockdev-setrw
blockdev-setrw-apparaat

Stelt het blokapparaat met de naam "device" in op lezen-schrijven.

Dit maakt gebruik van de blokdev(8) opdracht.

btrfs-saldo-annuleren
btrfs-balance-cancel-pad

Annuleer een lopend saldo op een btrfs-bestandssysteem.

btrfs-balans-pauze
btrfs-balans-pauze pad

Pauzeer een lopende balans op een btrfs-bestandssysteem.

btrfs-balans-cv
btrfs-balance-cv-pad

Hervat een gepauzeerd saldo op een btrfs-bestandssysteem.

btrfs-saldo-status
btrfs-balance-statuspad

Toon de status van een lopend of gepauzeerd saldo op een btrfs-bestandssysteem.

btrfs-apparaat-add
btrfs-device-add 'apparaten...' fs

Voeg de lijst met apparaten in "devices" toe aan het btrfs-bestandssysteem dat is gemount op "fs". Als
"apparaten" is een lege lijst, dit doet niets.

btrfs-apparaat-verwijderen
btrfs-device-delete 'apparaten...' fs

Verwijder de "apparaten" uit het btrfs-bestandssysteem dat is gemount op "fs". Als "apparaten" leeg is
lijst, dit levert niets op.

btrfs-bestandssysteem-balans
btrfs-balans
btrfs-bestandssysteem-balans fs

Verdeel de chunks in het btrfs-bestandssysteem dat is gemount op "fs" over de onderliggende apparaten.

btrfs-bestandssysteem-defragmentatie
btrfs-bestandssysteem-defragment pad [flush:true|false] [comprimeren:..]

Defragmenteer een bestand of map op een btrfs-bestandssysteem. comprimeren is een van zlib of lzo.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfs-bestandssysteem-formaat wijzigen
btrfs-bestandssysteem-resize koppelpunt [grootte:N]

Met deze opdracht wordt de grootte van een btrfs-bestandssysteem gewijzigd.

Merk op dat, in tegenstelling tot andere resize-aanroepen, het bestandssysteem moet worden aangekoppeld en dat de parameter dat ook is
het mountpoint, niet het apparaat (dit is een vereiste van btrfs zelf).

De optionele parameters zijn:

"grootte"
De nieuwe grootte (in bytes) van het bestandssysteem. Als u dit weglaat, wordt de grootte van het bestandssysteem gewijzigd in
de maximale grootte.

Zie ook btrfs(8).

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfs-bestandssysteem-synchronisatie
btrfs-bestandssysteem-synchronisatie fs

Forceer synchronisatie op het btrfs-bestandssysteem dat is gemount op "fs".

btrfs-fsck
btrfs-fsck-apparaat [superblock:N] [reparatie:true|false]

Gebruikt om een ​​btrfs-bestandssysteem te controleren, "device" is het apparaatbestand waar het bestandssysteem zich bevindt
opgeslagen.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfs-afbeelding
btrfs-image 'bron...' afbeelding [compressniveau:N]

Dit wordt gebruikt om een ​​afbeelding van een btrfs-bestandssysteem te maken. Alle gegevens worden op nul gezet, maar
metadata en dergelijke blijven behouden.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfs-qgroup-toewijzen
btrfs-qgroup-src dst-pad toewijzen

Voeg qgroup "src" toe aan bovenliggende qgroup "dst". Met dit commando kunnen verschillende qgroups worden gegroepeerd in een
bovenliggende qgroup om de gemeenschappelijke limiet te delen.

btrfs-qgroup-create
btrfs-qgroup-create qgroupid-subvolume

Maak een quotagroep (qgroup) voor subvolume op "subvolume".

btrfs-qgroup-vernietigen
btrfs-qgroup-destroy qgroupid-subvolume

Een quotagroep vernietigen.

btrfs-qgroup-limiet
btrfs-qgroup-limit subvolumegrootte

Beperk de grootte van een subvolume waarvan het pad "subvolume" is. "grootte" kan het achtervoegsel G, M,
of K

btrfs-qgroup-verwijderen
btrfs-qgroup-remove src dst-pad

Verwijder qgroup "src" uit de bovenliggende qgroup "dst".

btrfs-qgroup-show
btrfs-qgroup-show pad

Toon alle subvolumequotagroepen in een btrfs-bestandssysteem, inclusief hun gebruik.

btrfs-quota-enable
btrfs-quotum-enable fs true|false

Schakel ondersteuning voor subvolumequota in of uit voor bestandssystemen die "pad" bevatten.

btrfs-quota-rescan
btrfs-quota-rescan fs

Verwijder alle qgroup-nummers en scan de metadata opnieuw met de huidige configuratie.

btrfs-vervangen
btrfs-vervang srcdev targetdev mntpoint

Vervang het apparaat van een btrfs-bestandssysteem. Op een live bestandssysteem dupliceert u de gegevens naar het
doelapparaat dat momenteel op het bronapparaat is opgeslagen. Na voltooiing van de
operatie, wordt het bronapparaat weggevaagd en uit het bestandssysteem verwijderd.

De "targetdev" moet even groot of groter zijn dan de "srcdev". Apparaten die dat wel zijn
die momenteel is aangekoppeld, mogen nooit worden gebruikt als de "targetdev".

btrfs-rescue-chunk-recover
btrfs-rescue-chunk-recover-apparaat

Herstel de chunkboom van het btrfs-bestandssysteem door de apparaten één voor één te scannen.

btrfs-rescue-super-herstel
btrfs-rescue-super-recover-apparaat

Herstel slechte superblokken van goede kopieën.

btrfs-scrub-annuleren
btrfs-scrub-cancel-pad

Annuleer een actieve scrub op een btrfs-bestandssysteem.

btrfs-scrub-cv
btrfs-scrub-cv-pad

Hervat een eerder geannuleerde of onderbroken scrub op een btrfs-bestandssysteem.

btrfs-scrub-start
btrfs-scrub-startpad

Leest alle gegevens en metagegevens op het bestandssysteem en gebruikt controlesommen en het duplicaat
kopieën van RAID-opslag om eventuele corrupte gegevens te identificeren en te repareren.

btrfs-scrub-status
btrfs-scrub-status pad

Toon de status van actieve of voltooide scrub op een btrfs-bestandssysteem.

btrfs-set-zaaien
btrfs-set-seeding-apparaat true|false

Schakel de seeding-functie in of uit van een apparaat dat een btrfs-bestandssysteem bevat.

btrfs-subvolume-create
btrfs-subvolume-create-opts
btrfs-subvolume-aanmaken bestemming [qgroupid:..]

Maak een btrfs-subvolume. Het argument "dest" is de doelmap en de naam
van het deelvolume, in de vorm /pad/naar/bestemming/naam. De optionele parameter "qgroupid"
vertegenwoordigt de qgroup waaraan het nieuw gemaakte subvolume zal worden toegevoegd.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfs-subvolume-verwijderen
btrfs-subvolume-subvolume verwijderen

Verwijder het genoemde btrfs-subvolume of de momentopname.

btrfs-subvolume-get-default
btrfs-subvolume-get-default fs

Haal het standaard subvolume of de momentopname op van een bestandssysteem dat is gemount op "mountpoint".

btrfs-subvolume-lijst
btrfs-subvolume-lijst fs

Maak een lijst van de btrfs-snapshots en subvolumes van het btrfs-bestandssysteem dat is aangekoppeld op "fs".

btrfs-subvolume-set-standaard
btrfs-subvolume-set-standaard id fs

Stel het subvolume van het btrfs-bestandssysteem "fs" in dat standaard wordt aangekoppeld. Zien
"btrfs-subvolume-list" om een ​​lijst met subvolumes te krijgen.

btrfs-subvolume-show
btrfs-subvolume-toon subvolume

Gedetailleerde informatie over het subvolume retourneren.

btrfs-subvolume-snapshot
btrfs-subvolume-snapshot-opts
btrfs-subvolume-snapshot bronbestemming [ro:true|false] [qgroupid:..]

Maak een momentopname van het btrfs-subvolume "bron". Het argument "dest" is de bestemming
map en de naam van de momentopname, in het formulier /pad/naar/bestemming/naam. Standaard is de
De nieuw gemaakte momentopname is beschrijfbaar als de waarde van de optionele parameter "ro" waar is
Er wordt een alleen-lezen momentopname gemaakt. De optionele parameter "qgroupid" vertegenwoordigt de qgroup
waaraan de nieuw gemaakte momentopname wordt toegevoegd.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

btrfstune-inschakelen-uitgebreide-inode-refs
btrfstune-enable-extended-inode-refs-apparaat

Hierdoor worden uitgebreide inode-referenties ingeschakeld.

btrfstune-enable-magere-metadata-extent-refs
btrfstune-enable-skinny-metadata-extent-refs-apparaat

Dit maakt skinny metadata-referenties mogelijk.

btrfstune-zaaien
btrfstune-seeding-apparaat true|false

Schakel het seeden van een btrfs-apparaat in, dit zal een fs-readonly forceren, zodat u het kunt gebruiken
andere bestandssystemen bouwen.

c-wijzer
c-wijzer

In niet-C-taalbindingen kunt u hiermee de onderliggende C-aanwijzer naar de
handvat (dat wil zeggen "h *"). Het doel hiervan is om andere bibliotheken te laten samenwerken
libguestfs.

canonieke-apparaatnaam
canonieke apparaatnaam apparaat

Deze hulpprogrammafunctie is handig bij het weergeven van apparaatnamen aan de gebruiker. Het duurt een
aantal onregelmatige apparaatnamen en retourneert deze in een consistent formaat:

/dev/hdX
/dev/vdX
Deze worden geretourneerd als / Dev / sdX. Merk op dat dit werkt voor apparaatnamen en partitienamen.
Dit is ongeveer het omgekeerde van het algoritme dat wordt beschreven in "BLOCK DEVICE NAMING"
in gastfs(3).

/dev/mapper/VG-LV
/dev/dm-N
Omgezet naar /dev/VG/LV formulier met behulp van "lvm-canonieke-lv-naam".

Andere tekenreeksen worden ongewijzigd geretourneerd.

cap-get-bestand
cap-get-bestandspad

Deze functie retourneert de Linux-mogelijkheden die zijn gekoppeld aan "pad". De ingestelde mogelijkheden zijn
terug in tekstvorm (zie cap_to_text(3)).

Als er geen mogelijkheden aan een bestand zijn gekoppeld, wordt een lege tekenreeks geretourneerd.

cap-set-bestand
cap-set-bestandspad cap

Met deze functie worden de Linux-mogelijkheden ingesteld die aan "pad" zijn gekoppeld. De mogelijkheden zijn ingesteld op "cap"
moet in tekstvorm worden doorgegeven (zie cap_from_text(3)).

hoofdlettergevoelig pad
hoofdlettergevoelig pad

Dit kan worden gebruikt om hoofdletterongevoelige paden op te lossen op een bestandssysteem dat hoofdlettergebruik is
gevoelig. De use case is om paden op te lossen die u vanuit Windows hebt gelezen
configuratiebestanden of het Windows-register, naar het ware pad.

De opdracht behandelt een bijzonderheid van het Linux ntfs-3g-bestandssysteemstuurprogramma (en waarschijnlijk
anderen), namelijk dat, hoewel het onderliggende bestandssysteem hoofdletterongevoelig is, de driver
exporteert het bestandssysteem naar Linux als hoofdlettergevoelig.

Een gevolg hiervan is dat speciale mappen zoals C:\windows kan verschijnen als
/RAMEN or /ramen (of andere dingen), afhankelijk van de precieze details van hoe ze waren
gemaakt. In Windows zelf zou dit geen probleem zijn.

Bug of functie? Jij beslist: http://www.tuxera.com/community/ntfs-3g-faq/#posixbestandsnamen1

"case-sensitive-path" probeert het ware hoofdlettergebruik van elk element in het pad op te lossen. Het
zal een opgelost pad retourneren als het volledige pad of de bovenliggende map bestaat. Als de
de bovenliggende map bestaat, maar het volledige pad niet; in het geval van de bovenliggende map wel
correct worden opgelost en de rest ongewijzigd wordt toegevoegd. Als het bestand bijvoorbeeld
"/Windows/System32/netkvm.sys" bestaat:

"hoofdlettergevoelig pad" ("/windows/system32/netkvm.sys")
"Windows/System32/netkvm.sys"

"hoofdlettergevoelig pad" ("/windows/system32/NoSuchFile")
"Windows/System32/NoSuchFile"

"hoofdlettergevoelig pad" ("/windows/system33/netkvm.sys")
FOUT

Note: Vanwege het bovenstaande gedrag kan "case-sensitive-path" niet worden gebruikt om te controleren
het bestaan ​​van een bestand.

Note: Deze functie verwerkt geen stationsnamen, backslashes enz.

Zie ook "realpath".

hoe
katten pad

Retourneer de inhoud van het bestand met de naam "pad".

Omdat deze functie in C een "char *" retourneert, is er geen manier om onderscheid te maken tussen
een teken "\0" in een bestand en het einde van de tekenreeks. Om binaire bestanden te verwerken, gebruikt u het "leesbestand"
of "download"-functies.

checksum
checksum csumtype-pad

Deze aanroep berekent de MD5-, SHAx- of CRC-controlesom van het bestand met de naam "pad".

Het type controlesom dat moet worden berekend, wordt gegeven door de parameter "csumtype", die er één moet hebben
van de volgende waarden:

"crc"
Bereken de cyclische redundantiecontrole (CRC) gespecificeerd door POSIX voor de opdracht "cksum".

"md5"
Bereken de MD5-hash (met behulp van het programma "md5sum").

"sha1"
Bereken de SHA1-hash (met behulp van het programma "sha1sum").

"sha224"
Bereken de SHA224-hash (met behulp van het programma "sha224sum").

"sha256"
Bereken de SHA256-hash (met behulp van het programma "sha256sum").

"sha384"
Bereken de SHA384-hash (met behulp van het programma "sha384sum").

"sha512"
Bereken de SHA512-hash (met behulp van het programma "sha512sum").

De controlesom wordt geretourneerd als een afdrukbare tekenreeks.

Om de controlesom voor een apparaat te verkrijgen, gebruikt u "checksum-device".

Om de controlesommen voor veel bestanden te verkrijgen, gebruikt u "checksums-out".

checksum-apparaat
checksum-apparaat csumtype-apparaat

Deze aanroep berekent de MD5-, SHAx- of CRC-controlesom van de inhoud van het genoemde apparaat
"apparaat". Zie de opdracht "checksum" voor de typen ondersteunde controlesommen.

controlesommen-uit
checksums-out csumtype map (sumsfile|-)

Deze opdracht berekent de controlesommen van alle reguliere bestanden in directory en zendt dan een uit
lijst met deze controlesommen naar het lokale uitvoerbestand "sumsfile".

Dit kan worden gebruikt voor het verifiëren van de integriteit van een virtuele machine. Maar om goed te zijn
secure moet u letten op de uitvoer van het checksum-commando (het gebruikt degenen
van GNU coreutils). In het bijzonder wanneer de bestandsnaam niet afdrukbaar is, gebruikt coreutils een
speciale backslash-syntaxis. Zie het GNU coreutils-infobestand voor meer informatie.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

chmod
chmod-modus pad

Wijzig de modus (rechten) van "pad" in "modus". Alleen numerieke modi worden ondersteund.

Note: Wanneer u deze opdracht van guestfish gebruikt, is "mode" standaard decimaal, tenzij
je voegt er 0 aan toe om octaal te krijgen, dat wil zeggen. gebruik 0700 en niet 700.

De feitelijk ingestelde modus wordt beïnvloed door het umask.

chown
chown eigenaarsgroepspad

Wijzig de bestandseigenaar in "eigenaar" en de groep in "groep".

Alleen numerieke uid en gid worden ondersteund. Als u namen wilt gebruiken, moet u lokaliseren
en parseer het wachtwoordbestand zelf (Augeas-ondersteuning maakt dit relatief eenvoudig).

clear-backend-instelling
naam voor clear-backend-instelling

Als er een backend-instellingsreeks is die overeenkomt met "name" of begint met "name=", dan is dat het geval
string wordt verwijderd uit de backend-instellingen.

Deze aanroep retourneert het aantal tekenreeksen dat is verwijderd (dit kan 0, 1 of groter zijn).
dan 1).

Zie "ACHTERUIT" in gastfs(3), "BACKEND-INSTELLINGEN" in gastfs(3).

commando
commando 'argumenten...'

Deze aanroep voert een opdracht uit vanaf het gastbestandssysteem. Het bestandssysteem moet zijn aangekoppeld, en
moet een compatibel besturingssysteem bevatten (dat wil zeggen iets Linux, met hetzelfde of
compatibele processorarchitectuur).

De enkele parameter is een lijst met argumenten in argv-stijl. Het eerste element is de naam van
het programma dat moet worden uitgevoerd. Volgende elementen zijn parameters. De lijst mag niet leeg zijn (bijv.
moet een programmanaam bevatten). Merk op dat de opdracht rechtstreeks wordt uitgevoerd en dat ook is niet aangeroepen via
de schaal (zie "sh").

De retourwaarde is alles waarnaar wordt afgedrukt stdout door het commando.

Als de opdracht een afsluitstatus anders dan nul retourneert, retourneert deze functie een fout
bericht. De foutberichtreeks is de inhoud van stderr van het commando.

De omgevingsvariabele $PATH bevat minimaal / Usr / bin en / bin. Als u een
programma vanaf een andere locatie, moet u het volledige pad in de eerste parameter opgeven.

Gedeelde bibliotheken en gegevensbestanden die door het programma nodig zijn, moeten beschikbaar zijn op bestandssystemen
die op de juiste plaatsen gemonteerd zijn. Het is de verantwoordelijkheid van de beller om alles te controleren
bestandssystemen die nodig zijn, worden op de juiste locaties gemount.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

opdrachtregels
opdrachtregels 'argumenten ...'

Dit is hetzelfde als "opdracht", maar splitst het resultaat op in een lijst met regels.

Zie ook: "sh-lijnen"

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

comprimeren-apparaat-uit
compress-device-out ctype-apparaat (zdevice|-) [niveau:N]

Met deze opdracht wordt "device" gecomprimeerd en naar het lokale bestand "zdevice" geschreven.

De parameters "ctype" en optionele "level" hebben dezelfde betekenis als in "compress-out".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

uitpersen
gecomprimeerd ctype-bestand (zfile|-) [niveau:N]

Deze opdracht comprimeert filet en schrijft het naar het lokale bestand zbestand.

Het gebruikte compressieprogramma wordt bestuurd door de parameter "ctype". Momenteel dit
omvat: "comprimeren", "gzip", "bzip2", "xz" of "lzop". Bij sommige compressietypen is dit mogelijk niet het geval
ondersteund door bepaalde builds van libguestfs, in welk geval u een foutmelding krijgt
met de subtekenreeks "niet ondersteund".

De optionele parameter "level" regelt het compressieniveau. De betekenis en standaard voor
deze parameter is afhankelijk van het compressieprogramma dat wordt gebruikt.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

config
config hvparam hvwaarde

Dit kan worden gebruikt om willekeurige hypervisorparameters aan het formulier toe te voegen -param waarde.
Eigenlijk is het niet helemaal willekeurig - we voorkomen dat u een aantal parameters instelt
zou interfereren met de parameters die we gebruiken.

Het eerste teken van de tekenreeks "hvparam" moet een "-" (streepje) zijn.

"hvwaarde" kan NULL zijn.

kopieer-attributen
kopieerkenmerken src dest [all:true|false] [mode:true|false] [xattributes:true|false] [eigendom:true|false]

Kopieer de kenmerken van een pad (dit kan een bestand of een map zijn) naar een ander pad.

Standaard wordt het kenmerk 'no' gekopieerd, dus zorg ervoor dat u een (of 'all') opgeeft om te kopiëren
alles).

De optionele argumenten specificeren welke attributen kunnen worden gekopieerd:

"modus"
Kopieer een deel van de bestandsmodus van "bron" naar "bestemming". Alleen de UNIX-machtigingen
en de sticky/setuid/setgid-bits kunnen worden gekopieerd.

"xattributen"
Kopieer de uitgebreide Linux-kenmerken (xattrs) van "bron" naar "bestemming". Deze vlag
doet niets als de linuxxattrs functie is niet beschikbaar (zie "functie beschikbaar").

"eigendom"
Kopieer de eigenaar-UID en de groepsgid van "bron" naar "bestemming".

"alle"
Kopiëren allen de attributen van "bron" tot "bestemming". Als u dit inschakelt, worden alle
andere vlaggen, als deze nog niet zijn opgegeven.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

kopieer-apparaat-naar-apparaat
kopieer-apparaat-naar-apparaat src dest [srcoffset:N] [destoffset:N] [grootte:N] [sparse:true|false] [toevoegen:true|false]

De vier oproepen "kopieer-apparaat-naar-apparaat", "kopieer-apparaat-naar-bestand", "kopieer-bestand-naar-apparaat" en
Met "kopieer-bestand-naar-bestand" kunt u kopiëren van een bron (apparaat | bestand) naar een bestemming
(apparaat|bestand).

Er kunnen gedeeltelijke kopieën worden gemaakt, omdat u optioneel de bronverschuiving en bestemming kunt opgeven
offset en formaat om te kopiëren. Deze waarden zijn allemaal gespecificeerd in bytes. Indien niet gegeven, wordt de
offsets zijn beide standaard ingesteld op nul, en de grootte is standaard ingesteld op zoveel mogelijk kopiëren tot
we hebben het einde van de bron bereikt.

De bron en bestemming kunnen hetzelfde object zijn. Overlappende regio's hoeven dat echter niet te zijn
correct gekopieerd.

Als de bestemming een bestand is, wordt dit indien nodig aangemaakt. Als het doelbestand dat niet is
groot genoeg, het wordt verlengd.

Als de bestemming een bestand is en de vlag "toevoegen" niet is ingesteld, dan is het doelbestand
wordt afgekapt. Als de vlag "toevoegen" is ingesteld, wordt de kopie toegevoegd aan het doelbestand.
De vlag 'toevoegen' kan momenteel niet worden ingesteld voor apparaten.

Als de "sparse"-vlag waar is, vermijdt de oproep schrijfblokken die alleen nullen bevatten,
wat kan helpen in sommige situaties waarin de back-upschijf dun is ingericht. Let daar op
tenzij het doel al op nul is gezet, zal het gebruik van deze optie resulteren in onjuist kopiëren.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

kopieer-apparaat-naar-bestand
kopieer-apparaat-naar-bestand src dest [srcoffset:N] [destoffset:N] [grootte:N] [sparse:true|false] [toevoegen:true|false]

Zie "kopieer-apparaat-naar-apparaat" voor een algemeen overzicht van deze oproep.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

kopieer-bestand-naar-apparaat
kopieer-bestand-naar-apparaat src dest [srcoffset:N] [destoffset:N] [grootte:N] [sparse:true|false] [append:true|false]

Zie "kopieer-apparaat-naar-apparaat" voor een algemeen overzicht van deze oproep.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

kopieer-bestand-naar-bestand
kopieer-bestand-naar-bestand src dest [srcoffset:N] [destoffset:N] [grootte:N] [sparse:true|false] [toevoegen:true|false]

Zie "kopieer-apparaat-naar-apparaat" voor een algemeen overzicht van deze oproep.

Dit is niet de gewenste functie voor het kopiëren van bestanden. Dit is voor het kopiëren van blokken binnenin
bestaande bestanden. Zie "cp", "cp-a" en "mv" voor algemene functies voor het kopiëren en verplaatsen van bestanden.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

kopieerformaat
kopieergrootte src beste grootte

Deze opdracht kopieert exact "size" bytes van het ene bronapparaat of bestand "src" naar het andere
bestemmingsapparaat of bestand "dest".

Houd er rekening mee dat dit mislukt als de bron te kort is of als de bestemming niet groot genoeg is.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep 'copy-device-to-device'.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

cp
cp src bestem

Hiermee kopieert u een bestand van "src" naar "dest", waarbij "dest" de naam van het doelbestand is of
doelmap.

cp-a
cp-a src bestem

Hiermee kopieert u een bestand of map van "src" naar "dest" recursief met behulp van de "cp -a"
opdracht.

cp-r
cp-r src bestem

Hiermee kopieert u een bestand of map recursief van "src" naar "dest" met behulp van de opdracht "cp -rP"
opdracht.

De meeste gebruikers zouden in plaats daarvan "cp-a" moeten gebruiken. Deze opdracht is handig als u dat niet wilt
machtigingen behouden, omdat het doelbestandssysteem dit niet ondersteunt (vooral wanneer
schrijven naar DOS FAT-bestandssystemen).

cpi-uit
cpio-out directory (cpiofile|-) [formaat:..]

Met deze opdracht wordt de inhoud van directory en downloadt het naar het lokale bestand "cpiofile".

De optionele parameter "format" kan worden gebruikt om het formaat te selecteren. Alleen het volgende
formaten zijn momenteel toegestaan:

"nieuwc"
Nieuw (SVR4) draagbaar formaat. Dit formaat is compatibel met het cpio-achtige formaat
formaat gebruikt door de Linux-kernel voor initramfs.

Dit is het standaard formaat.

"crc"
Nieuw (SVR4) draagbaar formaat met een checksum.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

dd
dd src bestem

Deze opdracht kopieert van het ene bronapparaat of bestand "src" naar een ander doelapparaat of
bestand "dest". Normaal gesproken zou u dit gebruiken om bijvoorbeeld naar of van een apparaat of partitie te kopiëren
voorbeeld om een ​​bestandssysteem te dupliceren.

Als de bestemming een apparaat is, moet deze even groot of groter zijn dan het bronbestand of
apparaat, anders mislukt het kopiëren. Dit commando kan geen gedeeltelijke kopieën maken (zie "kopiëren-
apparaat-naar-apparaat").

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep 'copy-device-to-device'.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

apparaat-index
apparaat-indexapparaat

Deze functie neemt een apparaatnaam (bijvoorbeeld "/dev/sdb") en retourneert de index van het apparaat in
de lijst met apparaten.

Indexnummers beginnen vanaf 0. Het genoemde apparaat moet bestaan, bijvoorbeeld als een geretourneerde string
van "lijst-apparaten".

Zie ook "lijst-apparaten", "part-to-dev".

df
df

Met deze opdracht wordt de opdracht "df" uitgevoerd om de gebruikte schijfruimte te rapporteren.

Deze opdracht is vooral handig voor interactieve sessies. Het is niet bedoeld dat je het probeert
om de uitvoerreeks te parseren. Gebruik "statvfs" uit programma's.

df-h
df-h

Met deze opdracht wordt de opdracht "df -h" uitgevoerd om de gebruikte schijfruimte in een voor mensen leesbaar formaat te rapporteren.

Deze opdracht is vooral handig voor interactieve sessies. Het is niet bedoeld dat je het probeert
om de uitvoerreeks te parseren. Gebruik "statvfs" uit programma's.

schijf maken
schijf-maak bestandsnaam formaat grootte [backingfile:..] [backingformat:..] [vooraf toegewezen:..] [compat:..] [clustergrootte:N]

Maak een lege schijfkopie met de naam bestandsnaam (een hostbestand) met het formaat "format" (meestal
"rauw" of "qcow2"). De grootte is "size" bytes.

Indien gebruikt met de optionele parameter "backingfile", wordt er een momentopname bovenop gemaakt
het back-upbestand. In dit geval moet "grootte" worden doorgegeven als "-1". De grootte van de momentopname
is hetzelfde als de grootte van het back-upbestand, dat automatisch wordt ontdekt. Jij bent
aangemoedigd om ook "backingformat" door te geven om het formaat van "backingfile" te beschrijven.

If bestandsnaam verwijst naar een blokapparaat, waarna het apparaat wordt geformatteerd. De "grootte" wordt genegeerd
omdat blokapparaten een intrinsieke grootte hebben.

De andere optionele parameters zijn:

"voortoewijzing"
Als het formaat "onbewerkt" is, kan dit "uit" (of "sparse") of "volledig" zijn om een
respectievelijk een dun of volledig toegewezen bestand. De standaardinstelling is "uit".

Als het formaat "qcow2" is, kan dit "uit" (of "sparse"), "metadata" of "volledig" zijn.
Het vooraf toewijzen van metagegevens kan sneller gaan als er veel schrijfbewerkingen worden uitgevoerd, maar neemt meer ruimte in beslag.
De standaardinstelling is "uit".

"compat"
Alleen "qcow2": geef string 1.1 door om het geavanceerde qcow2-formaat te gebruiken dat wordt ondersteund door qemu ≥
1.1.

"clustergrootte"
Alleen "qcow2": Wijzig de clustergrootte van qcow2. De standaardwaarde is 65536 (bytes) en dit
De instelling kan elke macht van twee tussen 512 en 2097152 zijn.

Merk op dat deze aanroep de nieuwe schijf niet aan de handle toevoegt. Mogelijk moet u "add-
drive-opts" afzonderlijk.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

schijfformaat
bestandsnaam in schijfformaat

Detecteer en retourneer het formaat van de aangeroepen schijfkopie bestandsnaam. bestandsnaam kan ook een
hostapparaat, etc. Als het formaat van de afbeelding niet kan worden gedetecteerd, is dit "onbekend".
teruggekeerd.

Houd er rekening mee dat het detecteren van het schijfformaat onder bepaalde omstandigheden onveilig kan zijn. Zien
"CVE-2010-3851" in gastfs(3).

Zie ook: "SCHIJFBEELDFORMATEN" in gastfs(3)

schijf-heeft-back-bestand
schijf-heeft-back-bestand bestandsnaam

Detecteer en retourneer of de schijfkopie bestandsnaam heeft een back-upbestand.

Houd er rekening mee dat het detecteren van schijffuncties onder bepaalde omstandigheden onveilig kan zijn. Zien
"CVE-2010-3851" in gastfs(3).

schijf-virtuele-grootte
bestandsnaam met virtuele schijfgrootte

Detecteer en retourneer de virtuele grootte in bytes van de aangeroepen schijfkopie bestandsnaam.

Houd er rekening mee dat het detecteren van schijffuncties onder bepaalde omstandigheden onveilig kan zijn. Zien
"CVE-2010-3851" in gastfs(3).

dmesg
dmesg

Dit retourneert de kernelberichten ("dmesg" -uitvoer) van de gastkernel. Dit is
soms handig voor uitgebreid debuggen van problemen.

Een andere manier om dezelfde informatie te verkrijgen is door uitgebreide berichten in te schakelen met "set-verbose"
of door de omgevingsvariabele "LIBGUESTFS_DEBUG=1" in te stellen voordat u het programma uitvoert.

Download
download externe bestandsnaam (bestandsnaam|-)

Download file externe bestandsnaam en sla het op als bestandsnaam op de lokale machine.

bestandsnaam kan ook een benoemde pijp zijn.

Zie ook "uploaden", "kat".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

download-offset
download-offset remotebestandsnaam (bestandsnaam|-) offsetgrootte

Download file externe bestandsnaam en sla het op als bestandsnaam op de lokale machine.

externe bestandsnaam wordt gelezen voor "size" bytes beginnend bij "offset" (deze regio moet binnen zijn
het bestand of apparaat).

Houd er rekening mee dat er geen limiet is op de hoeveelheid gegevens die kan worden gedownload met deze oproep.
in tegenstelling tot "preread", en deze aanroep leest altijd het volledige bedrag, tenzij er een fout optreedt.

Zie ook "downloaden", "voorlezen".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

drop-caches
drop-caches whattodrop

Dit instrueert de gastkernel om zijn paginacache en/of dentries en inode-caches te verwijderen.
De parameter "whattodrop" vertelt de kernel wat er precies moet worden neergezet, zie
http://linux-mm.org/Drop_Caches

Als u "whattodrop" instelt op 3, zou alles moeten verdwijnen.

Deze belt automatisch sync(2) vóór de bewerking, zodat het maximale gastgeheugen is
bevrijd.

du
du pad

Met deze opdracht wordt de opdracht "du -s" uitgevoerd om het gebruik van de bestandsruimte voor "pad" te schatten.

"pad" kan een bestand of een map zijn. Als "pad" een directory is, omvat de schatting
de inhoud van de map en alle submappen (recursief).

Het resultaat is de geschatte grootte in kilobytes (dat wil zeggen eenheden van 1024 bytes).

e2fsck
e2fsck-apparaat [correct:true|false] [forceall:true|false]

Hierdoor wordt de ext2/ext3-bestandssysteemcontrole op "apparaat" uitgevoerd. Het kan het volgende duren
optionele argumenten:

"juist"
Herstel automatisch het bestandssysteem. Deze optie zorgt ervoor dat e2fsck automatisch wordt uitgevoerd
repareer alle bestandssysteemproblemen die veilig kunnen worden opgelost zonder menselijke tussenkomst.

Deze optie mag niet tegelijkertijd met de optie "forceall" worden opgegeven.

"geforceerd"
Ga uit van een antwoord van ‘ja’ op alle vragen; staat toe dat e2fsck niet-
interactief.

Deze optie mag niet tegelijk met de "juiste" optie worden opgegeven.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

e2fsck-f
e2fsck-f-apparaat

Dit voert "e2fsck -p -f device" uit, dwz. voert de ext2/ext3 bestandssysteemcontrole uit op "apparaat",
niet-interactief (-p), zelfs als het bestandssysteem schoon lijkt (-f).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "e2fsck".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

echo-daemon
echo-daemon 'woorden ...'

Deze opdracht voegt de lijst met doorgegeven "woorden" samen met enkele spaties ertussen en
retourneert de resulterende tekenreeks.

U kunt dit commando gebruiken om de verbinding met de daemon te testen.

Zie ook "ping-daemon".

egr
egrep regex-pad

Dit roept het externe programma "egrep" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

egrepi
egrepi regex-pad

Dit roept het externe programma "egrep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

gelijk
gelijk bestand1 bestand2

Hiermee worden de twee bestanden vergeleken file1 en file2 en retourneert true als de inhoud exact klopt
gelijk of anders onwaar.

Het externe cmp(1) Er wordt een programma gebruikt voor de vergelijking.

bestaat
bestaat pad

Dit retourneert "true" als en alleen als er een bestand, map (of iets anders) is met het gegeven
naam "pad".

Zie ook "is-bestand", "is-dir", "stat".

extlinux
extlinux-map

Installeer de SYSLINUX-bootloader op het apparaat dat is gemonteerd op directory. In tegenstelling tot "syslinux"
waarvoor een FAT-bestandssysteem vereist is, dit kan worden gebruikt op een ext2/3/4- of btrfs-bestandssysteem.

De directory parameter kan een mountpoint zijn, of een directory binnen het mountpoint.

Je moet de partitie ook markeren als "actief" ("part-set-bootable") en een Master Boot
Record moet worden geïnstalleerd (bijvoorbeeld met behulp van "pwrite-device") op de eerste sector van het geheel
schijf. Het SYSLINUX-pakket wordt geleverd met enkele geschikte Master Boot Records. Zie de
extlinux(1) manpagina voor meer informatie.

Er kan aanvullende configuratie aan SYSLINUX worden geleverd door een bestand met de naam
extlinux.conf op het bestandssysteem onder directory. Voor meer informatie over de
inhoud van dit bestand, zie extlinux(1).

Zie ook "syslinux".

vallen
pad len lokaliseren

Deze opdracht wijst vooraf een bestand toe (dat nul bytes bevat) met de naam "path" met de grootte "len" bytes.
Als het bestand al bestaat, wordt het overschreven.

Verwar dit niet met het guestfish-specifieke "alloc"-commando dat een bestand toewijst
de host en koppelt deze als apparaat.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "fallocate64".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

fallocate64
fallocate64 pad len

Deze opdracht wijst vooraf een bestand toe (dat nul bytes bevat) met de naam "path" met de grootte "len" bytes.
Als het bestand al bestaat, wordt het overschreven.

Houd er rekening mee dat deze aanroep schijfblokken voor het bestand toewijst. Gebruik om een ​​schaars bestand te maken
in plaats daarvan "afgekapte grootte".

De verouderde aanroep "fallocate" doet hetzelfde, maar is vanwege een vergissing alleen toegestaan
Lengtes van 30 bits moeten worden gespecificeerd, waardoor de maximale grootte van de gemaakte bestanden effectief wordt beperkt
via dat gesprek naar 1 GB.

Verwar dit niet met de guestfish-specifieke "alloc" en "sparse" commando's die create
een bestand in de host en koppel het als een apparaat.

functie beschikbaar
functie-beschikbare 'groepen ...'

Dit is hetzelfde als "beschikbaar", maar in tegenstelling tot die oproep retourneert het eenvoudig waar/onwaar
booleaans resultaat, in plaats van een uitzondering te genereren als een object niet wordt gevonden. Voor anderen
documentatie zie "beschikbaar".

fgrep
fgrep-patroonpad

Dit roept het externe "fgrep"-programma aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

fgrepi
fgrepi-patroonpad

Dit roept het externe programma "fgrep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

filet
bestandspad

Deze oproep maakt gebruik van de standaard filet(1) opdracht om het type of de inhoud van het bestand te bepalen.

Deze oproep zal ook transparant in verschillende soorten gecomprimeerde bestanden kijken.

Het exacte commando dat wordt uitgevoerd is "file -zb path". Merk in het bijzonder op dat de bestandsnaam
niet voorafgegaan aan de uitvoer (de -b keuze).

De output is afhankelijk van de output van de onderliggende waarde filet(1) commando en het kan veranderen
toekomst op manieren die buiten onze macht liggen. Met andere woorden, de output wordt niet gegarandeerd door de
ABI.

Zie ook: filet(1), "vfs-type", "lstat", "is-file", "is-blockdev" (enz.), "is-nul".

bestandsarchitectuur
bestandsarchitectuur bestandsnaam

Dit detecteert de architectuur van het binaire bestand bestandsnaam, en retourneert deze indien bekend.

Momenteel gedefinieerde architecturen zijn:

"I386"
Deze tekenreeks wordt geretourneerd voor alle 32-bits i386-, i486-, i586- en i686-binaire bestanden, ongeacht
de precieze processorvereisten van het binaire bestand.

"x86_64"
64-bit x86-64.

"spar"
32-bits SPARC.

"sparc64"
64-bit SPARC V9 en hoger.

"ia64"
Intel Itanium.

"ppc"
32-bits Power-PC.

"ppc64"
64-bits Power-PC.

"arm"
32-bits ARM.

"aarch64"
64-bits ARM.

Libguestfs kan in de toekomst andere architectuurreeksen retourneren.

De functie werkt in ieder geval op de volgende soorten bestanden:

· veel soorten Un*x- en Linux-binaire bestanden

· vele soorten gedeelde Un*x- en Linux-bibliotheken

· Windows Win32- en Win64-binaire bestanden

· Windows Win32 en Win64 DLL's

Win32 binaire bestanden en DLL's retourneren "i386".

Win64 binaire bestanden en DLL's retourneren "x86_64".

· Linux-kernelmodules

· Linux nieuwe stijl initrd-images

· enkele niet-x86 Linux vmlinuz-kernels

Wat het momenteel niet kan doen:

· statische bibliotheken (libfoo.a)

· Linux oude stijl initrd als gecomprimeerd ext2-bestandssysteem (RHEL 3)

· x86 Linux vmlinuz-kernels

x86 vmlinuz-afbeeldingen (bzImage-formaat) bestaan ​​uit een mix van 16-, 32- en gecomprimeerde code,
en zijn vreselijk moeilijk uit te pakken. Als je de architectuur van een kernel wilt vinden,
gebruik in plaats daarvan de architectuur van de bijbehorende initrd- of kernelmodule(s).

bestandsgrootte
bestandsgrootte bestand

Deze opdracht retourneert de grootte van filet in bytes.

Om andere statistieken over een bestand te krijgen, gebruikt u "stat", "lstat", "is-dir", "is-file" etc.
grootte van blokapparaten, gebruik "blockdev-getsize64".

bestandssysteem beschikbaar
bestandssysteem-beschikbaar bestandssysteem

Controleer of libguestfs het genoemde bestandssysteem ondersteunt. Het argument "bestandssysteem" is een
bestandssysteemnaam, zoals "ext3".

U moet "launch" aanroepen voordat u deze opdracht gebruikt.

Dit is vooral nuttig als negatieve test. Als dit waar retourneert, betekent dit niet dat a
een bepaald bestandssysteem kan worden gemaakt of aangekoppeld, omdat bestandssystemen voor andere kunnen falen
redenen, zoals dat het een latere versie van het bestandssysteem is, of incompatibel is
functies, of zonder de juiste mkfs.fs> hulpmiddel.

Zie ook "beschikbaar", "beschikbare functie", "BESCHIKBAARHEID" in gastfs(3).

vullen
vul c len pad

Met deze opdracht wordt een nieuw bestand gemaakt met de naam "pad". De initiële inhoud van het bestand is "len"
octetten van "c", waarbij "c" een getal moet zijn in het bereik "[0..255]".

Om een ​​bestand met nul bytes (sporadisch) te vullen, is het veel efficiënter om "truncate-
size". Om een ​​bestand te maken met een patroon van herhalende bytes, gebruik je "fill-pattern".

vul-dir
vul-dir dir nr

Deze functie, handig voor het testen van bestandssystemen, creëert "nr" lege bestanden in de map
"dir" met de namen 00000000 tot en met "nr-1" (dwz elke bestandsnaam is 8 cijfers lang, opgevuld met
nullen).

vulpatroon
vulpatroonpatroon lenpad

Deze functie lijkt op "fill", behalve dat er een nieuw bestand met de lengte "len" wordt aangemaakt
het herhalende patroon van bytes in "patroon". Het patroon wordt indien nodig ingekort
zorg ervoor dat de lengte van het bestand precies "len" bytes is.

vinden
map vinden

Met deze opdracht worden alle bestanden en mappen recursief weergegeven, beginnend bij directory. Het
is in wezen gelijk aan het uitvoeren van het shell-commando "find directory -print", maar dan enkele
nabewerking vindt plaats op de uitvoer, zoals hieronder beschreven.

Dit retourneert een lijst met tekenreeksen zonder elke voorvoegsel. Dus als de mapstructuur:

/tmp/een
/tmp/b
/tmp/c/d

dan de geretourneerde lijst van "find" / tmp zouden 4 elementen zijn:

a
b
c
CD

If directory geen map is, retourneert deze opdracht een fout.

De geretourneerde lijst wordt gesorteerd.

find0
directory find0 (bestanden|-)

Met deze opdracht worden alle bestanden en mappen recursief weergegeven, beginnend bij directory,
het plaatsen van de resulterende lijst in het externe bestand dat wordt aangeroepen bestanden.

Deze opdracht werkt op dezelfde manier als "vinden" met de volgende uitzonderingen:

· De resulterende lijst wordt naar een extern bestand geschreven.

· Items (bestandsnamen) in het resultaat worden gescheiden door "\0"-tekens. Zien vinden(1) optie
-afdrukken0.

· De resultatenlijst is niet gesorteerd.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

findfs-label
vindfs-label label

Deze opdracht doorzoekt de bestandssystemen en retourneert het bestandssysteem met het opgegeven label. Een
Er wordt een fout geretourneerd als een dergelijk bestandssysteem niet kan worden gevonden.

Om het label van een bestandssysteem te vinden, gebruikt u "vfs-label".

vindfs-uuid
findfs-uuid uuid

Deze opdracht doorzoekt de bestandssystemen en retourneert het bestandssysteem met de opgegeven UUID. Een
Er wordt een fout geretourneerd als een dergelijk bestandssysteem niet kan worden gevonden.

Om de UUID van een bestandssysteem te vinden, gebruikt u "vfs-uuid".

fsck
fsck fstype-apparaat

Hierdoor wordt de bestandssysteemcontrole (fsck) uitgevoerd op "apparaat" dat een bestandssysteemtype moet hebben
"fstype".

Het geretourneerde gehele getal is de status. Zien fsck(8) voor de lijst met statuscodes van "fsck".

Opmerkingen:

· Meerdere statuscodes kunnen bij elkaar worden opgeteld.

· Een retourcode die niet nul is, kan 'succes' betekenen, bijvoorbeeld als fouten zijn gecorrigeerd
op het bestandssysteem.

· Het controleren of repareren van NTFS-volumes wordt niet ondersteund (door linux-ntfs).

Deze opdracht is volledig gelijk aan het uitvoeren van "fsck -a -t fstype device".

FSTR
fstrim mountpoint [offset:N] [lengte:N] [minimaal vrije omvang:N]

Trim de vrije ruimte in het bestandssysteem dat op "mountpoint" is gemonteerd. Het bestandssysteem moet
gemonteerd lezen-schrijven.

De inhoud van het bestandssysteem wordt niet beïnvloed, maar de vrije ruimte in het bestandssysteem wel
"bijgesneden", dat wil zeggen teruggegeven aan het hostapparaat, waardoor schijfimages schaarser worden,
waardoor ongebruikte ruimte in qcow2-bestanden opnieuw kan worden gebruikt, enz.

Deze operatie vereist ondersteuning in libguestfs, het aangekoppelde bestandssysteem, de host
bestandssysteem, qemu en de hostkernel. Als deze ondersteuning niet aanwezig is, kan dit een foutmelding geven
of lijken zelfs te rennen, maar doen niets.

Zie ook "nul-vrije ruimte". Dat is een iets andere operatie waarbij vrije ruimte wordt omgezet
in het bestandssysteem in nullen. Het is geldig om "fstrim" aan te roepen in plaats van of erna
"zero-free-space" noemen.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

krijgen-toevoegen
krijgen-toevoegen

Retourneer de extra kernelopties die zijn toegevoegd aan de libguestfs-apparaatkernel
opdrachtregel.

Indien "NULL" dan worden er geen opties toegevoegd.

get-attach-methode
get-attach-methode

Retourneer de huidige backend.

Zie "set-backend" en "BACKEND" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de 'get-backend'-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

get-autosync
get-autosync

Haal de autosync-vlag op.

terugkrijgen
terugkrijgen

Retourneer de huidige backend.

Deze handle-eigenschap werd voorheen de "attach-methode" genoemd.

Zie "set-backend" en "BACKEND" in gastfs(3).

get-backend-instelling
get-backend-instellingsnaam

Zoek een backend-instellingsreeks die 'name' is of begint met 'name='. Als "naam",
dit retourneert de tekenreeks "1". Als "name=", retourneert dit het gedeelte na het gelijkteken
(dit kan een lege string zijn).

Als een dergelijke instelling niet wordt gevonden, genereert deze functie een fout. De fout (zie "laatste fout")
zal in dit geval "ESRCH" zijn.

Zie "ACHTERUIT" in gastfs(3), "BACKEND-INSTELLINGEN" in gastfs(3).

get-backend-instellingen
get-backend-instellingen

Retourneer de huidige backend-instellingen.

Deze aanroep retourneert alle tekenreeksen voor back-endinstellingen. Als u één backend wilt vinden
instelling, zie "get-backend-setting".

Zie "ACHTERUIT" in gastfs(3), "BACKEND-INSTELLINGEN" in gastfs(3).

get-cachedir
get-cachedir

Haal de map op die door de handle wordt gebruikt om de cache van het apparaat op te slaan.

krijg direct
krijg direct

Retourneer de vlag voor directe apparaatmodus.

get-e2attrs
get-e2attrs-bestand

Dit retourneert de bestandskenmerken die zijn gekoppeld aan filet.

De attributen zijn een reeks bits die bij elke inode horen en die het gedrag van de inode beïnvloeden
het bestand. De attributen worden geretourneerd als een reeks letters (hieronder beschreven). De
string mag leeg zijn, wat aangeeft dat er geen bestandskenmerken zijn ingesteld voor dit bestand.

Deze attributen zijn alleen aanwezig als het bestand zich op een ext2/3/4 bestandssysteem bevindt.
Het gebruik van deze aanroep op andere bestandssysteemtypen zal resulteren in een fout.

De tekens (bestandskenmerken) in de geretourneerde tekenreeks zijn momenteel:

'A' Wanneer het bestand wordt geopend, wordt de tijd ervan niet gewijzigd.

'a' Het bestand kan alleen worden toegevoegd.

'c' Het bestand is op schijf gecomprimeerd.

'D' (Alleen mappen.) Wijzigingen in deze map worden synchroon naar schijf geschreven.

'd' Het bestand is geen kandidaat voor back-up (zie storten(8)).

'E' Het bestand bevat compressiefouten.

'e' Het bestand gebruikt extensies.

'h' Het bestand slaat zijn blokken op in eenheden van de blokgrootte van het bestandssysteem in plaats van
sectoren.

'I' (Alleen mappen.) De map maakt gebruik van gehashte bomen.

'i' Het bestand is onveranderlijk. Het kan niet worden gewijzigd, verwijderd of hernoemd. Er kan geen enkele link zijn
gemaakt voor dit bestand.

'j' Het bestand is in een datajournaal opgenomen.

's' Wanneer het bestand wordt verwijderd, worden alle blokken op nul gezet.

'S' Wijzigingen in dit bestand worden synchroon naar schijf geschreven.

'T' (Alleen mappen.) Dit is een hint naar de blokallocator die submappen bevat
die zich in deze map bevinden, moeten over blokken worden verspreid. Indien niet aanwezig, het blok
allocator zal proberen submappen te groeperen.

't' Voor een bestand schakelt dit het samenvoegen van de staart uit. (Niet gebruikt door upstream-implementaties van
ext2.)

'u' Wanneer het bestand wordt verwijderd, worden de blokken ervan opgeslagen, waardoor de verwijdering van het bestand ongedaan kan worden gemaakt.

'X' De onbewerkte inhoud van het gecomprimeerde bestand is toegankelijk.

'Z' Het gecomprimeerde bestand is vuil.

Er kunnen later meer bestandskenmerken aan deze lijst worden toegevoegd. Mogelijk zijn niet alle bestandskenmerken ingesteld
voor allerlei soorten bestanden. Voor gedetailleerde informatie, raadpleeg de kletsen(1) man-pagina.

Zie ook "set-e2attrs".

Verwar deze attributen niet met uitgebreide attributen (zie "getxattr").

get-e2generatie
get-e2generation-bestand

Dit retourneert de ext2-bestandsgeneratie van een bestand. De generatie (die vroeger heette
de "versie") is een nummer dat aan een inode is gekoppeld. Dit wordt het meest gebruikt door NFS
servers.

De generatie is alleen aanwezig als het bestand zich op een ext2/3/4 bestandssysteem bevindt. Gebruik makend van
deze aanroep op andere bestandssysteemtypen zal resulteren in een fout.

Zie "set-e2generation".

krijg-e2label
get-e2label-apparaat

Dit retourneert het ext2/3/4 bestandssysteemlabel van het bestandssysteem op "apparaat".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "vfs-label".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

get-e2uuid
get-e2uuid-apparaat

Dit retourneert de ext2/3/4 bestandssysteem-UUID van het bestandssysteem op "apparaat".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "vfs-uuid".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

krijg-hv
krijg-hv

Retourneert het huidige binaire hypervisorbestand.

Dit is altijd niet-NULL. Als dit nog niet is ingesteld, wordt de standaard qemu geretourneerd
binaire naam.

get-identificatie
get-identificatie

Haal de handvat-ID op. Zie "set-identifier".

get-libvirt-gevraagde-credential-uitdaging
get-libvirt-gevraagde-credential-challenge index

Verkrijg de uitdaging (geleverd door libvirt) voor de "index"-e aangevraagde referentie. Als
libvirt heeft geen uitdaging gegeven, dit retourneert de lege string "".

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

get-libvirt-gevraagde-referentie-defresult
get-libvirt-gevraagde-referentie-defresult index

Haal het standaardresultaat op (geleverd door libvirt) voor de "index"-de gevraagde referentie. Als
libvirt heeft geen standaardresultaat opgeleverd, dit retourneert de lege string "".

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

get-libvirt-gevraagd-credential-prompt
get-libvirt-gevraagde-credential-prompt index

Haal de prompt op (geleverd door libvirt) voor de "index"-de gevraagde referentie. Als libvirt
heeft geen prompt gegeven, dit retourneert de lege tekenreeks "".

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

get-libvirt-gevraagde-referenties
get-libvirt-gevraagde-referenties

Dit mag alleen worden aangeroepen tijdens het terugbellen van gebeurtenissen voor gebeurtenissen van het type
"GUESTFS_EVENT_LIBVIRT_AUTH".

Retourneert de lijst met inloggegevens gevraagd door libvirt. Mogelijke waarden zijn een subset van de
tekenreeksen die werden opgegeven toen u "set-libvirt-supported-credentials" aanriep.

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

get-memsize
get-memsize

Hiermee wordt de geheugengrootte in megabytes opgehaald die aan de hypervisor is toegewezen.

Als "set-memsize" niet is aangeroepen op deze handle, en als "LIBGUESTFS_MEMSIZE" niet is ingesteld,
dan retourneert dit de gecompileerde standaardwaarde voor memsize.

Voor meer informatie over de architectuur van libguestfs, zie gastfs(3).

krijg-netwerk
krijg-netwerk

Dit retourneert de vlag voor het inschakelen van het netwerk.

get-pad
get-pad

Retourneert het huidige zoekpad.

Dit is altijd niet-NULL. Als dit nog niet is ingesteld, wordt de standaardwaarde geretourneerd
pad.

get-pgroep
get-pgroep

Dit retourneert de procesgroepvlag.

krijg-pid
pid
krijg-pid

Retourneert de proces-ID van de hypervisor. Als er geen hypervisor actief is, dan dit
zal een fout teruggeven.

Dit is een interne oproep die wordt gebruikt voor foutopsporing en testen.

get-programma
get-programma

Haal de programmanaam op. Zie "ingesteld programma".

krijg-qemu
krijg-qemu

Retourneert het huidige binaire hypervisorbestand (meestal qemu).

Dit is altijd niet-NULL. Als dit nog niet is ingesteld, wordt de standaard qemu geretourneerd
binaire naam.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "get-hv".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

get-herstel-proc
get-herstel-proc

Retourneer de vlag voor het herstelproces ingeschakeld.

get-selinux
get-selinux

Dit retourneert de huidige instelling van de selinux-vlag die aan het apparaat is doorgegeven op
opstarttijd. Zie "set-selinux".

Voor meer informatie over de architectuur van libguestfs, zie gastfs(3).

krijg-smp
krijg-smp

Dit retourneert het aantal virtuele CPU's dat aan het apparaat is toegewezen.

get-tmpdir
get-tmpdir

Haal de map op die door de handle wordt gebruikt om tijdelijke bestanden op te slaan.

get-trace
get-trace

Retourneer de opdrachttraceervlag.

krijg-umasker
krijg-umasker

Retourneer het huidige umask. Standaard is het umask 022, tenzij dit is ingesteld door te bellen
"umask".

word-uitgebreid
word-uitgebreid

Dit retourneert de vlag voor uitgebreide berichten.

getcon
getcon

Dit haalt de SELinux-beveiligingscontext van de daemon op.

Zie de documentatie over SELINUX in gastfs(3), en "setcon"

getxattr
getxattr padnaam

Haal een enkel uitgebreid attribuut op uit het bestand "pad" met de naam "naam". Deze oproep volgt
symlinks. Als u een uitgebreid attribuut voor de symlink zelf wilt opzoeken, gebruikt u
"lgetxattr".

Normaal gesproken is het beter om alle uitgebreide attributen in één keer uit een bestand te halen door te bellen
"getxattrs". Sommige Linux-bestandssysteemimplementaties bevatten echter fouten en bieden geen
manier om attributen op te sommen. Voor deze bestandssystemen (met name ntfs-3g) moet je de
namen van de gewenste uitgebreide attributen vooraf en roep deze functie aan.

Uitgebreide attribuutwaarden zijn klodders binaire gegevens. Als er geen uitgebreid attribuut is
met de naam "naam", retourneert dit een fout.

Zie ook: "getxattrs", "lgetxattr", attr(5).

getxattrs
getxattrs-pad

Deze oproep vermeldt de uitgebreide kenmerken van het bestand of de map "pad".

Op systeemoproepniveau is dit een combinatie van de lijstxattr(2) en getxattr(2) bellen.

Zie ook: "lgetxattrs", attr(5).

glob-uitbreiden
glob-uitbreidingspatroon

Deze opdracht zoekt naar alle padnamen die overeenkomen met "patroon" volgens het jokerteken
uitbreidingsregels die door de shell worden gebruikt.

Als er geen paden overeenkomen, retourneert dit een lege lijst (let op: geen fout).

Het is gewoon een wikkel rond de C glob(3) functie met vlaggen "GLOB_MARK|GLOB_BRACE". Zien
die handleidingpagina voor meer details.

Merk op dat er geen equivalent commando bestaat voor het uitbreiden van een apparaatnaam (bijv. /dev/sd*).
Gebruik in plaats daarvan de functies "list-devices", "list-partitions" enz.

grep
grep-opteert
grep regex pad [uitgebreid:true|false] [vast:true|false] [ongevoelig:true|false] [gecomprimeerd:true|false]

Dit roept het externe "grep" -programma aan en retourneert de overeenkomende regels.

De optionele vlaggen zijn:

"verlengd"
Gebruik uitgebreide reguliere expressies. Dit is hetzelfde als het gebruik van de -E vlag.

"vast"
Match opgelost (gebruik geen reguliere expressies). Dit is hetzelfde als het gebruik van de -F vlag.

"ongevoelig"
Match hoofdletterongevoelig. Dit is hetzelfde als het gebruik van de -i vlag.

"gecomprimeerd"
Gebruik "zgrep" in plaats van "grep". Hierdoor kan de invoer worden gecomprimeerd of gzip
gecomprimeerd.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

grep
grepi regex-pad

Dit roept het externe programma "grep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

grub-installatie
grub-install root-apparaat

Deze opdracht installeert GRUB 1 (de Grand Unified Bootloader) op "device", met de root
map is "root".

Opmerkingen:

· Er is momenteel geen manier in de API om grub2 te installeren, wat door de meeste moderne gebruikers wordt gebruikt
Linux-gasten. Het is mogelijk om de opdracht grub2 vanaf de gast uit te voeren, hoewel zie
de waarschuwingen in "OPDRACHTEN UITVOEREN" in gastfs(3).

· Dit maakt gebruik van "grub-install" van de host. Helaas is grub niet altijd compatibel
met zichzelf, dus dit werkt alleen in vrij beperkte omstandigheden. Zorgvuldig testen met
elke gastversie is aan te raden.

· Als grub-install de foutmelding 'Er is geen geschikt station gevonden in het gegenereerde apparaat
map." Het kan zijn dat u een /boot/grub/apparaat.map eerst dat bestand
bevat de toewijzing tussen grub-apparaatnamen en Linux-apparaatnamen. Het is meestal
voldoende om een ​​bestand te maken met daarin:

(hd0) /dev/vda

vervangen /dev/vda met de naam van het installatieapparaat.

hoofd
hoofd pad

Met deze opdracht worden de eerste 10 regels van een bestand geretourneerd als een lijst met tekenreeksen.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

hoofd-n
hoofd-n nrlines pad

Als de parameter "nrlines" een positief getal is, retourneert dit de eerste "nrlines"-regels van
het bestand "pad".

Als de parameter "nrlines" een negatief getal is, retourneert dit regels uit het bestand "path",
met uitzondering van de laatste "nrlines"-regels.

Als de parameter "nrlines" nul is, retourneert dit een lege lijst.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

hexdump
hexdump-pad

Dit voert "hexdump -C" uit op het opgegeven "pad". Het resultaat is het voor mensen leesbare, canonieke
hexadecimale dump van het bestand.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

hivex-dicht
hivex-dicht

Sluit de huidige hivex-handgreep.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-commit
hivex-commit bestandsnaam

Wijzigingen in de component doorvoeren (schrijven).

Als de optionele bestandsnaam parameter null is, worden de wijzigingen naar dezelfde parameter teruggeschreven
bijenkorf die werd geopend. Als dit niet nul is, worden ze naar de alternatieve bestandsnaam geschreven
gegeven en de oorspronkelijke bijenkorf blijft onaangeroerd.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-add-child
hivex-node-add-child oudernaam

Voeg een onderliggend knooppunt toe aan 'ouder' met de naam 'naam'.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-kinderen
hivex-node-kinderen nodeh

Retourneert de lijst met knooppunten die subsleutels zijn van "nodeh".

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-knooppunt-verwijder-kind
hivex-knooppunt-verwijder-onderliggend knooppunth

Verwijder "nodeh", indien nodig recursief.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-get-child
hivex-node-get-child nodeh-naam

Retourneer het kind van "nodeh" met de naam "name", als deze bestaat. Dit kan de betekenis 0 retourneren
de naam is niet gevonden.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-get-waarde
hivex-node-get-value nodeh-sleutel

Retourneer de waarde die is gekoppeld aan "nodeh" en die de naam "key" heeft, als deze bestaat. Dit kan
retourneert 0, wat betekent dat de sleutel niet is gevonden.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-knooppuntnaam
hivex-knooppuntnaam knooppunth

Retourneert de naam van "nodeh".

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-ouder
hivex-knooppunt-ouderknooppunth

Retourneert het bovenliggende knooppunt van "nodeh".

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-set-waarde
hivex-knooppunt-set-waarde knooppunth sleutel t val

Stel of vervang een enkele waarde onder het knooppunt "nodeh". De "sleutel" is de naam, "t" is de
type, en "val" zijn de gegevens.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-node-waarden
hivex-node-waarden knooppunth

Retourneert de array van (sleutel, datatype, data) tupels die zijn gekoppeld aan "nodeh".

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

bijenkorf-open
hivex-open bestandsnaam [verbose:true|false] [debug:true|false] [write:true|false]

Open het Windows-registercomponentbestand met de naam bestandsnaam. Als er een eerdere bijenkorf was
handle die aan deze guestfs-sessie is gekoppeld, wordt deze gesloten.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

hivex-wortel
hivex-wortel

Retourneer het hoofdknooppunt van de component.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-waardesleutel
hivex-waarde-sleutelwaardeh

Retourneert het sleutelveld (naam) van een tupel (sleutel, gegevenstype, gegevens).

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-waarde-type
hivex-waarde-type waardeh

Retourneert het gegevenstypeveld uit een (sleutel, gegevenstype, gegevens) tupel.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

hivex-waarde-utf8
hivex-waarde-utf8 waardeh

Dit roept "hivex-waarde-waarde" aan (wat het gegevensveld retourneert van een hivex-waarde-tuple).
Vervolgens wordt ervan uitgegaan dat het veld een UTF-16LE-reeks is en wordt het resultaat geconverteerd naar UTF-8 (of
als dit niet mogelijk is, wordt er een foutmelding weergegeven).

Dit is handig voor het lezen van tekenreeksen uit het Windows-register. Maar dat is het niet
waterdicht omdat het register niet sterk getypeerd is en velden willekeurige of
onverwachte gegevens.

hivex-waarde-waarde
hivex-waarde-waarde waardeh

Retourneert het gegevensveld van een (sleutel, gegevenstype, gegevens) tupel.

Dit is een wikkel om de bijenkorf(3) roep met dezelfde naam.

Zie ook: "hivex-waarde-utf8".

initrd-kat
initrd-cat initrdpad bestandsnaam

Met deze opdracht wordt het bestand uitgepakt bestandsnaam uit het initrd-bestand genaamd initrdpad. De
bestandsnaam moet worden opgegeven zonder de initiële / karakter.

In guestfish kunt u bijvoorbeeld de volgende opdracht gebruiken om het opstartscript te onderzoeken
(meestal genoemd) /in het) in een Linux initrd- of initramfs-image:

initrd-cat /boot/initrd- .img init

Zie ook "initrd-lijst".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

initrd-lijst
initrd-lijst pad

Met deze opdracht worden de bestanden weergegeven die zich in een initrd bevinden.

De bestanden worden zonder initiaal weergegeven / karakter. De bestanden worden in de volgorde vermeld
ze verschijnen (niet noodzakelijkerwijs alfabetisch). Directorynamen worden vermeld als afzonderlijke items.

Oude Linux-kernels (2.4 en eerder) gebruikten een gecomprimeerd ext2-bestandssysteem als initrd. Wij Slechts
ondersteunen het nieuwere initramfs-formaat (gecomprimeerde cpio-bestanden).

inotify-add-watch
inotify-add-watch padmasker

Kijk naar "pad" voor de gebeurtenissen vermeld in "masker".

Merk op dat als "pad" een map is, gebeurtenissen binnen die map worden bekeken, maar dit
doet niet gebeuren recursief (in submappen).

Opmerking voor niet-C- of niet-Linux-aanroepers: de inotify-gebeurtenissen worden gedefinieerd door de Linux-kernel
ABI en zijn opgenomen in /usr/include/sys/inotify.h.

inotify-sluiten
inotify-sluiten

Hiermee wordt de inotify-handle gesloten die eerder werd geopend door inotify_init. Het verwijdert
alle horloges, gooit alle openstaande gebeurtenissen weg en maakt de toewijzing van alle middelen ongedaan.

inotify-bestanden
inotify-bestanden

Deze functie is een handige verpakking rond "inotify-read", die alleen maar een lijst retourneert
padnamen van objecten die zijn aangeraakt. De geretourneerde padnamen worden gesorteerd en
ontdubbeld.

initify-init
inotify-init maxevents

Met deze opdracht wordt een nieuwe inotify-handle gemaakt. Het inotify-subsysteem kan worden gebruikt om te waarschuwen
gebeurtenissen die plaatsvinden met objecten in het gastbestandssysteem.

"maxevents" is het maximale aantal gebeurtenissen dat in de wachtrij wordt geplaatst tussen oproepen naar
"inotify-read" of "inotify-files". Als dit wordt doorgegeven als 0, dan wordt de kernel (of eerder
set) standaard wordt gebruikt. Voor Linux 2.6.29 was de standaardwaarde 16384 gebeurtenissen. Voorbij deze limiet,
de kernel gooit gebeurtenissen weg, maar registreert het feit dat hij ze weggooide door a in te stellen
markeer "IN_Q_OVERFLOW" in de geretourneerde structuurlijst (zie "inotify-read").

Voordat er gebeurtenissen worden gegenereerd, moet u enkele horloges toevoegen aan de interne volglijst.
Zie: "inotify-add-watch" en "inotify-rm-watch".

Gebeurtenissen in de wachtrij moeten periodiek worden gelezen door "inotify-read" (of "inotify-files" aan te roepen
wat slechts een nuttige verpakking is rond "inotify-read"). Als je de gebeurtenissen niet voorleest
Vaak genoeg riskeer je dat de interne wachtrij overloopt.

Na gebruik dient de hendel gesloten te worden door "inotify-close" aan te roepen. Hiermee worden ook eventuele
kijkt automatisch.

Zie ook inotify(7) voor een overzicht van de inotify-interface zoals weergegeven door Linux
kernel, wat ongeveer is wat we blootleggen via libguestfs. Merk op dat er één globaal is
inotify-handle per libguestfs-instantie.

inotify-lezen
inotify-lezen

Retourneert de volledige wachtrij met gebeurtenissen die hebben plaatsgevonden sinds de vorige leesaanroep.

Als er geen gebeurtenissen hebben plaatsgevonden, retourneert dit een lege lijst.

Note: Om er zeker van te zijn dat alle gebeurtenissen zijn gelezen, moet u deze functie oproepen
totdat er een lege lijst wordt geretourneerd. De reden is dat de oproep gebeurtenissen leest
tot de maximale berichtgrootte van het apparaat naar de host en laat de resterende gebeurtenissen in de wachtrij staan.

inotify-rm-watch
inotify-rm-watch wd

Verwijder een eerder gedefinieerd inotify-horloge. Zie "inotify-add-watch".

inspecteer-get-arch
inspecteer-get-arch root

Dit retourneert de architectuur van het geïnspecteerde besturingssysteem. Het mogelijke rendement
waarden worden vermeld onder "bestandsarchitectuur".

Als de architectuur niet kon worden bepaald, wordt de string "onbekend" geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-distro
inspecteer-get-distro root

Dit retourneert de distributie (distributie) van het geïnspecteerde besturingssysteem.

Momenteel gedefinieerde distributies zijn:

"alpinelinux"
Alpiene Linux.

"altlinux"
ALT-Linux.

"archlinux"
Boog Linux.

"buildroot"
Van Buildroot afgeleide distro, maar niet een die we specifiek herkennen.

"centos"
CentOS

"cirros"
Cirros.

"coreos"
KernOS.

"debian"
Debian.

"fedora"
Fedora.

"freebsd"
GratisBSD.

"vrijheden"
GratisDOS.

"zuinigheid"
Zuinig.

"gentoo"
Gentoo.

"linuxmint"
Linux Mint.

"mageia"
Magia.

"mandriva"
Mandriva.

"meego"
MeeGo.

"netbsd"
NetBSD.

"openbsd"
OpenBSD.

"opengebruik"
OpenSUSE.

"orakellinux"
Oracle-Linux.

"pardus"
Pardus.

"pldlinux"
PLD Linux.

"op redhat gebaseerd"
Een van Red Hat afgeleide distro.

"rhel"
Red Hat Enterprise-Linux.

"wetenschappelijkelinux"
Wetenschappelijke Linux.

"slackware"
slak.

"sles"
SuSE Linux Enterprise Server of Desktop.

"suse-gebaseerd"
Sommige van openSuSE afgeleide distro's.

"ttylinux"
ttylinux.

"ubuntu"
Ubuntu.

"onbekend"
De distributie kon niet worden bepaald.

"ramen"
Windows heeft geen distributies. Deze tekenreeks wordt geretourneerd als het besturingssysteemtype is
Windows.

Toekomstige versies van libguestfs kunnen hier andere tekenreeksen retourneren. De beller zou dat moeten zijn
bereid om elke snaar aan te kunnen.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-drive-toewijzingen
inspecteer-get-drive-mappings root

Deze aanroep is handig voor Windows, dat een primitief systeem voor het toewijzen van stationsletters gebruikt
(graag willen C: \) naar partities. Deze inspectie-API onderzoekt het Windows-register om erachter te komen
hoe schijven/partities worden toegewezen aan stationsletters, en retourneert een hashtabel zoals in de
voorbeeld hieronder:

C => /dev/vda2
E => /dev/vdb1
F => /dev/vdc1

Houd er rekening mee dat sleutels stationsletters zijn. Voor Windows is de sleutel hoofdlettergevoelig en correct
bevat de stationsletter, zonder het gebruikelijke dubbele puntscheidingsteken.

In de toekomst zullen we mogelijk andere besturingssystemen ondersteunen die ook schijfletters gebruiken, maar de
sleutels hiervoor zijn mogelijk niet hoofdlettergevoelig en kunnen langer zijn dan 1 teken. Voor
In OS-9 werden harde schijven bijvoorbeeld "h0", "h1" enz. genoemd.

Voor Windows-gasten worden momenteel alleen toewijzingen van de harde schijf geretourneerd. Verwisselbare schijven (bijv.
DVD-ROM's) worden genegeerd.

Voor gasten die geen schijftoewijzingen gebruiken, of als de schijftoewijzingen dat niet kunnen zijn
bepaald, retourneert dit een lege hashtabel.

Lees "INSPECTIE" in gastfs(3) voor meer details. Zie ook "inspecteren-krijgen-
mountpoints", "inspecteer-get-bestandssystemen".

inspecteer-get-bestandssystemen
inspect-get-filesystems root

Dit retourneert een lijst met alle bestandssystemen waarvan we denken dat ze hiermee verband houden
besturingssysteem. Dit omvat het rootbestandssysteem, andere gewone bestandssystemen en niet-
aangekoppelde apparaten zoals swappartities.

In het geval van een virtuele machine met meerdere opstartmogelijkheden is het mogelijk dat een bestandssysteem wordt gedeeld
tussen besturingssystemen.

Lees "INSPECTIE" in gastfs(3) voor meer details. Zie ook "inspecteren-krijgen-
bevestigingspunten".

inspecteer-krijg-formaat
inspecteer-get-format root

Dit retourneert het formaat van het geïnspecteerde besturingssysteem. Je kunt het gebruiken om te detecteren
installeer images, live-cd's en dergelijke.

Momenteel gedefinieerde formaten zijn:

"geïnstalleerd"
Dit is een geïnstalleerd besturingssysteem.

"installatieprogramma"
De schijfimage die wordt geïnspecteerd, is geen geïnstalleerd besturingssysteem, maar een bootable
installatieschijf, live-cd of iets dergelijks.

"onbekend"
Het formaat van deze schijfkopie is niet bekend.

Toekomstige versies van libguestfs kunnen hier andere tekenreeksen retourneren. De beller zou dat moeten zijn
bereid om elke snaar aan te kunnen.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-hostnaam
inspecteer-krijg-hostnaam root

Deze functie retourneert de hostnaam van het besturingssysteem zoals gevonden door inspectie van het
configuratiebestanden van gasten.

Als de hostnaam niet kon worden bepaald, wordt de tekenreeks "unknown" geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-icon
inspecteren-get-icon root [favicon:true|false] [hoge kwaliteit:true|false]

Deze functie retourneert een pictogram dat overeenkomt met het geïnspecteerde besturingssysteem. Het icoon
wordt geretourneerd als een buffer die een PNG-afbeelding bevat (indien nodig opnieuw gecodeerd naar PNG).

Als het niet mogelijk was om een ​​pictogram te krijgen, retourneert deze functie een lengte nul (niet-NULL)
buffer. bellers Dan moet je controle voor dit geval.

Libguestfs zal beginnen met het zoeken naar een bestand met de naam /etc/favicon.png or C:\etc\favicon.png
en als het het juiste formaat heeft, wordt de inhoud van dit bestand geretourneerd. Jij kan
schakel favicons uit door de optionele "favicon" boolean als false door te geven (standaard is waar).

Als het vinden van de favicon niet lukt, zoeken we op andere plaatsen in de gast naar een geschikte
icoon.

Als de optionele booleaanse waarde 'hoge kwaliteit' waar is, worden alleen pictogrammen van hoge kwaliteit geretourneerd.
dat betekent alleen iconen met een hoge resolutie en een alfakanaal. De standaardwaarde (false) is
om elk mogelijk pictogram terug te geven, zelfs als het van ondermaatse kwaliteit is.

Opmerkingen:

· In tegenstelling tot de meeste andere inspectie-API-aanroepen moeten de schijven van de gast vooraf worden aangekoppeld
je noemt dit, omdat het informatie uit het gastbestandssysteem moet lezen tijdens het
noemen.

· Beveiliging: De pictogramgegevens zijn afkomstig van de niet-vertrouwde gast en moeten worden behandeld
voorzichtigheid. Het is bekend dat PNG-bestanden exploits bevatten. Zorg ervoor dat libpng (of een ander
relevante bibliotheken) volledig up-to-date zijn voordat u probeert het pictogram te verwerken of weer te geven.

· De geretourneerde PNG-afbeelding kan elk formaat hebben. Het is misschien niet vierkant. Libguestfs probeert het
retourneer het grootste pictogram van de hoogste kwaliteit dat beschikbaar is. De toepassing moet de schaal schalen
pictogram in de gewenste grootte.

· Voor het extraheren van pictogrammen uit Windows-gasten is het externe "wrestool"-programma van de
"icoutils"-pakket en verschillende programma's ("bmptopnm", "pnmtopng", "pamcut") van de
"netpbm"-pakket. Deze moeten afzonderlijk worden geïnstalleerd.

· Pictogrammen van het besturingssysteem zijn doorgaans handelsmerken. Win juridisch advies in voordat u het gebruikt
handelsmerken in toepassingen.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

inspecteer-get-major-versie
inspecteer-get-major-version root

Dit retourneert het hoofdversienummer van het geïnspecteerde besturingssysteem.

Windows gebruikt een consistent versiebeheerschema niet weerspiegeld in het populaire publiek
namen die door het besturingssysteem worden gebruikt. Met name het besturingssysteem dat bekend staat als "Windows 7" is
eigenlijk versie 6.1 (dat wil zeggen major = 6, minor = 1). U kunt de echte versies ontdekken
overeenkomend met releases van Windows door Wikipedia of MSDN te raadplegen.

Als de versie niet kon worden bepaald, wordt 0 geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-minor-versie
inspect-get-minor-version root

Dit retourneert het secundaire versienummer van het geïnspecteerde besturingssysteem.

Als de versie niet kon worden bepaald, wordt 0 geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details. Zie ook "inspecteer-krijg-major-
versie".

inspecteer-get-mountpoints
inspecteer-get-mountpoints root

Dit retourneert een hash van waar we denken dat de bestandssystemen zijn geassocieerd met deze bewerking
systeem gemonteerd moet worden. Bellers moeten er rekening mee houden dat dit op zijn best een goede inschatting is
door configuratiebestanden zoals / Etc / fstab. In bijzonder nota dat dit mag
retourneer bestandssystemen die niet bestaan ​​of niet kunnen worden gemonteerd en callers moeten worden voorbereid
om fouten op te lossen of te negeren als ze deze proberen te monteren.

Elk element in de geretourneerde hashtabel heeft een sleutel die het pad is van het mountpoint (bijv.
/bagageruimte) en een waarde die het bestandssysteem is dat daar zou worden gemount (bijv. / Dev / sda1).

Niet-gemonteerde apparaten zoals wisselapparaten zijn dat wel niet terug in deze lijst.

Voor besturingssystemen zoals Windows die nog steeds stationsletters gebruiken, is deze aanroep alleen geldig
retourneer een vermelding voor de eerste schijf "gemonteerd op" /. Voor informatie over het in kaart brengen van
stationsletters naar partities, zie "inspect-get-drive-mappings".

Lees "INSPECTIE" in gastfs(3) voor meer details. Zie ook "inspecteren-krijgen-
bestandssystemen".

inspecteer-get-pakket-formaat
inspecteer-get-package-format root

Deze functie en "inspect-get-package-management" retourneren het pakketformaat en -pakket
beheertool gebruikt door het geïnspecteerde besturingssysteem. Bijvoorbeeld voor Fedora deze
functies zouden "rpm" (pakketformaat) en "yum" of "dnf" (pakketbeheer) retourneren.

Dit retourneert de string "onbekend" als we het pakketformaat niet konden bepalen or indien de
besturingssysteem heeft geen echt verpakkingssysteem (bijv. Windows).

Mogelijke tekenreeksen zijn onder meer: ​​"rpm", "deb", "ebuild", "pisi", "pacman", "pkgsrc", "apk".
Toekomstige versies van libguestfs kunnen andere tekenreeksen retourneren.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-pakketbeheer
inspecteer-get-pakketbeheer root

"inspect-get-package-format" en deze functie retourneert het pakketformaat en pakket
beheertool gebruikt door het geïnspecteerde besturingssysteem. Bijvoorbeeld voor Fedora deze
functies zouden "rpm" (pakketformaat) en "yum" of "dnf" (pakketbeheer) retourneren.

Dit retourneert de tekenreeks "onbekend" als we de pakketbeheertool niet konden bepalen or
als het besturingssysteem geen echt verpakkingssysteem heeft (bijv. Windows).

Mogelijke tekenreeksen zijn onder meer: ​​"yum", "dnf", "up2date", "apt" (voor alle Debian-derivaten),
"portage", "pisi", "pacman", "urpmi", "zypper", "apk". Toekomstige versies van libguestfs kunnen dat wel zijn
andere strings retourneren.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-productnaam
inspecteer-get-productnaam root

Dit retourneert de productnaam van het geïnspecteerde besturingssysteem. De productnaam luidt
over het algemeen een tekenreeks in vrije vorm die aan de gebruiker kan worden weergegeven, maar dat niet zou moeten zijn
geparseerd door programma's.

Als de productnaam niet kon worden bepaald, wordt de tekenreeks "onbekend" geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-product-variant
inspecteer-get-productvariant root

Hiermee wordt de productvariant van het geïnspecteerde besturingssysteem geretourneerd.

Voor Windows-gasten retourneert dit de inhoud van de registersleutel
"HKLM\Software\Microsoft\Windows NT\CurrentVersion" "InstallationType", meestal een
tekenreeks zoals "Client" of "Server" (andere waarden zijn mogelijk). Dit kan gebruikt worden
onderscheid maken tussen consumenten- en bedrijfsversies van Windows die hetzelfde versienummer hebben
(Windows 7 en Windows 2008 Server zijn bijvoorbeeld beide versie 6.1, maar de eerste is dat wel
"Client" en de laatste is "Server").

Voor zakelijke Linux-gasten zijn we van plan om in de toekomst de productvariant terug te brengen
als "Bureaublad", "Server" enzovoort. Maar dit wordt momenteel niet geïmplementeerd.

Als de productvariant niet kon worden bepaald, wordt de tekenreeks "onbekend" geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details. Zie ook "inspecteer-get-product-
name", "inspecteer-get-major-version".

inspecteer-get-roots
inspecteer-get-roots

Deze functie is een handige manier om de lijst met rootapparaten op te halen, zoals geretourneerd door a
vorige aanroep naar "inspect-os", maar zonder het hele inspectieproces opnieuw uit te voeren.

Dit retourneert een lege lijst als er geen root-apparaten zijn gevonden of als de beller dat niet heeft gedaan
genaamd "inspect-os".

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-type
inspecteer-get-type root

Dit retourneert het type van het geïnspecteerde besturingssysteem. Momenteel gedefinieerde typen zijn:

"linux"
Elk op Linux gebaseerd besturingssysteem.

"ramen"
Elk Microsoft Windows-besturingssysteem.

"freebsd"
GratisBSD.

"netbsd"
NetBSD.

"openbsd"
OpenBSD.

"hindernis"
GNU/Hurd.

"dos"
MS-DOS, FreeDOS en anderen.

"minix"
MINIX.

"onbekend"
Het type besturingssysteem kan niet worden bepaald.

Toekomstige versies van libguestfs kunnen hier andere tekenreeksen retourneren. De beller zou dat moeten zijn
bereid om elke snaar aan te kunnen.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-windows-current-control-set
inspecteer-get-windows-current-control-set root

Dit retourneert de Windows CurrentControlSet van de geïnspecteerde gast. De CurrentControlSet
is een registersleutelnaam zoals "ControlSet001".

Bij deze oproep wordt ervan uitgegaan dat de gast Windows is en dat het register kan worden onderzocht
inspectie. Als dit niet het geval is, wordt er een fout geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-get-windows-systemroot
inspecteer-get-windows-systemroot root

Dit retourneert de Windows-systeemroot van de geïnspecteerde gast. De systeemhoofdmap is een map
pad zoals /RAMEN.

Bij deze aanroep wordt ervan uitgegaan dat de gast Windows is en dat de systeemhoofdmap kan worden bepaald door
inspectie. Als dit niet het geval is, wordt er een fout geretourneerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-is-live
inspecteer-is-live root

Als "inspect-get-format" "installer" retourneert (dit is een installatieschijf), dan wordt dit geretourneerd
true als er een livebeeld op de schijf is gedetecteerd.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-is-meerdelig
inspecteer-is-multipart root

Als "inspect-get-format" "installer" retourneert (dit is een installatieschijf), dan wordt dit geretourneerd
true als de schijf deel uitmaakt van een set.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-is-netinst
inspect-is-netinst root

Als "inspect-get-format" "installer" retourneert (dit is een installatieschijf), dan wordt dit geretourneerd
true als de schijf een netwerkinstallatieprogramma is, dwz. geen op zichzelf staande installatie-cd, maar een installatie-cd
heeft waarschijnlijk netwerktoegang nodig om de installatie te voltooien.

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteer-lijst-applicaties
inspect-list-applicaties root

Retourneert de lijst met applicaties die in het besturingssysteem zijn geïnstalleerd.

Opmerking: Deze aanroep werkt anders dan andere delen van de inspectie-API. Je moet
roep "inspect-os" aan, en vervolgens "inspect-get-mountpoints", en mount vervolgens de schijven voordat u aanroept
dit. Het vermelden van aanvragen is een aanzienlijk moeilijkere operatie die vereist
toegang tot het volledige bestandssysteem. Merk ook op dat dit in tegenstelling tot de andere "inspect-get-*" -aanroepen
die alleen gegevens retourneren die in de cache in de libguestfs-handle zijn opgeslagen, deze aanroep leest feitelijk
delen van de aangekoppelde bestandssystemen tijdens de oproep.

Hierdoor wordt een lege lijst geretourneerd als de inspectiecode de lijst niet heeft kunnen bepalen
toepassingen.

De applicatiestructuur bevat de volgende velden:

"applicatie naam"
De naam van de applicatie. Voor van Red Hat en Debian afkomstige Linux-gasten:
dit is de pakketnaam.

"app_display_name"
De weergavenaam van de toepassing, soms gelokaliseerd in de installatietaal van
het gastbesturingssysteem.

Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "". Bellers moeten worden weergegeven
iets kan in plaats daarvan "app_name" gebruiken.

"app_epoch"
Voor pakketbeheerders die tijdperken gebruiken, bevat dit het tijdperk van het pakket (an
geheel getal). Indien niet beschikbaar, wordt dit geretourneerd als 0.

"app versie"
De versietekenreeks van de toepassing of het pakket. Indien niet beschikbaar, wordt dit geretourneerd als
een lege tekenreeks "".

"app_release"
De releasestring van de applicatie of het pakket, voor pakketbeheerders die dit gebruiken.
Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "".

"app_install_path"
Het installatiepad van de applicatie (op besturingssystemen zoals Windows die
gebruik installatiepaden). Dit pad heeft het formaat dat door de gast wordt gebruikt
systeem, het is geen libguestfs-pad.

Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "".

"app_trans_pad"
Het installatiepad vertaald in een libguestfs-pad. Als deze niet beschikbaar is, wordt deze geretourneerd
als een lege tekenreeks "".

"app_uitgever"
De naam van de uitgever van de applicatie, voor pakketbeheerders die hiervan gebruik maken. Als
niet beschikbaar, dit wordt geretourneerd als een lege tekenreeks "".

"app_url"
De URL (bijvoorbeeld upstream-URL) van de applicatie. Indien niet beschikbaar, wordt dit geretourneerd als een
lege tekenreeks "".

"app_source_pakket"
Voor verpakkingssystemen die dit ondersteunen, de naam van het bronpakket. Als
niet beschikbaar, dit wordt geretourneerd als een lege tekenreeks "".

"app_samenvatting"
Een korte (meestal één regel) beschrijving van de applicatie of het pakket. Indien niet beschikbaar
dit wordt geretourneerd als een lege tekenreeks "".

"app_beschrijving"
Een langere beschrijving van de applicatie of het pakket. Als deze niet beschikbaar is, wordt deze geretourneerd
als een lege tekenreeks "".

Lees "INSPECTIE" in gastfs(3) voor meer details.

In deze functie is verouderd. Gebruik in nieuwe code de aanroep "inspect-list-applications2".
gebruiken.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

inspecteer-lijst-applicaties2
inspecteer-lijst-applicaties2 root

Retourneert de lijst met applicaties die in het besturingssysteem zijn geïnstalleerd.

Opmerking: Deze aanroep werkt anders dan andere delen van de inspectie-API. Je moet
roep "inspect-os" aan, en vervolgens "inspect-get-mountpoints", en mount vervolgens de schijven voordat u aanroept
dit. Het vermelden van aanvragen is een aanzienlijk moeilijkere operatie die vereist
toegang tot het volledige bestandssysteem. Merk ook op dat dit in tegenstelling tot de andere "inspect-get-*" -aanroepen
die alleen gegevens retourneren die in de cache in de libguestfs-handle zijn opgeslagen, deze aanroep leest feitelijk
delen van de aangekoppelde bestandssystemen tijdens de oproep.

Hierdoor wordt een lege lijst geretourneerd als de inspectiecode de lijst niet heeft kunnen bepalen
toepassingen.

De applicatiestructuur bevat de volgende velden:

"app2_naam"
De naam van de applicatie. Voor van Red Hat en Debian afkomstige Linux-gasten:
dit is de pakketnaam.

"app2_display_naam"
De weergavenaam van de toepassing, soms gelokaliseerd in de installatietaal van
het gastbesturingssysteem.

Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "". Bellers moeten worden weergegeven
iets kan in plaats daarvan "app2_name" gebruiken.

"app2_epoch"
Voor pakketbeheerders die tijdperken gebruiken, bevat dit het tijdperk van het pakket (an
geheel getal). Indien niet beschikbaar, wordt dit geretourneerd als 0.

"app2_versie"
De versietekenreeks van de toepassing of het pakket. Indien niet beschikbaar, wordt dit geretourneerd als
een lege tekenreeks "".

"app2_release"
De releasestring van de applicatie of het pakket, voor pakketbeheerders die dit gebruiken.
Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "".

"app2_arch"
De architectuurtekenreeks van de toepassing of het pakket, voor pakketbeheerders die
dit. Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "".

"app2_installatie_pad"
Het installatiepad van de applicatie (op besturingssystemen zoals Windows die
gebruik installatiepaden). Dit pad heeft het formaat dat door de gast wordt gebruikt
systeem, het is geen libguestfs-pad.

Indien niet beschikbaar, wordt dit geretourneerd als een lege tekenreeks "".

"app2_trans_pad"
Het installatiepad vertaald in een libguestfs-pad. Als deze niet beschikbaar is, wordt deze geretourneerd
als een lege tekenreeks "".

"app2_publisher"
De naam van de uitgever van de applicatie, voor pakketbeheerders die hiervan gebruik maken. Als
niet beschikbaar, dit wordt geretourneerd als een lege tekenreeks "".

"app2_url"
De URL (bijvoorbeeld upstream-URL) van de applicatie. Indien niet beschikbaar, wordt dit geretourneerd als een
lege tekenreeks "".

"app2_bronpakket"
Voor verpakkingssystemen die dit ondersteunen, de naam van het bronpakket. Als
niet beschikbaar, dit wordt geretourneerd als een lege tekenreeks "".

"app2_samenvatting"
Een korte (meestal één regel) beschrijving van de applicatie of het pakket. Indien niet beschikbaar
dit wordt geretourneerd als een lege tekenreeks "".

"app2_beschrijving"
Een langere beschrijving van de applicatie of het pakket. Als deze niet beschikbaar is, wordt deze geretourneerd
als een lege tekenreeks "".

Lees "INSPECTIE" in gastfs(3) voor meer details.

inspecteren-os
inspecteren-os

Deze functie gebruikt andere libguestfs-functies en bepaalde heuristieken om het
schijf(s) (meestal schijven die bij een virtuele machine horen), op zoek naar besturingssystemen.

De geretourneerde lijst is leeg als er geen besturingssystemen zijn gevonden.

Als er één besturingssysteem is gevonden, retourneert dit een lijst met één enkel element, namelijk
is de naam van het rootbestandssysteem van dit besturingssysteem. Ook hiervoor is het mogelijk
functie om een ​​lijst terug te geven die meer dan één element bevat, wat een dual-boot of aangeeft
multi-boot virtuele machine, waarbij elk element het rootbestandssysteem is van een van de
besturingssystemen.

U kunt de rootstring(s) doorgeven aan andere "inspect-get-*"-functies om dit te doen
meer informatie opvragen over elk besturingssysteem, zoals de naam en versie.

Deze functie gebruikt andere libguestfs-functies zoals "mount-ro" en "umount-all" in volgorde
om bestandssystemen te mounten en te ontkoppelen en de inhoud te bekijken. Dit moet worden gebeld met nr
schijven die momenteel zijn gemonteerd. De functie kan ook gebruik maken van Augeas, dus elke bestaande Augeas-handle
zal gesloten worden.

Deze functie kan geen gecodeerde schijven decoderen. De beller moet dat eerst doen (supplying
de benodigde sleutels) als de schijf gecodeerd is.

Lees "INSPECTIE" in gastfs(3) voor meer details.

Zie ook "lijstbestandssystemen".

is-blockdev
is-blockdev-opts
is-blockdev pad [followsymlinks:true|false]

Dit retourneert 'true' als en alleen als er een blokapparaat is met de opgegeven 'pad'-naam.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een blokapparaat zorgt er ook voor dat de functie waar retourneert.

Deze aanroep kijkt alleen naar bestanden binnen het gastbestandssysteem. Libguestfs-partities en
apparaten blokkeren (bijv. / Dev / sda) kan niet worden gebruikt als de parameter "path" van deze aanroep.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-chardev
is-chardev-opteert
is-chardev pad [followsymlinks:true|false]

Dit retourneert 'true' als en slechts als er een karakterapparaat is met de opgegeven 'pad'-naam.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een chardev zorgt er ook voor dat de functie waar retourneert.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-config
is-config

Dit retourneert true als deze handle wordt geconfigureerd (in de status "CONFIG").

Voor meer informatie over staten, zie gastfs(3).

is-dir
is-dir-opteert
is-dir pad [followsymlinks:true|false]

Dit retourneert "true" als en slechts als er een map is met de opgegeven "pad"-naam. Opmerking
dat het false retourneert voor andere objecten zoals bestanden.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een map zorgt er ook voor dat de functie waar retourneert.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-fifo
is-fifo-opteert
is-fifo pad [followsymlinks:true|false]

Dit retourneert "true" als en slechts als er een FIFO (named pipe) is met het opgegeven "pad"
naam.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een FIFO zorgt er ook voor dat de functie waar retourneert.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-bestand
is-bestand-opts
is-bestandspad [followsymlinks:true|false]

Dit retourneert "true" als en slechts als er een regulier bestand is met de opgegeven "pad"-naam.
Merk op dat het false retourneert voor andere objecten zoals mappen.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een bestand zorgt er ook voor dat de functie waar retourneert.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-lv
is-lv-apparaat

Deze opdracht test of "device" een logisch volume is, en retourneert true als dit het volume is
geval.

is-aansluiting
is-socket-opteert
is-socketpad [followsymlinks:true|false]

Dit retourneert "true" als en slechts als er een Unix-domeinsocket is met het opgegeven "pad"
naam.

Als de optionele vlag "followsymlinks" waar is, dan is er een symlink (of keten van symlinks) die
eindigt met een socket zorgt er ook voor dat de functie waar retourneert.

Zie ook "statistiek".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

is-symlink
is-symlink-pad

Dit retourneert "true" als en slechts als er een symbolische link is met de opgegeven "pad"-naam.

Zie ook "statistiek".

is-hele-apparaat
is een apparaat voor het hele apparaat

Dit retourneert 'true' als en slechts als 'apparaat' verwijst naar een heel blokapparaat. Dat wil zeggen: niet A
partitie of een logisch apparaat.

is-nul
is-nul pad

Dit retourneert waar als het bestand bestaat en het bestand leeg is of als het allemaal nul bytes bevat.

is-nul-apparaat
is-nul-apparaat-apparaat

Dit retourneert waar als het apparaat bestaat en alle nulbytes bevat.

Houd er rekening mee dat dit bij grote apparaten lang kan duren.

isoinfo
isoinfo isobestand

Dit is hetzelfde als "isoinfo-device", behalve dat het werkt voor een ISO-bestand dat zich daarin bevindt
een ander aangekoppeld bestandssysteem. Houd er rekening mee dat in het gebruikelijke geval waarin u een ISO hebt toegevoegd
bestand als een libguestfs-apparaat, zou u dat doen niet noem dit. In plaats daarvan zou je "isoinfo-
apparaat".

isoinfo-apparaat
isoinfo-apparaatapparaat

"apparaat" is een ISO-apparaat. Dit retourneert een structuur van informatie die uit de primaire wordt gelezen
volumedescriptor (het ISO-equivalent van het superblok) van het apparaat.

Meestal is het efficiënter om de isoinfo(1) commando met de -d optie op de host
om ISO-bestanden te analyseren, in plaats van door libguestfs te gaan.

Voor informatie over de primaire volumedescriptorvelden, zie
http://wiki.osdev.org/ISO_9660#De_Primaire_Volume_Descriptor

journaal-afsluiten
journaal-afsluiten

Sluit de journaalgreep.

dagboek-get
dagboek-get

Lees de huidige journaalboeking. Hiermee worden alle velden in het journaal geretourneerd als een set van
"(attrname, attrval)"-paren. De "attrname" is de veldnaam (een tekenreeks).

De "attrval" is de veldwaarde (een binaire blob, vaak maar niet altijd een string). Alsjeblieft
merk op dat "attrval" een byte-array is, niet een op \0 eindigende C-reeks.

De lengte van de gegevens kan worden ingekort tot de gegevensdrempel (zie: "journal-set-data-
drempel", "journal-get-data-threshold").

Als u de gegevensdrempel instelt op onbeperkt (0), kan deze oproep een journaalboeking lezen van
elke maat, bijv. het wordt niet beperkt door het libguestfs-protocol.

journaal-get-data-threshold
journaal-get-data-threshold

Haal de huidige gegevensdrempel op voor het lezen van journaalboekingen. Dit is een hint voor het tijdschrift
dat gegevensvelden tot deze grootte kunnen worden afgekapt bij het lezen ervan (merk ook op dat dit niet het geval is).
kort ze af). Als dit 0 oplevert, is de drempel onbeperkt.

Zie ook "journal-set-data-threshold".

journal-get-realtime-usec
journal-get-realtime-usec

Ontvang de realtime (wandklok) tijdstempel van de huidige journaalboeking.

tijdschrift-volgende
tijdschrift-volgende

Naar de volgende journaalboeking gaan. U moet dit minstens één keer bellen nadat u het bestand hebt geopend
verwerken voordat u gegevens kunt lezen.

De geretourneerde Booleaanse waarde vertelt u of er nog meer journaalrecords zijn om te lezen. "WAAR"
betekent dat u het volgende record kunt lezen (bijv. met behulp van "journal-get"), en "false" betekent dat dit het geval is
het einde van het dagboek bereikt.

tijdschrift-open
journal-open map

Open het systemd-journaal dat zich in directory. Elke eerder geopende journaalingang is dat wel
Gesloten.

De inhoud van het tijdschrift kan worden gelezen met "journal-next" en "journal-get".

Nadat u klaar bent met het gebruik van het dagboek, sluit u de handgreep door te bellen
"journaal-close".

journaal-set-data-drempel
drempelwaarde voor dagboeksetgegevens

Stel de gegevensdrempel in voor het lezen van journaalboekingen. Dit is een hint voor het tijdschrift dat dit het geval is
kan gegevensvelden tot deze grootte afkappen wanneer ze worden gelezen (merk ook op dat dit niet het geval is
kort ze af). Zet je deze op 0, dan is de drempel onbeperkt.

Zie ook "journal-get-data-threshold".

dagboek overslaan
dagboek overslaan

Vooruitspringen ("skip ≥ 0") of achteruit ("skip < 0") in het journaal.

Het aantal daadwerkelijk overgeslagen vermeldingen wordt geretourneerd (let op "rskip ≥ 0"). Als dit niet de
hetzelfde als de absolute waarde van de skip-parameter ("|skip|") die u hebt ingevoerd, betekent dit
je hebt het einde of het begin van het dagboek bereikt.

kill-subproces
kill-subproces

Dit doodt de hypervisor.

Noem dit niet. Zie in plaats daarvan: "afsluiten".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "shutdown".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

lancering
lopen
lancering

U moet dit aanroepen nadat u de handle hebt geconfigureerd (bijvoorbeeld door schijven toe te voegen), maar daarvoor
het uitvoeren van eventuele acties.

Roep niet twee keer "lanceren" op hetzelfde handvat. Hoewel het geen fout zal geven (bijv
historische redenen), is het precieze gedrag wanneer u dit doet niet goed gedefinieerd. Handvatten
zijn erg goedkoop om te maken, dus maak voor elke lancering een nieuwe.

Ik hoor
Het pad van de eigen eigenaargroep

Wijzig de bestandseigenaar in "eigenaar" en de groep in "groep". Dit is als "chown", maar als "pad"
een symlink is, wordt de link zelf gewijzigd, niet het doel.

Alleen numerieke uid en gid worden ondersteund. Als u namen wilt gebruiken, moet u lokaliseren
en parseer het wachtwoordbestand zelf (Augeas-ondersteuning maakt dit relatief eenvoudig).

ldmtool-alles maken
ldmtool-alles maken

Deze functie scant alle blokapparaten op zoek naar dynamische schijfvolumes van Windows en
partities en maakt apparaten aan voor alle gevonden partities.

Roep "list-ldm-volumes" en "list-ldm-partitions" aan om alle apparaten te retourneren.

Merk op dat u niet Normaal gesproken moet u dit expliciet aanroepen, omdat dit automatisch gebeurt
op het moment van "lancering". Het is echter mogelijk dat u deze functie wilt aanroepen als u hotplugged heeft
schijven of u hebt zojuist een dynamische Windows-schijf gemaakt.

ldmtool-schijfgroep-schijven
ldmtool-diskgroup-schijven schijfgroep

Retourneer de schijven in een dynamische Windows-schijfgroep. De parameter "diskgroup" moet de
GUID van een schijfgroep, één element uit de lijst geretourneerd door "ldmtool-scan".

ldmtool-schijfgroepnaam
ldmtool-diskgroup-naam diskgroup

Retourneert de naam van een dynamische Windows-schijfgroep. De parameter "diskgroup" moet de
GUID van een schijfgroep, één element uit de lijst geretourneerd door "ldmtool-scan".

ldmtool-schijfgroep-volumes
ldmtool-diskgroup-volumes schijfgroep

Retourneer de volumes in een dynamische Windows-schijfgroep. De parameter "diskgroup" moet zijn
de GUID van een schijfgroep, één element uit de lijst geretourneerd door "ldmtool-scan".

ldmtool-alles verwijderen
ldmtool-alles verwijderen

Dit is in wezen het tegenovergestelde van "ldmtool-create-all". Het verwijdert de apparaattoewijzer
toewijzingen voor alle dynamische schijfvolumes van Windows

ldmtool-scan
ldmtool-scan

Deze functie scant naar dynamische Windows-schijven. Het retourneert een lijst met identificatiegegevens (GUID's)
voor alle schijfgroepen die zijn gevonden. Deze identificatiegegevens kunnen worden doorgegeven aan andere "ldmtool-*"
functies.

Deze functie scant alle blokapparaten. Om een ​​subset van blokapparaten te scannen, roept u "ldmtool-
scanapparaten" in plaats daarvan.

ldmtool-scan-apparaten
ldmtool-scan-devices 'apparaten ...'

Deze functie scant naar dynamische Windows-schijven. Het retourneert een lijst met identificatiegegevens (GUID's)
voor alle schijfgroepen die zijn gevonden. Deze identificatiegegevens kunnen worden doorgegeven aan andere "ldmtool-*"
functies.

De parameter "apparaten" is een lijst met blokapparaten die worden gescand. Als deze lijst dat is
leeg, alle blokapparaten worden gescand.

ldmtool-volume-hint
ldmtool-volume-hint schijfgroepvolume

Retourneert het hintveld van het volume met de naam 'volume' in de schijfgroep met GUID
"schijfgroep". Dit is mogelijk niet gedefinieerd, in welk geval de lege string wordt geretourneerd. De
hintveld is vaak, maar niet altijd, de naam van een Windows-station, bijvoorbeeld. "E:".

ldmtool-volume-partities
ldmtool-volume-partities schijfgroepvolume

Retourneer de lijst met partities in het volume met de naam 'volume' in de schijfgroep met GUID
"schijfgroep".

ldmtool-volume-type
ldmtool-volume-type schijfgroepvolume

Retourneert het type volume met de naam 'volume' in de schijfgroep met GUID 'diskgroup'.

Mogelijke volumetypen die hier kunnen worden geretourneerd zijn: "eenvoudig", "spanned", "striped",
"gespiegeld", "raid5". Andere soorten kunnen ook geretourneerd worden.

lgetxattr
padnaam lgetxattr

Haal een enkel uitgebreid attribuut op uit het bestand "pad" met de naam "naam". Als "pad" een symbolische link is,
dan retourneert deze aanroep een uitgebreid attribuut van de symlink.

Normaal gesproken is het beter om alle uitgebreide attributen in één keer uit een bestand te halen door te bellen
"getxattrs". Sommige Linux-bestandssysteemimplementaties bevatten echter fouten en bieden geen
manier om attributen op te sommen. Voor deze bestandssystemen (met name ntfs-3g) moet je de
namen van de gewenste uitgebreide attributen vooraf en roep deze functie aan.

Uitgebreide attribuutwaarden zijn klodders binaire gegevens. Als er geen uitgebreid attribuut is
met de naam "naam", retourneert dit een fout.

Zie ook: "lgetxattrs", "getxattr", attr(5).

lgetxattrs
lgetxattrs-pad

Dit is hetzelfde als "getxattrs", maar als "path" een symbolische link is, retourneert het de
uitgebreide kenmerken van de link zelf.

lijst-9p
lijst-9p

Maak een lijst van alle 9p-bestandssystemen die aan de gast zijn gekoppeld. Er wordt een lijst met mount-tags geretourneerd.

lijst-apparaten
lijst-apparaten

Maak een lijst van alle blokapparaten.

De volledige blokapparaatnamen worden geretourneerd, bijvoorbeeld. / Dev / sda.

Zie ook "lijstbestandssystemen".

lijst-schijflabels
lijst-schijflabels

Als u schijven toevoegt met behulp van de optionele parameter "label" van "add-drive-opts", kunt u
deze aanroep om schijflabels en onbewerkte blokapparaat- en partitienamen (zoals
/ Dev / sda en / Dev / sda1).

Dit retourneert een hashtabel, waarbij sleutels de schijflabels zijn (zonder the /dev/schijf/guestfs
prefix), en de waarden zijn de volledige onbewerkte blokapparaat- en partitienamen (bijv. / Dev / sda
en / Dev / sda1).

list-dm-apparaten
list-dm-apparaten

Maak een lijst van alle Device Mapper-apparaten.

De geretourneerde lijst bevat /dev/mapper/* apparaten, bijv. degenen die zijn gemaakt door een eerdere oproep naar
"luks-open".

Device mapper-apparaten die overeenkomen met logische volumes zijn dat wel niet terug in deze lijst.
Roep "lvs" aan als u logische volumes wilt weergeven.

list-bestandssystemen
list-bestandssystemen

Deze inspectieopdracht zoekt naar bestandssystemen op partities, blokapparaten en logische
volumes, waarbij een lijst met "mountables" wordt geretourneerd die bestandssystemen en hun type bevatten.

De retourwaarde is een hash, waarbij de sleutels de apparaten zijn die bestandssystemen bevatten, en de
waarden zijn de bestandssysteemtypen. Bijvoorbeeld:

"/dev/sda1" => "ntfs"
"/dev/sda2" => "ext2"
"/dev/vg_guest/lv_root" => "ext4"
"/dev/vg_guest/lv_swap" => "ruilen"

De sleutel is niet noodzakelijkerwijs een blokapparaat. Het kan ook een ondoorzichtige 'monteerbare' string zijn
die kan worden doorgegeven aan "mount".

De waarde kan de speciale waarde "onbekend" hebben, wat betekent dat de inhoud van het apparaat dat is
onbepaald of leeg. "swap" betekent een Linux-swappartitie.

Deze opdracht voert andere libguestfs-opdrachten uit, waaronder mogelijk "mount" en "umount", en
daarom moet je dit kort na de lancering gebruiken en alleen als er niets is gemonteerd.

Niet alle geretourneerde bestandssystemen kunnen worden gemonteerd. In het bijzonder zijn swappartities dat wel
terug in de lijst. Ook controleert deze opdracht niet of elk gevonden bestandssysteem
geldig en monteerbaar, en sommige bestandssystemen kunnen monteerbaar zijn, maar vereisen speciale opties.
Bestandssystemen behoren mogelijk niet allemaal tot één enkel logisch besturingssysteem (gebruik "inspect-os" om
zoek naar besturingssystemen).

lijst-ldm-partities
lijst-ldm-partities

Deze functie retourneert alle dynamische Windows-schijfpartities die zijn gevonden tijdens het opstarten.
Het retourneert een lijst met apparaatnamen.

lijst-ldm-volumes
lijst-ldm-volumes

Deze functie retourneert alle dynamische schijfvolumes van Windows die zijn gevonden tijdens het opstarten. Het
retourneert een lijst met apparaatnamen.

list-md-apparaten
list-md-apparaten

Maak een lijst van alle Linux MD-apparaten.

lijst-partities
lijst-partities

Maak een lijst van alle partities die op alle blokapparaten zijn gedetecteerd.

De volledige namen van partitieapparaten worden geretourneerd, bijvoorbeeld. / Dev / sda1

Dit retourneert geen logische volumes. Daarvoor moet je "lvs" aanroepen.

Zie ook "lijstbestandssystemen".

ll
ll-map

Maak een lijst van de bestanden in directory (ten opzichte van de hoofdmap is er geen cwd) in de
formaat van 'ls -la'.

Deze opdracht is vooral handig voor interactieve sessies. Het is niet bedoeld dat je het probeert
om de uitvoerreeks te parseren.

llz
llz-map

Maak een lijst van de bestanden in directory in het formaat 'ls -laZ'.

Deze opdracht is vooral handig voor interactieve sessies. Het is niet bedoeld dat je het probeert
om de uitvoerreeks te parseren.

ln
In doellinknaam

Met deze opdracht wordt een harde koppeling gemaakt met behulp van de opdracht "ln".

ln-f
ln-f doellinknaam

Met deze opdracht wordt een harde koppeling gemaakt met behulp van de opdracht "ln -f". De -f optie verwijdert de
link ("linknaam") als deze al bestaat.

ln-s
ln-s doellinknaam

Met deze opdracht wordt een symbolische link gemaakt met behulp van de opdracht "ln -s".

ln-sf
ln-sf doellinknaam

Deze opdracht maakt een symbolische link met behulp van de opdracht "ln -sf", The -f optie verwijdert de
link ("linknaam") als deze al bestaat.

lverwijderexattr
lremovexattr xattr pad

Dit is hetzelfde als "removexattr", maar als "path" een symbolische link is, verwijdert het een
uitgebreid attribuut van de link zelf.

ls
ls-map

Maak een lijst van de bestanden in directory (ten opzichte van de hoofdmap is er geen cwd). De '.'
en '..'-items worden niet geretourneerd, maar verborgen bestanden worden weergegeven.

ls0
ls0 map (bestandsnamen|-)

Dit gespecialiseerde commando wordt gebruikt om een ​​overzicht te krijgen van de bestandsnamen in de directory "dir".
De lijst met bestandsnamen wordt naar het lokale bestand geschreven bestandsnamen (op de gastheer).

In het uitvoerbestand worden de bestandsnamen gescheiden door "\0"-tekens.

"." en ".." worden niet geretourneerd. De bestandsnamen zijn niet gesorteerd.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

lsetxattr
lsetxattr xattr val vallen pad

Dit is hetzelfde als "setxattr", maar als "path" een symbolische link is, dan wordt er een extended
attribuut van de link zelf.

staat
lstat-pad

Retourneert bestandsinformatie voor het opgegeven "pad".

Dit is hetzelfde als "stat", behalve dat als "pad" een symbolische link is, de link dat ook is
state-ed, niet het bestand waarnaar het verwijst.

Dit is hetzelfde als de staat(2) systeemoproep.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "lstatns".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

lstatlijst
lstatlist-pad 'namen ...'

Met deze aanroep kunt u de bewerking "lstat" uitvoeren op meerdere bestanden, waarbij alle bestanden
bevinden zich in de map "pad". "names" is de lijst met bestanden uit deze map.

Bij terugkomst krijg je een lijst met statistische structuren, met een één-op-één correspondentie met de "namen"
lijst. Als een naam niet bestaat of niet kan worden ingevoerd, dan wordt het veld "st_ino" daarvan weergegeven
structuur is ingesteld op "-1".

Deze aanroep is bedoeld voor programma's die de inhoud van een map efficiënt willen weergeven
zonder veel heen- en terugreizen te maken. Zie ook "lxattrlist" voor een vergelijkbare efficiënte oproep voor
uitgebreide attributen krijgen.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "lstatnslist".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

staten
lstatns pad

Retourneert bestandsinformatie voor het opgegeven "pad".

Dit is hetzelfde als "statns", behalve dat als "path" een symbolische link is, de link dat ook is
state-ed, niet het bestand waarnaar het verwijst.

Dit is hetzelfde als de staat(2) systeemoproep.

lstatnslijst
lstatnslist pad 'namen ...'

Met deze aanroep kunt u de bewerking "lstatns" uitvoeren op meerdere bestanden, waarbij alle bestanden
bevinden zich in de map "pad". "names" is de lijst met bestanden uit deze map.

Bij terugkomst krijg je een lijst met statistische structuren, met een één-op-één correspondentie met de "namen"
lijst. Als een naam niet bestaat of niet kan worden ingevoerd, dan wordt het veld "st_ino" daarvan weergegeven
structuur is ingesteld op "-1".

Deze aanroep is bedoeld voor programma's die de inhoud van een map efficiënt willen weergeven
zonder veel heen- en terugreizen te maken. Zie ook "lxattrlist" voor een vergelijkbare efficiënte oproep voor
uitgebreide attributen krijgen.

luks-toevoegen-toets
luks-add-key apparaatsleutelsleuf

Met deze opdracht wordt een nieuwe sleutel toegevoegd aan het LUKS-apparaat "apparaat". "sleutel" is elke bestaande sleutel, en is dat ook
gebruikt om toegang te krijgen tot het apparaat. "newkey" is de nieuwe sleutel die moet worden toegevoegd. "sleutelslot" is het sleutelslot
dat wordt vervangen.

Houd er rekening mee dat als "keyslot" al een sleutel bevat, deze opdracht zal mislukken. Je moet
gebruik eerst "luks-kill-slot" om die sleutel te verwijderen.

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

luks-dichtbij
luks-close-apparaat

Hiermee wordt een LUKS-apparaat gesloten dat eerder is gemaakt door "luks-open" of "luks-open-ro". De
De parameter "device" moet de naam zijn van het LUKS-toewijzingsapparaat (bijv. /dev/mapper/mapnaam)
en niet de naam van het onderliggende blokapparaat.

luks-formaat
luks-formaat apparaatsleutelsleuf

Met deze opdracht worden de bestaande gegevens op het "apparaat" gewist en wordt het apparaat geformatteerd als een gecodeerd LUKS-apparaat
apparaat. "sleutel" is de initiële sleutel, die wordt toegevoegd aan sleutelslot "slot". (LUKS ondersteunt 8
sleutelgleuven, genummerd 0-7).

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

luks-formaat-cijfer
luks-format-cipher apparaat sleutelslot cipher

Dit commando is hetzelfde als "luks-format", maar u kunt er ook het gebruikte "cipher" mee instellen.

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

luks-kill-slot
luks-kill-slot apparaatsleutelslot

Met deze opdracht wordt de sleutel in sleutelslot "keyslot" verwijderd van het gecodeerde LUKS-apparaat
"apparaat". "sleutel" moet een van de zijn Overige sleutels.

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

luks-open
luks-open apparaatkaartnaam

Deze opdracht opent een blokapparaat dat is gecodeerd volgens Linux Unified
Key Setup (LUKS) standaard.

"apparaat" is het gecodeerde blokapparaat of de partitie.

De beller moet een van de sleutels opgeven die zijn gekoppeld aan het LUKS-blokkeerapparaat, in de "sleutel"
parameter.

Hierdoor wordt een nieuw blokapparaat aangemaakt, genaamd /dev/mapper/mapnaam. Leest en schrijft hiernaar
blokapparaat worden respectievelijk gedecodeerd van en gecodeerd naar het onderliggende "apparaat".

Als dit blokapparaat LVM-volumegroepen bevat, roept u "vgscan" aan, gevolgd door "vg-
activatie-alles" zal ze zichtbaar maken.

Gebruik "list-dm-devices" om alle Device Mapper-apparaten weer te geven.

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

luks-open-ro
luks-open-ro apparaatkaartnaam

Dit is hetzelfde als "luks-open", behalve dat er een alleen-lezen-toewijzing wordt gemaakt.

Deze opdracht heeft een of meer sleutel- of wachtwoordzinparameters. Guestfish zal vragen om
deze afzonderlijk.

lvcreëren
lvcreate logvol volgroup MBes

Hierdoor wordt een logisch LVM-volume gemaakt met de naam "logvol" op de volumegroep "volgroup", met
"grootte" megabytes.

lvcreate-vrij
lvcreate-free logvol volgroup procent

Maak een LVM logisch volume met de naam /dev/volgroup/logvol, waarbij ongeveer "procent" % wordt gebruikt
van de resterende vrije ruimte in de volumegroep. Dit is het handigst als 'percentage' 100 is
hierdoor ontstaat de grootst mogelijke LV.

lvm-canonieke-lv-naam
lvm-canonieke-lv-naam lvnaam

Hiermee worden alternatieve naamgevingsschema's voor LV's die u mogelijk tegenkomt, omgezet in het canonieke
naam. Bijvoorbeeld, /dev/mapper/VG-LV wordt omgezet in /dev/VG/LV.

Deze opdracht retourneert een fout als de parameter "lvname" niet verwijst naar een logisch
volume.

Zie ook "is-lv", "canonieke apparaatnaam".

lvm-clear-filter
lvm-clear-filter

Dit maakt het effect van "lvm-set-filter" ongedaan. LVM kan elk blokapparaat zien.

Met deze opdracht wordt ook de LVM-cache gewist en wordt een volumegroepscan uitgevoerd.

lvm-verwijder-alles
lvm-verwijder-alles

Met deze opdracht worden alle logische LVM-volumes, volumegroepen en fysieke volumes verwijderd.

lvm-set-filter
lvm-set-filter 'apparaten ...'

Hiermee wordt het LVM-apparaatfilter zo ingesteld dat LVM alleen de blokapparaten kan "zien".
in de lijst "apparaten", en negeert alle andere aangesloten blokapparaten.

Als schijfimage(s) dubbele PV's of VG's bevatten, is deze opdracht handig om LVM naartoe te halen
negeer de duplicaten, anders kan LVM in de war raken. Merk ook op dat er twee soorten zijn
duplicatie mogelijk: ofwel gekloonde PV's/VG's die identieke UUID's hebben; of VG's die dat zijn
niet gekloond, maar heeft toevallig dezelfde naam. Bij normaal gebruik kunt u geen creatie maken
deze situatie, maar u kunt het buiten LVM doen, bijvoorbeeld. door schijfimages te klonen of per bit
rommelen in de LVM-metagegevens.

Met deze opdracht wordt ook de LVM-cache gewist en wordt een volumegroepscan uitgevoerd.

U kunt hele blokapparaten of individuele partities filteren.

U kunt dit niet gebruiken als er momenteel een VG in gebruik is (bijvoorbeeld als deze een aangekoppeld bestandssysteem bevat),
zelfs als u die VG niet filtert.

verplaats
Verwijder het apparaat

Verwijder een LVM logisch volume "device", waarbij "device" het pad naar de LV is, zoals
/dev/VG/LV.

U kunt ook alle LV's in een volumegroep verwijderen door de VG-naam op te geven, /dev/VG.

lvrenaam
lvrename logvol newlogvol

Hernoem een ​​logisch volume "logvol" met de nieuwe naam "newlogvol".

Groot formaat
Vergroot het aantal MB's van het apparaat

Hiermee wordt de grootte van een bestaand logisch LVM-volume gewijzigd (breidt of verkleint) naar "mbytes". Wanneer
verkleinen, gegevens in het verkleinde deel gaan verloren.

Vrij van formaat
lvresize-vrij lv procent

Dit breidt een bestaand logisch volume "lv" uit, zodat het "pc"% van het resterende vrije volume vult
ruimte in de volumegroep. Normaal gesproken zou je dit noemen met pc = 100, wat de
zoveel mogelijk op het logische volume, waarbij alle resterende vrije ruimte in de volumegroep wordt gebruikt.

lvs
lvs

Maak een lijst van alle gedetecteerde logische volumes. Dit is het equivalent van de lvs(8) opdracht.

Dit retourneert een lijst met de namen van de logische volumeapparaten (bijv. /dev/VolGroup00/LogVol00).

Zie ook "lvs-full", "list-bestandssystemen".

lvs-vol
lvs-vol

Maak een lijst van alle gedetecteerde logische volumes. Dit is het equivalent van de lvs(8) opdracht. De
"volledige" versie bevat alle velden.

lvuuid
Prachtig apparaat

Deze opdracht retourneert de UUID van het LVM LV "apparaat".

lxattrlijst
lxattrlist pad 'namen ...'

Met deze aanroep kunt u de uitgebreide kenmerken van meerdere bestanden ophalen, waar alle bestanden zich bevinden
in de map "pad". "names" is de lijst met bestanden uit deze map.

Bij terugkomst krijg je een platte lijst met xattr-structuren die opeenvolgend moeten worden geïnterpreteerd.
De eerste xattr-structuur heeft altijd een "attrname" met de lengte nul. "attrval" in deze structuur is
nul-lengte om aan te geven dat er een fout is opgetreden bij het uitvoeren van "lgetxattr" voor dit bestand, or is een C
string die een decimaal getal is (het aantal volgende attributen voor dit bestand, welke
kan "0" zijn). Dan staan ​​na de eerste xattr-structuur de nul of meer attributen voor de
eerstgenoemde bestand. Dit herhaalt zich voor het tweede en volgende bestand.

Deze aanroep is bedoeld voor programma's die de inhoud van een map efficiënt willen weergeven
zonder veel heen- en terugreizen te maken. Zie ook "lstatlist" voor een soortgelijke efficiënte oproep
standaardstatistieken verkrijgen.

max-schijven
max-schijven

Retourneert het maximale aantal schijven dat aan een handle kan worden toegevoegd (bijvoorbeeld door "add-drive-opts"
en soortgelijke oproepen).

Deze functie is toegevoegd in libguestfs 1.19.7. In eerdere versies van libguestfs was het
limiet was 25.

Zie "MAXIMUM AANTAL SCHIJVEN" in gastfs(3) voor aanvullende informatie over dit onderwerp.

md-creëren
md-create naam 'apparaten ...' [missingbitmap:N] [nrdevices:N] [spare:N] [chunk:N] [niveau:..]

Maak een Linux MD (RAID)-apparaat met de naam "name" op de apparaten in de lijst "devices".

De optionele parameters zijn:

"ontbrekende bitmap"
Een bitmap van ontbrekende apparaten. Als er een bit is ingesteld, betekent dit dat er een ontbrekend apparaat is toegevoegd
naar de array. Het minst significante bit komt overeen met het eerste apparaat in de array.

Als voorbeelden:

Als "devices = ["/dev/sda"]" en "missingbitmap = 0x1" dan zou de resulterende array
zijn "[ , "/dev/sda"]".

Als "devices = ["/dev/sda"]" en "missingbitmap = 0x2" dan zou de resulterende array
wees "["/dev/sda", ]".

Deze staat standaard op 0 (geen ontbrekende apparaten).

De lengte van "apparaten" + het aantal bits dat is ingesteld in "missingbitmap" moet gelijk zijn
"nrapparaten" + "reserve".

"nrapparaten"
Het aantal actieve RAID-apparaten.

Als dit niet wordt ingesteld, wordt dit standaard ingesteld op de lengte van "apparaten" plus het aantal ingestelde bits
"ontbrekende bitmap".

"Reserve"
Het aantal reserveapparaten.

Als dit niet is ingesteld, is dit standaard 0.

"brok"
De chunkgrootte in bytes.

"peil"
Het RAID-niveau, dat een van de volgende kan zijn: lineair, raid0, 0, streep, raid1, 1, spiegel,
raid4, 4, raid5, 5, raid6, 6, raid10, 10. Sommige hiervan zijn synoniem, en meer
Niveaus kunnen in de toekomst worden toegevoegd.

Indien niet ingesteld, is dit standaard "raid1".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

md-detail
md-detail md

Deze opdracht geeft de uitvoer van 'mdadm -DY weer '. Meestal zijn dit de volgende velden
aanwezig in de geretourneerde hash. Er kunnen ook andere velden aanwezig zijn.

"peil"
Het raid-niveau van het MD-apparaat.

"apparaten"
Het aantal onderliggende apparaten in het MD-apparaat.

"metagegevens"
De gebruikte metadataversie.

"uuid"
De UUID van het MD-apparaat.

"naam"
De naam van het MD-apparaat.

md-stat
md-stat md

Deze oproep retourneert een lijst met de onderliggende apparaten waaruit de enkele software-RAID bestaat
array-apparaat "md".

Om een ​​lijst met software-RAID-apparaten te krijgen, roept u "list-md-devices" op.

Elke geretourneerde structuur komt overeen met één apparaat, samen met een aanvullende status
informatie:

"mdstat_apparaat"
De naam van het onderliggende apparaat.

"mdstat_index"
De index van dit apparaat binnen de array.

"mdstat_flags"
Vlaggen die aan dit apparaat zijn gekoppeld. Dit is een string met (in willekeurige volgorde)
nul of meer van de volgende vlaggen:

"W" schrijft voornamelijk

"F"-apparaat is defect

"S"-apparaat is een RAID-reserveapparaat

"R"-vervanging

md-stop
md-stop md

Met deze opdracht wordt de MD-array met de naam "md" gedeactiveerd. Het apparaat is gestopt, maar dat is niet het geval
vernietigd of op nul gezet.

mkdir
mkdir-pad

Maak een map met de naam "pad".

mkdir-modus
mkdir-modus padmodus

Met deze opdracht wordt een map gemaakt, waarbij de initiële machtigingen van de map worden ingesteld
"modus".

Voor gewone Linux-bestandssystemen is de daadwerkelijke modus die wordt ingesteld "mode & ~umask &
01777". Niet-native-Linux-bestandssystemen kunnen de modus op andere manieren interpreteren.

Zie ook "mkdir", "umask"

mkdir-p
mkdir-p-pad

Maak een map met de naam "pad", en maak eventueel bovenliggende mappen aan. Dit is
zoals het shell-commando "mkdir -p".

mkdtemp
mkdtemp tmpl

Met deze opdracht wordt een tijdelijke map gemaakt. De parameter 'tmpl' moet een full zijn
padnaam voor de tijdelijke mapnaam, waarbij de laatste zes tekens "XXXXXX" zijn.

Bijvoorbeeld: "/tmp/myprogXXXXXX" of "/Temp/myprogXXXXXX", waarbij de tweede geschikt is
voor Windows-bestandssystemen.

De naam van de tijdelijke map die is gemaakt, wordt geretourneerd.

De tijdelijke map is gemaakt met modus 0700 en is eigendom van root.

De beller is verantwoordelijk voor het verwijderen van de tijdelijke map en de inhoud ervan na gebruik.

Zie ook: mkdtemp(3)

mke2fs
mke2fs-apparaat [aantal blokken:N] [blokgrootte:N] [fragmentgrootte:N] [blokkenpergroep:N] [aantalgroepen:N] [bytesperinode:N] [inodegrootte:N] [journalgrootte:N] [aantalinodes:N] [stridesize: N] [streepbreedte:N] [maxonlineresize:N] [gereserveerdeblokkenpercentage:N] [mmpupdateinterval:N] [journaalapparaat:..] [label:..] [laatstgemonteerde map:..] [creatoros:..] [fstype:. .] [gebruikstype:..] [uuid:..] [forcecreate:true|false] [writesbandgrouponly:true|false] [lazyitableinit:true|false] [lazyjournalinit:true|false] [testfs:true|false] [ verwijder:true|false] [quotatype:true|false] [extent:true|false] [bestandstype:true|false] [flexbg:true|false] [hasjournal:true|false] [journaldev:true|false] [groot bestand :true|false] [quota:true|false] [resizeinode:true|false] [sparsesuper:true|false] [uninitbg:true|false]

"mke2fs" wordt gebruikt om een ​​ext2-, ext3- of ext4-bestandssysteem op "apparaat" te maken.

De optionele "blockscount" is de grootte van het bestandssysteem in blokken. Als het wordt weggelaten
standaard ingesteld op de grootte van "apparaat". Let op als het bestandssysteem te klein is om een
journal, zal "mke2fs" in plaats daarvan stilletjes een ext2-bestandssysteem aanmaken.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mke2fs-J
mke2fs-J fstype apparaatlogboek met blokgrootte

Hierdoor wordt een ext2/3/4 bestandssysteem op "device" aangemaakt met een extern journaal op "journal". Het
is gelijk aan het commando:

mke2fs -t fstype -b blokgrootte -J device=

Zie ook "mke2journal".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mke2fs-JL
mke2fs-JL fstype apparaatlabel met blokgrootte

Hierdoor wordt een ext2/3/4 bestandssysteem op "apparaat" aangemaakt met een extern journaal op het journaal
met het label "label".

Zie ook "mke2journal-L".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mke2fs-JU
mke2fs-JU fstype blokformaat apparaat uuid

Hierdoor wordt een ext2/3/4 bestandssysteem op "apparaat" aangemaakt met een extern journaal op het journaal
met UUID "uuid".

Zie ook "mke2journal-U".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mke2journaal
mke2journal blokkeerapparaat

Hierdoor wordt een ext2 extern journaal aangemaakt op "apparaat". Het is gelijk aan het commando:

mke2fs -O journal_dev -b blokgrootte-apparaat

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mke2journaal-L
mke2journal-L labelapparaat met blokgrootte

Hierdoor wordt een ext2 extern journaal aangemaakt op "apparaat" met label "label".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mke2journal-U
mke2journal-U blokkeert uuid-apparaat

Hierdoor wordt een ext2 extern journaal aangemaakt op "device" met UUID "uuid".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mke2fs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mkfifo
mkfifo-moduspad

Deze oproep creëert een FIFO (genaamd pipe) genaamd "path" met modus "mode". Het is gewoon een
handig wikkeltje om "mknod".

In tegenstelling tot "mknod", "mode" Dan moet je bevatten alleen machtigingsbits.

De feitelijk ingestelde modus wordt beïnvloed door het umask.

mkfs
mkfs-opt
mkfs fstype apparaat [blokgrootte:N] [kenmerken:..] [inode:N] [sectorgrootte:N] [label:..]

Deze functie creëert een bestandssysteem op "apparaat". Het bestandssysteemtype is "fstype", voor
voorbeeld "ext3".

De optionele argumenten zijn:

"blokgrootte"
De blokgrootte van het bestandssysteem. Ondersteunde blokgroottes zijn afhankelijk van het bestandssysteemtype, maar
doorgaans zijn dit 1024, 2048 of 4096 voor Linux ext2/3 bestandssystemen.

Voor VFAT en NTFS wordt de parameter "blocksize" behandeld als de gevraagde clustergrootte.

Voor UFS-blokformaten, zie mkfs.ufs(8).

"Kenmerken"
Deze passeert de -O parameter naar het externe mkfs-programma.

Voor bepaalde bestandssysteemtypen kunnen hierdoor extra bestandssysteemfuncties worden geselecteerd.
Bekijk mke2fs(8) en mkfs.ufs(8) voor meer details.

U kunt deze optionele parameter niet gebruiken met het bestandssysteemtype "gfs" of "gfs2".

"inode"
Deze passeert de -I parameter naar buiten mke2fs(8) programma dat de inode instelt
grootte (momenteel alleen voor ext2/3/4 bestandssystemen).

"sectorgrootte"
Deze passeert de -S parameter naar extern mkfs.ufs(8) programma, dat de sectorgrootte bepaalt
voor ufs-bestandssysteem.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mkfs-b
mkfs-b fstype blokgrootte-apparaat

Deze aanroep is vergelijkbaar met "mkfs", maar u kunt hiermee de blokgrootte van het
resulterende bestandssysteem. Ondersteunde blokgroottes zijn afhankelijk van het type bestandssysteem, maar doorgaans
het zijn alleen 1024, 2048 of 4096.

Voor VFAT en NTFS wordt de parameter "blocksize" behandeld als de gevraagde clustergrootte.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mkfs".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mkfs-btrfs
mkfs-btrfs 'apparaten ...' [allocstart:N] [bytecount:N] [datatype:..] [bladgrootte:N] [label:..] [metadata:..] [nodesize:N] [sectorgrootte: N]

Maak een btrfs-bestandssysteem, waarmee alle configureerbare instellingen kunnen worden ingesteld. Voor meer informatie over
de optionele argumenten, zie mkfs.btrfs(8).

Omdat btrfs-bestandssystemen meerdere apparaten kunnen omspannen, is hiervoor een niet-lege lijst met apparaten nodig.

Om algemene bestandssystemen aan te maken, gebruik je "mkfs".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mklost-en-gevonden
mklost-en-gevonden mountpoint

Maak de map "lost+found", normaal gesproken in de hoofdmap van een ext2/3/4 bestandssysteem.
"mountpoint" is de map waaronder we de map "lost+found" proberen te maken.

mkmountpunt
mkmountpoint vrijgesteldpad

"mkmountpoint" en "rmmountpoint" zijn gespecialiseerde aanroepen die kunnen worden gebruikt om extra
mountpoints voordat u het eerste bestandssysteem mount.

Deze oproepen zijn Slechts noodzakelijk in een aantal zeer beperkte omstandigheden, vooral in het geval dat
u een mix van niet-gerelateerde en/of alleen-lezen bestandssystemen samen wilt mounten.

Live-cd's bevatten bijvoorbeeld vaak een "Russisch pop"-nest van bestandssystemen, een ISO-buitenkant
laag, met een squashfs-afbeelding erin, met daarin een ext2/3-afbeelding. Je kunt uitpakken
dit als volgt in guestfish:

add-ro Fedora-11-i686-Live.iso
lopen
mkmountpoint /cd
mkmountpoint /sqsh
mkmountpoint /ext3fs
mount /dev/sda/cd
mount-loop /cd/LiveOS/squashfs.img /sqsh
mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs

Het interne bestandssysteem is nu uitgepakt onder het mountpoint /ext3fs.

"mkmountpoint" is niet compatibel met "umount-all". Het is mogelijk dat u onverwachte fouten krijgt als u
probeer deze oproepen te mixen. Het is het veiligst om bestandssystemen handmatig te ontkoppelen en te verwijderen
bevestigingspunten na gebruik.

"umount-all" ontkoppelt bestandssystemen door eerst de langste paden te sorteren, zodat dit werkt
bij handmatige mountpoints moet je ervoor zorgen dat de binnenste mountpoints het langst zijn
padnamen, zoals in de voorbeeldcode hierboven.

Zie https://bugzilla.redhat.com/show_bug.cgi?id=599503 voor meer details

Autosync [zie "set-autosync", dit is standaard ingesteld op handvatten] kan ervoor zorgen dat "umount-all"
worden aangeroepen wanneer de hendel gesloten is, wat ook deze problemen kan veroorzaken.

mknoden
mknod mode devmajor devminor pad

Met deze aanroep worden speciale blok- of tekenapparaten of benoemde pijpen (FIFO's) gemaakt.

De parameter "mode" moet de modus zijn, waarbij gebruik wordt gemaakt van de standaardconstanten. "ontwikkelaarmajor" en
"devminor" zijn de grote en kleine nummers van het apparaat, die alleen worden gebruikt bij het maken van blok en
karakter speciale apparaten.

Merk op dat, net als mknoden(2), de modus moet bitsgewijze OR'd zijn met S_IFBLK, S_IFCHR,
S_IFIFO of S_IFSOCK (anders creëert deze aanroep gewoon een normaal bestand). Deze constanten
zijn beschikbaar in de standaard Linux-headerbestanden, of je kunt "mknod-b", "mknod-c" of
"mkfifo", dit zijn wrappers rond deze opdracht die bitsgewijs OF in de juiste volgorde staan
constante voor jou.

De feitelijk ingestelde modus wordt beïnvloed door het umask.

mknod-b
mknod-b mode devmajor devminor pad

Met deze aanroep wordt een blokapparaatknooppunt gemaakt met de naam "path" met modus "mode" en device
majeur/mineur "devmajor" en "devminor". Het is gewoon een handige verpakking rond "mknod".

In tegenstelling tot "mknod", "mode" Dan moet je bevatten alleen machtigingsbits.

De feitelijk ingestelde modus wordt beïnvloed door het umask.

mknod-c
mknod-c mode devmajor devminor pad

Met deze aanroep wordt een char-apparaatknooppunt gemaakt met de naam "path" met modus "mode" en device major/minor
"devmajor" en "devminor". Het is gewoon een handige verpakking rond "mknod".

In tegenstelling tot "mknod", "mode" Dan moet je bevatten alleen machtigingsbits.

De feitelijk ingestelde modus wordt beïnvloed door het umask.

mkswap
mkswap-opts
mkswap-apparaat [label:..] [uuid:..]

Maak een Linux-swappartitie op "apparaat".

Met de optieargumenten "label" en "uuid" kunt u het label en/of de UUID van het nieuwe bestand instellen
partitie wisselen.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mkswap-L
mkswap-L labelapparaat

Maak een swappartitie op "device" met het label "label".

Houd er rekening mee dat u geen wissellabel aan een blokapparaat (bijv. / Dev / sda), gewoon naar een
partitie. Dit lijkt een beperking te zijn van de kernel- of swaptools.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mkswap".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mkswap-U
mkswap-U uuid-apparaat

Maak een swappartitie op "device" met UUID "uuid".

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "mkswap".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

mkswap-bestand
mkswap-bestandspad

Maak een wisselbestand.

Met deze opdracht wordt alleen een handtekening voor een wisselbestand naar een bestaand bestand geschreven. Om het bestand te maken
zelf, gebruik dan iets als "fallocate".

mktemp
mktemp tmpl [achtervoegsel:..]

Met deze opdracht wordt een tijdelijk bestand gemaakt. De parameter "tmpl" moet een volledige padnaam zijn
de tijdelijke mapnaam, waarbij de laatste zes tekens "XXXXXX" zijn.

Bijvoorbeeld: "/tmp/myprogXXXXXX" of "/Temp/myprogXXXXXX", waarbij de tweede geschikt is
voor Windows-bestandssystemen.

De naam van het tijdelijke bestand dat is gemaakt, wordt geretourneerd.

Het tijdelijke bestand is gemaakt met modus 0600 en is eigendom van root.

De beller is verantwoordelijk voor het verwijderen van het tijdelijke bestand na gebruik.

Als de optionele parameter "suffix" wordt opgegeven, wordt het achtervoegsel (bijv. ".txt") toegevoegd aan
de tijdelijke naam.

Zie ook: "mkdtemp".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

modprobe
modprobe modulenaam

Hierdoor wordt een kernelmodule in het apparaat geladen.

monteren
monteerbaar montagepunt monteren

Mount een gastschijf op een positie in het bestandssysteem. Blokapparaten krijgen een naam / Dev / sda,
/ Dev / sdb enzovoort, zoals ze aan de gast zijn toegevoegd. Als deze blokapparaten bevatten
partities, zullen ze de gebruikelijke namen hebben (bijv. / Dev / sda1). Ook LVM /dev/VG/LV-Stijl
namen kunnen worden gebruikt, of 'mountable' strings die worden geretourneerd door "list-filesystems" of "inspect-get-
bevestigingspunten".

De regels zijn hetzelfde als voor monteren(2): Er moet eerst een bestandssysteem op worden aangekoppeld / vaardigheden
andere kunnen worden gemonteerd. Andere bestandssystemen kunnen alleen worden aangekoppeld op mappen die al
bestaan.

Het aangekoppelde bestandssysteem is beschrijfbaar, als we voldoende machtigingen hebben voor het onderliggende bestandssysteem
stuurt.

Vóór libguestfs 1.13.16 voegde deze aanroep impliciet de opties "sync" en "noatime" toe.
De optie "synchroniseren" vertraagde het schrijven aanzienlijk en veroorzaakte veel problemen voor gebruikers. Als jouw
programma moet mogelijk werken met oudere versies van libguestfs, gebruik in plaats daarvan "mount-options".
(gebruik een lege string voor de eerste parameter als u geen opties wilt).

berg-9p
mount-9p mounttag mountpoint [opties:..]

Mount het virtio-9p bestandssysteem met de tag "mounttag" in de map "mountpoint".

Indien nodig wordt "trans=virtio" automatisch aan de opties toegevoegd. Eventuele andere opties
vereist kan worden doorgegeven in de optionele parameter "options".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mount-lokaal
mount-local localmountpoint [alleen-lezen:true|false] [opties:..] [cachetimeout:N] [debugcalls:true|false]

Deze aanroep exporteert het voor libguestfs toegankelijke bestandssysteem naar een lokaal koppelpunt (map)
genaamd "localmountpoint". Normaal leest en schrijft naar bestanden en mappen onder
"localmountpoint" worden omgeleid via libguestfs.

Als de optionele vlag "alleen-lezen" is ingesteld op waar, wordt er naar de retourfout van het bestandssysteem geschreven
"EROFS".

"opties" is een door komma's gescheiden lijst met koppelopties. Zien gastberg(1) voor wat nuttigs
opties.

"cachetimeout" stelt de time-out (in seconden) in voor in de cache opgeslagen directory-items. De standaardwaarde is
60 seconden. Zien gastberg(1) voor meer informatie.

Als "debugcalls" is ingesteld op true, wordt er aanvullende foutopsporingsinformatie gegenereerd
elke FUSE-oproep.

Wanneer "mount-local" terugkeert, is het bestandssysteem gereed, maar verwerkt het geen verzoeken
(de toegang daartoe wordt geblokkeerd). Je moet "mount-local-run" aanroepen om de hoofdlus uit te voeren.

Zie "MOUNT LOKAAL" in gastfs(3) voor volledige documentatie.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

mount-local-run
mount-local-run

Voer de hoofdlus uit die kernelaanroepen vertaalt naar libguestfs-aanroepen.

Dit zou alleen moeten worden aangeroepen nadat "mount-local" succesvol is geretourneerd. De oproep zal dat niet doen
return totdat het bestandssysteem is ontkoppeld.

Note je moet niet voer gelijktijdige libguestfs-aanroepen uit op dezelfde handle vanuit een andere thread.

Je kunt dit vanuit een andere thread aanroepen dan degene die "mount-local" noemt, onderwerp
aan de gebruikelijke regels voor threads en libguestfs (zie "MEERDERE HANDLES EN MEERDERE THREADS"
in gastfs(3)).

Zie "MOUNT LOKAAL" in gastfs(3) voor volledige documentatie.

mount-lus
mount-loop bestand mountpoint

Met dit commando kun je mounten filet (een bestandssysteemafbeelding in een bestand) op een koppelpunt. Het is
volledig gelijk aan het commando "mount -o loop file mountpoint".

montage-opties
mount-opties opties monteerbaar mountpoint

Dit is hetzelfde als het commando "mount", maar u kunt hiermee de mount-opties instellen zoals hiervoor
the monteren(8) -o vlag.

Als de parameter "options" een lege tekenreeks is, worden er geen opties doorgegeven (alle opties
standaard ingesteld op wat het bestandssysteem gebruikt).

berg-ro
mount-ro monteerbaar montagepunt

Dit is hetzelfde als het commando "mount", maar het koppelt het bestandssysteem aan met alleen-lezen
(-o ro) vlag.

berg-vfs
mount-vfs opties vfstype monteerbaar mountpunt

Dit is hetzelfde als het commando "mount", maar u kunt hiermee beide mount-opties instellen
en het vfstype zoals voor de monteren(8) -o en -t vlaggen.

bevestigingspunten
bevestigingspunten

Deze oproep is vergelijkbaar met "mounts". Die oproep retourneert een lijst met apparaten. Deze keert terug
een hashtabel (kaart) van de apparaatnaam naar de map waar het apparaat is gekoppeld.

mounts
mounts

Dit retourneert de lijst met momenteel aangekoppelde bestandssystemen. Het retourneert de lijst met apparaten
(Bv. / Dev / sda1, /dev/VG/LV).

Sommige interne steunen zijn niet afgebeeld.

Zie ook: "aankoppelpunten"

mv
mv src bestem

Dit verplaatst een bestand van "src" naar "dest" waarbij "dest" een doelbestandsnaam is of
doelmap.

Zie ook: "hernoemen".

nr-apparaten
nr-apparaten

Dit retourneert het aantal toegevoegde blokapparaten. Dit is hetzelfde als de
aantal apparaten dat zou worden geretourneerd als u "list-devices" aanroept.

Als u wilt weten hoeveel apparaten er maximaal kunnen worden toegevoegd, roept u "max-disks" op.

ntfs-3g-probe
ntfs-3g-probe waar|onwaar apparaat

Deze opdracht voert de . uit ntfs-3g.sonde(8) opdracht die een NTFS-"apparaat" onderzoekt
monteerbaarheid. (Niet alle NTFS-volumes kunnen lezen en schrijven worden aangekoppeld, en sommige kunnen niet worden aangekoppeld
helemaal).

"rw" is een Booleaanse vlag. Stel dit in op true als u wilt testen of het volume kan worden gekoppeld
lezen schrijven. Stel dit in op false als u wilt testen of het volume alleen-lezen kan worden geactiveerd.

De retourwaarde is een geheel getal dat 0 is als de bewerking zou slagen, of iets anders dan nul
waarde gedocumenteerd in de ntfs-3g.sonde(8) handleiding pagina.

ntfsclone-in
ntfsclone-in (back-upbestand|-) apparaat

Herstel het "back-upbestand" (van een eerdere aanroep naar "ntfsclone-out") naar "device",
bestaande inhoud van dit apparaat overschrijven.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

ntfsclone-uit
ntfsclone-out-apparaat (back-upbestand|-) [alleen metadata:true|false] [rescue:true|false] [ignorefscheck:true|false] [preservetimestamps:true|false] [force:true|false]

Stream het NTFS-bestandssysteem "apparaat" naar het lokale bestand "backupfile". Het formaat dat wordt gebruikt
het back-upbestand is een speciaal formaat dat wordt gebruikt door de ntfsclone(8) gereedschap.

Als de optionele vlag 'metadataonly' waar is, dan Slechts de metagegevens worden opgeslagen, waardoor alles verloren gaat
de gebruikersgegevens (dit is handig voor het diagnosticeren van bepaalde bestandssysteemproblemen).

De optionele vlaggen "rescue", "ignorefscheck", "preservetimestamps" en "force" zijn
precieze betekenissen gedetailleerd in de ntfsclone(8) man-pagina.

Gebruik "ntfsclone-in" om het bestand terug te zetten naar een libguestfs-apparaat.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

ntfsfix
ntfsfix-apparaat [clearbadsectors:true|false]

Deze opdracht repareert enkele fundamentele NTFS-inconsistenties, reset het NTFS-journaalbestand,
en plant een NTFS-consistentiecontrole voor de eerste keer dat Windows wordt opgestart.

Dit is niet een equivalent van Windows "chkdsk". Het doet niet scan het bestandssysteem op
inconsistenties.

De optionele vlag "clearbadsectors" wist de lijst met slechte sectoren. Dit is handig achteraf
een schijf met slechte sectoren klonen naar een nieuwe schijf.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

ntfsgrootte
ntfsresize-opts
ntfsresize-apparaat [grootte:N] [force:true|false]

Met deze opdracht wordt de grootte van een NTFS-bestandssysteem gewijzigd, waardoor het wordt uitgebreid of verkleind tot de grootte van het
onderliggend apparaat.

De optionele parameters zijn:

"grootte"
De nieuwe grootte (in bytes) van het bestandssysteem. Als u dit weglaat, wordt de grootte van het bestandssysteem gewijzigd in
plaats de container (bijv. scheidingswand).

"dwingen"
Als deze optie waar is, forceer dan het wijzigen van de grootte van het bestandssysteem, zelfs als het bestandssysteem
is gemarkeerd omdat een consistentiecontrole vereist is.

Na de bewerking voor het wijzigen van de grootte wordt het bestandssysteem altijd gemarkeerd als consistentie vereisend
controleren (voor de veiligheid). U moet Windows opstarten om deze controle uit te voeren en te wissen
deze voorwaarde. als jij niet zet u de optie "forceren" dan is het niet mogelijk om te bellen
"ntfsresize" meerdere keren op een enkel bestandssysteem zonder Windows op te starten
tussen elke formaatwijziging.

Zie ook ntfsgrootte(8).

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

ntfsresize-grootte
ntfsresize-size apparaatgrootte

Deze opdracht is hetzelfde als "ntfsresize", behalve dat u hiermee de nieuwe grootte kunt opgeven
(in bytes) expliciet.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "ntfsresize".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

parse-omgeving
parse-omgeving

Parseer de omgeving van het programma en stel dienovereenkomstig vlaggen in de handle in. Bijvoorbeeld als
"LIBGUESTFS_DEBUG=1" dan wordt de vlag 'verbose' in de handle gezet.

De meeste programma's do niet genoodzaakt bent naar Bellen dit. Het gebeurt impliciet wanneer u "create" aanroept.

Zie "OMGEVINGVARIABELEN" in gastfs(3) voor een lijst met omgevingsvariabelen die dat wel kunnen
invloed hebben op libguestfs-handvatten. Zie ook "guestfs_create_flags" in gastfs(3), en "parse-
milieu-lijst".

parse-omgevingslijst
parse-omgeving-lijst 'omgeving ...'

Parseer de lijst met tekenreeksen in het argument "omgeving" en stel vlaggen in de handle in
overeenkomstig. Als "LIBGUESTFS_DEBUG=1" bijvoorbeeld een tekenreeks in de lijst is, dan wordt de
'verbose' vlag staat in het handvat.

Dit is hetzelfde als "parse-environment", behalve dat het een expliciete lijst met tekenreeksen parseert
in plaats van de omgeving van het programma.

gedeeltelijk toevoegen
onderdeel toevoegen apparaat prlogex startect endect

Met deze opdracht wordt een partitie toegevoegd aan "apparaat". Als er geen partitietabel op het apparaat aanwezig is,
roep eerst "part-init" aan.

De parameter "prlogex" is het type partitie. Normaal gesproken moet u "p" of
"primair" hier, maar MBR-partitietabellen ondersteunen ook "l" (of "logisch") en "e" (of
"uitgebreide") partitietypen.

"startsect" en "endsect" zijn het begin en einde van de partitie in sectoren. "eindsectie"
kan negatief zijn, wat betekent dat het terugtelt vanaf het einde van de schijf ("-1" is de
laatste sector).

Het maken van een partitie die de hele schijf bestrijkt, is niet zo eenvoudig. Gebruik "part-disk" om dit te doen
dat.

deel-del
onderdeel-del apparaat onderdeelnummer

Met deze opdracht wordt de partitie met het nummer "partnum" op "device" verwijderd.

Houd er rekening mee dat in het geval van MBR-partitionering het verwijderen van een uitgebreide partitie ook alle partities verwijdert
logische partities die het bevat.

deel-schijf
part-schijf apparaat onderdeeltype

Deze opdracht is eenvoudigweg een combinatie van "part-init" gevolgd door "part-add" om een
één primaire partitie die de hele schijf bestrijkt.

"parttype" is het type partitietabel, meestal "mbr" of "gpt", maar andere mogelijke waarden
worden beschreven in "part-init".

deel-get-bootable
part-get-bootable device partnum

Deze opdracht retourneert true als de partitie "partnum" op "device" de opstartbare vlag heeft
in te stellen.

Zie ook "part-set-bootable".

part-get-gpt-gui
part-get-gpt-guid device onderdeelnummer

Retourneer de GUID van de genummerde GPT-partitie "partnum".

deel-get-gpt-type
part-get-gpt-type apparaat artikelnummer

Retourneer het type GUID van de genummerde GPT-partitie "partnum". Voor MBR-partities retourneert u een
juiste GUID die overeenkomt met het MBR-type. Gedrag is niet gedefinieerd voor andere partities
types.

deel-get-mbr-id
part-get-mbr-id device partnum

Retourneert de byte van het MBR-type (ook bekend als de ID-byte) van de genummerde partitie
"partum".

Merk op dat alleen MBR-partities (oude DOS-stijl) typebytes hebben. Je krijgt een ongedefinieerd karakter
resultaten voor andere partitietabeltypen (zie "part-get-parttype").

part-get-mbr-part-type
part-get-mbr-part-type device partnum

Dit retourneert het partitietype van een MBR-partitie met het nummer "partnum" op apparaat "device".

Het retourneert 'primair', 'logisch' of 'uitgebreid'.

deel-krijg-naam
onderdeel-get-naam apparaat onderdeelnummer

Hiermee wordt de partitienaam opgehaald op partitie met het nummer "partnum" op apparaat "device". Opmerking
dat partities genummerd zijn vanaf 1.

De partitienaam kan alleen worden gelezen in bepaalde typen partitietabellen. Dit werkt door
"gpt" maar niet op "mbr"-partities.

deel-krijg-deeltype
part-get-parttype-apparaat

Deze opdracht onderzoekt de partitietabel op "device" en retourneert het type partitietabel
(formaat) wordt gebruikt.

Veel voorkomende retourwaarden zijn: "msdos" (een MBR-partitietabel in DOS/Windows-stijl), "gpt" (een
Partitietabel in GPT/EFI-stijl). Andere waarden zijn mogelijk, hoewel ongebruikelijk. Zie "deel-
init" voor een volledige lijst.

deel-init
part-init apparaat onderdeeltype

Hierdoor wordt een lege partitietabel gemaakt op "apparaat" van een van de genoemde partitietypen
onderstaand. Normaal gesproken zou "parttype" ofwel "msdos" of "gpt" moeten zijn (voor grote schijven).

Aanvankelijk zijn er geen partities. Hierna moet u voor elk "part-add" aanroepen
partitie vereist.

Mogelijke waarden voor "parttype" zijn:

efi
gpt Intel EFI / GPT-partitietabel.

Dit wordt aanbevolen voor partities van >= 2 TB die toegankelijk zijn vanuit Linux en Intel-
gebaseerd op Mac OS X. Het heeft ook een beperkte achterwaartse compatibiliteit met het "mbr" -formaat.

mbr
msdos
Het standaard pc-"Master Boot Record" (MBR)-formaat dat wordt gebruikt door MS-DOS en Windows. Dit
partitietype wel Slechts werken voor apparaatformaten tot 2 TB. Voor grote schijven wij
raden aan om "gpt" te gebruiken.

Andere typen partitietabellen die mogelijk werken, maar niet worden ondersteund, zijn onder meer:

aix AIX-schijflabels.

amiga
RDB Amiga "Rigid Disk Block"-formaat.

bsd BSD-schijflabels.

DASD
DASD, gebruikt op IBM-mainframes.

dvh MIPS/SGI-volumes.

Mac Oud Mac-partitieformaat. Moderne Macs gebruiken "gpt".

pc98
NEC PC-98-formaat, blijkbaar gebruikelijk in Japan.

zon Zonneschijflabels.

onderdelen lijst
onderdeellijst apparaat

Met deze opdracht wordt de partitietabel op "device" geparseerd en wordt de lijst met partities geretourneerd
gevonden.

De velden in de geretourneerde structuur zijn:

deel_nummer
Partitienummer, tellend vanaf 1.

deel_start
Begin van de partitie in bytes. Om sectoren te krijgen moet je delen door die van het apparaat
sectorgrootte, zie "blockdev-getss".

deel_einde
Einde van de partitie in bytes.

onderdeelgrootte
Grootte van de partitie in bytes.

gedeeltelijk ingesteld-opstartbaar
part-set-opstartbaar apparaat partnum true|false

Hiermee wordt de opstartbare vlag ingesteld op partitie met het nummer "partnum" op apparaat "device". Let daar op
partities zijn genummerd vanaf 1.

De opstartvlag wordt door sommige besturingssystemen (met name Windows) gebruikt om te bepalen welke
partitie waarvandaan moet worden opgestart. Het wordt geenszins universeel erkend.

deel-set-gpt-guid
part-set-gpt-guid apparaat partnum guid

Stel de GUID van de genummerde GPT-partitie "partnum" in op "guid". Geeft een foutmelding als de
partitietabel van "device" is geen GPT, of als "guid" geen geldige GUID is.

deel-set-gpt-type
part-set-gpt-type apparaat partnum guid

Stel het type GUID van de genummerde GPT-partitie "partnum" in op "guid". Geeft een foutmelding als de
partitietabel van "device" is geen GPT, of als "guid" geen geldige GUID is.

Bekijk http://en.wikipedia.org/wiki/GUID_Partition_Table#Partition_type_GUIDs voor een nuttig
lijst met type-GUID's.

deel-set-mbr-id
part-set-mbr-id device partnum idbyte

Stelt de byte van het MBR-type (ook bekend als de ID-byte) van de genummerde partitie "partnum" in
"idbyte". Merk op dat de typebytes die in de meeste documentatie worden aangehaald in feite hexadecimaal zijn
cijfers, maar meestal gedocumenteerd zonder voorafgaande "0x", wat verwarrend kan zijn.

Merk op dat alleen MBR-partities (oude DOS-stijl) typebytes hebben. Je krijgt een ongedefinieerd karakter
resultaten voor andere partitietabeltypen (zie "part-get-parttype").

deelsetnaam
part-set-name apparaat partnumnaam

Hiermee wordt de partitienaam ingesteld op partitie met het nummer "partnum" op apparaat "device". Opmerking
dat partities genummerd zijn vanaf 1.

De partitienaam kan alleen worden ingesteld voor bepaalde typen partitietabellen. Dit werkt door
"gpt" maar niet op "mbr"-partities.

deel-naar-ontwikkelen
part-to-dev-partitie

Deze functie neemt een partitienaam (bijv. "/dev/sdb1") en verwijdert het partitienummer,
retourneert de apparaatnaam (bijv. "/dev/sdb").

De benoemde partitie moet bestaan, bijvoorbeeld als een tekenreeks die wordt geretourneerd door "list-partitions".

Zie ook "part-to-partnum", "device-index".

part-to-partnummer
partitie van part naar partnum

Deze functie neemt een partitienaam (bijv. "/dev/sdb1") en retourneert het partitienummer
(bijv. 1).

De benoemde partitie moet bestaan, bijvoorbeeld als een tekenreeks die wordt geretourneerd door "list-partitions".

Zie ook "part-to-dev".

ping-daemon
ping-daemon

Dit is een testprobe in de guestfs-daemon die in het libguestfs-apparaat draait.
Door deze functie aan te roepen, wordt gecontroleerd of de daemon op het ping-bericht reageert, zonder dat dit het geval is
de daemon of de aangesloten blokapparaten op enige andere manier beïnvloeden.

voorlezen
offset voor padtelling

Met deze opdracht kunt u een deel van een bestand lezen. Het leest "count" bytes van het bestand, beginnend
bij "offset", uit bestand "pad".

Hierdoor worden mogelijk minder bytes gelezen dan gevraagd. Voor verdere details zie de voorlezen(2) systeem
noemen.

Zie ook "pwrite", "preread-device".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

pre-apparaat
offset van het aantal apparaten vóór het apparaat

Met deze opdracht kunt u een deel van een blokapparaat lezen. Het leest "aantal" bytes van "apparaat",
beginnend bij "compensatie".

Hierdoor worden mogelijk minder bytes gelezen dan gevraagd. Voor verdere details zie de voorlezen(2) systeem
noemen.

Zie ook "voorlezen".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

pvchange-uid
pvchange-uuid-apparaat

Genereer een nieuwe willekeurige UUID voor het fysieke volume "apparaat".

pvchange-uuid-all
pvchange-uuid-all

Genereer nieuwe willekeurige UUID's voor alle fysieke volumes.

PVC creëren
pvcreate-apparaat

Hierdoor wordt een fysiek LVM-volume gemaakt op het genoemde "apparaat", waar "apparaat" normaal gesproken zou moeten staan
een partitienaam zijn, zoals / Dev / sda1.

pvreverplaatsen
pvremove-apparaat

Hiermee wordt een fysiek volumeapparaat gewist, zodat LVM het niet langer zal herkennen.

De implementatie gebruikt de opdracht "pvremove", die weigert fysieke volumes te wissen
bevatten volumegroepen, dus u moet deze eerst verwijderen.

grootte
pvresize-apparaat

Hiermee wordt het formaat van een bestaand fysiek LVM-volume aangepast (breidt of verkleint) zodat het overeenkomt met de nieuwe grootte
het onderliggende apparaat.

pvresize-grootte
pvresize-size apparaatgrootte

Deze opdracht is hetzelfde als "pvresize", behalve dat u hiermee de nieuwe grootte kunt opgeven
(in bytes) expliciet.

pv
pv

Maak een lijst van alle gedetecteerde fysieke volumes. Dit is het equivalent van de pv(8) opdracht.

Dit retourneert een lijst met alleen de apparaatnamen die PV's bevatten (bijv. / Dev / sda2).

Zie ook "pvs-vol".

pvs-vol
pvs-vol

Maak een lijst van alle gedetecteerde fysieke volumes. Dit is het equivalent van de pv(8) opdracht.
De "volledige" versie bevat alle velden.

pvuuid
pvuuid apparaat

Deze opdracht retourneert de UUID van het LVM PV "apparaat".

schrijf
pwrite pad inhoud offset

Met deze opdracht wordt naar een deel van een bestand geschreven. Het schrijft de gegevensbuffer "inhoud" naar het bestand
"pad" beginnend bij offset "offset".

Deze opdracht implementeert de schrijf(2) systeemaanroep, en net als bij die systeemaanroep is dit misschien niet het geval
schrijf de volledige gevraagde gegevens. De retourwaarde is het aantal bytes dat daadwerkelijk was
naar het bestand geschreven. Dit zou zelfs 0 kunnen zijn, hoewel korte schrijfbewerkingen voor regulier onwaarschijnlijk zijn
bestanden in gewone omstandigheden.

Zie ook "pread", "pwrite-device".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

pwrite-apparaat
pwrite-device apparaatinhoud gecompenseerd

Met deze opdracht wordt naar een deel van een apparaat geschreven. Het schrijft de databuffer "inhoud" naar "apparaat"
beginnend bij offset "offset".

Deze opdracht implementeert de schrijf(2) systeemaanroep, en net als bij die systeemaanroep is dit misschien niet het geval
schrijf de volledige gevraagde gegevens (hoewel korte schrijfbewerkingen naar schijfapparaten en partities dat wel zijn).
waarschijnlijk onmogelijk met standaard Linux-kernels).

Zie ook "pschrijven".

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

lees-bestand
leesbestand pad

Deze oproep retourneert de inhoud van het bestand "pad" als buffer.

In tegenstelling tot "cat" kan deze functie bestanden correct verwerken die ingebedde ASCII NUL bevatten
tekens.

leesregels
leesregels pad

Retourneer de inhoud van het bestand met de naam "pad".

De bestandsinhoud wordt geretourneerd als een lijst met regels. Achteraan het teken "LF" en "CRLF".
sequenties zijn niet teruggekeerd.

Houd er rekening mee dat deze functie binaire bestanden (met name files
met het teken "\0" dat wordt behandeld als het einde van de tekenreeks). Voor degenen die je moet gebruiken
de "read-file" -functie en splits de buffer zelf in regels.

leesmap
leesmap richt

Dit retourneert de lijst met directory-items in directory "dir".

Alle vermeldingen in de directory worden geretourneerd, inclusief "." En "..". De inzendingen zijn niet
gesorteerd, maar geretourneerd in dezelfde volgorde als het onderliggende bestandssysteem.

Ook retourneert deze aanroep basisinformatie over het bestandstype over elk bestand. Het veld "ftyp" zal dat wel doen
een van de volgende tekens bevatten:

'b' Blok speciaal

'c' Char speciaal

'd'-map

'f' FIFO (genaamd pijp)

'l' Symbolische link

'r' Normaal bestand

's'-aansluiting

'u' Onbekend bestandstype

'?' De leesmap(3) call retourneerde een veld "d_type" met een onverwachte waarde

Deze functie is voornamelijk bedoeld voor gebruik door programma's. Om een ​​eenvoudige lijst met namen te krijgen,
gebruik "ls". Gebruik "ll" om een ​​afdrukbare map voor menselijke consumptie te krijgen.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

leeslink
leeslink-pad

Deze opdracht leest het doel van een symbolische link.

leeslinklijst
readlinklist pad 'namen ...'

Met deze aanroep kunt u een "readlink"-bewerking uitvoeren op meerdere bestanden, waar alle bestanden zich bevinden
in de map "pad". "names" is de lijst met bestanden uit deze map.

Bij terugkomst krijg je een lijst met strings, met een één-op-één correspondentie met de lijst "namen".
Elke string is de waarde van de symbolische link.

Indien de leeslink(2) de bewerking mislukt op elke naam, dan is de bijbehorende resultaatreeks
de lege tekenreeks "". De hele operatie is echter voltooid, zelfs als dat zo was
leeslink(2) fouten, en dus kun je deze functie aanroepen met namen waarvan je niet weet of
het zijn al symbolische links (zij het iets minder efficiënt).

Deze aanroep is bedoeld voor programma's die de inhoud van een map efficiënt willen weergeven
zonder veel heen- en terugreizen te maken.

echt pad
realpath-pad

Retourneert de gecanoniseerde absolute padnaam van "path". Het geretourneerde pad bevat geen ".", ".."
of symbolische linkpadelementen.

opnieuw monteren
koppelpunt opnieuw koppelen [rw:true|false]

Met deze aanroep kunt u de vlag "rw" (alleen-lezen/lezen-schrijven) wijzigen op een reeds aangekoppeld bestand
bestandssysteem op "mountpoint", waarbij een alleen-lezen bestandssysteem wordt geconverteerd naar lezen-schrijven, of omgekeerd
omgekeerd.

Houd er rekening mee dat u momenteel de "optionele" parameter "rw" moet opgeven. In de toekomst misschien wel
toestaan ​​dat andere vlaggen worden aangepast.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

verwijder-schijf
verwijder schijflabel

Deze functie is conceptueel het tegenovergestelde van "add-drive-opts". Het verwijdert de schijf die
was eerder toegevoegd met het label "label".

Houd er rekening mee dat u, om schijven te verwijderen, deze met labels moet toevoegen (zie het optionele
"label"-argument naar "add-drive-opts"). Als je geen label hebt gebruikt, kan dat niet zo zijn
verwijderd.

U kunt deze functie oproepen voor of na het lanceren van de handgreep. Als u na de lancering wordt gebeld,
als de backend dit ondersteunt, proberen we de schijf los te koppelen: zie "HOTPLUGGING" in
gastfs(3). De schijf Dan moet je niet in gebruik zijn (bijv. gemonteerd) wanneer u dit doet. Wij proberen te detecteren
als de schijf in gebruik is en u ervan weerhoudt dit te doen.

verwijderxattr
verwijderxattr xattr pad

Deze aanroep verwijdert het uitgebreide attribuut genaamd "xattr" van het bestand "path".

Zie ook: "lremovexattr", attr(5).

andere naam geven
hernoem oudpad nieuwpad

Hernoem een ​​bestand naar een nieuwe plaats op hetzelfde bestandssysteem. Dit is hetzelfde als Linux
andere naam geven(2) systeemoproep. In de meeste gevallen kunt u beter "mv" gebruiken.

formaat wijzigen2fs
resize2fs-apparaat

Hiermee wordt de grootte van een ext2-, ext3- of ext4-bestandssysteem aangepast aan de grootte van het onderliggende apparaat.

Zie ook "RESIZE2FS-FOUTEN" in gastfs(3).

formaat wijzigen2fs-M
resize2fs-M-apparaat

Dit commando is hetzelfde als "resize2fs", maar het bestandssysteem wordt verkleind tot het minimum
maat. Dit werkt als de -M optie toe aan de opdracht "resize2fs".

Om de resulterende grootte van het bestandssysteem te krijgen, moet u "tune2fs-l" aanroepen en het
Waarden voor 'Blokgrootte' en 'Aantal blokken'. Deze twee getallen, met elkaar vermenigvuldigd, geven de
resulterende grootte van het minimale bestandssysteem in bytes.

Zie ook "RESIZE2FS-FOUTEN" in gastfs(3).

resize2fs-formaat
resize2fs-size apparaatgrootte

Deze opdracht is hetzelfde als "resize2fs", behalve dat u hiermee de nieuwe grootte kunt opgeven
(in bytes) expliciet.

Zie ook "RESIZE2FS-FOUTEN" in gastfs(3).

rm
rm pad

Verwijder het enkele bestand "pad".

rm-f
rm-f-pad

Verwijder het bestand "pad".

Als het bestand niet bestaat, wordt die fout genegeerd. (Andere fouten, bijv. I/O-fouten of slecht
paden, worden niet genegeerd)

Met deze oproep kunnen geen mappen worden verwijderd. Gebruik "rmdir" om een ​​lege map te verwijderen, of "rm-rf"
om mappen recursief te verwijderen.

rm-rf
rm-rf-pad

Verwijder het bestand of de map "pad", waarbij de inhoud recursief wordt verwijderd als het een map is.
Dit lijkt op het shell-commando "rm -rf".

rmdir
rmdir-pad

Verwijder het "pad" van de enkele map.

rmmontagepunt
rmmountpoint vrijgesteldpad

Met deze aanroep wordt een mountpoint verwijderd dat eerder is gemaakt met "mkmountpoint". Zien
"mkmountpoint" voor volledige details.

rsync
rsync src dest [archief:true|false] [verwijderdste:true|false]

Deze aanroep kan worden gebruikt om twee mappen onder dezelfde libguestfs te kopiëren of te synchroniseren
hendel. Hierbij wordt gebruik gemaakt van de rsync(1) programma dat een snel algoritme gebruikt dat kopiëren vermijdt
bestanden onnodig.

"src" en "dest" zijn de bron- en doelmappen. Bestanden worden gekopieerd van "src"
naar "dest".

De optionele argumenten zijn:

"archief"
Schakelt de archiefmodus in. Dit is hetzelfde als het passeren van de --archief vlag naar "rsync".

"de meest verwijderde"
Verwijder bestanden op de bestemming die niet bestaan ​​op de bron.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

rsync-in
rsync-in externe bestemming [archief:true|false] [deletedest:true|false]

Deze oproep kan worden gebruikt om het bestandssysteem op de host of op afstand te kopiëren of te synchroniseren
computer met het bestandssysteem binnen libguestfs. Hierbij wordt gebruik gemaakt van de rsync(1) programma dat gebruikt
een snel algoritme dat voorkomt dat bestanden onnodig worden gekopieerd.

Deze oproep werkt alleen als het netwerk is ingeschakeld. Zie "set-netwerk" of de --netwerk optie
naar verschillende tools zoals gastvis(1).

Bestanden worden gekopieerd van de externe server en map gespecificeerd door "remote" naar de
doelmap "dest".

Het formaat van de externe serverreeks wordt gedefinieerd door rsync(1). Houd er rekening mee dat er geen manier is
om een ​​wachtwoord of wachtwoordzin op te geven, zodat het doel zo moet worden ingesteld dat er geen vereist is.

De optionele argumenten zijn dezelfde als die van "rsync".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

rsync-uit
rsync-out src op afstand [archief:true|false] [deletedest:true|false]

Deze aanroep kan worden gebruikt om het bestandssysteem binnen libguestfs te kopiëren of te synchroniseren met een
bestandssysteem op de host of op een externe computer. Hierbij wordt gebruik gemaakt van de rsync(1) programma dat gebruikt
een snel algoritme dat voorkomt dat bestanden onnodig worden gekopieerd.

Deze oproep werkt alleen als het netwerk is ingeschakeld. Zie "set-netwerk" of de --netwerk optie
naar verschillende tools zoals gastvis(1).

Bestanden worden gekopieerd van de bronmap "src" naar de externe server en map
gespecificeerd door "op afstand".

Het formaat van de externe serverreeks wordt gedefinieerd door rsync(1). Houd er rekening mee dat er geen manier is
om een ​​wachtwoord of wachtwoordzin op te geven, zodat het doel zo moet worden ingesteld dat er geen vereist is.

De optionele argumenten zijn dezelfde als die van "rsync".

Globbing vindt niet plaats op de parameter "src". In programma's die de API rechtstreeks gebruiken
je moet de wildcards zelf uitbreiden (zie "glob-expand"). In Guestfish kun je de
"glob"-opdracht (zie "glob"), bijvoorbeeld:

> glob rsync-out /* rsync://remote/

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

schrobapparaat
schrobapparaat

Deze opdracht schrijft patronen over "apparaat" om het ophalen van gegevens moeilijker te maken.

Het is een interface voor de schrobben(1) programma. Zie die handleidingpagina voor meer details.

scrub-bestand
scrub-bestand bestand

Deze opdracht schrijft patronen over een bestand om het ophalen van gegevens moeilijker te maken.

Het bestand is verwijderd na het schrobben.

Het is een interface voor de schrobben(1) programma. Zie die handleidingpagina voor meer details.

schrobvrije ruimte
scrub-freespace richt

Deze opdracht maakt de map "dir" aan en vult deze vervolgens met bestanden tot het bestandssysteem
is vol, en scrubt de bestanden zoals bij "scrub-file", en verwijdert ze. Het is de bedoeling om
scrub alle vrije ruimte op de partitie met "dir".

Het is een interface voor de schrobben(1) programma. Zie die handleidingpagina voor meer details.

set-toevoegen
toevoegen
set-toevoegen toevoegen

Deze functie wordt gebruikt om extra opties toe te voegen aan de kernelopdracht libguestfs-appliance
lijn.

De standaardwaarde is "NULL", tenzij dit wordt overschreven door de "LIBGUESTFS_APPEND"-omgeving in te stellen
variabel.

Het instellen van "toevoegen" op "NULL" betekent: geen aanvullende opties worden doorgegeven (libguestfs voegt altijd toe
een paar van zijn eigen).

set-attach-methode
bijlage-methode
set-attach-methode backend

Stel de methode in die libguestfs gebruikt om verbinding te maken met de backend guestfsd-daemon.

Zie "ACHTERUIT" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "set-backend"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

set-autosync
automatisch synchroniseren
set-autosync waar|onwaar

Als "autosync" waar is, wordt autosync ingeschakeld. Libguestfs zal zijn uiterste best doen
om bestandssystemen consistent en gesynchroniseerd te maken wanneer de handle gesloten is (ook als de
programma wordt afgesloten zonder de hendels te sluiten).

Dit is standaard ingeschakeld (sinds libguestfs 1.5.24 werd dit voorheen uitgeschakeld door
standaard).

set-backend
backend
set-backend-backend

Stel de methode in die libguestfs gebruikt om verbinding te maken met de backend guestfsd-daemon.

Deze handle-eigenschap werd voorheen de "attach-methode" genoemd.

Zie "ACHTERUIT" in gastfs(3).

set-backend-instelling
set-backend-setting naam val

Voeg "name=value" toe aan de stringlijst met backend-instellingen. Maar als er al een string is
bestaat die overeenkomt met "naam" of begint met "naam=", dan wordt die instelling vervangen.

Zie "ACHTERUIT" in gastfs(3), "BACKEND-INSTELLINGEN" in gastfs(3).

set-backend-instellingen
set-backend-instellingen 'instellingen ...'

Stel een lijst in met nul of meer instellingen die worden doorgegeven aan de huidige backend. Elk
setting is een string die op een backend-specifieke manier wordt geïnterpreteerd, of genegeerd als dat niet het geval is
begrepen door de backend.

De standaardwaarde is een lege lijst, tenzij de omgevingsvariabele
'LIBGUESTFS_BACKEND_SETTINGS' is ingesteld toen de handle werd gemaakt. Deze omgeving
variabele bevat een door dubbele punten gescheiden lijst met instellingen.

Deze aanroep vervangt alle backend-instellingen. Als u een enkele backend-instelling wilt vervangen,
zie "set-backend-setting". Als u een enkele backend-instelling wilt wissen, zie "clear-
backend-instelling".

Zie "ACHTERUIT" in gastfs(3), "BACKEND-INSTELLINGEN" in gastfs(3).

set-cachedir
cachedir
set-cachedir cachedir

Stel de map in die door de handle wordt gebruikt om de cache van het apparaat op te slaan, wanneer u een supermin gebruikt
apparaat. Het apparaat wordt in de cache opgeslagen en gedeeld tussen alle ingangen die hetzelfde hebben
effectieve gebruikers-ID.

De omgevingsvariabelen "LIBGUESTFS_CACHEDIR" en "TMPDIR" bepalen de standaardwaarde: If
"LIBGUESTFS_CACHEDIR" is ingesteld, dan is dat de standaard. Anders als "TMPDIR" is ingesteld
dat is de standaard. Anders / Var / tmp is de standaard.

set-direct
directe
set-direct waar|onwaar

Als de directe toepassingsmodusvlag is ingeschakeld, worden stdin en stdout rechtstreeks doorgegeven
door naar het apparaat zodra het is gelanceerd.

Een gevolg hiervan is dat logberichten niet door de bibliotheek worden opgevangen en afgehandeld
"set-log-message-callback", maar ga direct naar stdout.

U wilt dit waarschijnlijk niet gebruiken, tenzij u weet wat u doet.

De standaardinstelling is uitgeschakeld.

set-e2attrs
set-e2attrs bestand attrs [clear:true|false]

Hiermee worden de bestandskenmerken "attrs" die aan de inode zijn gekoppeld, ingesteld of gewist filet.

"attrs" is een reeks tekens die bestandskenmerken vertegenwoordigen. Zie "get-e2attrs" voor een
lijst met mogelijke attributen. Niet alle kenmerken kunnen worden gewijzigd.

Als de optionele boolean "clear" niet aanwezig of false is, worden de genoemde "attrs" ingesteld
de inode.

Als "clear" waar is, worden de genoemde "attrs" gewist in de inode.

In beide gevallen blijven andere attributen die niet aanwezig zijn in de string "attrs" ongewijzigd.

Deze attributen zijn alleen aanwezig als het bestand zich op een ext2/3/4 bestandssysteem bevindt.
Het gebruik van deze aanroep op andere bestandssysteemtypen zal resulteren in een fout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

set-e2generatie
set-e2generation bestandsgeneratie

Hiermee stelt u de ext2-bestandsgeneratie van een bestand in.

Zie "get-e2generation".

set-e2label
set-e2label apparaatlabel

Hierdoor wordt het ext2/3/4 bestandssysteemlabel van het bestandssysteem op "device" ingesteld op "label".
Bestandssysteemlabels zijn beperkt tot 16 tekens.

U kunt "tune2fs-l" of "get-e2label" gebruiken om het bestaande label op een
bestandssysteem.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "set-label".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

set-e2uuid
set-e2uuid apparaat uuid

Hiermee wordt de ext2/3/4 bestandssysteem-UUID van het bestandssysteem op "device" ingesteld op "uuid". De
formaat van de UUID en alternatieven zoals "clear", "random" en "time" worden beschreven in
the tune2fs(8) manpagina.

U kunt "vfs-uuid" gebruiken om de bestaande UUID van een bestandssysteem terug te geven.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "set-uuid"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

set-hv
hv
set-hv hv

Stel het binaire hypervisorbestand in dat we zullen gebruiken. De hypervisor is afhankelijk van de backend, maar is dat ook
meestal de locatie van de qemu/KVM-hypervisor. Voor de uml-backend is dit de locatie
van het binaire bestand "linux" of "vmlinux".

De standaardwaarde wordt gekozen toen de bibliotheek werd gecompileerd door het configuratiescript.

U kunt dit ook overschrijven door de omgevingsvariabele "LIBGUESTFS_HV" in te stellen.

Houd er rekening mee dat u deze functie zo vroeg mogelijk na het maken van de handle moet aanroepen.
Dit komt omdat sommige pre-lanceringsbewerkingen afhankelijk zijn van het testen van qemu-functies (door het uitvoeren van
"qemu -help"). Als het binaire bestand van qemu verandert, testen we de functies niet opnieuw, en dat ziet u mogelijk ook
inconsistente resultaten. Het gebruik van de omgevingsvariabele "LIBGUESTFS_HV" is het veiligst van allemaal
omdat daarmee het qemu-binaire bestand wordt gekozen op hetzelfde moment dat de handle wordt gemaakt.

set-ID
identificatie
set-identificatiecode

Dit is een informatieve string die de beller optioneel in de handle kan zetten. Het is
op verschillende plaatsen afgedrukt, waardoor de huidige handle kan worden geïdentificeerd tijdens het debuggen
uitgang.

Een belangrijke plaats is wanneer tracering is ingeschakeld. Als de ID-tekenreeks niet leeg is
string, dan veranderen traceerberichten hiervan:

libguestfs: trace: get_tmpdir
libguestfs: trace: get_tmpdir = "/ tmp"

deze:

libguestfs: trace: ID: get_tmpdir
libguestfs: trace: ID: get_tmpdir = "/ tmp"

waarbij "ID" de identificatiereeks is die door deze aanroep is ingesteld.

De ID mag alleen alfanumerieke ASCII-tekens, onderstrepingstekens en mintekens bevatten.
De standaardwaarde is de lege tekenreeks.

Zie ook "set-programma", "set-trace", "get-identifier".

set-label
set-label monteerbaar label

Stel het bestandssysteemlabel in op "mountable" op "label".

Slechts enkele bestandssysteemtypen ondersteunen labels, en libguestfs ondersteunt alleen het instellen van labels
een subset hiervan.

ext2, ext3, ext4
Labels zijn beperkt tot 16 bytes.

NTFS
Labels zijn beperkt tot 128 Unicode-tekens.

XFS Het label is beperkt tot 12 bytes. Het bestandssysteem mag niet worden gemount wanneer u dit probeert
stel het etiket in.

btrfs
Het label is beperkt tot 255 bytes en sommige tekens zijn niet toegestaan. Het instellen van de
label op een btrfs-subvolume zal het label op het bovenliggende bestandssysteem plaatsen. De
bestandssysteem mag niet worden aangekoppeld wanneer u probeert het label in te stellen.

fat Het label is beperkt tot 11 bytes.

Als er geen ondersteuning is voor het wijzigen van het label voor het type van het opgegeven bestandssysteem,
set_label mislukt en stelt errno in als ENOTSUP.

Om het label op een bestandssysteem te lezen, roept u "vfs-label" aan.

set-libvirt-gevraagde-credential
set-libvirt-gevraagde-referentie-index cred

Nadat u de "index"-referentie van de gebruiker hebt aangevraagd, roept u deze functie aan om de
antwoord terug naar libvirt.

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

set-libvirt-ondersteunde-referenties
set-libvirt-ondersteunde-referenties 'creds ...'

Roep deze functie aan voordat u een gebeurtenishandler voor "GUESTFS_EVENT_LIBVIRT_AUTH" instelt
Geef de lijst met referentietypen op die het programma kan verwerken.

De "creds"-lijst moet een niet-lege lijst met tekenreeksen zijn. Mogelijke tekenreeksen zijn:

"gebruikersnaam"
"authnaam"
"taal"
"cnonce"
"wachtwoordzin"
"echoprompt"
"noechoprompt"
"rijk"
"extern"

Zie libvirt documentatie voor de betekenis van deze credential types.

Zie "LIBVIRT-AUTHENTICATIE" in gastfs(3) voor documentatie en voorbeeldcode.

set-memgrootte
grootte
set-memgrootte memgrootte

Hiermee wordt de geheugengrootte ingesteld in megabytes die aan de hypervisor is toegewezen. Deze heeft er maar één
effect indien aangeroepen vóór "lancering".

U kunt dit ook wijzigen door eerder de omgevingsvariabele "LIBGUESTFS_MEMSIZE" in te stellen
het handvat is gemaakt.

Voor meer informatie over de architectuur van libguestfs, zie gastfs(3).

set-netwerk
netwerk
set-netwerk true|false

Als "netwerk" waar is, is het netwerk ingeschakeld in het libguestfs-apparaat. De
standaard is onwaar.

Dit heeft invloed op de vraag of opdrachten toegang kunnen krijgen tot het netwerk (zie "OPDRACHTEN UITVOEREN" in
gastfs(3)).

U moet dit aanroepen voordat u "launch" aanroept, anders heeft het geen effect.

set-pad
pad
zoekpad met ingesteld pad

Stel het pad in dat libguestfs zoekt naar kernel en initrd.img.

De standaardwaarde is "$libdir/guestfs", tenzij dit wordt overschreven door de instelling "LIBGUESTFS_PATH"
variabele omgeving.

Door "path" in te stellen op "NULL" wordt het standaardpad hersteld.

set-pgroep
pgroep
set-pgroep waar|onwaar

Als "pgroup" waar is, worden onderliggende processen in hun eigen procesgroep geplaatst.

Het praktische gevolg hiervan is dat signalen als "SIGINT" (van gebruikers die op "^C" drukken)
wordt niet ontvangen door het kindproces.

De standaardwaarde voor deze vlag is false, omdat u normaal gesproken wilt dat "^C" het subproces beëindigt.
Guestfish stelt deze vlag in op true bij interactief gebruik, zodat "^C" langdurige
commando's netjes uitvoeren (zie "user-cancel").

set-programma
programma
vast programmaprogramma

Stel de programmanaam in. Dit is een informatieve string die het hoofdprogramma optioneel kan gebruiken
in het handvat gezet.

Wanneer de handle wordt aangemaakt, wordt de programmanaam in de handle ingesteld op de basisnaam van
"argv[0]". Als dat niet mogelijk was, wordt deze ingesteld op de lege string (maar nooit "NULL").

set-qemu
qemu
set-qemu hv

Stel het binaire hypervisorbestand (meestal qemu) in dat we zullen gebruiken.

De standaardwaarde wordt gekozen toen de bibliotheek werd gecompileerd door het configuratiescript.

U kunt dit ook overschrijven door de omgevingsvariabele "LIBGUESTFS_HV" in te stellen.

Door "hv" in te stellen op "NULL" wordt het standaard binaire bestand van qemu hersteld.

Houd er rekening mee dat u deze functie zo vroeg mogelijk na het maken van de handle moet aanroepen.
Dit komt omdat sommige pre-lanceringsbewerkingen afhankelijk zijn van het testen van qemu-functies (door het uitvoeren van
"qemu -help"). Als het binaire bestand van qemu verandert, testen we de functies niet opnieuw, en dat ziet u mogelijk ook
inconsistente resultaten. Het gebruik van de omgevingsvariabele "LIBGUESTFS_HV" is het veiligst van allemaal
omdat daarmee het qemu-binaire bestand wordt gekozen op hetzelfde moment dat de handle wordt gemaakt.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "set-hv".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

set-herstel-proc
herstel-proc
set-herstel-proc true|false

Als dit wordt aangeroepen met de parameter "false", zorgt "launch" niet voor een herstel
proces. Het doel van het herstelproces is om op hol geslagen hypervisorprocessen te stoppen
het geval waarin het hoofdprogramma abrupt wordt afgebroken.

Dit heeft alleen enig effect als het wordt aangeroepen vóór "lancering", en de standaardwaarde is waar.

Ongeveer de enige keer dat u dit wilt uitschakelen, is als het hoofdproces zich splitst
zichzelf naar de achtergrond (‘daemoniseren’). In dit geval denkt het herstelproces na
dat het hoofdprogramma is verdwenen en zo de hypervisor doodt, wat niet erg is
nuttig.

set-selinux
Selinux
set-selinux waar|onwaar

Dit stelt de selinux-vlag in die tijdens het opstarten aan het apparaat wordt doorgegeven. De standaardwaarde is
"selinux=0" (uitgeschakeld).

Merk op dat als SELinux is ingeschakeld, het zich altijd in de permissieve modus bevindt ("enforcing=0").

Voor meer informatie over de architectuur van libguestfs, zie gastfs(3).

set-smp
smp
set-smp smp

Wijzig het aantal virtuele CPU's dat aan het apparaat is toegewezen. De standaardwaarde is 1.
Als u dit verhoogt, kunnen de prestaties verbeteren, hoewel dit vaak geen effect heeft.

Deze functie moet vóór "lancering" worden aangeroepen.

set-tmpdir
tmpdir
set-tmpdir tmpdir

Stel de map in die door de handle wordt gebruikt om tijdelijke bestanden op te slaan.

De omgevingsvariabelen "LIBGUESTFS_TMPDIR" en "TMPDIR" bepalen de standaardwaarde: If
"LIBGUESTFS_TMPDIR" is ingesteld, dan is dat de standaardwaarde. Anders als "TMPDIR" is ingesteld, dan dat
is de standaard. Anders / tmp is de standaard.

set-trace
opsporen
set-trace waar | onwaar

Als de traceringsvlag van de opdracht is ingesteld op 1, roept libguestfs de parameters op en retourneert waarden
zijn getraceerd.

Als u C API-aanroepen naar libguestfs (en andere bibliotheken) wilt traceren, dan is mogelijk a
betere manier is om de externe te gebruiken ltrace(1) opdracht.

Commandosporen zijn uitgeschakeld, tenzij de omgevingsvariabele "LIBGUESTFS_TRACE" is gedefinieerd
en stel deze in op 1.

Traceerberichten worden normaal gesproken naar "stderr" verzonden, tenzij u een terugbelverzoek registreert om ze te verzenden
ergens anders (zie "set-event-callback").

set-uuid
set-uuid apparaat uuid

Stel de UUID van het bestandssysteem op "device" in op "uuid". Als dit mislukt en de fout ENOTSUP is,
betekent dat er geen ondersteuning is voor het wijzigen van de UUID voor het opgegeven type
bestandssysteem.

Slechts enkele bestandssysteemtypen ondersteunen het instellen van UUID's.

Om de UUID op een bestandssysteem te lezen, roept u "vfs-uuid" aan.

set-uuid-willekeurig
set-uuid-willekeurig apparaat

Stel de UUID van het bestandssysteem op "apparaat" in op een willekeurige UUID. Als dit niet lukt en de errno is
ENOTSUP betekent dat er geen ondersteuning is voor het wijzigen van de UUID voor het type
opgegeven bestandssysteem.

Slechts enkele bestandssysteemtypen ondersteunen het instellen van UUID's.

Om de UUID op een bestandssysteem te lezen, roept u "vfs-uuid" aan.

set-uitgebreid
breedsprakig
set-verbose waar | onwaar

Als 'uitgebreid' waar is, worden uitgebreide berichten ingeschakeld.

Uitgebreide berichten zijn uitgeschakeld tenzij de omgevingsvariabele "LIBGUESTFS_DEBUG" is
gedefinieerd en ingesteld op 1.

Uitgebreide berichten worden normaal gesproken naar "stderr" verzonden, tenzij u een terugbelverzoek registreert om te verzenden
ze ergens anders naartoe (zie "set-event-callback").

setcon
ingestelde context

Dit stelt de SELinux-beveiligingscontext van de daemon in op de string "context".

Zie de documentatie over SELINUX in gastfs(3).

setxattr
setxattr xattr val vallen pad

Deze aanroep stelt het uitgebreide attribuut genaamd "xattr" van het bestand "path" in op de waarde "val"
(van lengte "vallen"). De waarde bestaat uit willekeurige 8-bits gegevens.

Zie ook: "lsetxattr", attr(5).

sfschijf
sfdisk-apparaat cyls hoofden sectoren 'lijnen ...'

Dit is een directe interface naar de sfschijf(8) programma voor het maken van partities op blok
toestellen.

'apparaat' moet bijvoorbeeld een blokapparaat zijn / Dev / sda.

"cils", "heads" en "sectors" zijn het aantal cilinders, koppen en sectoren op de
device, die rechtstreeks naar sfdisk worden doorgegeven als -C, -H en -S parameters. Als je slaagt
Als deze voor elk van deze 0 is, wordt de overeenkomstige parameter weggelaten. Meestal voor 'groot'
schijven kunt u hiervoor gewoon 0 doorgeven, maar voor kleine schijven (floppy-formaat) kunt u sfdisk (of
eerder de kernel) kan de juiste geometrie niet uitwerken en je zult het moeten vertellen.

"lines" is een lijst met regels die we aan "sfdisk" doorgeven. Voor meer informatie verwijzen wij u naar de
sfschijf(8) manpagina.

Om een ​​enkele partitie te maken die de hele schijf beslaat, geeft u "regels" als één partitie door
elementlijst, waarbij het enkele element de string "," (komma) is.

Zie ook: "sfdisk-l", "sfdisk-N", "part-init"

In deze functie is verouderd. Gebruik in nieuwe code in plaats daarvan de aanroep "part-add".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

sfdiskM
sfdiskM-apparaat 'lijnen ...'

Dit is een vereenvoudigde interface voor de opdracht "sfdisk", waar partitiegroottes staan
alleen opgegeven in megabytes (afgerond op de dichtstbijzijnde cilinder) en dat is niet nodig
specificeer de parameters voor cilinders, koppen en sectoren die toch zelden of nooit werden gebruikt.

Zie ook: "sfdisk", de sfschijf(8) manpage en "part-disk"

In deze functie is verouderd. Gebruik in nieuwe code in plaats daarvan de aanroep "part-add".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

sfdisk-N
sfdisk-N-apparaat partnum cyls hoofden sectorenlijn

Dit loopt sfschijf(8) optie om alleen de enkele partitie "n" te wijzigen (let op: "n" telt vanaf
1).

Voor andere parameters, zie "sfdisk". Normaal gesproken moet u 0 doorgeven voor de cilinders/koppen/sectoren
parameters.

Zie ook: "gedeeltelijk toevoegen"

In deze functie is verouderd. Gebruik in nieuwe code in plaats daarvan de aanroep "part-add".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

sfdisk-schijf-geometrie
sfdisk-disk-geometry-apparaat

Dit toont de schijfgeometrie van "apparaat", gelezen uit de partitietabel. Met name in
in het geval dat het formaat van het onderliggende blokapparaat is gewijzigd, kan dit anders zijn
het kernelidee van de geometrie (zie "sfdisk-kernel-geometry").

Het resultaat is in een voor mensen leesbaar formaat en niet ontworpen om te worden geparseerd.

sfdisk-kernel-geometrie
sfdisk-kernel-geometrie-apparaat

Dit toont het idee van de kernel over de geometrie van "apparaat".

Het resultaat is in een voor mensen leesbaar formaat en niet ontworpen om te worden geparseerd.

sfdisk-l
sfdisk-l-apparaat

Hierdoor wordt de partitietabel op "apparaat" weergegeven in de voor mensen leesbare uitvoer van het
sfschijf(8) opdracht. Het is niet bedoeld om te worden ontleed.

Zie ook: "onderdelenlijst"

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "part-list".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

sh
sh commando

Deze aanroep voert een opdracht uit vanaf het gastbestandssysteem via dat van de gast / Bin / sh.

Dit lijkt op "opdracht", maar geeft de opdracht door aan:

/ Bin / sh -c "opdracht"

Afhankelijk van de shell van de gast resulteert dit meestal in het uitbreiden van jokertekens, shell
expressies die worden geïnterpoleerd, enzovoort.

Alle bepalingen over "opdracht" zijn van toepassing op deze oproep.

sh-lijnen
sh-lijnen commando

Dit is hetzelfde als "sh", maar splitst het resultaat op in een lijst met regels.

Zie ook: "opdrachtregels"

stillegging
stillegging

Dit is het tegenovergestelde van "lanceren". Het voert een ordelijke afsluiting van de backend uit
processen). Als de autosync-vlag is ingesteld (wat de standaard is), dan is de schijfkopie dat ook
gesynchroniseerd.

Als het subproces met een fout eindigt, retourneert deze functie een fout
moet niet worden genegeerd (dit kan erop duiden dat de schijfkopie niet kon worden weggeschreven).
op de juiste manier).

Het is veilig om dit meerdere keren te bellen. Extra oproepen worden genegeerd.

Deze oproep wel niet sluit of maak de handgreep vrij. Je moet nog steeds "close" bellen
daarna.

"close" zal dit aanroepen als u het niet expliciet doet, maar houd er rekening mee dat eventuele fouten worden genegeerd
in dat geval.

slaap
slaap seconden

Slaap gedurende "sec" seconden.

staat
stat pad

Retourneert bestandsinformatie voor het opgegeven "pad".

Dit is hetzelfde als de staat(2) systeemoproep.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "statns".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

standen
statns pad

Retourneert bestandsinformatie voor het opgegeven "pad".

Dit is hetzelfde als de staat(2) systeemoproep.

statistieken
statvfs-pad

Retourneert bestandssysteemstatistieken voor elk aangekoppeld bestandssysteem. "pad" moet een bestand zijn of
map in het aangekoppelde bestandssysteem (meestal is dit het aankoppelpunt zelf, maar it
hoeft niet).

Dit is hetzelfde als de statistieken(2) systeemoproep.

strings
snaren pad

Deze loopt de strings(1) opdracht voor een bestand en retourneert de lijst met afdrukbare tekenreeksen
gevonden.

Het commando "strings" heeft in het verleden problemen gehad met het parseren van niet-vertrouwde bestanden. Deze
worden beperkt in de huidige versie van libguestfs, maar zie "CVE-2014-8484" in gastfs(3).

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

snaren-e
strings-e coderingspad

Dit lijkt op het commando "strings", maar u kunt hiermee de codering van strings specificeren
worden gezocht in het bronbestand "pad".

Toegestane coderingen zijn:

s Enkele 7-bit-byte tekens zoals ASCII en de ASCII-compatibele delen van ISO-8859-X
(dit is wat "strings" gebruikt).

S Enkele tekens van 8 bits.

b 16-bits big endian-tekenreeksen, zoals gecodeerd in UTF-16BE of UCS-2BE.

l (kleine letter L)
16-bits kleine endian zoals UTF-16LE en UCS-2LE. Dit is handig bij het onderzoeken
binaire bestanden in Windows-gasten.

B 32-bits big-endian zoals UCS-4BE.

L 32-bits Little Endian zoals UCS-4LE.

De geretourneerde tekenreeksen worden getranscodeerd naar UTF-8.

Het commando "strings" heeft in het verleden problemen gehad met het parseren van niet-vertrouwde bestanden. Deze
worden beperkt in de huidige versie van libguestfs, maar zie "CVE-2014-8484" in gastfs(3).

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

swapoff-apparaat
apparaat met wisselapparaat

Met deze opdracht schakelt u het libguestfs-apparaatwisselapparaat of de partitie met de naam "device" uit.
Zie "swapon-apparaat".

swapoff-bestand
swapoff-bestand

Met deze opdracht wordt de libguestfs-appliancewissel in het bestand uitgeschakeld.

swapoff-label
swapoff-labellabel

Met deze opdracht wordt de libguestfs-appliance-swap op de gelabelde swap-partitie uitgeschakeld.

swapoff-uuid
swapoff-uuid uuid

Met deze opdracht wordt de swappartitie van het libguestfs-apparaat met de opgegeven UUID uitgeschakeld.

swapon-apparaat
apparaat met swap-on-apparaat

Met deze opdracht kan het libguestfs-apparaat het wisselapparaat of de genoemde partitie gebruiken
"apparaat". Het verhoogde geheugen wordt beschikbaar gesteld voor alle commando's, bijvoorbeeld de uitgevoerde commando's
met behulp van "commando" of "sh".

Houd er rekening mee dat u niet naar bestaande gastwisselpartities moet wisselen, tenzij u weet wat u moet doen
zijn aan het doen. Ze kunnen informatie over de slaapstand bevatten, of andere informatie die de gast heeft
wil niet dat je afvalt. Je loopt ook het risico dat er informatie over de gastheer naar de gast lekt
op deze manier. Sluit in plaats daarvan een nieuw hostapparaat aan op de gast en wissel daarop.

swapon-bestand
swapon-bestand

Met deze opdracht kunt u naar een bestand wisselen. Zie "swapon-apparaat" voor andere opmerkingen.

swapon-label
swapon-label

Met deze opdracht wordt swap naar een gelabelde swappartitie mogelijk gemaakt. Zie "swapon-apparaat" voor overige
notities.

swapon-uuid
swapon-uuid uuid

Met deze opdracht wordt swap naar een swappartitie met de opgegeven UUID mogelijk gemaakt. Zie "swapon-apparaat"
voor andere notities.

sync
sync

Hierdoor wordt de schijf gesynchroniseerd, zodat alle schrijfbewerkingen worden doorgespoeld naar de onderliggende schijfkopie.

U moet dit altijd aanroepen als u een schijfkopie hebt gewijzigd, voordat u de hendel sluit.

syslinux
syslinux-apparaat [map:..]

Installeer de SYSLINUX-bootloader op "apparaat".

De apparaatparameter moet een hele schijf zijn die is geformatteerd als een FAT-bestandssysteem, of een
partitie geformatteerd als FAT-bestandssysteem. In het laatste geval zou de partitie dat moeten zijn
gemarkeerd als "actief" ("part-set-bootable") en er moet een Master Boot Record zijn geïnstalleerd (bijv.
met behulp van "pwrite-device") op de eerste sector van de hele schijf. Het SYSLINUX-pakket komt
met enkele geschikte Master Boot Records. Zie de syslinux(1) manpagina voor verder
informatie.

De optionele argumenten zijn:

directory
Installeer SYSLINUX in de benoemde submap, in plaats van in de hoofdmap van het
FAT-bestandssysteem.

Er kan aanvullende configuratie aan SYSLINUX worden geleverd door een bestand met de naam syslinux.cfg
op het FAT-bestandssysteem, hetzij in de hoofdmap, of onder directory als dat optioneel is
argument wordt gebruikt. Voor meer informatie over de inhoud van dit bestand, zie
syslinux(1).

Zie ook "extlinux".

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

staart
staart pad

Met deze opdracht worden de laatste 10 regels van een bestand geretourneerd als een lijst met tekenreeksen.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

staart-n
staart-n nrlines pad

Als de parameter "nrlines" een positief getal is, retourneert dit de laatste "nrlines" regels van
het bestand "pad".

Als de parameter "nrlines" een negatief getal is, retourneert dit regels uit het bestand "path",
beginnend met de "-nrlines" regel.

Als de parameter "nrlines" nul is, retourneert dit een lege lijst.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

teer-in
tar-in-opteert
tar-in (tarfile|-) map [comprimeren:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Met deze opdracht wordt het lokale bestand "tarfile" geüpload en uitgepakt directory.

De optionele vlag "comprimeren" regelt de compressie. Als dit niet is opgegeven, moet de invoer dat wel zijn
een ongecomprimeerd tar-bestand. Anders kan een van de volgende strings worden geselecteerd
het compressietype van het invoerbestand: "compress", "gzip", "bzip2", "xz", "lzop". (Opmerking
dat niet alle builds van libguestfs al deze compressietypen zullen ondersteunen).

De andere optionele argumenten zijn:

"xattrs"
Indien ingesteld op true, worden uitgebreide kenmerken hersteld vanuit het tar-bestand.

"selinux"
Indien ingesteld op true, worden SELinux-contexten hersteld vanuit het tar-bestand.

"acls"
Indien ingesteld op true, worden POSIX ACL's hersteld vanuit het tar-bestand.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

teer-uit
tar-out-opteert
tar-out directory (tarfile|-) [comprimeren:..] [numericowner:true|false] [exclusief:..] [xattrs:true|false] [selinux:true|false] [acls:true|false]

Met deze opdracht wordt de inhoud van directory en downloadt het naar het lokale bestand "tarfile".

De optionele vlag "compress" regelt de compressie. Als dit niet wordt opgegeven, zal de uitvoer dat wel zijn
een ongecomprimeerd tar-bestand. Anders kan een van de volgende strings worden geselecteerd
het compressietype van het uitvoerbestand: "compress", "gzip", "bzip2", "xz", "lzop". (Opmerking
dat niet alle builds van libguestfs al deze compressietypen zullen ondersteunen).

De andere optionele argumenten zijn:

"exclusief"
Een lijst met jokertekens. Bestanden worden uitgesloten als ze overeenkomen met een van de jokertekens.

"numerieke eigenaar"
Indien ingesteld op true, zal het uitvoertar-bestand UID/GID-nummers bevatten in plaats van gebruiker/groep
namen.

"xattrs"
Indien ingesteld op true, worden uitgebreide attributen opgeslagen in de uitvoertar.

"selinux"
Indien ingesteld op true, worden SELinux-contexten opgeslagen in de uitvoer tar.

"acls"
Indien ingesteld op true, worden POSIX ACL's opgeslagen in de uitvoertar.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

tgz-in
tgz-in (tarball|-) map

Met deze opdracht wordt het lokale bestand "tarball" (a gzip gecomprimeerde tar-bestand) in
directory.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "tar-in"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

tgz-uit
tgz-out-map (tarball|-)

Met deze opdracht wordt de inhoud van directory en downloadt het naar het lokale bestand "tarball".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "tar-out"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

 
aanraakpad

Aanraking gedraagt ​​zich als de  (1) opdracht. Het kan worden gebruikt om de tijdstempels van een bestand bij te werken,
of, als het bestand niet bestaat, om een ​​nieuw bestand met lengte nul te maken.

Deze opdracht werkt alleen bij gewone bestanden en mislukt bij andere bestandstypen, zoals
mappen, symbolische links, speciale blokken etc.

afkappen
pad inkorten

Deze opdracht kapt "pad" af naar een bestand met een lengte van nul. Het bestand moet al bestaan.

afgekapte grootte
padgrootte met afgekapte grootte

Met deze opdracht wordt het "pad" afgekapt tot de grootte van "size" bytes. Het bestand moet al bestaan.

Als de huidige bestandsgrootte kleiner is dan "grootte", wordt het bestand uitgebreid tot de vereiste grootte
grootte met nul bytes. Hierdoor wordt een sparse-bestand gemaakt (dat wil zeggen dat er geen schijfblokken worden toegewezen
het bestand totdat u ernaar schrijft). Om een ​​niet-sparse bestand met nullen te maken, gebruik je "fallocate64"
gebruiken.

tune2fs
tune2fs apparaat [force:true|false] [maxmountcount:N] [mountcount:N] [foutgedrag:..] [groep:N] [intervaltussencontroles:N] [gereserveerdeblokkenpercentage:N] [laatstgemonteerdemap:..] [gereserveerdeblokkentelling:N ] [gebruiker:N]

Met deze aanroep kunt u verschillende bestandssysteemparameters van een ext2/ext3/ext4 aanpassen
bestandssysteem genaamd "apparaat".

De optionele parameters zijn:

"dwingen"
Forceer tune2fs om de bewerking te voltooien, zelfs als er fouten optreden. Dit is hetzelfde
als de tune2fs "-f" optie.

"maxmountaantal"
Stel het aantal mounts in waarna het bestandssysteem wordt gecontroleerd e2fsck(8). Als dit
0 is, wordt het aantal mounts genegeerd. Dit is hetzelfde als de tune2fs "-c"
optie.

"mountcount"
Stel het aantal keren in dat het bestandssysteem is aangekoppeld. Dit is hetzelfde als de
tune2fs "-C" optie.

"foutgedrag"
Verander het gedrag van de kernelcode wanneer er fouten worden gedetecteerd. Mogelijke waarden
momenteel zijn: "doorgaan", "remount-ro", "paniek". In de praktijk doen deze opties dat niet
maken echt geen enkel verschil, vooral als het gaat om schrijffouten.

Dit is hetzelfde als de tune2fs "-e" optie.

"groep"
Stel de groep in die gereserveerde bestandssysteemblokken kan gebruiken. Dit is hetzelfde als de
tune2fs "-g" optie, behalve dat dit alleen als een getal kan worden opgegeven.

"interval tussen controles"
Pas de maximale tijd tussen twee bestandssysteemcontroles aan (in seconden). Als de optie dat is
als 0 wordt doorgegeven, wordt de tijdsafhankelijke controle uitgeschakeld.

Dit is hetzelfde als de tune2fs "-i" optie.

"gereserveerdblokkenpercentage"
Stel het percentage van het bestandssysteem in dat alleen door bevoorrechte personen mag worden toegewezen
processen. Dit is hetzelfde als de tune2fs "-m" optie.

"laatst gemonteerde map"
Stel de laatst aangekoppelde map in. Dit is hetzelfde als de tune2fs "-M" optie.

"reservedblockscount" Stel het aantal gereserveerde bestandssysteemblokken in. Dit is hetzelfde als
de tune2fs "-r" optie.
"gebruiker"
Stel de gebruiker in die de gereserveerde bestandssysteemblokken kan gebruiken. Dit is hetzelfde als de
tune2fs "-u" optie, behalve dat dit alleen als een getal kan worden opgegeven.

Om de huidige waarden van bestandssysteemparameters te verkrijgen, zie "tune2fs-l". Voor nauwkeurige details
over hoe tune2fs werkt, zie de tune2fs(8) man-pagina.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

tune2fs-l
tune2fs-l-apparaat

Dit retourneert de inhoud van het ext2-, ext3- of ext4-bestandssysteemsuperblok op "apparaat".

Het is hetzelfde als het uitvoeren van "tune2fs -l device". Zien tune2fs(8) manpagina voor meer details.
De lijst met geretourneerde velden is niet duidelijk gedefinieerd en is afhankelijk van de versie van
"tune2fs" waartegen libguestfs is gebouwd, en het bestandssysteem zelf.

txz-in
txz-in (tarball|-) map

Met deze opdracht wordt het lokale bestand "tarball" (an xz gecomprimeerde tar-bestand) in
directory.

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "tar-in"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

txz-uit
txz-out-map (tarball|-)

Met deze opdracht wordt de inhoud van directory en downloadt het naar het lokale bestand "tarball" (zoals
een xz-gecomprimeerd tar-archief).

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de "tar-out"-aanroep.

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

umasker
umasker masker

Deze functie stelt het masker dat wordt gebruikt voor het maken van nieuwe bestanden en apparaatknooppunten in op "mask & 0777".

Typische umask-waarden zijn 022, waarmee nieuwe bestanden worden gemaakt met machtigingen zoals
"-rw-r--r--" of "-rwxr-xr-x", en 002 waarmee nieuwe bestanden worden gemaakt met machtigingen zoals
"-rw-rw-r--" of "-rwxrwxr-x".

Het standaard umask is 022. Dit is belangrijk omdat dit betekent dat mappen en apparaten
knooppunten worden gemaakt in de modus 0644 of 0755, zelfs als u 0777 opgeeft.

Zie ook "get-umask", umasker(2), "mknod", "mkdir".

Deze oproep retourneert het vorige umask.

umount
ontkoppelen
umount-opts
umount pathofvice [force:true|false] [lui afkoppelen:true|false]

Hiermee wordt het gegeven bestandssysteem ontkoppeld. Het bestandssysteem kan worden gespecificeerd door zijn
mountpoint (pad) of het apparaat dat het bestandssysteem bevat.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

umount-alles
alles ontkoppelen
umount-alles

Hiermee worden alle aangekoppelde bestandssystemen ontkoppeld.

Sommige interne mounts worden door deze oproep niet ontkoppeld.

umount-lokaal
umount-lokaal [opnieuw proberen: waar | onwaar]

Als libguestfs het bestandssysteem naar een lokaal mountpoint exporteert, wordt het hierdoor ontkoppeld.

Zie "MOUNT LOKAAL" in gastfs(3) voor volledige documentatie.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

uploaden
upload (bestandsnaam|-) externe bestandsnaam

Lokaal bestand uploaden bestandsnaam naar externe bestandsnaam op het bestandssysteem.

bestandsnaam kan ook een benoemde pijp zijn.

Zie ook "downloaden".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

upload-offset
upload-offset (bestandsnaam|-) externe bestandsnaam offset

Lokaal bestand uploaden bestandsnaam naar externe bestandsnaam op het bestandssysteem.

externe bestandsnaam wordt overschreven vanaf de opgegeven byte "offset". de bedoeling is
om delen van bestaande bestanden of apparaten te overschrijven, ook als dat een niet-bestaand bestand is
gespecificeerd, dan wordt het gemaakt met een "gat" vóór "offset". De grootte van de geschreven gegevens
is impliciet in de grootte van de bron bestandsnaam.

Houd er rekening mee dat er geen limiet is op de hoeveelheid gegevens die met deze oproep kan worden geüpload.
in tegenstelling tot "pwrite", en deze aanroep schrijft altijd het volledige bedrag, tenzij er een fout optreedt.

Zie ook "uploaden", "pwrite".

Gebruik "-" in plaats van een bestandsnaam om te lezen/schrijven vanuit stdin/stdout.

gebruiker-annuleren
gebruiker-annuleren

Deze functie annuleert de huidige upload- of downloadbewerking.

In tegenstelling tot de meeste andere libguestfs-aanroepen is deze functie signaal- en thread-veilig. Jij kan
noem het vanuit een signaalbehandelaar of vanuit een andere thread, zonder enige vergrendeling te hoeven uitvoeren.

De overdracht die aan de gang was (als die er is) zal kort daarna stoppen, en dat zal ook gebeuren
een fout retourneren. De errno (zie "guestfs_last_errno") is ingesteld op "EINTR", dus u kunt testen
om erachter te komen of de bewerking is geannuleerd of mislukt vanwege een andere fout.

Er wordt geen opschoning uitgevoerd: bijvoorbeeld als een bestand werd geüpload en daarna na annulering
Er is mogelijk een gedeeltelijk geüpload bestand. Het is de verantwoordelijkheid van de beller om dit op te ruimen
noodzakelijk.

Er zijn twee veel voorkomende plaatsen die u 'user-cancel' zou kunnen noemen:

In een interactief, op tekst gebaseerd programma zou je het zo kunnen aanroepen vanuit een "SIGINT"-signaalbehandelaar
dat het indrukken van "^C" de huidige bewerking annuleert. (Je moet ook bellen
"guestfs_set_pgroup" zodat onderliggende processen het signaal "^C" niet ontvangen).

In een grafisch programma, wanneer de hoofdthread een voortgangsbalk weergeeft met een annulering
knop, sluit u de annuleerknop aan om deze functie op te roepen.

gebruiken
utimens pad atsecs atnsecs mtsecs mtnsecs

Met deze opdracht worden de tijdstempels van een bestand ingesteld met een nauwkeurigheid van nanoseconden.

"atsecs, atnsecs" zijn de laatste toegangstijd (atime) in seconden en nanoseconden vanaf het tijdperk.

"mtsecs, mtnsecs" is de laatste wijzigingstijd (mtime) in seconden en nanoseconden vanaf de
tijdperk.

Als het *nsecs-veld de speciale waarde "-1" bevat, dan is de bijbehorende tijdstempel dat
ingesteld op de huidige tijd. (Het veld *secs wordt in dit geval genegeerd).

Als het *nsecs-veld de speciale waarde "-2" bevat, dan is de bijbehorende tijdstempel dat
onveranderd gelaten. (Het veld *secs wordt in dit geval genegeerd).

utsnaam
utsnaam

Hierdoor wordt de kernelversie van het apparaat geretourneerd, indien beschikbaar. Dit
informatie is alleen nuttig voor foutopsporing. Niets in de geretourneerde structuur wordt gedefinieerd door
de API.

versie
versie

Retourneert het versienummer van libguestfs waaraan het programma is gekoppeld.

Merk op dat dit vanwege dynamische koppelingen niet noodzakelijkerwijs de versie van libguestfs is
waartegen u heeft gecompileerd. U kunt het programma compileren en vervolgens tijdens runtime dynamisch uitvoeren
link tegen een heel ander libguestfs.zo bibliotheek.

Deze oproep is toegevoegd in versie 1.0.58. In eerdere versies van libguestfs was er geen
manier om het versienummer te verkrijgen. Vanuit C-code kunt u dynamische linkerfuncties gebruiken om te zoeken
uit of dit symbool bestaat (als dat niet het geval is, dan is het een eerdere versie).

De oproep retourneert een structuur met vier elementen. De eerste drie ("major", "minor" en
"release") zijn cijfers en komen overeen met het gebruikelijke versietriplet. Het vierde element
("extra") is een tekenreeks en is normaal gesproken leeg, maar kan worden gebruikt voor distributiespecifiek
informatie.

Om de oorspronkelijke versietekenreeks samen te stellen: "$major.$minor.$release$extra"

Zie ook: "LIBGUESTFS VERSIENUMMERS" in gastfs(3).

Opmerking: Gebruik deze oproep niet om de beschikbaarheid van functies te testen. In onderneming
distributies backporteren we functies van latere versies naar eerdere versies, waardoor dit ontstaat
een onbetrouwbare manier om functies te testen. Gebruik in plaats daarvan 'beschikbaar' of 'beschikbare functies'.

vfs-label
vfs-label monteerbaar

Dit retourneert het label van het bestandssysteem op "mountable".

Als het bestandssysteem geen label heeft, retourneert dit de lege tekenreeks.

Om een ​​bestandssysteem van het label te vinden, gebruik je "findfs-label".

vfs-minimale grootte
vfs-minimale maat monteerbaar

Haal de minimale grootte van het bestandssysteem op in bytes. Dit is de minimaal mogelijke maat voor
bestandssysteem krimpt.

Als het verkrijgen van de minimale grootte van het opgegeven bestandssysteem niet wordt ondersteund, zal dit mislukken en worden ingesteld
errno als ENOTSUP.

Zie ook ntfsgrootte(8) formaat wijzigen2fs(8) btrfs(8) xfs_info(8).

vfs-type
vfs-type monteerbaar

Met deze opdracht wordt het bestandssysteemtype opgehaald dat overeenkomt met het bestandssysteem op "mountable".

Voor de meeste bestandssystemen is het resultaat de naam van de Linux VFS-module die zou worden gebruikt
om dit bestandssysteem te mounten als u het hebt gemount zonder het bestandssysteemtype op te geven. Voor
bijvoorbeeld een string zoals "ext3" of "ntfs".

vfs-uuid
krijg-uuid
vfs-uuid monteerbaar

Dit retourneert de bestandssysteem-UUID van het bestandssysteem op "mountable".

Als het bestandssysteem geen UUID heeft, retourneert dit de lege string.

Om een ​​bestandssysteem van de UUID te vinden, gebruikt u "findfs-uuid".

vg-activeren
vg-activate true|false 'volgroups ...'

Deze opdracht activeert of (als "activate" false is) deactiveert alle logische volumes in de
vermelde volumegroepen "volgroups".

Deze opdracht is hetzelfde als het uitvoeren van "vgchange -ay|n volgroups..."

Merk op dat als "volgroups" een lege lijst is allen volumegroepen zijn geactiveerd of
gedeactiveerd.

vg-activeer-alles
vg-activeer-allemaal waar|onwaar

Met deze opdracht worden alle logische volumes geactiveerd of (als "activate" false is) gedeactiveerd
volumegroepen.

Deze opdracht is hetzelfde als het uitvoeren van "vgchange -ay|n"

vgchange-uuid
vgchange-uuid vg

Genereer een nieuwe willekeurige UUID voor de volumegroep "vg".

vgchange-uuid-all
vgchange-uuid-all

Genereer nieuwe willekeurige UUID's voor alle volumegroepen.

vgcreëer
vgcreate volgroup 'physvols ...'

Hierdoor wordt een LVM-volumegroep aangemaakt met de naam "volgroup" uit de niet-lege lijst met fysieke
volumes "physvols".

vglvuids
vglvuuiids vgnaam

Gegeven een VG genaamd "vgname", retourneert dit de UUID's van alle logische volumes die zijn aangemaakt
deze volumegroep.

U kunt dit samen met "lvs"- en "lvuuid"-aanroepen gebruiken om logische volumes en
volumegroepen.

Zie ook "vgpvuuids".

vgmeta
vgmeta vgnaam

"vgname" is een LVM-volumegroep. Met deze opdracht wordt de volumegroep onderzocht en geretourneerd
metagegevens.

Houd er rekening mee dat de metadata een interne structuur is die door LVM wordt gebruikt en op elk moment kan worden gewijzigd
tijd en wordt uitsluitend ter informatie verstrekt.

vgpvuids
vgpvuuiids vgname

Gegeven een VG genaamd "vgname", retourneert dit de UUID's van alle fysieke volumes die dit betreft
volumegroep bevindt zich op.

U kunt dit samen met "pvs"- en "pvuuid"-aanroepen gebruiken om fysieke volumes en
volumegroepen.

Zie ook "vglvuuids".

vgreverplaatsen
vgremove vgnaam

Verwijder een LVM-volumegroep "vgname" (bijvoorbeeld "VG").

Hierdoor worden ook alle logische volumes in de volumegroep (indien aanwezig) geforceerd verwijderd.

vgrenaam
vgrename volgroep nieuwevolgroep

Hernoem een ​​volumegroep "volgroup" met de nieuwe naam "newvolgroup".

enz
enz

Maak een lijst van alle gedetecteerde volumegroepen. Dit is het equivalent van de enz(8) opdracht.

Dit retourneert een lijst met alleen de volumegroepnamen die zijn gedetecteerd (bijvoorbeeld "VolGroup00").

Zie ook "vgs-full".

vgs-vol
vgs-vol

Maak een lijst van alle gedetecteerde volumegroepen. Dit is het equivalent van de enz(8) opdracht. De
"volledige" versie bevat alle velden.

vgscan
vgscan

Hiermee worden alle blokapparaten opnieuw gescand en wordt de lijst met fysieke LVM-volumes, volume
groepen en logische volumes.

vguuid
vguuid vgnaam

Deze opdracht retourneert de UUID van de LVM VG met de naam "vgname".

wc-c
wc-c pad

Deze opdracht telt de tekens in een bestand, met behulp van de externe opdracht "wc -c".

wc-l
wc-l pad

Dit commando telt de regels in een bestand, met behulp van het externe commando "wc -l".

wc-w
wc-w pad

Dit commando telt de woorden in een bestand, met behulp van het externe commando "wc -w".

doekjes
wipefs-apparaat

Met deze opdracht worden de bestandssysteem- of RAID-handtekeningen van het opgegeven "apparaat" gewist om de
bestandssysteem onzichtbaar voor libblkid.

Hierdoor wordt het bestandssysteem zelf of andere gegevens van het "apparaat" niet gewist.

Vergelijk met "nul", waarmee de eerste paar blokken van een apparaat op nul worden gezet.

schrijven
schrijf padinhoud

Met deze aanroep wordt een bestand gemaakt met de naam "pad". De inhoud van het bestand is de string "content"
(die alle 8-bits gegevens kan bevatten).

Zie ook "schrijven-bijvoegen".

schrijven-toevoegen
inhoud van schrijf-toevoegpad

Deze aanroep voegt "inhoud" toe aan het einde van het bestand "pad". Als "pad" niet bestaat, dan a
er wordt een nieuw bestand aangemaakt.

Zie ook "schrijven".

schrijf-bestand
inhoudsgrootte van schrijfbestandspad

Met deze aanroep wordt een bestand gemaakt met de naam "pad". De inhoud van het bestand is de string "content"
(die alle 8-bits gegevens kan bevatten), met de lengte "grootte".

Als speciaal geval, als "size" 0 is, wordt de lengte berekend met behulp van "strlen" (dus in deze
als de inhoud geen ingesloten ASCII NUL's kan bevatten).

NB. Vanwege een bug kan het schrijven van inhoud met ASCII NUL-tekens dat wel doen niet werken, ook al
de lengte is gespecificeerd.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in nieuwe code in plaats daarvan de aanroep "write".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

xfs-beheerder
xfs-admin-apparaat [extunscribe:true|false] [imgfile:true|false] [v2log:true|false] [projid32bit:true|false] [lazycounter:true|false] [label:..] [uuid:.. ]

Wijzig de parameters van het XFS-bestandssysteem op "apparaat".

Apparaten die zijn gemonteerd, kunnen niet worden gewijzigd. Beheerders moeten bestandssystemen ontkoppelen
voordat deze oproep parameters kan wijzigen.

Sommige parameters van een aangekoppeld bestandssysteem kunnen worden onderzocht en gewijzigd met behulp van de
"xfs-info" en "xfs-growfs" oproepen.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

xfs-groeifs
xfs-growfs pad [datasec:true|false] [logsec:true|false] [rtsec:true|false] [datasize:N] [logsize:N] [rtsize:N] [rtextsize:N] [maxpct:N]

Laat het XFS-bestandssysteem groeien dat op "pad" is gemonteerd.

De geretourneerde structuur bevat geometrie-informatie. Ontbrekende velden worden geretourneerd als "-1"
(voor numerieke velden) of lege tekenreeks.

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

xfs-info
xfs-info pathovice

"pathordevice" is een aangekoppeld XFS-bestandssysteem of een apparaat dat een XFS-bestandssysteem bevat. Dit
commando retourneert de geometrie van het bestandssysteem.

De geretourneerde structuur bevat geometrie-informatie. Ontbrekende velden worden geretourneerd als "-1"
(voor numerieke velden) of lege tekenreeks.

xfs-reparatie
xfs-repair-apparaat [forcelogzero:true|false] [nomodify:true|false] [noprefetch:true|false] [forcegeometry:true|false] [maxmem:N] [ihashsize:N] [bhashsize:N] [agstride: N] [logdev:..] [rtdev:..]

Repareer corrupt of beschadigd XFS-bestandssysteem op "apparaat".

Het bestandssysteem wordt gespecificeerd met behulp van het argument "device", waarvan de apparaatnaam moet zijn
de schijfpartitie of het volume dat het bestandssysteem bevat. Als de naam van een blok wordt gegeven
apparaat, zal "xfs_repair" proberen het onbewerkte apparaat te vinden dat is gekoppeld aan het opgegeven
blokkeer apparaat en zal in plaats daarvan het onbewerkte apparaat gebruiken.

Hoe dan ook, het te repareren bestandssysteem moet worden ontkoppeld, anders ontstaat het resultaat
bestandssysteem is mogelijk inconsistent of corrupt.

De geretourneerde status geeft aan of corruptie van het bestandssysteem is gedetecteerd (retourneert 1) of
werd niet gedetecteerd (retourneert 0).

Deze opdracht heeft een of meer optionele argumenten. Zie "OPTIONELE ARGUMENTEN".

zegep
zegrep regex-pad

Dit roept het externe programma "zegrep" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

zegrepi
zegrepi regex-pad

Dit roept het externe programma "zegrep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

nul
nul apparaat

Deze opdracht schrijft nullen over de eerste paar blokken van "apparaat".

Hoeveel blokken op nul worden gezet, is niet gespecificeerd (maar dat is wel zo). niet genoeg om het veilig af te vegen
apparaat). Het zou voldoende moeten zijn om eventuele partitietabellen en superblokken van het bestandssysteem te verwijderen
enzovoort.

Als blokken al nul zijn, vermijdt deze opdracht het schrijven van nullen. Dit voorkomt de
het onderliggende apparaat niet schaars wordt of onnodig groeit.

Zie ook: "zero-device", "scrub-device", "is-zero-device"

nul-apparaat
apparaat zonder apparaat

Dit commando schrijft nullen over het gehele "apparaat". Vergelijk met "nul", wat gewoon is
stelt de eerste paar blokken van een apparaat op nul.

Als blokken al nul zijn, vermijdt deze opdracht het schrijven van nullen. Dit voorkomt de
het onderliggende apparaat niet schaars wordt of onnodig groeit.

nul-vrije ruimte
map met nul vrije ruimte

Nul de vrije ruimte in het bestandssysteem waarop het is gemonteerd directory. Het bestandssysteem moet
gemonteerd lezen-schrijven.

De inhoud van het bestandssysteem wordt niet beïnvloed, maar alle vrije ruimte in het bestandssysteem wordt vrijgemaakt.

Vrije ruimte wordt niet "bijgesneden". Misschien wilt u "fstrim" aanroepen als alternatief voor
dit, of nadat u dit hebt gebeld, afhankelijk van uw wensen.

nulvrij
nulvrij apparaat

Deze loopt de nulvrij programma op "apparaat". Dit programma claimt nul ongebruikte inodes en
schijfblokken op een ext2/3 bestandssysteem, waardoor het mogelijk wordt het bestandssysteem te comprimeren
effectiever.

Je mag niet voer dit programma uit als het bestandssysteem is aangekoppeld.

Het is mogelijk dat het gebruik van dit programma het bestandssysteem of de gegevens op het
bestandssysteem.

zfgrep
zfgrep-patroonpad

Dit roept het externe programma "zfgrep" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

zfgrepi
zfgrepi-patroonpad

Dit roept het externe programma "zfgrep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

zbestand
zfile meth-pad

Deze opdracht wordt uitgevoerd filet na eerst "path" te hebben gedecomprimeerd met behulp van "method".

"methode" moet een van de volgende opties zijn: "gzip", "compress" of "bzip2".

Gebruik sinds 1.0.63 in plaats daarvan "file", dat nu gecomprimeerde bestanden kan verwerken.

In deze functie is verouderd. Gebruik in nieuwe code in plaats daarvan de aanroep "file".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

zgrep
zgrep regex-pad

Dit roept het externe programma "zgrep" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

zgrepi
zgrepi regex-pad

Dit roept het externe programma "zgrep -i" aan en retourneert de overeenkomende regels.

Vanwege het berichtenprotocol is er een overdrachtslimiet van ergens tussen de 2 MB en
4 MB. Zie "PROTOCOLLIMIETEN" in gastfs(3).

In deze functie is verouderd. Gebruik in de nieuwe code in plaats daarvan de aanroep "grep".

Verouderde functies worden niet uit de API verwijderd, maar het feit dat ze dat wel zijn
verouderd geeft aan dat er problemen zijn met het juiste gebruik van deze functies.

EXIT STATUS

guestfish retourneert 0 als de opdrachten zonder fouten zijn voltooid, of 1 als er een fout is opgetreden.

MILIEU VARIABELEN

EDITOR
Het commando "edit" gebruikt $EDITOR als editor. Indien niet ingesteld, wordt "vi" gebruikt.

GUESTFISH_DISPLAY_IMAGE
Het commando "display" gebruikt $GUESTFISH_DISPLAY_IMAGE om afbeeldingen weer te geven. Als dit niet is ingesteld, wordt het
toepassingen tonen(1).

GASTVIS_INIT
Wordt afgedrukt wanneer de gastvis start. Zie "VRAAG".

GUESTFISH_OUTPUT
Afgedrukt vóór de gastenvisuitvoer. Zie "VRAAG".

GASTVIS_PID
Gebruikt met de --op afstand optie om het externe guestfish-proces te specificeren dat moet worden beheerd. Zien
sectie "AFSTANDSBEDIENING GUESTFISH OVER EEN STOPCONTACT".

GASTVIS_PS1
Stel de opdrachtprompt in. Zie "VRAAG".

GUESTFISH_RESTORE
Afgedrukt voordat de gastvis vertrekt. Zie "VRAAG".

HEXEDITOR
Het commando "hexedit" gebruikt $HEXETOR als de externe hex-editor. Indien niet gespecificeerd,
de externe hexedit(1) programma wordt gebruikt.

HOME
Indien gecompileerd met GNU-leesregelondersteuning, kunnen verschillende bestanden in de thuismap staan
gebruikt. Zie "BESTANDEN".

LIBGUESTFS_APPEND
Geef extra opties door aan de gastkernel.

LIBGUESTFS_ATTACH_METHOD
Dit is de oude manier om 'LIBGUESTFS_BACKEND' in te stellen.

LIBGUESTFS_BACKEND
Kies de standaardmanier om het apparaat te maken. Zie "guestfs_set_backend" in
gastfs(3).

LIBGUESTFS_BACKEND_SETTINGS
Een door dubbele punten gescheiden lijst met backend-specifieke instellingen. Zie "ACHTERUIT" in gastfs(3)
"BACKEND-INSTELLINGEN" in gastfs(3).

LIBGUESTFS_CACHEDIR
De locatie waar libguestfs zijn apparaat in de cache zal opslaan, bij gebruik van een supermin
apparaat. Het apparaat wordt in de cache opgeslagen en gedeeld tussen alle ingangen die hetzelfde hebben
effectieve gebruikers-ID.

Als "LIBGUESTFS_CACHEDIR" niet is ingesteld, wordt "TMPDIR" gebruikt. Als "TMPDIR" niet is ingesteld,
harte / Var / tmp is gebruikt.

Zie ook "LIBGUESTFS_TMPDIR", "set-cachedir".

LIBGUESTFS_DEBUG
Stel "LIBGUESTFS_DEBUG=1" in om uitgebreide berichten in te schakelen. Dit heeft hetzelfde effect als
met de -v optie.

LIBGUESTFS_HV
Stel de standaard binaire hypervisor (meestal qemu) in die libguestfs gebruikt. Indien niet ingesteld,
vervolgens wordt de qemu gebruikt die tijdens het compileren door het configuratiescript werd gevonden.

LIBGUESTFS_MEMSIZE
Stel het geheugen in dat is toegewezen aan het qemu-proces, in megabytes. Bijvoorbeeld:

LIBGUESTFS_MEMSIZE=700

LIBGUESTFS_PATH
Stel het pad in dat guestfish gebruikt om te zoeken naar kernel en initrd.img. Zie de
discussie over paden in gastfs(3).

LIBGUESTFS_QEMU
Dit is de oude manier om "LIBGUESTFS_HV" in te stellen.

LIBGUESTFS_TMPDIR
De locatie waar libguestfs tijdelijke bestanden opslaat die door elke handle worden gebruikt.

Als "LIBGUESTFS_TMPDIR" niet is ingesteld, wordt "TMPDIR" gebruikt. Als "TMPDIR" niet is ingesteld,
harte / tmp is gebruikt.

Zie ook "LIBGUESTFS_CACHEDIR", "set-tmpdir".

LIBGUESTFS_TRACE
Stel "LIBGUESTFS_TRACE=1" in om opdrachttracering in te schakelen.

PAGER
Het "more" commando gebruikt $PAGER als pager. Indien niet ingesteld, wordt "meer" gebruikt.

PATH
Libguestfs en guestfish kunnen enkele externe programma's uitvoeren en vertrouwen erop dat $PATH is ingesteld
tot een redelijke waarde. Als je de libvirt backend gebruikt, zal libvirt helemaal niet werken
tenzij $PATH het pad van qemu/KVM bevat.

SUPERMIN_KERNEL
SUPERMIN_KERNEL_VERSIE
SUPERMIN_MODULES
Deze drie omgevingsvariabelen maken de kernel mogelijk die libguestfs gebruikt in de
apparaat te selecteren. Als $SUPERMIN_KERNEL niet is ingesteld, dan is dit de meest recente host
kernel is gekozen. Voor meer informatie over kernelselectie, zie supermin(1).

TMPDIR
Zie "LIBGUESTFS_CACHEDIR", "LIBGUESTFS_TMPDIR".

Gebruik guestfish online met behulp van onworks.net-services