'\" t
.\"     Title: dconf
.\"    Author: Ryan Lortie <desrt@desrt.ca>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 09/15/2025
.\"    Manual: User Commands
.\"    Source: dconf
.\"  Language: Persian
.\"
.TH "DCONF" "1" "" "dconf" "User Commands"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
dconf \- ابزاری ساده برای کار با پایگاه‌داده dconf
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR read [\-d] \fIKEY\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR list \fIDIR\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR write \fIKEY\fR \fIVALUE\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR reset [\-f] \fIPATH\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR compile \fIOUTPUT\fR \fIKEYFILEDIR\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR update [\fIDBDIR\fR]
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR watch \fIPATH\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR dump \fIDIR\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR load [\-f] \fIDIR\fR
.HP \w'\fBdconf\fR\ 'u
\fBdconf\fR help [\fICOMMAND\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
\fBdconf\fR
می‌تواند عملیات گوناگونی را روی پایگاه‌داده dconf انجام دهد؛ از جمله خواندن یا نوشتن مقادیر منفرد یا کل دایرکتوری‌ها\&. این ابزار مستقیماً روی dconf عمل می‌کند، بدون اینکه از اطلاعات شِمای gsettings استفاده کند\&. بنابراین، نمی‌تواند بررسی نوع و سازگاری مقادیر را انجام دهد\&. در صورتی که به چنین بررسی‌هایی نیاز باشد، ابزار
\fBgsettings\fR(1)
یک جایگزین مناسب است\&.
.PP
آرگومان‌های
\fIDIR\fR
باید مسیرهای دایرکتوری باشند (که با \*(Aq/\*(Aq شروع و پایان می‌یابند)، آرگومان‌های
\fIKEY\fR
باید مسیرهای کلید باشند (که با \*(Aq/\*(Aq شروع می‌شوند اما پایان نمی‌یابند) و آرگومان‌های
\fIPATH\fR
می‌توانند مسیر دایرکتوری یا کلید باشند\&.
.PP
آرگومان
\fIOUTPUT\fR
باید مکانی برای نوشتن پایگاه‌داده (باینری) dconf باشد و آرگومان
\fIKEYFILEDIR\fR
باید دایرکتوری دارای پسوند d.\& شامل فایل‌های کلید باشد\&.
.PP
آرگومان‌های
\fIVALUE\fR
باید در قالب GVariant باشند؛ بنابراین برای مثال یک رشته باید نقل‌قول‌های صریح داشته باشد: "\*(Aqfoo\*(Aq"\&. این قالب هنگام چاپ مقادیر نیز استفاده می‌شود\&.
.PP
توجه داشته باشید که dconf برای نوشتن تغییرات در پایگاه‌داده dconf به یک اتصال گذرگاه نشست D\-Bus نیاز دارد\&.
.SH "دستورات (COMMANDS)"
.PP
\fBread\fR
.RS 4
خواندن مقدار یک کلید\&. از
\fB\-d\fR
برای چاپ مقدار پیش‌فرض به جای مقدار تنظیم‌شده توسط کاربر استفاده کنید\&.
.RE
.PP
\fBlist\fR
.RS 4
فهرست کردن زیرکلیدها و زیردایرکتوری‌های یک دایرکتوری\&.
.RE
.PP
\fBwrite\fR
.RS 4
نوشتن یک مقدار جدید در یک کلید\&.
.RE
.PP
\fBreset\fR
.RS 4
بازنشانی یک کلید یا یک دایرکتوری کامل\&. برای دایرکتوری‌ها، باید
\fB\-f\fR
مشخص شود\&.
.RE
.PP
\fBcompile\fR
.RS 4
کامپایل کردن یک پایگاه‌داده باینری از روی فایل‌های کلید\&.
.sp
نتیجه همیشه به ترتیب بایت little\-endian است، بنابراین می‌توان آن را با خیال راحت در \*(Aqshare\*(Aq نصب کرد\&. اگر روی ماشینی با ترتیب big endian استفاده شود، dconf هنگام خواندن به طور خودکار ترتیب بایت‌ها را جابه‌جا می‌کند\&.
.RE
.PP
\fBupdate\fR
.RS 4
به‌روزرسانی پایگاه‌های داده سیستمی dconf\&.
.RE
.PP
\fBwatch\fR
.RS 4
پایش یک کلید یا دایرکتوری برای تغییرات\&.
.RE
.PP
\fBdump\fR
.RS 4
استخراج یک زیرمسیر کامل در خروجی استاندارد (stdout)\&. خروجی در قالبی شبیه به keyfile و مقادیر در نحو GVariant هستند\&.
.RE
.PP
\fBload\fR
.RS 4
پر کردن یک زیرمسیر از ورودی استاندارد (stdin)\&. قالب مورد انتظار همانند خروجی تولید شده توسط
\fBdump\fR
است\&. تلاش برای تغییر کلیدهای غیرقابل‌نوشتن دستور load را لغو می‌کند\&. برای نادیده گرفتن تغییرات این کلیدها به جای لغو، از
\fB\-f\fR
استفاده کنید\&.
.RE
.PP
\fBhelp\fR
.RS 4
نمایش راهنما و خروج\&. اگر
\fICOMMAND\fR
مشخص شده باشد، راهنمای مربوط به آن دستور نمایش داده می‌شود\&.
.RE
.SH "متغیرهای محیطی (ENVIRONMENT)"
.PP
\fBDCONF_PROFILE\fR
.RS 4
این متغیر محیطی تعیین می‌کند که از کدام پروفایل dconf استفاده شود\&. به
\fBdconf\fR(7)
مراجعه کنید\&.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBdconf\fR(7),
\fBgsettings\fR(1),
\fBdconf-editor\fR(1)