نام (NAME)

xdg-open - باز کردن یک فایل یا نشانی اینترنتی در برنامه برگزیده کاربر

خلاصه دستور (SYNOPSIS)

xdg-open {file | URL}

xdg-open {--help | --manual | --version}

توضیحات (DESCRIPTION)

دستور xdg-open یک فایل یا نشانی اینترنتی (URL) را در برنامه برگزیده کاربر باز می‌کند. اگر یک نشانی اینترنتی ارائه شود، در مرورگر وب برگزیده کاربر باز خواهد شد. اگر یک فایل ارائه شود، در برنامه برگزیده برای فایل‌های آن نوع باز می‌شود. دستور xdg-open از نشانی‌های اینترنتی file، ftp، http و https پشتیبانی می‌کند.

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

از آنجا که xdg-open نمی‌تواند آرگومان‌هایی را که با “-” آغاز می‌شوند مدیریت کند، توصیه می‌شود مسیرهای فایل به یکی از روش‌های زیر ارائه شوند:

•ارائه مسیرهای مطلق؛ یعنی با استفاده از realpath به‌عنوان پیش‌پردازنده.

•افزودن پیشوند “./” به مسیرهای نسبی شناخته‌شده فایل. برای نمونه با استفاده از sed -E 's|^[^/]|./\0|'.

•ارائه یک نشانی اینترنتی پرونده (file URL).

گزینه‌ها (OPTIONS)

--help

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

--manual

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

--version

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

کدهای خروج (EXIT CODES)

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

1

خطا در نحو (سینتکس) خط فرمان.

2

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

3

ابزار لازم پیدا نشد.

4

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

در صورت موفقیت، فرایند راه‌اندازی‌شده از فایل .desktop منشعب (fork) نخواهد شد و بنابراین ممکن است منجر به اجرای طولانی‌مدت xdg-open شود. این رفتار عمداً با بیشتر بازکننده‌های مخصوص میزکار تفاوت دارد تا به برنامه‌های مبتنی بر خط فرمان اجازه دهد در همان ترمینالی اجرا شوند که xdg-open از آن فراخوانی شده بود.

گزارش مشکلات (REPORTING ISSUES)

لطفاً به یاد داشته باشید که xdg-open بیشتر کاستی‌های پیکربندی خود و بازکنندهٔ زیربنایی را به ارث می‌برد.

در صورتی که دستور xdg-mime query default "$(xdg-mime query filetype path/to/troublesome_file)" نام برنامه‌ای را که مسئول رفتار غیرمنتظره است نشان دهد، می‌توانید با تنظیم یک گرداننده (handler) دیگر آن را برطرف کنید. (اگر برنامه ایراد دارد به توسعه‌دهندگان آن اطلاع دهید)

همچنین نکته امنیتی را در xdg-mime(1) برای زیردستور default ببینید.

اگر یک ایراد با استفاده از بازکنندهٔ مخصوص محیط رومیزی قابل بازتولید باشد (و مشکل پیکربندی نباشد): لطفاً ابتدا آن را به مسئول مربوط به همان بخش گزارش دهید (گزارش به xdg-utils بهتر از گزارش ندادن است، اما از آنجا که xdg-utils در زمان آزاد بسیار اندکی نگهداری می‌شوند، رفع مشکل بسیار بیشتر طول خواهد کشید).

در صورتی که مشکل منحصراً مربوط به xdg-open باشد، لطفاً آن را گزارش کنید به: https://gitlab.freedesktop.org/xdg/xdg-utils/-/issues .