dbus-binding-tool - Trực tuyến trên Đám mây

CHƯƠNG TRÌNH:

TÊN

dbus-binding-tool - Tiện ích tạo GLib ràng buộc bằng ngôn ngữ C.

SYNOPSIS

công cụ liên kết dbus [--lực lượng] [--Cứu giúp] [--ignore-không được hỗ trợ] [--mode =xinh đẹp | glib-
máy khách | glib-server] [--output =hồ sơ] [--prefix =tiền tố biểu tượng] [--phiên bản] [hồ sơ...]

MÔ TẢ

công cụ liên kết dbus được sử dụng để hiển thị một GObject qua D-Bus. Như đầu vào, công cụ liên kết dbus sử dụng
một tệp tin XML Introspection D-Bus. Như đầu ra, các ràng buộc phía máy khách hoặc phía máy chủ là
được tạo ra. Đầu ra này là tệp tiêu đề giúp giảm bớt việc sử dụng đối tượng D-Bus từ xa.
Đầu ra được gửi đến tiêu chuẩn hoặc đến tên tệp được chỉ định với --đầu ra tranh luận.

ĐA THẾ HỆ MÔ TẢ

Sau đây là một tệp XML nội bộ D-Bus mẫu mô tả một đối tượng
tiết lộ một phương thức, có tên ManyArgs:














công cụ liên kết dbus hỗ trợ các chú thích ở định dạng XML để kiểm soát thêm cách
các ràng buộc được tạo ra.

phía khách hàng ràng buộc
Khi xây dựng các ràng buộc phía máy khách, --mode = glib-client đối số được sử dụng. Khách hàng-
các liên kết bên hỗ trợ chú thích "org.freedesktop.DBus.Glib.NoReply". Đây là
được chỉ định trong để chỉ ra rằng khách hàng không mong đợi một câu trả lời
cuộc gọi phương thức, do đó, một câu trả lời sẽ không được gửi. Điều này thường được sử dụng để tăng tốc độ nhanh chóng
phương thức gọi trong đó không có đối số "out" và không biết phương thức có thành công hay không
là một thỏa hiệp có thể chấp nhận được để giảm một nửa lưu lượng trên xe buýt. Ví dụ:


[...]

[...]


phía máy chủ ràng buộc
Khi xây dựng liên kết phía máy chủ, --mode = glib-server đối số được sử dụng. Ngoài ra
--tiếp đầu ngữ đối số phải được sử dụng khi xây dựng liên kết phía máy chủ để các chức năng trong
đầu ra được tạo được ưu tiên với giá trị được chỉ định. Hỗ trợ ràng buộc phía máy chủ
các chú thích sau:

"org.freedesktop.DBus.GLib.CSymbol"

Chú thích này được sử dụng để chỉ định tên ký hiệu C cho các loại khác nhau (giao diện,
phương pháp, v.v.), nếu nó khác với tên mà D-Bus tạo ra.



[...]


[...]



"org.freedesktop.DBus.GLib.Async"

Chú thích này đánh dấu việc triển khai phương thức là một hàm không đồng bộ,
không trả lại phản hồi ngay lập tức mà sẽ gửi phản hồi vào một thời điểm nào đó sau đó tới
hoàn thành cuộc gọi. Điều này được sử dụng để triển khai các dịch vụ không chặn nơi các cuộc gọi phương thức có thể
mất thời gian.

Khi một phương thức không đồng bộ, nguyên mẫu hàm sẽ khác. Nó được yêu cầu rằng
chức năng tuân theo các quy tắc sau:

· Hàm phải trả về giá trị kiểu gboolean; ĐÚNG về thành công và SAI
nếu không thì.
· Tham số đầu tiên là một con trỏ đến một thể hiện của đối tượng.
· Theo sau con trỏ thể hiện đối tượng là các giá trị đầu vào của phương thức.
· Tham số cuối cùng phải là (DBusGMethodInvocation *). Điều này được sử dụng khi gửi
thông báo phản hồi trở lại máy khách, bằng cách gọi dbus_g_method_return hoặc
dbus_g_method_return_error.

Ví dụ:


[...]

[...]


"org.freedesktop.DBus.GLib.Const"

Thuộc tính này chỉ có thể được áp dụng cho "out" và chỉ định rằng tham số
không được sao chép khi trả lại. Ví dụ: điều này biến đối số của 's' từ a (char **)
thành a (const char **), và dẫn đến đối số không được giải phóng bởi D-Bus sau
tin nhắn được gửi đi. Ví dụ:





"org.freedesktop.DBus.GLib.ReturnVal"

Thuộc tính này chỉ có thể được áp dụng cho "out" và thay đổi chức năng mong đợi
Chữ ký. Nó hiện có thể được đặt thành hai giá trị: "" hoặc "error". Đối số được đánh dấu bằng
thuộc tính này không được trả về thông qua đối số con trỏ mà bằng giá trị trả về của hàm.
Nếu giá trị của thuộc tính là chuỗi trống, thì đối số (GError *) cũng bị bỏ qua vì vậy
không có cách tiêu chuẩn nào để trả về giá trị lỗi. Điều này rất hữu ích cho việc giao tiếp
với mã hiện có, vì có thể khớp với các API hiện có. Nếu giá trị của thuộc tính là
"error", thì đối số cuối cùng là (GError *) như bình thường. Ví dụ:

LỰA CHỌN

Các tùy chọn sau được hỗ trợ:

--lực lượng

Ghi đè tệp đầu ra nếu nó đã tồn tại với dấu thời gian mới hơn nguồn
các tập tin.

--Cứu giúp

Hiển thị thông tin sử dụng.

- không được hỗ trợ

Nếu được đặt, thì chữ ký không được hỗ trợ cho các tham số bị bỏ qua.

--mode =đẹp | glib-client | glib-server

Nếu giá trị là "glib-client", thì các liên kết với client sẽ được tạo. Nếu giá trị là
"glib-server", sau đó các liên kết máy chủ được tạo. Nếu giá trị là "khá", thì
đầu ra ở định dạng con người dễ đọc hơn.

--output =hồ sơ

Chỉ định đầu ra hồ sơ.

- tiền tố =tiền tố biểu tượng

Các hàm trong đầu ra được tạo có tiền tố là tiền tố biểu tượng giá trị.

--phiên bản

Hiển thị số phiên bản của công cụ liên kết dbus chỉ huy.

TOÁN HẠNG

Các toán hạng sau được hỗ trợ:

hồ sơ Danh sách một hoặc nhiều tệp XML Introspection D-Bus đầu vào để đưa vào
đầu ra được tạo ra.

Sử dụng dbus-binding-tool trực tuyến bằng các dịch vụ onworks.net