| XDG-USER-DIRS-UPD(1) | User Commands | XDG-USER-DIRS-UPD(1) |
نام (NAME)
xdg-user-dirs-update - بهروزرسانی پیکربندی دایرکتوریهای کاربر XDG
خلاصه دستور (SYNOPSIS)
xdg-user-dirs-update [OPTION...] [--set NAME PATH...]
توضیحات (DESCRIPTION)
xdg-user-dirs-update وضعیت کنونی فایل user-dirs.dirs کاربران را بهروزرسانی میکند. اگر پیش از این چنین فایلی وجود نداشته باشد، فایلی بر اساس مقادیر پیشفرض سیستم ایجاد میشود، یا در صورت وجود چنین دایرکتوریهایی، از نامهای قدیمیِ ترجمهنشده استفاده خواهد شد. فهرست دایرکتوریهای قدیمی مورد استفاده عبارتند از: ~/Desktop، ~/Templates و ~/Public.
اگر یک پیکربندی قدیمی وجود داشته باشد، با هر دایرکتوری پیشفرض جدیدی بهروزرسانی میشود. علاوه بر این، هر دایرکتوری پیکربندیشدهای که به مکانهای ناموجود اشاره دارد، با اشاره به دایرکتوری خانه (home) کاربر بازنشانی میشود. این حالت معمولاً زمانی رخ میدهد که کاربر دایرکتوری را حذف کرده باشد، بنابراین احتمالاً تمایلی به استفاده مجدد از آن ندارد.
در اولین اجرا، یک فایل user-dirs.locale ایجاد میشود که حاوی محلیسازی (locale) استفادهشده برای ترجمه است. این فایل بعداً توسط ابزارهای گرافیکی مانند xdg-user-dirs-gtk-update استفاده میشود تا تغییر محلیسازی را تشخیص داده و امکان انتقال از نامهای قدیمی را فراهم سازد.
xdg-user-dirs-update به طور معمول در آغاز نشست کاربر به صورت خودکار اجرا میشود تا دایرکتوریهای کاربر XDG را مطابق با محلیسازی کاربر بهروزرسانی کند.
گزینهها (OPTIONS)
گزینههای زیر پشتیبانی میشوند:
--help
--force
--dummy-output PATH
--set NAME PATH
NAME باید یکی از موارد زیر باشد:
PATH باید یک مسیر مطلق باشد، مانند $HOME/Some/Directory.
فایلها (FILES)
پیکربندی دایرکتوریهای کاربر XDG در فایل user-dirs.dirs در مکانی که توسط متغیر محیطی XDG_CONFIG_HOME مشخص میشود، ذخیره میگردد.
محیط (ENVIRONMENT)
متغیر محیطی XDG_CONFIG_HOME تعیین میکند که فایل user-dirs.dirs در کجا قرار دارد.
همچنین ببینید (SEE ALSO)
xdg-user-dir(1), user-dirs.dirs(5), user-dirs.defaults(5), user-dirs.conf(5).
نویسندگان (AUTHORS)
Alexander Larsson <alexl@redhat.com>
| 04/08/2026 | XDG |