augtool - Online di Cloud

PROGRAM:

NAMA

augtool - memeriksa dan memodifikasi file konfigurasi

RINGKASAN

augtool [OPSI] [COMMAND]

DESKRIPSI

Augeas adalah alat pengeditan konfigurasi. Ini mem-parsing file konfigurasi dalam aslinya
format dan mengubahnya menjadi pohon. Perubahan konfigurasi dilakukan dengan memanipulasi
pohon ini dan menyimpannya kembali ke file konfigurasi asli.

augtool menyediakan antarmuka baris perintah ke pohon yang dihasilkan. COMMAND bisa tunggal
perintah seperti yang dijelaskan di bawah "PERINTAH". Saat dipanggil tanpa COMMAND, ia membaca perintah dari
input standar sampai end-of-file ditemukan.

PILIHAN

-c, --pemeriksaan ketik
Lensa Typecheck. Ini bisa sangat lambat, dan karena itu tidak dilakukan secara default, tetapi adalah
sangat dianjurkan selama pengembangan.

-b, --cadangan
Saat file diubah, simpan yang asli dalam file dengan ekstensi '.augsave'

-n, --baru
Simpan perubahan pada file dengan ekstensi '.augnew', jangan ubah file aslinya

-r, --akar=ROOT
Gunakan direktori ROOT sebagai root dari sistem file. Lebih diutamakan daripada root set
dengan variabel lingkungan AUGEAS_ROOT.

-I, --termasuk=DIR
Tambahkan DIR ke jalur beban modul. Dapat diberikan berkali-kali. Direktori diatur di sini
dicari sebelum direktori yang ditentukan dalam lingkungan AUGEAS_LENS_LIB
variabel, dan sebelum direktori default /usr/share/augeas/lensa dan
/usr/share/augeas/lensa/dist.

-t, --mengubah=XFM
Tambahkan transformasi file; menggunakan sintaks perintah 'transform', misalnya "-t 'Fstab incl
/etc/fstab.bak'".

-f, --mengajukan=FILE
Baca perintah dari FILE.

-i, --interaktif
Baca perintah dari terminal. Ketika digabungkan dengan -f atau pengalihan stdin, drop
ke dalam sesi interaktif setelah menjalankan perintah dari file.

-e, --gema
Saat membaca perintah dari file melalui stdin, gema perintah sebelum mencetaknya
output.

-s, --penyimpanan otomatis
Secara otomatis menyimpan semua perubahan di akhir sesi.

-S, --nostdinc
Jangan mencari salah satu direktori default untuk modul. Saat opsi ini disetel,
hanya direktori yang ditentukan secara eksplisit dengan -I atau ditentukan dalam AUGEAS_LENS_LIB akan
mencari modul.

-L, --tidak memuat
Jangan memuat file apa pun saat startup. Ini biasanya digunakan untuk menyempurnakan file mana yang ingin
muat dengan memodifikasi entri di "/ augeas/load" dan kemudian mengeluarkan perintah "load".

-A, --tidak ada pemuatan otomatis
Jangan memuat modul lensa apa pun, dan karenanya tidak ada file, saat startup. Ini tidak menciptakan
entri di bawah "/augeas/load" apa pun; untuk membaca file apa pun, file tersebut perlu diatur
secara manual dan pemuatan harus dimulai dengan perintah "muat". Menggunakan opsi ini memberikan
startup tercepat.

--menjangkau
Muat posisi rentang untuk node di pohon, karena terkait dengan file asli.
Memungkinkan penggunaan merentang perintah untuk mengambil data posisi.

--Versi: kapan
Cetak informasi versi dan keluar. Versinya juga ada di pohon di bawah
"/augeas/versi".

PERINTAH

Dalam mode interaktif, perintah dan jalur dapat diselesaikan dengan menekan "TAB".

