gsettings(1) General Commands Manual gsettings(1)

gsettings - ابزار خط فرمانی مدیریت و پیکربندی تنظیمات GSettings

gsettings get SCHEMA[:PATH] KEY
gsettings monitor SCHEMA[:PATH] KEY
gsettings writable SCHEMA[:PATH] KEY
gsettings range SCHEMA[:PATH] KEY
gsettings describe SCHEMA[:PATH] KEY
gsettings set SCHEMA[:PATH] KEY VALUE
gsettings reset SCHEMA[:PATH] KEY
gsettings reset-recursively SCHEMA[:PATH]
gsettings list-schemas [--print-paths]
gsettings list-relocatable-schemas
gsettings list-keys SCHEMA[:PATH]
gsettings list-children SCHEMA[:PATH]
gsettings list-recursively [SCHEMA[:PATH]]
gsettings help [COMMAND]

برنامه gsettings یک رابط خط فرمانی ساده برای GSettings فراهم می‌کند. این ابزار به شما امکان می‌دهد تا مقادیر یک کلید مشخص را دریافت، تنظیم کرده یا تغییرات آن را پایش کنید.

آرگومان‌های SCHEMA و KEY برای اکثر دستورات جهت تعیین شناسه شِما و نام کلید مورد نظر الزامی هستند. شناسه شِما می‌تواند به صورت اختیاری دارای پسوند :PATH باشد. مشخص کردن مسیر تنها زمانی لازم است که شِما مسیر ثابتی نداشته باشد.

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

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

get

مقدار KEY را دریافت می‌کند. مقدار به صورت یک GVariant سریال‌سازی‌شده در خروجی چاپ می‌شود.

monitor

تغییرات KEY را پایش کرده و مقادیر تغییر‌یافته را چاپ می‌کند. اگر هیچ KEY مشخص نشود، تمام کلیدهای درون شِما پایش می‌شوند. پایش تا زمانی که فرآیند متوقف شود ادامه خواهد داشت.

writable

بررسی می‌کند که آیا KEY قابل نوشتن است یا خیر.

range

محدوده مقادیر معتبر برای KEY را استعلام می‌کند.

describe

توضیحات مربوط به مقادیر معتبر برای KEY را استعلام می‌کند.

set

مقدار KEY را روی VALUE تنظیم می‌کند. مقدار باید به صورت یک GVariant سریال‌سازی‌شده مشخص شود.

reset

مقدار KEY را به مقدار پیش‌فرض آن بازنشانی می‌کند.

reset-recursively

تمام کلیدهای موجود در SCHEMA داده‌شده را بازنشانی می‌کند.

list-schemas

شِماهای نصب‌شده و غیرقابل‌جابه‌جایی را فهرست می‌کند. در صورتی که به شِماهای قابل‌جابه‌جایی علاقه‌مند هستید، list-relocatable-schemas را ببینید. اگر --print-paths مشخص شده باشد، مسیری که هر شِما به آن نگاشت شده است نیز چاپ می‌شود.

list-relocatable-schemas

شِماهای نصب‌شده و قابل‌جابه‌جایی را فهرست می‌کند. در صورتی که به شِماهای غیرقابل‌جابه‌جایی علاقه‌مند هستید، list-schemas را ببینید.

list-keys

کلیدهای موجود در SCHEMA را فهرست می‌کند.

list-children

فرزندان SCHEMA را فهرست می‌کند.

list-recursively

کلیدها و مقادیر را به صورت بازگشتی فهرست می‌کند. اگر هیچ SCHEMA مشخص نشده باشد، کلیدها در تمامی شِماها فهرست می‌شوند.

help

پیام راهنما را چاپ کرده و خارج می‌شود.

dconf(1), dconf-editor(1)