dbus-binding-tool: en línea en la nube

PROGRAMA:

NOMBRE

dbus-binding-tool - Utilidad de generación de enlaces GLib en lenguaje C.

SINOPSIS

herramienta de encuadernación dbus [--fuerza] [--ayuda] [--ignorar-no compatible] [--mode =bonita | simplista
cliente | servidor glib] [--salida =presentar] [--prefijo =símbolo-prefijo] [--versión] [presentar...]

DESCRIPCIÓN

herramienta de encuadernación dbus se utiliza para exponer un GObject a través de D-Bus. Como entrada, herramienta de encuadernación dbus usos
un archivo XML D-Bus Introspection. Como resultado, los enlaces del lado del cliente o del lado del servidor son
generado. Esta salida es un archivo de encabezado que facilita el uso de un objeto D-Bus remoto.
La salida se envía a la salida estándar o al nombre de archivo especificado con --producción argumento.

EXTENDIDO DESCRIPCIÓN

El siguiente es un ejemplo de archivo XML de introspección de D-Bus que describe un objeto que
expone un método, llamado ManyArgs:














herramienta de encuadernación dbus admite anotaciones en formato XML para controlar aún más cómo
Se generan enlaces.

lado del cliente Enlaces
Al crear enlaces del lado del cliente, el:-mode = glib-client se utiliza el argumento. El cliente-
Los enlaces laterales admiten la anotación "org.freedesktop.DBus.Glib.NoReply". Este es
especificado dentro del etiqueta para indicar que el cliente no espera una respuesta a
la llamada al método, por lo que no se debe enviar una respuesta. Esto se usa a menudo para acelerar
llamadas a métodos donde no hay argumentos "out" y sin saber si el método tuvo éxito
es un compromiso aceptable para reducir a la mitad el tráfico en el autobús. Por ejemplo:


[...]

[...]


server-side Enlaces
Al crear enlaces del lado del servidor, el --mode = servidor-glib se utiliza el argumento. También el
--prefijo El argumento debe usarse al crear enlaces del lado del servidor para que las funciones en el
la salida generada está prefijada con el valor especificado. El soporte de enlaces del lado del servidor
las siguientes anotaciones:

"org.freedesktop.DBus.GLib.CSymbol"

Esta anotación se utiliza para especificar los nombres de los símbolos C para los distintos tipos (interfaz,
método, etc.), si difiere del nombre que genera D-Bus.



[...]


[...]



"org.freedesktop.DBus.GLib.Async"

Esta anotación marca la implementación del método como una función asincrónica, que no
no devolverá una respuesta de inmediato, pero enviará la respuesta en algún momento posterior a
completar la llamada. Esto se usa para implementar servicios sin bloqueo donde las llamadas a métodos pueden
tomar tiempo.

Cuando un método es asincrónico, el prototipo de función es diferente. Se requiere que
la función se ajusta a las siguientes reglas:

· La función debe devolver un valor de tipo gboolean; VERDADERO en el éxito y FALSO
de otra manera.
· El primer parámetro es un puntero a una instancia del objeto.
· A continuación del puntero de la instancia del objeto se encuentran los valores de entrada del método.
· El parámetro final debe ser un (DBusGMethodInvocation *). Esto se usa al enviar
el mensaje de respuesta al cliente, llamando a dbus_g_method_return o
dbus_g_method_return_error.

Por ejemplo:


[...]

[...]


"org.freedesktop.DBus.GLib.Const"

Este atributo solo se puede aplicar a "out" nodos, y especifica que el parámetro
no se copia cuando se devuelve. Por ejemplo, esto convierte un argumento 's' de un (char **)
a (const char **), y da como resultado que D-Bus no libere el argumento después de
se envía el mensaje. Por ejemplo:





"org.freedesktop.DBus.GLib.ReturnVal"

Este atributo solo se puede aplicar a "out" nodos y altera la función esperada
firma. Actualmente se puede establecer en dos valores: "" o "error". El argumento marcado con
este atributo no se devuelve mediante un argumento de puntero, sino mediante el valor de retorno de la función.
Si el valor del atributo es la cadena vacía, el argumento (GError *) también se omite, por lo que
no existe una forma estándar de devolver un valor de error. Esto es muy útil para interactuar
con el código existente, ya que es posible hacer coincidir las API existentes. Si el valor del atributo es
"error", entonces el argumento final es un (GError *) como de costumbre. Por ejemplo:

OPCIONES

Se admiten las siguientes opciones:

--fuerza

Sobrescriba el archivo de salida si ya existe con una marca de tiempo más reciente que la fuente
archivos.

--ayuda

Muestra información de uso.

--ignorar-no soportado

Si se establece, las firmas no admitidas para los parámetros se ignoran.

--mode =bonito | cliente-glib | servidor-glib

Si el valor es "glib-client", se generan enlaces de cliente. Si el valor es
"glib-server", luego se generan los enlaces del servidor. Si el valor es "bonito", entonces el
la salida está en un formato más legible por humanos.

--salida =presentar

Especifique la salida presentar.

--prefix =símbolo-prefijo

Las funciones en la salida generada tienen el prefijo símbolo-prefijo .

--versión

Muestra el número de versión del herramienta de encuadernación dbus mando.

OPERANDOS

Se admiten los siguientes operandos:

presentar Una lista de uno o más archivos XML de introspección D-Bus de entrada para incluir en
la salida generada.

Use dbus-binding-tool en línea usando los servicios de onworks.net