Jalur yang diterima sebagai argumen oleh perintah menggunakan subset kecil dari ekspresi jalur XPath.
Ekspresi jalur terdiri dari sejumlah segmen, dipisahkan oleh "/". Di setiap segmen,
karakter "*" dapat digunakan untuk mencocokkan setiap node terlepas dari labelnya. Simpul saudara dengan
label identik dapat dibedakan dengan menambahkan "[N]" ke labelnya agar sesuai dengan N-th
saudara dengan label seperti itu. Saudara terakhir dengan label tertentu dapat dihubungi sebagai
"[terakhir()]". Lihat "CONTOH" untuk beberapa contoh ini.

ADMIN PERINTAH
Perintah berikut mengontrol perilaku Augeas dan augtool itu sendiri.

membantu
Cetak teks bantuan ini

memuat
Muat file sesuai dengan transformasi di "/ augeas/load".

berhenti
Keluar dari program

Ambil kembali
Ubah pohon di PATH kembali menjadi teks menggunakan LENS lensa dan simpan string yang dihasilkan
di NODE_OUT. Asumsikan bahwa pohon awalnya dibaca dengan lensa yang sama dan
string disimpan di NODE_IN sebagai input.

menyimpan
Simpan semua perubahan yang tertunda ke disk. Kecuali jika -b or -n opsi baris perintah adalah
diberikan, file diubah di tempat.

menyimpan
Parsing NODE menggunakan LENS dan simpan pohon yang dihasilkan di PATH.

mengubah
Tambahkan transformasi untuk FILE menggunakan LENS. LENS dapat berupa nama modul atau lensa penuh
nama. Jika nama modul diberikan, maka "lns" akan menjadi lensa yang diasumsikan. FILTER
harus berupa "incl" atau "excl". Jika filternya adalah "termasuk", FILE akan diuraikan oleh
lensa. Jika filternya adalah "excl", FILE akan dikeluarkan dari LENS. FILE mungkin
mengandung wildcard.

BACA BACA PERINTAH
Perintah berikut digunakan untuk mengambil data dari pohon Augeas.

dump-xml [ ]
Cetak entri di pohon sebagai XML. Jika PATH diberikan, pencetakan dimulai di sana, jika tidak
seluruh pohon dicetak.

mendapatkan
Cetak nilai yang terkait dengan PATH

label
Dapatkan dan cetak label yang terkait dengan PATH

ls
Sebutkan anak-anak langsung dari PATH

pertandingan [ ]
Temukan semua jalur yang cocok dengan POLA. Jika VALUE diberikan, hanya jalur yang cocok yang
nilai sama dengan VALUE dicetak

mencetak [ ]
Cetak entri di pohon. Jika PATH diberikan, pencetakan dimulai di sana, jika tidak,
seluruh pohon dicetak

merentang
Cetak nama file dari mana node PATH dihasilkan, serta
informasi tentang posisi dalam file yang sesuai dengan label, nilai, dan
seluruh simpul. PATH harus cocok dengan tepat satu node.

Anda perlu menjalankan 'set /augeas/span enable' sebelum memuat file untuk mengaktifkan perekaman
dari informasi rentang. Ini dinonaktifkan secara default.

MENULIS PERINTAH
Perintah berikut digunakan untuk memodifikasi pohon Augeas.

jelas
Tetapkan nilai untuk PATH ke NULL. Jika PATH belum ada di pohon, itu dan semua nya
nenek moyang akan tercipta.

jelas
Hapus beberapa nilai node dalam satu operasi. Temukan atau buat simpul yang cocok dengan SUB dengan
menafsirkan SUB sebagai ekspresi jalur relatif terhadap setiap node BASE yang cocok. Jika SUB adalah
'.', node yang cocok dengan BASE akan dimodifikasi.

in
Masukkan simpul baru dengan label LABEL tepat sebelum atau sesudah PATH ke dalam pohon. DI MANA
harus 'sebelum' atau 'setelah'.

menyisipkan
Alias ​​​​dari in.

mv
Pindahkan node SRC ke DST. SRC harus cocok dengan tepat satu node di pohon. DST juga harus
cocok dengan tepat satu simpul di pohon, atau mungkin belum ada. Jika DST sudah ada, itu
dan semua turunannya dihapus. Jika DST belum ada, itu dan semua yang hilang
nenek moyang diciptakan.

