XRDB(1) X Version 11 XRDB(1)

xrdb - ابزار پایگاه‌داده منابع کارساز X

xrdb [-option ...] [filename]

Xrdb برای دریافت یا تنظیم محتویات ویژگی RESOURCE_MANAGER در پنجره ریشه (root window) صفحه نمایش ۰، یا ویژگی SCREEN_RESOURCES در پنجره ریشه هر یک یا همه صفحه‌های نمایش، یا ترکیبی از همه آن‌ها به کار می‌رود. به طور معمول این برنامه را از درون فایل راه‌اندازی X خود اجرا خواهید کرد.

بسیاری از کلاینت‌های X از ویژگی‌های RESOURCE_MANAGER و SCREEN_RESOURCES برای دریافت اولویت‌ها و تنظیمات دلخواه کاربر درباره رنگ، قلم‌ها و موارد دیگر برای برنامه‌ها استفاده می‌کنند. قرار گرفتن این اطلاعات در کارساز (جایی که برای تمامی کلاینت‌ها در دسترس است) به جای ذخیره روی دیسک، مشکل نسخه‌های پیشین X را حل می‌کند؛ در نسخه‌های پیشین کاربر مجبور بود فایل‌های defaults را روی هر ماشینی که استفاده می‌کرد نگهداری کند. این سازوکار همچنین امکان تغییر پویای پیش‌فرض‌ها را بدون نیاز به ویرایش فایل‌ها فراهم می‌سازد.

ویژگی RESOURCE_MANAGER برای منابعی به کار می‌رود که روی تمامی صفحه‌های نمایشگر اعمال می‌شوند. ویژگی SCREEN_RESOURCES روی هر صفحه، منابع اضافی (یا بازنویسی‌کننده) را برای استفاده در آن صفحه مشخص می‌کند. (هنگامی که تنها یک صفحه نمایش وجود دارد، معمولاً از SCREEN_RESOURCES استفاده نمی‌شود و همه منابع فقط در ویژگی RESOURCE_MANAGER قرار می‌گیرند.)

فایل مشخص‌شده با filename (یا محتوای ورودی استاندارد در صورتی که - مشخص شده یا نام فایلی داده نشده باشد) به صورت اختیاری با نمادهای تعریف‌شده زیر، بر اساس قابلیت‌های کارساز در حال استفاده، از پیش‌پردازنده C عبور داده می‌شود:

بخش نام میزبان (hostname) در نمایشگری که به آن متصل هستید.
رشته نام میزبان SERVERHOST که به یک شناسه معتبر تبدیل شده است. برای مثال، "my-dpy.lcs.mit.edu" به SRVR_my_dpy_lcs_mit_edu تبدیل می‌شود.
مشابه SERVERHOST.
شماره نمایشگر روی میزبان کارساز.
نام میزبانی که xrdb روی آن در حال اجرا است.
رشته نام میزبان CLIENTHOST که به یک شناسه معتبر تبدیل شده است. برای مثال، "expo.lcs.mit.edu" به CLNT_expo_lcs_mit_edu تبدیل می‌شود.
شماره انتشار سازنده کارساز. تفسیر این شماره بسته به مقدار VENDOR متغیر خواهد بود.
نسخه فرعی (minor) پروتکل X که توسط این کارساز پشتیبانی می‌شود (در حال حاضر ۰).
نسخه اصلی (major) پروتکل X که توسط این کارساز پشتیبانی می‌شود (همواره باید ۱۱ باشد).
یک رشته صریح که سازنده یا ارائه‌دهنده کارساز را مشخص می‌کند.
رشته نام VENDOR که به یک شناسه معتبر تبدیل شده است. برای مثال، "The X.Org Foundation" به VNDR_The_X_Org_Foundation تبدیل می‌شود.
یک نماد برای هر افزونه پروتکل که توسط کارساز پشتیبانی می‌شود تعریف می‌شود. نام رشته‌ای هر افزونه به یک شناسه معتبر تبدیل می‌شود. برای مثال، "XC-MISC" به EXT_XC_MISC تبدیل می‌شود.
تعداد کل صفحه‌ها.
شماره صفحه فعلی (شروع از صفر).
تعداد بیت‌های باارزش در مشخصات رنگ RGB. این مقدار، لگاریتم در مبنای ۲ از تعداد سایه‌های مجزایی است که سخت‌افزار می‌تواند برای هر رنگ پایه تولید کند. توجه داشته باشید که این مقدار معمولاً به PLANES مرتبط نیست.
یکی از مقادیر StaticGray، GrayScale، StaticColor، PseudoColor، TrueColor یا DirectColor. این مقدار، کلاس بصری (visual class) پنجره ریشه است.
کلاس بصری پنجره ریشه به قالبی که بتوانید روی آن دستور #ifdef را اعمال کنید. این مقدار، شناسه عددی جلوه بصری است.
تعریف می‌شود اگر، و تنها اگر، CLASS یکی از مقادیر StaticColor، PseudoColor، TrueColor یا DirectColor باشد.
یک نماد برای هر جلوه بصری پشتیبانی‌شده در صفحه تعریف می‌شود. این نماد شامل کلاس جلوه بصری و عمق آن است؛ مقدار آن شناسه عددی جلوه بصری است. (اگر بیش از یک جلوه بصری دارای کلاس و عمق یکسان باشند، شناسه عددی اولین موردی که توسط کارساز گزارش شده استفاده می‌شود.)
ارتفاع پنجره ریشه بر حسب پیکسل.
عرض پنجره ریشه بر حسب پیکسل.
تعداد صفحات بیتی (عمق) پنجره ریشه.
تفکیک‌پذیری افقی (x) صفحه بر حسب پیکسل بر متر.
تفکیک‌پذیری عمودی (y) صفحه بر حسب پیکسل بر متر.

