خروجی عبارت باقاعده (Regexp output)

به‌طور پیش‌فرض augprint عبارت‌های مسیری تولید می‌کند که از مقایسه‌های برابری ساده "=" تشکیل شده‌اند:

set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/ipaddr '127.0.0.1'

گزینه --regexp خروجی را به گونه‌ای تغییر می‌دهد که مقایسه‌های مبتنی بر عبارت‌های باقاعده تولید کند:

set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\.0\\..*')]/ipaddr '127.0.0.1'

حداقل طول N عبارت باقاعده را می‌توان با "--regexp=N" مشخص کرد.

اگر با عبارت باقاعده N نویسه‌ای چند مقدار مختلف مطابقت پیدا کنند، augprint عبارت باقاعده طولانی‌تری از N را انتخاب خواهد کرد.

محدودیت‌ها (Limitations)

تنها پیوست‌شدن (Append-only)

خروجی عمدتاً بر پایه عملیات‌های set استوار است. عملیات set تنها می‌تواند:

الف) مقدار موجود را در همان جای خود تغییر دهد

ب) یک مقدار جدید را پس از آخرین موقعیت در گروه اضافه کند

این بدان معنی است که در صورت بازتولید یک مدخل، ممکن است در همان موقعیت مدنظر اولیه قرار نگیرد. به عنوان مثال، اگر مدخل مربوط به 192.0.2.3 از قبل وجود نداشته باشد، به عنوان آخرین مدخل در /etc/hosts ایجاد خواهد شد.

اغلب، چنین ردیف‌های خارج از ترتیبی تأثیری در کارایی پرونده پیکربندی حاصل ندارند. اگر ترتیب اهمیت داشته باشد، ویرایش دستی اسکریپت "augtool" مورد نیاز خواهد بود.

مقادیر تکراری (Repeated Values)

دستور augprint همیشه در یافتن عبارت مسیر یکتا برای یک موقعیت موفق نمی‌شود. در این صورت augprint موقعیت ترتیبی را به عبارتی که یکتا نیست اضافه می‌کند.

این حالت به ویژه زمانی رخ می‌دهد که مقادیر تکراری در پرونده وجود داشته باشد.

برای پرونده /etc/hosts شامل:

#------
192.0.2.3   defaultdns
#------

دستور augprint خروجی زیر را تولید می‌کند:

set /files/etc/hosts/#comment[.='--------'][1] '--------'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.3']/ipaddr '192.0.2.3'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.3']/canonical 'defaultdns'
set /files/etc/hosts/#comment[.='--------'][2] '--------'

دقت کنید که چگونه به مسیرهای "#comment" به ترتیب "[1]" و "[2]" بعد از "[expr]" اضافه شده است.

سایر مسیرهایی که عبارت‌های یکتا دارند مستقیماً تحت تأثیر قرار نمی‌گیرند.

خروجی پیش‌فرض (Default output)

"augprint /etc/hosts"

set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/ipaddr '127.0.0.1'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/canonical 'localhost'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/alias[.='localhost.localdomain'] 'localhost.localdomain'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/alias[.='localhost4'] 'localhost4'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/alias[.='localhost4.localdomain4'] 'localhost4.localdomain4'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.3']/ipaddr '192.0.2.3'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.3']/canonical 'dns-a'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.4']/ipaddr '192.0.2.4'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.4']/canonical 'dns-b'

خروجی مشروح (Verbose output)

"augprint --verbose /etc/hosts";

#   /files/etc/hosts
#   /files/etc/hosts/1
#   /files/etc/hosts/1/ipaddr  '127.0.0.1'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/ipaddr '127.0.0.1'
#   /files/etc/hosts/1/canonical  'localhost'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/canonical 'localhost'
#   /files/etc/hosts/1/alias[1]  'localhost.localdomain'
set /files/etc/hosts/seq::*[ipaddr='127.0.0.1']/alias[.='localhost.localdomain'] 'localhost.localdomain'
...

خروجی عبارت باقاعده (Rexexp output)

