augtool - Online in de cloud

PROGRAMMA:

NAAM

augtool - configuratiebestanden inspecteren en wijzigen

KORTE INHOUD

augtool [OPTIES] [COMMANDO]

PRODUCTBESCHRIJVING

Augeas is een tool voor het bewerken van configuraties. Het parseert configuratiebestanden in hun oorspronkelijke versie
formatteert en transformeert ze in een boom. Configuratiewijzigingen worden aangebracht door middel van manipulatie
deze boom en sla deze weer op in de oorspronkelijke configuratiebestanden.

augtool biedt een opdrachtregelinterface voor de gegenereerde boomstructuur. COMMANDO kan een enkelvoudig commando zijn
commando zoals beschreven onder "COMMANDO'S". Wanneer het zonder COMMAND wordt aangeroepen, worden de opdrachten gelezen van
standaardinvoer totdat een end-of-file wordt aangetroffen.

OPTIES

-c, --typecontrole
Typecheck lenzen. Dit kan erg traag zijn en wordt daarom niet standaard gedaan, maar gebeurt wel
ten zeerste aanbevolen tijdens de ontwikkeling.

-b, --back-up
Wanneer bestanden worden gewijzigd, bewaar dan de originelen in een bestand met de extensie '.augsave'

-n, --nieuwe
Bewaar wijzigingen in bestanden met de extensie '.augnew', wijzig de originele bestanden niet

-r, --wortel=ROOT
Gebruik directory ROOT als de root van het bestandssysteem. Heeft voorrang op een rootset
met de omgevingsvariabele AUGEAS_ROOT.

-I, --erbij betrekken=DIR
Voeg DIR toe aan het laadpad van de module. Kan meerdere keren gegeven worden. De mappen die hier zijn ingesteld
worden doorzocht vóór directory's die zijn opgegeven in de AUGEAS_LENS_LIB-omgeving
variabele, en vóór de standaardmappen /usr/share/augeas/lenzen en
/usr/share/augeas/lenzen/dist.

-t, --transformeren=XFM
Voeg een bestandstransformatie toe; gebruikt de syntaxis van de opdracht 'transform', bijvoorbeeld "-t 'Fstab incl
/etc/fstab.bak'".

-f, --het dossier=FILE
Lees opdrachten uit BESTAND.

-i, --interactief
Lees opdrachten van de terminal. In combinatie met -f of omleiding van stdin, drop
in een interactieve sessie na het uitvoeren van de opdrachten uit het bestand.

-e, --echo
Wanneer u opdrachten uit een bestand leest via stdin, echo dan de opdrachten voordat u ze afdrukt
uitgang.

-s, --automatisch opslaan
Sla automatisch alle wijzigingen op aan het einde van de sessie.

-S, --nostdinc
Zoek niet in een van de standaardmappen voor modules. Wanneer deze optie is ingesteld,
alleen mappen die expliciet zijn gespecificeerd met -I of gespecificeerd in AUGEAS_LENS_LIB zal zijn
module gezocht.

-L, --geen lading
Laad geen bestanden bij het opstarten. Dit wordt over het algemeen gebruikt om nauwkeurig af te stemmen naar welke bestanden
load door de gegevens in "/augeas/load" te wijzigen en vervolgens een "load"-opdracht te geven.

-A, --geenautomatisch laden
Laad bij het opstarten geen lensmodules en dus ook geen bestanden. Hierdoor ontstaat nr
vermeldingen onder "/augeas/load" dan ook; Om bestanden te kunnen lezen, moeten ze worden ingesteld
handmatig en het laden moet worden gestart met een "load"-commando. Het gebruik van deze optie geeft
de snelste opstart.

--span
Laad spanposities voor knooppunten in de boom, aangezien deze betrekking hebben op het originele bestand.
Maakt het gebruik van de span commando om positiegegevens op te halen.

--versie
Versie-informatie afdrukken en afsluiten. De versie staat ook in de boom eronder
"/augeas/versie".

COMMANDO'S

In de interactieve modus kunnen opdrachten en paden worden voltooid door op "TAB" te drukken.

