busctl - Online na nuvem

PROGRAMA:

NOME

busctl - examine o ônibus

SINOPSE

busctl [OPÇÕES ...] [COMANDO] [NOME...]

DESCRIÇÃO

busctl pode ser usado para introspectar e monitorar o barramento D-Bus.

OPÇÕES

As seguintes opções são compreendidas:

--address =ENDEREÇO
Conecte-se ao barramento especificado por ENDEREÇO em vez de usar padrões adequados para qualquer um
o sistema ou barramento do usuário (ver --sistema e --do utilizador opções).

- show-machine
Ao mostrar a lista de pares, mostra uma coluna contendo os nomes dos contêineres que eles
pertence a. Ver systemd-machined.service(8).

--exclusivo
Ao mostrar a lista de pares, mostre apenas nomes "únicos" (da forma
":número.número").

--adquirido
O oposto de --exclusivo - apenas nomes "conhecidos" serão mostrados.

--ativável
Ao mostrar a lista de pares, mostra apenas os pares que realmente não foram ativados
ainda, mas pode ser iniciado automaticamente se acessado.

--match =JOGO
Ao mostrar as mensagens sendo trocadas, mostre apenas o subconjunto correspondente JOGO.

--size =
Quando usado com o capturar comando, especifica o tamanho máximo da mensagem de barramento para capturar
("snaplen"). O padrão é 4096 bytes.

--Lista
Quando usado com o árvore comando, mostra uma lista simples de caminhos de objeto em vez de uma árvore.

--quieto
Quando usado com o chamada comando, suprime a exibição da carga útil da mensagem de resposta.
Observe que mesmo se esta opção for especificada, os erros retornados ainda serão impressos e
a ferramenta indicará sucesso ou falha com o código de saída do processo.

--verbose
Quando usado com o chamada or obter-propriedade comando, mostra a saída de uma forma mais detalhada
formato.

--expect-reply =BOOL
Quando usado com o chamada comando, especifica se busctl deve esperar pela conclusão de
a chamada do método, produzir os dados de resposta do método retornados e retornar com sucesso ou
falha por meio do código de saída do processo. Se for definido como "não", a chamada do método será
emitida, mas nenhuma resposta é esperada, a ferramenta é encerrada imediatamente e, portanto, não
a resposta pode ser mostrada e nenhum sucesso ou falha é retornado por meio do código de saída. Para
suprimir apenas a saída da carga útil da mensagem de resposta, use --quieto acima de. Padrões para
"sim".

--auto-start =BOOL
Quando usado com o chamada comando, especifica se a chamada do método deve implicitamente
ativar o serviço chamado, caso ainda não esteja em execução, mas esteja configurado para ser
auto-iniciado. O padrão é "sim".

--allow-interativo-autorização =BOOL
Quando usado com o chamada comando, especifica se os serviços podem impor
autorização interativa durante a execução da operação, se a política de segurança for
configurado para isso. O padrão é "sim".

--timeout =SECS
Quando usado com o chamada comando, especifica o tempo máximo de espera pela chamada do método
conclusão. Se nenhuma unidade de tempo for especificada, assume segundos. As outras unidades usuais são
compreendido, também (ms, nós, s, min, h, d, w, mês, y). Observe que este tempo limite não
aplique se --expect-reply = no é usado, pois a ferramenta não espera por nenhuma mensagem de resposta
então. Quando não especificado ou quando definido como 0, o padrão de "25s" é assumido.

--augment-creds =BOOL
Controla se os dados de credencial informados por Lista or estado deve ser aumentado com
dados de / proc. Quando está ligado, os dados mostrados são possivelmente inconsistentes, como
os dados lidos de / proc pode ser mais recente do que o resto da credencial
em formação. O padrão é "sim".

--do utilizador
Fale com o gerente de serviço do usuário que está ligando, em vez do gerente de serviço de
o sistema.

--sistema
Fale com o gerente de serviço do sistema. Este é o padrão implícito.

-H, --host =
Execute a operação remotamente. Especifique um nome de host ou um nome de usuário e nome de host
separados por "@", para se conectar. O nome do host pode, opcionalmente, ser sufixado por um
nome do contêiner, separado por ":", que se conecta diretamente a um contêiner específico em
o host especificado. Isso usará SSH para se comunicar com a instância do gerenciador de máquina remota.
Os nomes dos contêineres podem ser enumerados com máquinactl -H HOST.

-M, --máquina =
Execute a operação em um contêiner local. Especifique um nome de contêiner para se conectar.

--sem pager
Não canalize a saída para um pager.

--sem legenda
Não imprima a legenda, ou seja, cabeçalhos de coluna e rodapé com dicas.

-h, --Socorro
Imprima um breve texto de ajuda e saia.

--versão
Imprima uma string de versão curta e saia.

COMANDOS

Os seguintes comandos são compreendidos:

Lista
Mostre todos os pares no barramento, por seus nomes de serviço. Por padrão, mostra único e
nomes bem conhecidos, mas isso pode ser alterado com o --exclusivo e --adquirido comuta.
Esta é a operação padrão se nenhum comando for especificado.

estado [SERVIÇO]
Mostra as informações do processo e as credenciais de um serviço de ônibus (se algum for especificado por seu
nome exclusivo ou conhecido), um processo (se algum for especificado por seu PID numérico), ou o
proprietário do barramento (se nenhum parâmetro for especificado).

monitor [SERVIÇO...]
Despeje as mensagens que estão sendo trocadas. Se SERVIÇO é especificado, mostra mensagens de ou para este
peer, identificado por seu nome conhecido ou exclusivo. Caso contrário, mostre todas as mensagens no
ônibus. Use Ctrl-C para encerrar o despejo.

