.\" Copyright 1991, Digital Equipment Corporation.
.\" Copyright 1991, 1994, 1998  The Open Group
.\"
.\" Permission to use, copy, modify, distribute, and sell this software and its
.\" documentation for any purpose is hereby granted without fee, provided that
.\" the above copyright notice appear in all copies and that both that
.\" copyright notice and this permission notice appear in supporting
.\" documentation.
.\"
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
.\" OTHER DEALINGS IN THE SOFTWARE.
.\"
.\" Except as contained in this notice, the name of The Open Group shall
.\" not be used in advertising or otherwise to promote the sale, use or
.\" other dealings in this Software without prior written authorization
.\" from The Open Group.
.\"
.TH XRDB 1 2025-04-06 "xrdb 1.2.3" "X Version 11"
.SH "نام (NAME)"
xrdb \- ابزار پایگاه‌داده منابع کارساز X
.SH "خلاصه دستور (SYNOPSIS)"
.B xrdb
[\fI\-option\fP ...] [\fIfilename\fP]
.SH "توضیحات (DESCRIPTION)"
.B Xrdb
برای دریافت یا تنظیم محتویات ویژگی \fBRESOURCE_MANAGER\fP در پنجره ریشه (root window) صفحه نمایش ۰، یا ویژگی \fBSCREEN_RESOURCES\fP در پنجره ریشه هر یک یا همه صفحه‌های نمایش، یا ترکیبی از همه آن‌ها به کار می‌رود.
به طور معمول این برنامه را از درون فایل راه‌اندازی X خود اجرا خواهید کرد.
.LP
بسیاری از کلاینت‌های X از ویژگی‌های \fBRESOURCE_MANAGER\fP و \fBSCREEN_RESOURCES\fP برای دریافت اولویت‌ها و تنظیمات دلخواه کاربر درباره رنگ، قلم‌ها و موارد دیگر برای برنامه‌ها استفاده می‌کنند.
قرار گرفتن این اطلاعات در کارساز (جایی که برای تمامی کلاینت‌ها در دسترس است) به جای ذخیره روی دیسک،
مشکل نسخه‌های پیشین X را حل می‌کند؛ در نسخه‌های پیشین کاربر مجبور بود فایل‌های \fIdefaults\fP را روی هر ماشینی که استفاده می‌کرد نگهداری کند.
این سازوکار همچنین امکان تغییر پویای پیش‌فرض‌ها را بدون نیاز به ویرایش فایل‌ها فراهم می‌سازد.
.LP
ویژگی \fBRESOURCE_MANAGER\fP برای منابعی به کار می‌رود که روی تمامی صفحه‌های نمایشگر اعمال می‌شوند.
ویژگی \fBSCREEN_RESOURCES\fP روی هر صفحه، منابع اضافی (یا بازنویسی‌کننده) را برای استفاده در آن صفحه مشخص می‌کند.
(هنگامی که تنها یک صفحه نمایش وجود دارد، معمولاً از \fBSCREEN_RESOURCES\fP استفاده نمی‌شود و همه منابع فقط در ویژگی \fBRESOURCE_MANAGER\fP قرار می‌گیرند.)
.LP
فایل مشخص‌شده با
.I filename
(یا محتوای ورودی استاندارد در صورتی که \fB\-\fP مشخص شده یا نام فایلی داده نشده باشد)
به صورت اختیاری با نمادهای تعریف‌شده زیر، بر اساس قابلیت‌های کارساز در حال استفاده، از پیش‌پردازنده C عبور داده می‌شود:
.TP 8
.B SERVERHOST=\fIhostname\fP
بخش نام میزبان (hostname) در نمایشگری که به آن متصل هستید.
.TP 8
.B SRVR_\fIname\fB
رشته نام میزبان SERVERHOST که به یک شناسه معتبر تبدیل شده است.
برای مثال، "my\-dpy.lcs.mit.edu" به \fBSRVR_my_dpy_lcs_mit_edu\fP تبدیل می‌شود.
.TP 8
.B HOST=\fIhostname\fP
مشابه
.BR SERVERHOST .
.TP 8
.B DISPLAY_NUM=\fInum\fP
شماره نمایشگر روی میزبان کارساز.
.TP 8
.B CLIENTHOST=\fIhostname\fP
نام میزبانی که
.B xrdb
روی آن در حال اجرا است.
.TP 8
.B CLNT_\fIname\fB
رشته نام میزبان CLIENTHOST که به یک شناسه معتبر تبدیل شده است.
برای مثال، "expo.lcs.mit.edu" به \fBCLNT_expo_lcs_mit_edu\fP تبدیل می‌شود.
.TP 8
.B RELEASE=\fInum\fP
شماره انتشار سازنده کارساز.
تفسیر این شماره بسته به مقدار \fBVENDOR\fP متغیر خواهد بود.
.TP 8
.B REVISION=\fInum\fP
نسخه فرعی (minor) پروتکل X که توسط این کارساز پشتیبانی می‌شود (در حال حاضر ۰).
.TP 8
.B VERSION=\fInum\fP
نسخه اصلی (major) پروتکل X که توسط این کارساز پشتیبانی می‌شود (همواره باید ۱۱ باشد).
.TP 8
.B VENDOR="\fIvendor\fP"
یک رشته صریح که سازنده یا ارائه‌دهنده کارساز را مشخص می‌کند.
.TP 8
.B VNDR_\fIname\fP
رشته نام \fBVENDOR\fP که به یک شناسه معتبر تبدیل شده است.
برای مثال، "The X.Org Foundation" به \fBVNDR_The_X_Org_Foundation\fP تبدیل می‌شود.
.TP 8
.B EXT_\fIname\fP
یک نماد برای هر افزونه پروتکل که توسط کارساز پشتیبانی می‌شود تعریف می‌شود.
نام رشته‌ای هر افزونه به یک شناسه معتبر تبدیل می‌شود.
برای مثال، "XC\-MISC" به \fBEXT_XC_MISC\fP تبدیل می‌شود.
.TP 8
.B NUM_SCREENS=\fInum\fP
تعداد کل صفحه‌ها.
.TP 8
.B SCREEN_NUM=\fInum\fP
شماره صفحه فعلی (شروع از صفر).
.TP 8
.B BITS_PER_RGB=\fInum\fP
تعداد بیت‌های باارزش در مشخصات رنگ RGB.
این مقدار، لگاریتم در مبنای ۲ از تعداد سایه‌های مجزایی است که سخت‌افزار می‌تواند برای هر رنگ پایه تولید کند.
توجه داشته باشید که این مقدار معمولاً به \fBPLANES\fP مرتبط نیست.
.TP 8
.B CLASS=\fIvisualclass\fP
یکی از مقادیر
.BR StaticGray "، " GrayScale "، " StaticColor ،
.BR PseudoColor "، " TrueColor " یا " DirectColor .
این مقدار، کلاس بصری (visual class) پنجره ریشه است.
.TP 8
.B CLASS_\fIvisualclass\fP=\fIvisualid\fP
کلاس بصری پنجره ریشه به قالبی که بتوانید روی آن دستور \fB#ifdef\fP را اعمال کنید.
این مقدار، شناسه عددی جلوه بصری است.
.TP 8
.B COLOR
تعریف می‌شود اگر، و تنها اگر، \fBCLASS\fP یکی از مقادیر
.BR StaticColor "، " PseudoColor "، " TrueColor " یا " DirectColor
باشد.
.TP 8
.B CLASS_\fIvisualclass\fP_\fIdepth\fP=\fInum\fP
یک نماد برای هر جلوه بصری پشتیبانی‌شده در صفحه تعریف می‌شود.
این نماد شامل کلاس جلوه بصری و عمق آن است؛
مقدار آن شناسه عددی جلوه بصری است.
(اگر بیش از یک جلوه بصری دارای کلاس و عمق یکسان باشند، شناسه عددی اولین موردی که توسط کارساز گزارش شده استفاده می‌شود.)
.TP 8
.B HEIGHT=\fInum\fP
ارتفاع پنجره ریشه بر حسب پیکسل.
.TP 8
.B WIDTH=\fInum\fP
عرض پنجره ریشه بر حسب پیکسل.
.TP 8
.B PLANES=\fInum\fP
تعداد صفحات بیتی (عمق) پنجره ریشه.
.TP 8
.B X_RESOLUTION=\fInum\fP
تفکیک‌پذیری افقی (x) صفحه بر حسب پیکسل بر متر.
.TP 8
.B Y_RESOLUTION=\fInum\fP
تفکیک‌پذیری عمودی (y) صفحه بر حسب پیکسل بر متر.
.LP
شناسه‌های
.BR SRVR_\fIname\fP "، " CLNT_\fIname\fP ،
.BR VNDR_\fIname\fP " و " EXT_\fIname\fP
با تبدیل تمامی نویسه‌های غیر از حروف و ارقام به خط زیر (_) تشکیل می‌شوند.
.LP
خطوطی که با علامت تعجب (!) آغاز می‌شوند نادیده گرفته شده و می‌توانند به عنوان یادداشت (کامنت) استفاده شوند.
.LP
توجه داشته باشید که از آنجا که
.B xrdb
می‌تواند از ورودی استاندارد بخواند، می‌توان از آن برای تغییر مستقیم محتوای ویژگی‌ها از یک ترمینال یا از درون یک اسکریپت شل استفاده کرد..SH "گزینه‌ها (OPTIONS)"
برنامهٔ
.B xrdb
گزینه‌های زیر را می‌پذیرد:
.TP 8
.B \-help
این گزینه (یا هر گزینهٔ پشتیبانی‌نشدهٔ دیگری) سبب می‌شود توضیح کوتاهی از گزینه‌ها و پارامترهای مجاز چاپ شود.
.TP 8
.B \-version
این گزینه سبب چاپ نسخهٔ xrdb و خروج برنامه بدون انجام هیچ عملیات دیگری می‌شود.
.TP 8
.B \-display \fIdisplay\fP
این گزینه کارساز X مورد استفاده را مشخص می‌کند؛ ببینید
.BR X (7).
همچنین صفحه‌نمایشی را که باید برای گزینهٔ \fB\-screen\fP استفاده شود، و صفحه‌نمایشی را که نمادهای پیش‌پردازنده برای گزینهٔ \fB\-global\fP از آن مشتق می‌شوند تعیین می‌کند.
.TP 8
.B \-all
این گزینه نشان می‌دهد که عملیات باید هم بر روی مشخصهٔ منبع مستقل از صفحه‌نمایش (\fBRESOURCE_MANAGER\fP) و هم بر روی مشخصهٔ ویژهٔ هر صفحه‌نمایش (\fBSCREEN_RESOURCES\fP) در تمامی صفحه‌نمایش‌های نمایشگر انجام شود.
برای نمونه، هنگام استفاده همراه با \fB\-query\fP، محتوای همهٔ مشخصه‌ها در خروجی نمایش داده می‌شود.
برای \fB\-load\fP، \fB\-override\fP، و \fB\-merge\fP، فایل ورودی برای هر صفحه‌نمایش یک‌بار پردازش می‌شود.
منابعی که در خروجی همهٔ صفحه‌نمایش‌ها مشترک هستند جمع‌آوری شده و به عنوان منابع مستقل از صفحه‌نمایش اعمال می‌شوند.
منابع باقی‌مانده برای مشخصهٔ مربوط به هر صفحه‌نمایش به طور جداگانه اعمال می‌گردند.
این حالت، حالت پیش‌فرضِ عملکرد برنامه است.
.TP 8
.B \-global
این گزینه نشان می‌دهد که عملیات باید تنها روی مشخصهٔ مستقل از صفحه‌نمایش \fBRESOURCE_MANAGER\fP انجام شود.
.TP 8
.B \-screen
این گزینه نشان می‌دهد که عملیات باید تنها روی مشخصهٔ \fBSCREEN_RESOURCES\fP مربوط به صفحه‌نمایش پیش‌فرض نمایشگر انجام شود.
.TP 8
.B \-screens
این گزینه نشان می‌دهد که عملیات باید روی مشخصهٔ \fBSCREEN_RESOURCES\fP برای هر یک از صفحه‌نمایش‌های نمایشگر انجام شود.
برای گزینه‌های \fB\-load\fP، \fB\-override\fP، و \fB\-merge\fP، فایل ورودی برای هر صفحه‌نمایش پردازش می‌شود.
.TP 8
.B \-n
این گزینه مشخص می‌کند تغییراتی که قرار است روی مشخصه‌های تعیین‌شده اعمال شوند (هنگام استفاده با \fB\-load\fP، \fB\-override\fP، یا \fB\-merge\fP) یا تغییراتی که روی فایل منابع اعمال می‌شوند (هنگام استفاده با \fB\-edit\fP) باید روی خروجی استاندارد نمایش داده شوند، اما در عمل اعمال نگردند.
.TP 8
.B \-quiet
این گزینه مشخص می‌کند هشدارهای مربوط به مدخل‌های تکراری نباید نمایش داده شوند.
.TP 8
.B \-cpp \fIfilename\fP
این گزینه مسیر فایل برنامهٔ پیش‌پردازندهٔ C مورد استفاده را مشخص می‌کند.
اگرچه
.B xrdb
برای استفاده از
.BR cpp (1)
طراحی شده است، هر برنامه‌ای که به عنوان یک فیلتر عمل کند و گزینه‌های
.BR \-D "، " \-I "، و " \-U
را بپذیرد نیز می‌تواند استفاده شود.
.TP 8
.B \-nocpp
این گزینه نشان می‌دهد که
.B xrdb
نباید فایل ورودی را پیش از بارگذاری در مشخصه‌ها، از درون یک پیش‌پردازنده عبور دهد.
.TP 8
.B \-undef
در صورت استفاده از پیش‌پردازندهٔ C، این گزینه به آن ارسال می‌شود.
این کار از تعریف پیش‌فرض هرگونه ماکروی خاص سیستم توسط پیش‌پردازنده جلوگیری می‌کند.
.TP 8
.B \-E
این گزینه نشان می‌دهد هر دستور cpp اجراشده و خروجی حاصل از آن باید روی خروجی استاندارد نمایش داده شوند.
اگر \fB\-nocpp\fP نیز مشخص شده باشد، فایل ورودی دقیقاً به همان صورت که خوانده شده نشان داده خواهد شد.
تغییرات مشخص‌شده نیز اعمال خواهند شد، مگر اینکه گزینهٔ \fB\-n\fP نیز مشخص شده باشد.
.TP 8
.B \-symbols
این گزینه نشان می‌دهد نمادهایی که برای پیش‌پردازنده تعریف شده‌اند باید روی خروجی استاندارد چاپ شوند.
.TP 8
.B \-query
این گزینه نشان می‌دهد محتوای کنونی مشخصه‌های تعیین‌شده باید روی خروجی استاندارد چاپ شود.
توجه داشته باشید از آنجا که دستورهای پیش‌پردازنده در فایل منبع ورودی جزئی از فایل ورودی هستند و نه جزئی از مشخصه، در خروجی این گزینه نشان داده نخواهند شد.
گزینهٔ
.B \-edit
می‌تواند برای ادغام مجدد محتوای مشخصه‌ها در فایل منبع ورودی بدون آسیب رساندن به دستورهای پیش‌پردازنده استفاده شود.
.TP 8
.B \-get \fIname\fP
این گزینه مشخص می‌کند محتوای کنونی مشخصهٔ منطبق با \fIname\fP باید روی خروجی استاندارد چاپ شود.
.TP 8
.B \-load
این گزینه نشان می‌دهد که ورودی باید به عنوان مقدار جدید مشخصه‌های تعیین‌شده بارگذاری شود و جایگزین هر آنچه قبلاً بوده گردد (یعنی محتویات قبلی حذف می‌شوند).
این کنش، رفتار پیش‌فرض است.
.TP 8
.B \-override
این گزینه مشخص می‌کند ورودی باید به محتوای کنونی مشخصه‌های تعیین‌شده افزوده شود، نه اینکه جایگزین آن‌ها گردد.
مدخل‌های جدید بر مدخل‌های پیشین اولویت خواهند داشت (آن‌ها را بازنویسی می‌کنند).
.TP 8
.B \-merge
این گزینه مشخص می‌کند ورودی باید با محتوای کنونی مشخصه‌های تعیین‌شده ادغام شده و بر اساس الفبا مرتب شود، به جای آنکه جایگزین آن‌ها گردد.
.TP 8
.B \-remove
این گزینه مشخص می‌کند مشخصه‌های تعیین‌شده باید از روی کارساز حذف شوند.
.TP 8
.B \-retain
این گزینه مشخص می‌کند اگر \fBxrdb\fP نخستین کلاینت باشد، باید به کارساز اعلام شود که بازنشانی (reset) نگردد.
در شرایط عادی هرگز نیازی به این گزینه نخواهد بود، زیرا
.BR xdm (1)
و
.BR xinit (1)
همواره به عنوان کلاینت نخست عمل می‌کنند.
.TP 8
.B \-edit \fIfilename\fP
این گزینه مشخص می‌کند که محتوای مشخصه‌های تعیین‌شده باید درون فایل ارائه‌شده ویرایش و درج شود، و جایگزین هر مقداری گردد که پیش‌تر در آنجا فهرست شده است.
این قابلیت به شما امکان می‌دهد تغییراتی را که در مقادیر پیش‌فرض خود اعمال کرده‌اید با حفظ توضیحات و خطوط پیش‌پردازنده، مجدداً به فایل منابع خود بازگردانید.
.TP 8
.B \-backup \fIstring\fP
این گزینه پسوندی را مشخص می‌کند که برای ایجاد یک فایل پشتیبان، به انتهای نام فایل استفاده‌شده با
.B \-edit
افزوده می‌شود.
.TP 8
.B \-D\fIname[=value]\fP
این گزینه مستقیماً به پیش‌پردازنده ارسال می‌شود و برای تعریف نمادها جهت استفاده در عبارات شرطی مانند
.BR #ifdef
به کار می‌رود.
.TP 8
.B \-U\fIname\fP
این گزینه به پیش‌پردازنده ارسال می‌شود و برای حذف هرگونه تعریف موجود از این نماد به کار می‌رود.
.TP 8
.B \-I\fIdirectory\fP
این گزینه به پیش‌پردازنده ارسال می‌شود و برای تعیین دایرکتوری مورد جستجو جهت یافتن فایل‌هایی که با
.BR #include
ارجاع داده شده‌اند، به کار می‌رود..SH "فایل‌ها (FILES)"
.B Xrdb
به خودی خود هیچ فایلی را بارگذاری نمی‌کند، اما بسیاری از محیط‌های رومیزی از
.B xrdb
برای بارگذاری فایل‌های \fB~/.Xresources\fP هنگام راه‌اندازی نشست، جهت مقداردهی اولیه
پایگاه‌داده منابع،
به‌عنوان یک جایگزین تعمیم‌یافته برای فایل‌های \fB~/.Xdefaults\fP استفاده می‌کنند.
.SH "همچنین ببینید (SEE ALSO)"
.BR X (7),
.BR appres (1),
.BR listres (1),
.BR xdpyinfo (1),
مستندات Xlib Resource Manager،
مستندات منابع Xt
.SH "محیط (ENVIRONMENT)"
.TP 8
.B DISPLAY
برای تعیین اینکه از کدام نمایشگر استفاده شود.
.SH "گزارش باگ‌ها (BUGS)"
رفتار پیش‌فرض در صورت نبود آرگومان باید پرس‌وجو (query) باشد نه رونویسی (overwrite)، تا با سایر برنامه‌ها سازگار باشد.
.SH "نویسندگان (AUTHORS)"
Bob Scheifler, Phil Karlton، بازنویسی‌شده از نسخه اصلی توسط Jim Gettys