"augprint --regexp=4 /etc/hosts";

set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\..*')]/ipaddr '127.0.0.1'
set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\..*')]/canonical 'localhost'
set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\..*')]/alias[.=~regexp('localhost\\..*')] 'localhost.localdomain'
set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\..*')]/alias[.=~regexp('localhost4')] 'localhost4'
set /files/etc/hosts/seq::*[ipaddr=~regexp('127\\..*')]/alias[.=~regexp('localhost4\\..*')] 'localhost4.localdomain4'
set /files/etc/hosts/seq::*[ipaddr=~regexp('192\\.0\\.2\\.3')]/ipaddr '192.0.2.3'
set /files/etc/hosts/seq::*[ipaddr=~regexp('192\\.0\\.2\\.3')]/canonical 'dns-a'
set /files/etc/hosts/seq::*[ipaddr=~regexp('192\\.0\\.2\\.4')]/ipaddr '192.0.2.4'
set /files/etc/hosts/seq::*[ipaddr=~regexp('192\\.0\\.2\\.4')]/canonical 'dns-b'

توجه داشته باشید که گرچه حداقل طول ۴ تعیین شده است، اما augprint در صورت لزوم عبارات باقاعده طولانی‌تری را برای اطمینان از تطبیق یکتا انتخاب خواهد کرد.

استفاده از --lens (Using --lens)

اگر پرونده‌ای به‌طور پیش‌فرض به لنزی متصل نشده باشد، می‌توان از --lens lensname برای تعیین یک لنز استفاده کرد.

هنگامی که --lens مشخص شود، خروجی با دستورات مناسب "transform" و "load-file" پیشوندگذاری می‌شود تا اسکریپت augtool تکمیل شود، و همچنین یک دستور setm برای مستثنی کردن سایر لنزهای بارگذاری خودکار درج می‌گردد.

"augprint --lens shellvars /etc/skel/.bashrc";

setm /augeas/load/*[incl='/etc/skel/.bashrc' and label() != 'shellvars']/excl '/etc/skel/.bashrc'
transform shellvars incl /etc/skel/.bashrc
load-file /etc/skel/.bashrc
set /files/etc/skel/.bashrc/#comment[.='.bashrc'] '.bashrc'
set /files/etc/skel/.bashrc/#comment[.='Source global definitions'] 'Source global definitions'
set /files/etc/skel/.bashrc/@if[.='[ -f /etc/bashrc ]'] '[ -f /etc/bashrc ]'
set /files/etc/skel/.bashrc/@if[.='[ -f /etc/bashrc ]']/.source '/etc/bashrc'
set /files/etc/skel/.bashrc/#comment[.='User specific environment'] 'User specific environment'
...

لنزهای "simplelines" و "shellvars" معمولاً برای پرونده‌هایی که لنز اختصاصی ندارند بسیار مفیدند.

استفاده از --target (Using --target)

به منظور آماده‌سازی اسکریپت augtool برای یک پرونده خاص، ممکن است ترجیح داده شود به جای ویرایش پرونده اصلی، آن را در مکان دیگری کپی کرد.

گزینه --target این فرایند را ساده می‌سازد:

الف) کپی کردن /etc/hosts به یک مکان جدید

cp /etc/hosts ~

ب) ویرایش پرونده ~/hosts بر اساس نیاز

echo '192.0.2.7   defaultdns' >> ~/hosts

ج) اجرای "augprint" به صورت زیر

augprint --target /etc/hosts ~/hosts

د) رونوشت از بخش مرتبط خروجی و انتقال آن به اسکریپت augtool یا سایر کلاینت‌های Augeas

set /files/etc/hosts/seq::*[ipaddr='192.0.2.7']/ipaddr '192.0.2.7'
set /files/etc/hosts/seq::*[ipaddr='192.0.2.7']/canonical 'defaultdns'

توجه کنید که "augprint" مسیرها را متناظر با --target (/etc/hosts) تولید کرده است به جای آرگومان FILE (~/hosts).