pindah
Alias ​​​​dari mv.

cp
Salin simpul SRC ke DST. SRC harus cocok dengan tepat satu node di pohon. DST juga harus
cocok dengan tepat satu simpul di pohon, atau mungkin belum ada. Jika DST sudah ada, itu
dan semua turunannya dihapus. Jika DST belum ada, itu dan semua yang hilang
nenek moyang diciptakan.

salinan
Alias ​​​​dari cp.

mengubah nama
Ganti nama label semua node yang cocok dengan SRC menjadi LBL.

rm
Hapus PATH dan semua anaknya dari pohon

set
Kaitkan VALUE dengan PATH. Jika PATH belum ada di pohon, itu dan semua leluhurnya
akan dibuat.

setm [ ]
Atur beberapa node dalam satu operasi. Temukan atau buat simpul yang cocok dengan SUB dengan
menafsirkan SUB sebagai ekspresi jalur relatif terhadap setiap node BASE yang cocok. Jika SUB adalah
'.', node yang cocok dengan BASE akan dimodifikasi.

menyentuh
Buat PATH dengan nilai NULL jika belum ada di pohon. Semua leluhurnya akan
juga akan dibuat. Entri pohon baru ini akan muncul terakhir di antara saudara mereka.

PATH EKSPRESI PERINTAH
Perintah berikut membantu saat bekerja dengan ekspresi jalur.

defnode [ ]
Tentukan variabel NAME ke hasil evaluasi EXPR, yang harus berupa nodeset. Jika
belum ada node yang cocok dengan EXPR, satu dibuat dan NAME akan merujuknya. Jika NILAI
diberikan, ini sama dengan 'set EXPR VALUE'; jika VALUE tidak diberikan, simpulnya adalah
dibuat seolah-olah dengan 'clear EXPR' akan dan NAMA merujuk ke simpul itu.

defvar
Tentukan variabel NAME untuk hasil evaluasi EXPR. Variabel dapat digunakan dalam
ekspresi jalur sebagai $NAME. Perhatikan bahwa EXPR dievaluasi ketika variabel didefinisikan,
bukan saat digunakan.

LINGKUNGAN VARIABEL

AUGEAS_ROOT
Akar sistem file, defaultnya adalah '/'. Dapat ditimpa dengan -r command line
Option

AUGEAS_LENS_LIB
Daftar direktori yang dipisahkan titik dua dengan lensa. Direktori yang ditentukan di sini adalah
mencari direktori yang disetel dengan -I opsi baris perintah, tetapi sebelum
direktori default /usr/share/augeas/lensa dan /usr/share/augeas/lensa/dist

DIAGNOSTIK

Biasanya, status keluar adalah 0. Jika satu atau lebih perintah gagal, status keluar diatur ke non-
nilai nol.

Perhatikan bahwa kegagalan memuat beberapa file yang ditentukan oleh transformasi di
"/ augeas/load" tidak dianggap sebagai kegagalan. Jika penting untuk mengetahui bahwa semua file adalah
dimuat, Anda perlu mengeluarkan "kecocokan /augeas//error" setelah memuat untuk mengetahui detail tentang
file apa yang tidak dapat dimuat dan mengapa.

CONTOH

# mode baris perintah
augtool cetak /files/etc/hosts/

# mode interaktif
alat tambahan
alat bantu> bantuan
augtool> print /files/etc/hosts/

# Cetak entri ketiga dari baris AcceptEnv kedua
augtool print '/files/etc/ssh/sshd_config/AcceptEnv[2]/3'

# Temukan entri di inittab dengan tindakan 'initdefault'
augtool> cocokkan /files/etc/inittab/*/action initdefault

# Cetak alias terakhir untuk setiap entri di / Etc / hosts
augtool> print /files/etc/hosts/*/alias[last()]

Gunakan augtool online menggunakan layanan onworks.net