نام (NAME)

nih-dbus-tool - تولیدکننده کد پیوند D-Bus

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

nih-dbus-tool [OPTIONS]... [-o FILE] [XMLFILE]
nih-dbus-tool [OPTIONS]... -o FILE --system|--session --dest=NAME OBJECT-PATH

توضیحات (DESCRIPTION)

نمای کلی (OVERVIEW)

قالب درون‌نگری (introspection) مربوط به D-Bus یک سند XML است که رابط‌های پیاده‌سازی‌شده توسط یک شیء خاص را توصیف می‌کند، شامل متدها و سیگنال‌های آن رابط به همراه آرگومان‌هایشان و ویژگی‌های (properties) آن رابط.

یک سند، یک شیء واحد را توصیف می‌کند که توسط تگ ریشهٔ <node> نمایش داده می‌شود. رابط‌های پیاده‌سازی‌شده توسط آن شیء با تگ‌های <interface> درون آن مشخص می‌شوند. متدها، سیگنال‌ها و ویژگی‌های تعریف‌شده توسط رابط، به‌وسیلهٔ تگ‌های <method>، <signal> و <property> درون رابط توصیف می‌گردند. آرگومان‌های متدها و سیگنال‌ها توسط تگ‌های <arg> درون آن‌ها تعریف می‌شوند. نام‌ها و سایر مقادیر به عنوان مشخصه‌ها (attributes) برای هر تگ تعیین می‌گردند.

ویژگی‌های اضافی برای ابزارها یا نرم‌افزارهای خارجی می‌تواند در تگ‌های <annotation> ارائه شود. این تگ‌ها می‌توانند درون رابط‌ها، متدها، سیگنال‌ها، ویژگی‌ها و آرگومان‌ها قرار گیرند. nih-dbus-tool از بسیاری از این موارد استفاده می‌کند. توجه داشته باشید که حاشیه‌نویسی‌های آرگومان، یک افزونهٔ nih-dbus-tool برای این قالب به شمار می‌روند.

تجزیه‌کنندهٔ nih-dbus-tool نسبتاً آسان‌گیر و منعطف است تا امکان گسترش‌های آیندهٔ قالب درون‌نگری D-Bus را فراهم سازد. هر تگ، مشخصه یا حاشیه‌نویسی ناشناخته، یا هر تگی که در جای مورد انتظار قرار نگرفته باشد، همراه با یک هشدار نادیده گرفته خواهد شد. با این حال، نبود تگ ریشهٔ node، نبود مشخصه‌ها، مقادیر غیرمجاز یا با فرمت نامعتبر برای مشخصه‌های تعریف‌شده، یا ساختار نادرست XML منجر به خطا خواهد شد.

داده‌های نویسه‌ای و کامنت‌ها بخشی از توصیف در نظر گرفته نمی‌شوند و تجزیه نخواهند شد.

گزینه‌ها (OPTIONS)

نویسندگان (AUTHORS)

نوشته شده توسط Scott James Remnant <scott@netsplit.com>

گزارش باگ‌ها (BUGS)

گزارش باگ‌ها در https://launchpad.net/libnih/+bugs

کپی‌رایت و تکثیر (COPYRIGHT)

این یک نرم‌افزار آزاد است؛ برای شرایط تکثیر به منبع کد مراجعه کنید. هیچ ضمانتی وجود ندارد؛ حتی ضمانت ضمنی برای قابلیت فروش یا تناسب با یک هدف خاص.