NOTIFY-SEND(1)                   User Commands                  NOTIFY-SEND(1)

نام (NAME)
       notify-send - ابزاری برای ارسال اعلان‌های میزکار

خلاصه دستور (SYNOPSIS)
       notify-send [OPTIONS] {summary} [body]

توضیحات (DESCRIPTION)
       با استفاده از notify-send می‌توانید از طریق خط فرمان و به واسطه یک دیمن
       اعلان (notification daemon)، اعلان‌های میزکار را برای کاربر ارسال کنید.
       این اعلان‌ها می‌توانند برای باخبر کردن کاربر از یک رویداد یا نمایش
       اطلاعات، بدون ایجاد مزاحمت در کار او، استفاده شوند.

گزینه‌ها (OPTIONS)
       -?, --help
           نمایش راهنما و خروج.

       -a, --app-name=APP_NAME
           نام برنامه را برای اعلان مشخص می‌کند.

       -A, --action=[NAME=]Text...
           عملیات‌هایی را برای نمایش به کاربر مشخص می‌کند. این گزینه مستلزم
           --wait برای منتظر ماندن جهت دریافت ورودی کاربر است. می‌تواند چندین
           بار تکرار شود. مقدار NAME عملیات در stdout نوشته می‌شود. اگر NAME
           مشخص نشده باشد، از نمایه عددی گزینه استفاده خواهد شد (شروع از 1).

       --selected-action-fd=FILE_DESCRIPTOR
           توصیف‌کننده فایلی (file descriptor) که عملیات انتخاب‌شده توسط کاربر
           در آن نوشته می‌شود.

       --activation-token-fd=FILE_DESCRIPTOR
           توصیف‌کننده فایلی که توکن فعال‌سازی عملیات در آن نوشته می‌شود. دیمن
           باید از آن پشتیبانی کند.

       -u, --urgency=LEVEL
           سطح اضطرار را مشخص می‌کند (low، normal، critical).

       -t, --expire-time=TIME
           مدت‌زمان (به میلی‌ثانیه) نمایش اعلان بر روی صفحه نمایش.

           همه پیاده‌سازی‌ها از این پارامتر استفاده نمی‌کنند. GNOME Shell و
           Notify OSD همیشه آن را نادیده می‌گیرند، در حالی که Plasma آن را برای
           اعلان‌هایی با سطح اضطرار critical نادیده می‌گیرد.

       -i, --icon=ICON
           نام فایل یک آیکون یا یک آیکون استاندارد را برای نمایش مشخص می‌کند.

       -n, --app-icon=ICON
           نام فایل آیکون برنامه یا نام آیکون برنامه را مشخص می‌کند. سرور ممکن
           است آن را نمایش دهد یا ندهد.

       -c, --category=TYPE[,TYPE...]
           دسته‌بندی اعلان را مشخص می‌کند.

       -h, --hint=TYPE:NAME:VALUE
           داده‌های اضافی اولیه‌ای را برای ارسال مشخص می‌کند. انواع معتبر عبارتند
           از: BOOLEAN، INT، DOUBLE، STRING، BYTE و VARIANT.

       -p, --print-id
           شناسه (ID) اعلان را چاپ می‌کند.

       --id-fd=FILE_DESCRIPTOR
           توصیف‌کننده فایلی که شناسه اعلان در آن نوشته می‌شود.

       -r, --replace-id=REPLACE_ID
           شناسه اعلانی که باید جایگزین شود.

       -w, --wait
           پیش از خروج، تا زمان بسته شدن اعلان منتظر می‌ماند. اگر expire-time
           تنظیم شده باشد، به عنوان حداکثر زمان انتظار استفاده خواهد شد.

       -e, --transient
           یک اعلان گذرا (transient) را نشان می‌دهد. اعلان‌های گذرا قابلیت
           ماندگاری کارساز (server persistence) را در صورت وجود دور می‌زنند؛
           بنابراین تا زمانی که کاربر آن را تأیید کند، ذخیره نخواهند شد.

همچنین ببینید (SEE ALSO)
       مشخصات اعلان‌های میزکار (Desktop Notification Spec) در
       https://specifications.freedesktop.org/notification-spec.

نویسندگان (AUTHORS)
       Andre Filipe de Assuncao e Brito <decko@noisemakers.org>
           نویسنده اصلی

       Paul van Tilburg <paulvt@debian.org>
           نویسنده اصلی

       Riccardo Setti <giskard@debian.org>
           نویسنده اصلی

libnotify                                                       NOTIFY-SEND(1)