capturar [SERVIÇO...]
Semelhante a monitor mas escreve a saída no formato pcap (para detalhes, consulte o LibpcapGenericName
Envie o Formato[1] descrição. Certifique-se de redirecionar a saída para STDOUT para um arquivo.
Ferramentas como wireshark(1) pode ser usado para dissecar e visualizar os arquivos gerados.

árvore [SERVIÇO...]
Mostra uma árvore de objetos de um ou mais serviços. Se SERVIÇO é especificado, mostrar objeto
árvore dos serviços especificados apenas. Caso contrário, mostre todas as árvores de objetos de todos os serviços
no ônibus que adquiriu pelo menos um nome bem conhecido.

introspecção SERVIÇO OBJETO [INTERFACE]
Mostra interfaces, métodos, propriedades e sinais do objeto especificado (identificado
por seu caminho) no serviço especificado. Se o argumento da interface for passado, a saída
é limitado a membros da interface especificada.

chamada SERVIÇO OBJETO INTERFACE MÉTODO [SIGNATURE [ARGUMENTO...]]
Invoque um método e mostre a resposta. Pega um nome de serviço, caminho de objeto, interface
nome e nome do método. Se os parâmetros devem ser passados ​​para a chamada do método, uma assinatura
string é necessária, seguida pelos argumentos, formatados individualmente como strings. Para
detalhes sobre a formatação usada, veja abaixo. Para suprimir a saída dos dados retornados,
use o --quieto opção.

obter-propriedade SERVIÇO OBJETO INTERFACE PROPRIEDADE...
Recupere o valor atual de uma ou mais propriedades do objeto. Pega um nome de serviço,
caminho do objeto, nome da interface e nome da propriedade. Várias propriedades podem ser especificadas em
uma vez, caso em que seus valores serão mostrados um após o outro, separados por
newlines. A saída é, por padrão, em formato conciso. Usar --verbose por mais
formato de saída elaborado.

propriedade de conjunto SERVIÇO OBJETO INTERFACE PROPRIEDADE SIGNATURE ARGUMENTO...
Defina o valor atual de uma propriedade do objeto. Pega um nome de serviço, caminho de objeto,
nome da interface, nome da propriedade, assinatura da propriedade, seguido por uma lista de parâmetros
formatado como strings.

ajudar
Mostra a ajuda da sintaxe do comando.

PARÂMETRO FORMATANDO

A chamada e propriedade de conjunto comandos recebem uma string de assinatura seguida por uma lista de
parâmetros formatados como string (para obter detalhes sobre strings de assinatura D-Bus, consulte o Formato
. capítulo of que o ônibus D especificação[2]). Para tipos simples, cada parâmetro seguindo
a assinatura deve ser simplesmente o valor do parâmetro formatado como string. Booleano positivo
os valores podem ser formatados como "verdadeiro", "sim", "ativado" ou "1"; valores booleanos negativos podem ser
especificado como "falso", "não", "desligado" ou "0". Para matrizes, um argumento numérico para o número
de entradas seguidas das entradas devem ser especificadas. Para variantes, a assinatura do
o conteúdo deve ser especificado, seguido pelo conteúdo. Para dicionários e estruturas, o
seu conteúdo deve ser diretamente especificado.

Por exemplo,

queixo

é a formatação de uma única string "jawoll".

como 3 hello world foobar

é a formatação de um array de strings com três entradas, "hello", "world" e "foobar".

a {sv} 3 Um s Eins Dois u 2 Sim b verdadeiro

é a formatação de uma matriz de dicionário que mapeia strings para variantes, consistindo em três
entradas. A string "One" é atribuída à string "Eins". A string "Dois" é atribuída ao
Inteiro sem sinal de 32 bits 2. A string "Sim" é atribuída a um booleano positivo.

Observe que o chamada, obter-propriedade, introspecção comandos também irão gerar saída neste
formato para os dados retornados. Uma vez que este formato às vezes é muito conciso para ser facilmente
entendido, o chamada e obter-propriedade comandos podem gerar um mais verboso, multi-linha
saída quando passado o --verbose opção.

EXEMPLOS

Exemplo 1. Escreva e Leia a Propriedade

Os dois comandos a seguir primeiro escrevem uma propriedade e depois a leem de volta. A propriedade é
encontrado no objeto "/ org / freedesktop / systemd1" do serviço "org.freedesktop.systemd1".
O nome da propriedade é "LogLevel" em "org.freedesktop.systemd1.Manager"
interface. A propriedade contém uma única string:

# busctl set-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager LogLevel s debug
# busctl get-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager LogLevel
s "depurar"

Exemplo 2. reversa e Verboso saída

Os dois comandos a seguir lêem uma propriedade que contém uma matriz de strings e, primeiro
mostre-o em formato conciso, seguido de formato detalhado:

$ busctl get-property org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager Environment
como 2 "LANG = en_US.UTF-8" "PATH =/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager Environment
ARRAY "s" {
STRING "LANG = en_US.UTF-8";
STRING "PATH =/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Exemplo 3. Invocando a Forma

O seguinte comando invoca o método "StartUnit" no
interface "org.freedesktop.systemd1.Manager" do objeto "/ org / freedesktop / systemd1" de
o serviço "org.freedesktop.systemd1" e passa duas strings "cups.service" e
"substituir". Como resultado da chamada do método, um único parâmetro de caminho de objeto é recebido e
mostrando:

# busctl call org.freedesktop.systemd1 / org / freedesktop / systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/ org / freedesktop / systemd1 / job / 42684"

Use busctl online usando serviços onworks.net