Dies ist das Befehls-dbus-binding-tool, das im kostenlosen OnWorks-Hosting-Provider mit einer unserer zahlreichen kostenlosen Online-Workstations wie Ubuntu Online, Fedora Online, Windows-Online-Emulator oder MAC OS-Online-Emulator ausgeführt werden kann
PROGRAMM:
NAME/FUNKTION
dbus-binding-tool - Dienstprogramm zur Generierung von GLib-Bindungen in der C-Sprache.
ZUSAMMENFASSUNG
dbus-Binding-Tool [--Macht] [--Hilfe] [--ignore-nicht unterstützt] [--modus=hübsch|schön-
Client|glib-Server] [--Ausgabe=Datei] [--Präfix=Symbol-Präfix] [--Ausführung] [Datei...]
BESCHREIBUNG
dbus-Binding-Tool wird verwendet, um ein GObject über D-Bus bereitzustellen. Als Eingabe, dbus-Binding-Tool verwendet
eine D-Bus Introspection XML-Datei. Als Ausgabe ist die clientseitige oder serverseitige Bindung
erzeugt. Diese Ausgabe ist eine Header-Datei, die die Verwendung eines entfernten D-Bus-Objekts erleichtert.
Die Ausgabe wird an den Standardausgang oder an den mit dem - angegebenen Dateinamen gesendet.-Ausgang Argument.
VERLÄNGERT BESCHREIBUNG
Das Folgende ist eine Beispiel-XML-Datei für die D-Bus-Introspektion, die ein Objekt beschreibt, das
macht eine Methode namens ManyArgs verfügbar:
dbus-Binding-Tool unterstützt Anmerkungen im XML-Format, um weiter zu steuern, wie die
Bindungen erzeugt werden.
clientseitig Bindungen
Beim Erstellen clientseitiger Bindungen wird die --mode=glib-client Argument verwendet wird. Der Kunde-
Seitenbindungen unterstützen die Annotation "org.freedesktop.DBus.Glib.NoReply". Das ist
innerhalb der . angegeben Tag, um anzuzeigen, dass der Client keine Antwort erwartet auf
der Methodenaufruf, daher sollte keine Antwort gesendet werden. Dies wird oft verwendet, um schnell zu beschleunigen
Methodenaufrufe ohne "out"-Argumente und ohne zu wissen, ob die Methode erfolgreich war
ist ein akzeptabler Kompromiss, um den Verkehr im Bus zu halbieren. Zum Beispiel:
[...]
[...]
serverseitig Bindungen
Beim Erstellen serverseitiger Bindungen wird die --mode=glib-server Argument verwendet wird. Auch der
--Präfix -Argument muss beim Erstellen serverseitiger Bindungen verwendet werden, damit Funktionen in der
generierten Ausgaben wird der angegebene Wert vorangestellt. Die serverseitigen Bindungen unterstützen
die folgenden Anmerkungen:
"org.freedesktop.DBus.GLib.CSymbol"
Diese Annotation wird verwendet, um die C-Symbolnamen für die verschiedenen Typen (Schnittstelle,
Methode usw.), wenn sie sich vom Namen unterscheidet, den D-Bus generiert.
[...]
[...]
"org.freedesktop.DBus.GLib.Async"
Diese Annotation kennzeichnet die Methodenimplementierung als asynchrone Funktion, die
nicht sofort eine Antwort zurückschicken, sondern die Antwort zu einem späteren Zeitpunkt senden an
den Anruf abschließen. Dies wird verwendet, um nicht blockierende Dienste zu implementieren, bei denen Methodenaufrufe möglich sind
nimm dir Zeit.
Wenn eine Methode asynchron ist, ist der Funktionsprototyp anders. Es ist erforderlich, dass
die Funktion entspricht den folgenden Regeln:
· Die Funktion muss einen Wert vom Typ gboolean zurückgeben; WAHR bei Erfolg und FALSCH
Andernfalls.
· Der erste Parameter ist ein Zeiger auf eine Instanz des Objekts.
· Auf den Objektinstanzzeiger folgen die Methodeneingabewerte.
· Der letzte Parameter muss ein (DBusGMethodInvocation *) sein. Dies wird beim Senden verwendet
die Antwortnachricht zurück an den Client, indem Sie dbus_g_method_return aufrufen oder
dbus_g_method_return_error.
Beispielsweise:
[...]
[...]
"org.freedesktop.DBus.GLib.Const"
Dieses Attribut kann nur auf "out" angewendet werden Knoten und gibt an, dass der Parameter
wird bei der Rückgabe nicht kopiert. Dies wandelt beispielsweise ein 's'-Argument von einem (char **)
zu a (const char **) und führt dazu, dass das Argument nach dem nicht vom D-Bus freigegeben wird
Nachricht gesendet wird. Zum Beispiel:
"org.freedesktop.DBus.GLib.ReturnVal"
Dieses Attribut kann nur auf "out" angewendet werden Knoten und ändert die erwartete Funktion
Unterschrift. Es kann derzeit auf zwei Werte eingestellt werden: "" oder "Fehler". Das mit gekennzeichnete Argument
Dieses Attribut wird nicht über ein Zeigerargument zurückgegeben, sondern über den Rückgabewert der Funktion.
Wenn der Wert des Attributs ein leerer String ist, wird auch das Argument (GError *) weggelassen, also
Es gibt keine Standardmethode, um einen Fehlerwert zurückzugeben. Dies ist sehr nützlich für die Schnittstelle
mit bestehendem Code, da es möglich ist, vorhandene APIs abzugleichen. Wenn der Wert des Attributs ist
"error", dann ist das letzte Argument wie üblich ein (GError *). Zum Beispiel:
OPTIONAL
Die folgenden Optionen werden unterstützt:
--Macht
Überschreiben Sie die Ausgabedatei, wenn sie bereits mit einem neueren Zeitstempel als die Quelle vorhanden ist
Dateien.
--help
Nutzungsinformationen anzeigen.
--ignore-nicht unterstützt
Wenn gesetzt, dann nicht unterstützte Signaturen für Parameter werden ignoriert.
--mode=hübsch|glib-client|glib-server
Wenn der Wert "glib-client" ist, werden Clientbindungen generiert. Wenn der Wert ist
"glib-server", dann werden Serverbindungen generiert. Wenn der Wert "hübsch" ist, dann ist der
Die Ausgabe erfolgt in einem für den Menschen lesbareren Format.
--ausgabe=Datei
Geben Sie die Ausgabe an Datei.
--präfix=Symbol-Präfix
Funktionen in der generierten Ausgabe haben das Präfix Symbol-Präfix Wert.
--Version
Anzeige der Versionsnummer des dbus-Binding-Tool Befehl.
OPERANDEN
Folgende Operanden werden unterstützt:
Datei Eine Liste mit einer oder mehreren Eingabe-D-Bus-Introspection-XML-Dateien, die in
die erzeugte Ausgabe.
Verwenden Sie das dbus-binding-tool online mit den onworks.net-Diensten