شناسه‌های SRVR_name، CLNT_name، VNDR_name و EXT_name با تبدیل تمامی نویسه‌های غیر از حروف و ارقام به خط زیر (_) تشکیل می‌شوند.

خطوطی که با علامت تعجب (!) آغاز می‌شوند نادیده گرفته شده و می‌توانند به عنوان یادداشت (کامنت) استفاده شوند.

توجه داشته باشید که از آنجا که xrdb می‌تواند از ورودی استاندارد بخواند، می‌توان از آن برای تغییر مستقیم محتوای ویژگی‌ها از یک ترمینال یا از درون یک اسکریپت شل استفاده کرد..SH "گزینه‌ها (OPTIONS)" برنامهٔ xrdb گزینه‌های زیر را می‌پذیرد:

این گزینه (یا هر گزینهٔ پشتیبانی‌نشدهٔ دیگری) سبب می‌شود توضیح کوتاهی از گزینه‌ها و پارامترهای مجاز چاپ شود.
این گزینه سبب چاپ نسخهٔ xrdb و خروج برنامه بدون انجام هیچ عملیات دیگری می‌شود.
این گزینه کارساز X مورد استفاده را مشخص می‌کند؛ ببینید X(7). همچنین صفحه‌نمایشی را که باید برای گزینهٔ -screen استفاده شود، و صفحه‌نمایشی را که نمادهای پیش‌پردازنده برای گزینهٔ -global از آن مشتق می‌شوند تعیین می‌کند.
این گزینه نشان می‌دهد که عملیات باید هم بر روی مشخصهٔ منبع مستقل از صفحه‌نمایش (RESOURCE_MANAGER) و هم بر روی مشخصهٔ ویژهٔ هر صفحه‌نمایش (SCREEN_RESOURCES) در تمامی صفحه‌نمایش‌های نمایشگر انجام شود. برای نمونه، هنگام استفاده همراه با -query، محتوای همهٔ مشخصه‌ها در خروجی نمایش داده می‌شود. برای -load، -override، و -merge، فایل ورودی برای هر صفحه‌نمایش یک‌بار پردازش می‌شود. منابعی که در خروجی همهٔ صفحه‌نمایش‌ها مشترک هستند جمع‌آوری شده و به عنوان منابع مستقل از صفحه‌نمایش اعمال می‌شوند. منابع باقی‌مانده برای مشخصهٔ مربوط به هر صفحه‌نمایش به طور جداگانه اعمال می‌گردند. این حالت، حالت پیش‌فرضِ عملکرد برنامه است.
این گزینه نشان می‌دهد که عملیات باید تنها روی مشخصهٔ مستقل از صفحه‌نمایش RESOURCE_MANAGER انجام شود.
این گزینه نشان می‌دهد که عملیات باید تنها روی مشخصهٔ SCREEN_RESOURCES مربوط به صفحه‌نمایش پیش‌فرض نمایشگر انجام شود.
این گزینه نشان می‌دهد که عملیات باید روی مشخصهٔ SCREEN_RESOURCES برای هر یک از صفحه‌نمایش‌های نمایشگر انجام شود. برای گزینه‌های -load، -override، و -merge، فایل ورودی برای هر صفحه‌نمایش پردازش می‌شود.
این گزینه مشخص می‌کند تغییراتی که قرار است روی مشخصه‌های تعیین‌شده اعمال شوند (هنگام استفاده با -load، -override، یا -merge) یا تغییراتی که روی فایل منابع اعمال می‌شوند (هنگام استفاده با -edit) باید روی خروجی استاندارد نمایش داده شوند، اما در عمل اعمال نگردند.
این گزینه مشخص می‌کند هشدارهای مربوط به مدخل‌های تکراری نباید نمایش داده شوند.
این گزینه مسیر فایل برنامهٔ پیش‌پردازندهٔ C مورد استفاده را مشخص می‌کند. اگرچه xrdb برای استفاده از cpp(1) طراحی شده است، هر برنامه‌ای که به عنوان یک فیلتر عمل کند و گزینه‌های -D، -I، و -U را بپذیرد نیز می‌تواند استفاده شود.
این گزینه نشان می‌دهد که xrdb نباید فایل ورودی را پیش از بارگذاری در مشخصه‌ها، از درون یک پیش‌پردازنده عبور دهد.
در صورت استفاده از پیش‌پردازندهٔ C، این گزینه به آن ارسال می‌شود. این کار از تعریف پیش‌فرض هرگونه ماکروی خاص سیستم توسط پیش‌پردازنده جلوگیری می‌کند.
این گزینه نشان می‌دهد هر دستور cpp اجراشده و خروجی حاصل از آن باید روی خروجی استاندارد نمایش داده شوند. اگر -nocpp نیز مشخص شده باشد، فایل ورودی دقیقاً به همان صورت که خوانده شده نشان داده خواهد شد. تغییرات مشخص‌شده نیز اعمال خواهند شد، مگر اینکه گزینهٔ -n نیز مشخص شده باشد.
این گزینه نشان می‌دهد نمادهایی که برای پیش‌پردازنده تعریف شده‌اند باید روی خروجی استاندارد چاپ شوند.
این گزینه نشان می‌دهد محتوای کنونی مشخصه‌های تعیین‌شده باید روی خروجی استاندارد چاپ شود. توجه داشته باشید از آنجا که دستورهای پیش‌پردازنده در فایل منبع ورودی جزئی از فایل ورودی هستند و نه جزئی از مشخصه، در خروجی این گزینه نشان داده نخواهند شد. گزینهٔ -edit می‌تواند برای ادغام مجدد محتوای مشخصه‌ها در فایل منبع ورودی بدون آسیب رساندن به دستورهای پیش‌پردازنده استفاده شود.
این گزینه مشخص می‌کند محتوای کنونی مشخصهٔ منطبق با name باید روی خروجی استاندارد چاپ شود.
این گزینه نشان می‌دهد که ورودی باید به عنوان مقدار جدید مشخصه‌های تعیین‌شده بارگذاری شود و جایگزین هر آنچه قبلاً بوده گردد (یعنی محتویات قبلی حذف می‌شوند). این کنش، رفتار پیش‌فرض است.
این گزینه مشخص می‌کند ورودی باید به محتوای کنونی مشخصه‌های تعیین‌شده افزوده شود، نه اینکه جایگزین آن‌ها گردد. مدخل‌های جدید بر مدخل‌های پیشین اولویت خواهند داشت (آن‌ها را بازنویسی می‌کنند).
این گزینه مشخص می‌کند ورودی باید با محتوای کنونی مشخصه‌های تعیین‌شده ادغام شده و بر اساس الفبا مرتب شود، به جای آنکه جایگزین آن‌ها گردد.
این گزینه مشخص می‌کند مشخصه‌های تعیین‌شده باید از روی کارساز حذف شوند.
این گزینه مشخص می‌کند اگر xrdb نخستین کلاینت باشد، باید به کارساز اعلام شود که بازنشانی (reset) نگردد. در شرایط عادی هرگز نیازی به این گزینه نخواهد بود، زیرا xdm(1) و xinit(1) همواره به عنوان کلاینت نخست عمل می‌کنند.
این گزینه مشخص می‌کند که محتوای مشخصه‌های تعیین‌شده باید درون فایل ارائه‌شده ویرایش و درج شود، و جایگزین هر مقداری گردد که پیش‌تر در آنجا فهرست شده است. این قابلیت به شما امکان می‌دهد تغییراتی را که در مقادیر پیش‌فرض خود اعمال کرده‌اید با حفظ توضیحات و خطوط پیش‌پردازنده، مجدداً به فایل منابع خود بازگردانید.
این گزینه پسوندی را مشخص می‌کند که برای ایجاد یک فایل پشتیبان، به انتهای نام فایل استفاده‌شده با -edit افزوده می‌شود.
این گزینه مستقیماً به پیش‌پردازنده ارسال می‌شود و برای تعریف نمادها جهت استفاده در عبارات شرطی مانند #ifdef به کار می‌رود.
این گزینه به پیش‌پردازنده ارسال می‌شود و برای حذف هرگونه تعریف موجود از این نماد به کار می‌رود.
این گزینه به پیش‌پردازنده ارسال می‌شود و برای تعیین دایرکتوری مورد جستجو جهت یافتن فایل‌هایی که با #include ارجاع داده شده‌اند، به کار می‌رود..SH "فایل‌ها (FILES)" Xrdb به خودی خود هیچ فایلی را بارگذاری نمی‌کند، اما بسیاری از محیط‌های رومیزی از xrdb برای بارگذاری فایل‌های ~/.Xresources هنگام راه‌اندازی نشست، جهت مقداردهی اولیه پایگاه‌داده منابع، به‌عنوان یک جایگزین تعمیم‌یافته برای فایل‌های ~/.Xdefaults استفاده می‌کنند.

X(7), appres(1), listres(1), xdpyinfo(1), مستندات Xlib Resource Manager، مستندات منابع Xt

برای تعیین اینکه از کدام نمایشگر استفاده شود.

رفتار پیش‌فرض در صورت نبود آرگومان باید پرس‌وجو (query) باشد نه رونویسی (overwrite)، تا با سایر برنامه‌ها سازگار باشد.

Bob Scheifler, Phil Karlton، بازنویسی‌شده از نسخه اصلی توسط Jim Gettys

2025-04-06 xrdb 1.2.3