De paden die door opdrachten als argumenten worden geaccepteerd, gebruiken een kleine subset van XPath-padexpressies.
Een padexpressie bestaat uit een aantal segmenten, gescheiden door "/". In elk segment wordt de
Het teken "*" kan worden gebruikt om met elk knooppunt te matchen, ongeacht het label. Broederknooppunten met
identieke labels kunnen worden onderscheiden door "[N]" aan hun label toe te voegen, zodat het overeenkomt met de N-de
broer of zus met zo'n label. De laatste broer of zus met een specifiek label is te bereiken als
"[laatst()]". Zie "VOORBEELDEN" voor enkele voorbeelden hiervan.

BEHEERDER COMMANDO'S
De volgende opdrachten bepalen het gedrag van Augeas en augtool zelf.

hulp
Druk deze helptekst af

laden
Laad bestanden volgens de transformaties in "/augeas/load".

ophouden
Verlaat het programma

terugvinden
Transformeer de boom op PATH terug naar tekst met behulp van lens LENS en sla de resulterende string op
bij NODE_OUT. Stel dat de boom aanvankelijk met dezelfde lens en de
tekenreeks opgeslagen bij NODE_IN als invoer.

besparen
Bewaar alle openstaande wijzigingen op schijf. Tenzij ofwel de -b or -n opdrachtregelopties zijn
gegeven, bestanden worden op hun plaats gewijzigd.

shop
Parseer NODE met LENS en sla de resulterende boom op in PATH.

transformeren
Voeg een transformatie voor FILE toe met LENS. De LENS kan een modulenaam of een volledige lens zijn
naam. Als er een modulenaam wordt opgegeven, wordt "lns" als lens aangenomen. Het FILTER
moet 'incl' of 'excl' zijn. Als het filter "incl" is, wordt het BESTAND geparseerd
de lens. Als het filter "excl" is, wordt het BESTAND uitgesloten van de LENS. BESTAND mag
jokertekens bevatten.

LEZEN COMMANDO'S
De volgende opdrachten worden gebruikt om gegevens uit de Augeas-boom op te halen.

dump-xml [ ]
Print de gegevens in de boom als XML. Als PATH wordt opgegeven, begint het afdrukken daar, anders begint het afdrukken
de hele boom wordt afgedrukt.

krijgen
Druk de waarde af die aan PATH is gekoppeld

label
Haal het label op dat aan PATH is gekoppeld en druk het af

ls
Noem de directe kinderen van PATH

match [ ]
Vind alle paden die overeenkomen met PATTERN. Als VALUE is opgegeven, worden alleen de overeenkomende paden waarvan
waarde gelijk is aan WAARDE worden afgedrukt

print [ ]
Gegevens in de boom afdrukken. Als PATH wordt opgegeven, begint het afdrukken daar, anders wordt het
hele boom wordt afgedrukt

span
Druk de naam af van het bestand waaruit het knooppunt PATH is gegenereerd, evenals
informatie over de posities in het bestand die overeenkomen met het label, de waarde en
het gehele knooppunt. PATH moet met precies één knooppunt overeenkomen.

U moet 'set /augeas/span enable' uitvoeren voordat u bestanden laadt om opname mogelijk te maken
van spaninformatie. Het is standaard uitgeschakeld.

SCHRIJVEN COMMANDO'S
De volgende opdrachten worden gebruikt om de Augeas-boom te wijzigen.

duidelijk
Stel de waarde voor PATH in op NULL. Als PATH nog niet in de boom zit, dan is dat zo
voorouders zullen ontstaan.

opruimen
Wis meerdere knooppuntwaarden in één bewerking. Zoek of maak een knooppunt dat overeenkomt met SUB by
het interpreteren van SUB als een padexpressie ten opzichte van elk knooppunt dat overeenkomt met BASE. Als SUB dat is
'.', de knooppunten die overeenkomen met BASE zullen worden gewijzigd.

ins
Voeg een nieuw knooppunt met het label LABEL vlak voor of na PATH in de boom in. WAAR
moet 'voor' of 'na' zijn.

invoegen
alias van ins.

mv
Verplaats knooppunt SRC naar DST. SRC moet exact overeenkomen met één knooppunt in de boom. Zomertijd moet ook
komen precies overeen met één knooppunt in de boom, of bestaan ​​mogelijk nog niet. Als DST al bestaat, is dit het geval
en al zijn nakomelingen worden verwijderd. Als DST nog niet bestaat, ontbreekt het allemaal
voorouders zijn ontstaan.

