dbus-binding-tool - Online na nuvem

PROGRAMA:

NOME

dbus-binding-tool - Utilitário de geração de vínculos GLib em linguagem C.

SINOPSE

ferramenta de ligação dbus [--força] [--Socorro] [--ignore-sem suporte] [--mode =bonito | glib-
cliente | servidor glib] [--output =lima] [--prefix =símbolo-prefixo] [--versão] [lima...]

DESCRIÇÃO

ferramenta de ligação dbus é usado para expor um GObject via D-Bus. Como entrada, ferramenta de ligação dbus usos
um arquivo XML D-Bus Introspection. Como saída, as ligações do lado do cliente ou do lado do servidor são
gerado. Esta saída é um arquivo de cabeçalho que facilita o uso de um objeto D-Bus remoto.
A saída é enviada para a saída padrão ou para o nome do arquivo especificado com --saída argumento.

ESTENDIDO DESCRIÇÃO

A seguir está um exemplo de arquivo XML D-Bus Introspection que descreve um objeto que
expõe um método, denominado ManyArgs:














ferramenta de ligação dbus suporta anotações no formato XML para controlar ainda mais como o
ligações são geradas.

lado do cliente ligações
Ao construir ligações do lado do cliente, o --mode = glib-client argumento é usado. O cliente-
ligações laterais suportam a anotação "org.freedesktop.DBus.Glib.NoReply". Isto é
especificado dentro do tag para indicar que o cliente não está esperando uma resposta para
a chamada do método, portanto, uma resposta não deve ser enviada. Isso é frequentemente usado para acelerar rapidamente
chamadas de método onde não há argumentos "de saída" e sem saber se o método foi bem-sucedido
é um meio-termo aceitável para reduzir pela metade o tráfego no ônibus. Por exemplo:


[...]

[...]


do lado do servidor ligações
Ao construir ligações do lado do servidor, o --mode = glib-server argumento é usado. Também o
--prefixo argumento deve ser usado ao construir ligações do lado do servidor para que as funções no
a saída gerada é prefixada com o valor especificado. O suporte a ligações do lado do servidor
as seguintes anotações:

"org.freedesktop.DBus.GLib.CSymbol"

Esta anotação é usada para especificar os nomes dos símbolos C para os vários tipos (interface,
, etc.), se for diferente do nome que o D-Bus gera.



[...]


[...]



"org.freedesktop.DBus.GLib.Async"

Esta anotação marca a implementação do método como uma função assíncrona, que faz
não devolverá uma resposta imediatamente, mas enviará a resposta posteriormente para
completar a chamada. Isso é usado para implementar serviços sem bloqueio onde chamadas de método podem
tome tempo.

Quando um método é assíncrono, o protótipo da função é diferente. É necessário que
a função está em conformidade com as seguintes regras:

· A função deve retornar um valor do tipo gboolean; VERDADEIRO em caso de sucesso e FALSO
de outra forma.
· O primeiro parâmetro é um ponteiro para uma instância do objeto.
· Seguindo o ponteiro da instância do objeto estão os valores de entrada do método.
· O parâmetro final deve ser um (DBusGMethodInvocation *). Isso é usado ao enviar
a mensagem de resposta de volta para o cliente, chamando dbus_g_method_return ou
dbus_g_method_return_error.

Por exemplo:


[...]

[...]


"org.freedesktop.DBus.GLib.Const"

Este atributo só pode ser aplicado a "fora" nós e especifica que o parâmetro
não está sendo copiado quando devolvido. Por exemplo, isso transforma um argumento 's' de a (char **)
para a (const char **), e resulta no argumento não sendo liberado pelo D-Bus após o
a mensagem é enviada. Por exemplo:





"org.freedesktop.DBus.GLib.ReturnVal"

Este atributo só pode ser aplicado a "fora" nós, e altera a função esperada
assinatura. Atualmente, ele pode ser definido com dois valores: "" ou "erro". O argumento marcado com
este atributo não é retornado por meio de um argumento de ponteiro, mas pelo valor de retorno da função.
Se o valor do atributo for uma string vazia, o argumento (GError *) também será omitido, portanto
não existe uma maneira padrão de retornar um valor de erro. Isso é muito útil para fazer a interface
com o código existente, pois é possível combinar APIs existentes. Se o valor do atributo for
"erro", então o argumento final é a (GError *) como de costume. Por exemplo:

OPÇÕES

As seguintes opções são suportadas:

--força

Substitua o arquivo de saída se ele já existir com um carimbo de data / hora mais recente que o de origem
arquivos.

--Socorro

Exibir informações de uso.

--ignore-sem suporte

Se definido, então assinaturas não suportadas para os parâmetros são ignorados.

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

Se o valor for "glib-client", as ligações do cliente serão geradas. Se o valor for
"glib-server", então as ligações do servidor são geradas. Se o valor for "bonito", então o
a saída está em um formato mais legível.

--output =lima

Especifique a saída lima.

--prefix =símbolo-prefixo

As funções na saída gerada são prefixadas com o símbolo-prefixo valor.

--versão

Mostra o número da versão do ferramenta de ligação dbus comando.

OPERANDOS

Os seguintes operandos são suportados:

lima Uma lista de um ou mais arquivos XML de entrada D-Bus Introspection para incluir em
a saída gerada.

Use a ferramenta dbus-binding online usando serviços onworks.net