XDG-SETTINGS(1) xdg-settings Manual XDG-SETTINGS(1)

xdg-settings - دریافت تنظیمات گوناگون از محیط رومیزی

xdg-settings {get | check | set} {property} [subproperty] [value]

xdg-settings {--help | --list | --manual | --version}

دستور xdg-settings تنظیمات گوناگونی را از محیط رومیزی دریافت می‌کند. برای نمونه، محیط‌های رومیزی اغلب پیکربندی پیش‌کار (proxy) و تنظیمات مرورگر وب پیش‌فرض را فراهم می‌آورند. با استفاده از xdg-settings می‌توان این پارامترها را برای استفاده برنامه‌هایی که از کتابخانه‌های محیط رومیزی استفاده نمی‌کنند (و این تنظیمات را به‌صورت بومی به کار می‌گیرند) استخراج کرد.

دستور xdg-settings تنها برای استفاده در یک نشست رومیزی است. توصیه نمی‌شود xdg-settings به‌عنوان ریشه (root) اجرا شود.

--help

نمایش خلاصه دستور.

--list

فهرست کردن تمام ویژگی‌هایی که xdg-settings از آن‌ها آگاه است.

--manual

نمایش این صفحه راهنما.

--version

نمایش اطلاعات نسخه xdg-utils.

هنگام استفاده از xdg-settings برای دریافت (get)، بررسی (check) یا اعمال (set) یک تنظیم رومیزی، از ویژگی‌ها و در صورت نیاز زیرویژگی‌ها برای تعیین تنظیم مورد نظر استفاده می‌شود.

برخی از ویژگی‌ها (مانند default-web-browser) تنظیمی را که باید تغییر کند به‌طور کامل توصیف می‌کنند. ویژگی‌های دیگر (مانند default-url-scheme-handler) به اطلاعات بیشتری نیاز دارند (در این مورد، شِمای واقعی که باید گرداننده پیش‌فرض برای آن تعیین شود) که باید در یک زیرویژگی ارائه شود.

کد خروج 0 نشان‌دهنده موفقیت است، در حالی که کد خروج غیر صفر نشان‌دهنده شکست در عملیات است. کدهای شکست زیر ممکن است بازگردانده شوند:

1

خطا در نحو خط فرمان.

2

یکی از فایل‌های ارائه‌شده در خط فرمان وجود نداشت.

3

ابزار مورد نیاز یافت نشد.

4

عملیات شکست خورد.

xdg-mime(1), xdg-open(1), MIME applications associations specification[1]

دریافت نام فایل desktop مربوط به مرورگر وب پیش‌فرض فعلی

xdg-settings get default-web-browser

بررسی اینکه آیا مرورگر وب پیش‌فرض firefox.desktop است یا خیر، که این بررسی حتی اگر “get default-web-browser” بگوید مقدار فعلی همین است، باز هم ممکن است نادرست (false) باشد (اگر تنها برخی از تنظیمات بنیادین بازتاب‌دهنده آن مقدار باشند)

xdg-settings check default-web-browser firefox.desktop

تنظیم مرورگر وب پیش‌فرض روی google-chrome.desktop

xdg-settings set default-web-browser google-chrome.desktop

تنظیم گرداننده پیش‌فرض طرح نشانی وب mailto روی evolution.desktop

xdg-settings set default-url-scheme-handler mailto evolution.desktop

Mike Mammarella

نویسنده.

Copyright © 2009-2011

1.
MIME applications associations specification
12/06/2025 xdg-utils 1.1.0