beweging
alias van mv.

cp
Kopieer knooppunt SRC naar DST. SRC moet exact overeenkomen met één knooppunt in de boom. Zomertijd moet ook
komen precies overeen met één knooppunt in de boom, of bestaan ​​mogelijk nog niet. Als DST al bestaat, is dit het geval
en al zijn nakomelingen worden verwijderd. Als DST nog niet bestaat, ontbreekt het allemaal
voorouders zijn ontstaan.

kopiëren
alias van cp.

andere naam geven
Hernoem het label van alle knooppunten die overeenkomen met SRC en LBL.

rm
Verwijder PATH en al zijn kinderen uit de boom

reeks
Koppel VALUE aan PATH. Als PATH nog niet in de boom aanwezig is, geldt dit ook voor al zijn voorouders
zal gemaakt worden.

ingesteld [ ]
Stel meerdere knooppunten in één handeling in. Zoek of maak een knooppunt dat overeenkomt met SUB by
het interpreteren van SUB als een padexpressie ten opzichte van elk knooppunt dat overeenkomt met BASE. Als SUB dat is
'.', de knooppunten die overeenkomen met BASE zullen worden gewijzigd.

 
Maak PATH aan met de waarde NULL als het nog niet in de boom staat. Al zijn voorouders zullen dat doen
ook gecreëerd worden. Deze nieuwe boomvermeldingen verschijnen als laatste onder hun broers en zussen.

PATH UITDRUKKING COMMANDO'S
De volgende opdrachten helpen bij het werken met padexpressies.

verdedig [ ]
Definieer de variabele NAME als resultaat van de evaluatie van EXPR, wat een knooppuntenset moet zijn. Als
Er bestaat nog geen knooppunt dat overeenkomt met EXPR. Er wordt er één gemaakt en NAME zal ernaar verwijzen. Als WAARDE
is gegeven, is dit hetzelfde als 'set EXPR VALUE'; als VALUE niet is opgegeven, is het knooppunt dat wel
gemaakt alsof met 'clear EXPR' dat zou gebeuren en NAME verwijst naar dat knooppunt.

defvar
Definieer de variabele NAME op basis van het resultaat van de evaluatie van EXPR. De variabele kan worden gebruikt in
padexpressies als $NAME. Merk op dat EXPR wordt geëvalueerd wanneer de variabele wordt gedefinieerd,
niet wanneer het wordt gebruikt.

MILIEU VARIABELEN

AUGEAS_ROOT
De root van het bestandssysteem is standaard '/'. Kan worden overschreven met de -r opdrachtregel
optie

AUGEAS_LENS_LIB
Door dubbele punten gescheiden lijst met mappen met lenzen. De hier opgegeven mappen zijn
gezocht naar mappen die zijn ingesteld met de -I opdrachtregeloptie, maar vóór de
standaardmappen /usr/share/augeas/lenzen en /usr/share/augeas/lenzen/dist

DIAGNOSE

Normaal gesproken is de afsluitstatus 0. Als een of meer opdrachten mislukken, wordt de afsluitstatus ingesteld op niet-
nul waarde.

Houd er echter rekening mee dat het niet laden van sommige van de door transforms gespecificeerde bestanden mislukt
"/augeas/load" wordt niet als een fout beschouwd. Als het belangrijk is om te weten dat alle bestanden
geladen, moet u na het laden een "match /augeas//error" geven om details over te weten te komen
welke bestanden konden niet worden geladen en waarom.

Voorbeelden

# opdrachtregelmodus
augtool print /bestanden/etc/hosts/

# interactieve modus
vergrootglas
augtool> help
augtool> print /files/etc/hosts/

# Druk de derde invoer van de tweede AcceptEnv-regel af
augtool print '/files/etc/ssh/sshd_config/AcceptEnv[2]/3'

# Zoek het item in inittab met actie 'initdefault'
augtool> match /files/etc/inittab/*/action initdefault

# Druk de laatste alias voor elk item af in / Etc / hosts
augtool> print /files/etc/hosts/*/alias[laatste()]

Gebruik augtool online met behulp van onworks.net-services