DCONF(1) User Commands DCONF(1)

dconf - ابزاری ساده برای کار با پایگاه‌داده dconf

dconf read [-d] KEY

dconf list DIR

dconf write KEY VALUE

dconf reset [-f] PATH

dconf compile OUTPUT KEYFILEDIR

dconf update [DBDIR]

dconf watch PATH

dconf dump DIR

dconf load [-f] DIR

dconf help [COMMAND]

برنامه dconf می‌تواند عملیات گوناگونی را روی پایگاه‌داده dconf انجام دهد؛ از جمله خواندن یا نوشتن مقادیر منفرد یا کل دایرکتوری‌ها. این ابزار مستقیماً روی dconf عمل می‌کند، بدون اینکه از اطلاعات شِمای gsettings استفاده کند. بنابراین، نمی‌تواند بررسی نوع و سازگاری مقادیر را انجام دهد. در صورتی که به چنین بررسی‌هایی نیاز باشد، ابزار gsettings(1) یک جایگزین مناسب است.

آرگومان‌های DIR باید مسیرهای دایرکتوری باشند (که با '/' شروع و پایان می‌یابند)، آرگومان‌های KEY باید مسیرهای کلید باشند (که با '/' شروع می‌شوند اما پایان نمی‌یابند) و آرگومان‌های PATH می‌توانند مسیر دایرکتوری یا کلید باشند.

آرگومان OUTPUT باید مکانی برای نوشتن پایگاه‌داده (باینری) dconf باشد و آرگومان KEYFILEDIR باید دایرکتوری دارای پسوند d. شامل فایل‌های کلید باشد.

آرگومان‌های VALUE باید در قالب GVariant باشند؛ بنابراین برای مثال یک رشته باید نقل‌قول‌های صریح داشته باشد: "'foo'". این قالب هنگام چاپ مقادیر نیز استفاده می‌شود.

توجه داشته باشید که dconf برای نوشتن تغییرات در پایگاه‌داده dconf به یک اتصال گذرگاه نشست D-Bus نیاز دارد.

read

خواندن مقدار یک کلید. از -d برای چاپ مقدار پیش‌فرض به جای مقدار تنظیم‌شده توسط کاربر استفاده کنید.

list

فهرست کردن زیرکلیدها و زیردایرکتوری‌های یک دایرکتوری.

write

نوشتن یک مقدار جدید در یک کلید.

reset

بازنشانی یک کلید یا یک دایرکتوری کامل. برای دایرکتوری‌ها، باید -f مشخص شود.

compile

کامپایل کردن یک پایگاه‌داده باینری از روی فایل‌های کلید.

نتیجه همیشه به ترتیب بایت little-endian است، بنابراین می‌توان آن را با خیال راحت در 'share' نصب کرد. اگر روی ماشینی با ترتیب big endian استفاده شود، dconf هنگام خواندن به طور خودکار ترتیب بایت‌ها را جابه‌جا می‌کند.

update

به‌روزرسانی پایگاه‌های داده سیستمی dconf.

watch

پایش یک کلید یا دایرکتوری برای تغییرات.

dump

استخراج یک زیرمسیر کامل در خروجی استاندارد (stdout). خروجی در قالبی شبیه به keyfile و مقادیر در نحو GVariant هستند.

load

پر کردن یک زیرمسیر از ورودی استاندارد (stdin). قالب مورد انتظار همانند خروجی تولید شده توسط dump است. تلاش برای تغییر کلیدهای غیرقابل‌نوشتن دستور load را لغو می‌کند. برای نادیده گرفتن تغییرات این کلیدها به جای لغو، از -f استفاده کنید.

help

نمایش راهنما و خروج. اگر COMMAND مشخص شده باشد، راهنمای مربوط به آن دستور نمایش داده می‌شود.

DCONF_PROFILE

این متغیر محیطی تعیین می‌کند که از کدام پروفایل dconf استفاده شود. به dconf(7) مراجعه کنید.

dconf(7), gsettings(1), dconf-editor(1)

dconf