busctl - Online en la nube

PROGRAMA:

NOMBRE

busctl - Introspección del autobús

SINOPSIS

buscar [OPCIONES ...] [COMANDO] [NOMBRE...]

DESCRIPCIÓN

buscar puede usarse para introspectar y monitorear el bus D-Bus.

CAMPUS

Se entienden las siguientes opciones:

--address =DIRECCION
Conéctese al bus especificado por DIRECCION en lugar de utilizar valores predeterminados adecuados para
el sistema o bus de usuario (ver --sistema y --usuario opciones).

- show-machine
Al mostrar la lista de pares, muestre una columna que contenga los nombres de los contenedores que
pertenece a. Ver systemd-machined.servicio(8).

--único
Cuando muestre la lista de pares, muestre solo nombres "únicos" (de la forma
":número.número").

--adquirido
Lo contrario a --único - Solo se mostrarán los nombres "conocidos".

--activable
Al mostrar la lista de pares, muestre solo los pares que en realidad no se han activado
todavía, pero puede iniciarse automáticamente si se accede.

--match =PARTIDO
Al mostrar los mensajes que se intercambian, muestre solo el subconjunto que coincide PARTIDO.

--tamaño =
Cuando se usa con el capturar comando, especifica el tamaño máximo de mensaje de bus para capturar
("snaplen"). El valor predeterminado es 4096 bytes.

--lista
Cuando se usa con el árbol comando, muestra una lista plana de rutas de objetos en lugar de un árbol.

--tranquilo
Cuando se usa con el llamar al comando, suprime la visualización de la carga útil del mensaje de respuesta.
Tenga en cuenta que incluso si se especifica esta opción, los errores devueltos se seguirán imprimiendo y
la herramienta indicará éxito o fracaso con el código de salida del proceso.

--verboso
Cuando se usa con el llamar al or obtener propiedad comando, muestra la salida en una forma más detallada
formato.

--expect-reply =BOOL
Cuando se usa con el llamar al comando, especifica si buscar esperará la finalización de
la llamada al método, muestra los datos de respuesta del método devueltos y devuelve el éxito o
falla a través del código de salida del proceso. Si se establece en "no", la llamada al método será
emitido pero no se espera respuesta, la herramienta termina inmediatamente y, por lo tanto, no
Se puede mostrar la respuesta y no se devuelve ningún éxito o fracaso a través del código de salida. Para
solo suprime la salida de la carga útil del mensaje de respuesta, use --tranquilo encima. Predeterminado a
"sí".

--auto-start =BOOL
Cuando se usa con el llamar al comando, especifica si la llamada al método debe implícitamente
activar el servicio llamado, si aún no se está ejecutando pero está configurado para ser
auto-iniciado. El valor predeterminado es "sí".

--permitir-autorización-interactiva =BOOL
Cuando se usa con el llamar al comando, especifica si los servicios pueden hacer cumplir
autorización interactiva durante la ejecución de la operación, si la política de seguridad es
configurado para esto. El valor predeterminado es "sí".

--timeout =SEGS
Cuando se usa con el llamar al comando, especifica el tiempo máximo de espera para la llamada al método
terminación. Si no se especifica ninguna unidad de tiempo, asume segundos. Las otras unidades habituales son
también entendido (ms, us, s, min, h, d, w, month, y). Tenga en cuenta que este tiempo de espera no
aplicar si --expect-reply = no se utiliza, ya que la herramienta no espera ningún mensaje de respuesta
luego. Cuando no se especifica o cuando se establece en 0, se asume el valor predeterminado de "25s".

--augment-creds =BOOL
Controla si los datos de credenciales informados por lista or estado será aumentado con
datos de / proc. Cuando está activado, los datos que se muestran son posiblemente inconsistentes, ya que
los datos leídos de / proc puede ser más reciente que el resto de la credencial
información. El valor predeterminado es "sí".

--usuario
Hable con el administrador de servicios del usuario que llama, en lugar del administrador de servicios de
el sistema.

--sistema
Habla con el administrador de servicios del sistema. Este es el valor predeterminado implícito.

-H, --host =
Ejecute la operación de forma remota. Especifique un nombre de host o un nombre de usuario y un nombre de host
separados por "@", para conectarse. El nombre de host puede tener opcionalmente un sufijo
nombre del contenedor, separado por ":", que se conecta directamente a un contenedor específico en
el host especificado. Esto usará SSH para comunicarse con la instancia del administrador de la máquina remota.
Los nombres de los contenedores se pueden enumerar con máquinactl -H HOST.

-M, --machine =
Ejecutar la operación en un contenedor local. Especifique un nombre de contenedor al que conectarse.

--sin buscapersonas
No canalice la salida a un buscapersonas.

--no-leyenda
No imprima la leyenda, es decir, los encabezados de las columnas y el pie de página con sugerencias.

-h, --ayuda
Imprima un breve texto de ayuda y salga.

--versión
Imprima una cadena de versión corta y salga.

COMANDOS

Se entienden los siguientes comandos:

lista
Muestre a todos los compañeros en el autobús, por sus nombres de servicio. De forma predeterminada, muestra tanto únicos como
nombres conocidos, pero esto se puede cambiar con el --único y --adquirido interruptores.
Ésta es la operación predeterminada si no se especifica ningún comando.

estado [SERVICIO]
Muestre la información del proceso y las credenciales de un servicio de autobús (si se especifica uno por su
nombre único o conocido), un proceso (si se especifica uno por su PID numérico), o el
propietario del bus (si no se especifica ningún parámetro).

monitorear [SERVICIO...]
Volcado de mensajes que se están intercambiando. Si SERVICIO se especifica, mostrar mensajes hacia o desde este
par, identificado por su nombre conocido o único. De lo contrario, muestre todos los mensajes en el
autobús. Utilice Ctrl-C para finalizar el volcado.

capturar [SERVICIO...]
Similar a monitorear pero escribe la salida en formato pcap (para más detalles, consulte la Captura de labios
Archive Formato[1. Descripción. Asegúrese de redirigir la salida a STDOUT a un archivo.
Herramientas como Wireshark(1) se puede utilizar para analizar y ver los archivos generados.

árbol [SERVICIO...]
Muestra un árbol de objetos de uno o más servicios. Si SERVICIO se especifica, mostrar objeto
árbol de los servicios especificados solamente. De lo contrario, muestre todos los árboles de objetos de todos los servicios.
en el autobús que adquirió al menos un nombre conocido.

introspección SERVICIO OBJETO [INTERFAZ]
Mostrar interfaces, métodos, propiedades y señales del objeto especificado (identificado
por su ruta) en el servicio especificado. Si se pasa el argumento de la interfaz, la salida
está limitado a miembros de la interfaz especificada.

llamar al SERVICIO OBJETO INTERFAZ MÉTODO [FIRMA [ARGUMENTO...]]
Invocar un método y mostrar la respuesta. Toma un nombre de servicio, ruta de objeto, interfaz
nombre y nombre del método. Si los parámetros deben pasarse a la llamada al método, una firma
Se requiere una cadena, seguida de los argumentos, formateados individualmente como cadenas. Para
detalles sobre el formato utilizado, consulte a continuación. Para suprimir la salida de los datos devueltos,
utilizar el --tranquilo .

obtener propiedad SERVICIO OBJETO INTERFAZ PROPIEDADES...
Recupera el valor actual de una o más propiedades del objeto. Toma un nombre de servicio,
ruta del objeto, nombre de la interfaz y nombre de la propiedad. Se pueden especificar varias propiedades en
una vez, en cuyo caso sus valores se mostrarán uno tras otro, separados por
nuevas líneas. La salida está, por defecto, en formato conciso. Usar --verboso para una mayor
elaborado formato de salida.

propiedad de conjunto SERVICIO OBJETO INTERFAZ PROPIEDADES FIRMA ARGUMENTO...
Establece el valor actual de una propiedad de objeto. Toma un nombre de servicio, ruta de objeto,
nombre de interfaz, nombre de propiedad, firma de propiedad, seguido de una lista de parámetros
formateado como cadenas.

ayuda
Mostrar ayuda sobre la sintaxis de comandos.

PARÁMETRO FORMATEAR

El llamar al y propiedad de conjunto Los comandos toman una cadena de firma seguida de una lista de
parámetros formateados como cadena (para obtener detalles sobre las cadenas de firmas D-Bus, consulte la Tipo de Propiedad
te capítulo of las D-Autobús especificación[2]). Para tipos simples, cada parámetro siguiente
la firma debe ser simplemente el valor del parámetro formateado como cadena. Booleano positivo
los valores pueden tener el formato "verdadero", "sí", "activado" o "1"; los valores booleanos negativos pueden ser
especificado como "falso", "no", "desactivado" o "0". Para matrices, un argumento numérico para el número
de las entradas seguidas de las entradas se especificarán. Para variantes, la firma del
Se especificarán los contenidos, seguidos de los contenidos. Para diccionarios y estructuras, el
El contenido de ellos se especificará directamente.

Por ejemplo,

s mandíbula

es el formato de una sola cadena "jawoll".

como 3 hola mundo foobar

es el formato de una matriz de cadenas con tres entradas, "hola", "mundo" y "foobar".

a {sv} 3 Uno s Eins Dos u 2 Sí b verdadero

es el formato de una matriz de diccionario que asigna cadenas a variantes, que consta de tres
entradas. A la cadena "Uno" se le asigna la cadena "Eins". A la cadena "Dos" se le asigna el
Entero sin signo de 32 bits 2. A la cadena "Sí" se le asigna un valor booleano positivo.

Tenga en cuenta que llamar al, obtener propiedad, introspección Los comandos también generarán salida en este
formato para los datos devueltos. Dado que este formato a veces es demasiado conciso para ser fácilmente
entendido, el llamar al y obtener propiedad Los comandos pueden generar un lenguaje multilínea más detallado.
salida cuando pasa el --verboso .

EJEMPLOS

Ejemplo 1. Escribe. y Leer a Propiedades

Los siguientes dos comandos primero escriben una propiedad y luego la vuelven a leer. La propiedad es
que se encuentra en el objeto "/ org / freedesktop / systemd1" del servicio "org.freedesktop.systemd1".
El nombre de la propiedad es "LogLevel" en "org.freedesktop.systemd1.Manager"
interfaz. La propiedad contiene una sola cadena:

# 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"

Ejemplo 2. Reverse y Verboso Salida

Los siguientes dos comandos leen una propiedad que contiene una matriz de cadenas, y primero
muéstrelo en formato conciso, seguido de formato detallado:

$ 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 "RUTA =/ usr / local / sbin:/ usr / local / bin:/ usr / sbin:/ usr / bin";
};

Ejemplo 3. Invocando a Método

El siguiente comando invoca el método "StartUnit" en el
Interfaz "org.freedesktop.systemd1.Manager" del objeto "/ org / freedesktop / systemd1" de
el servicio "org.freedesktop.systemd1" y le pasa dos cadenas "cups.service" y
"reemplazar". Como resultado de la llamada al método, se recibe un único parámetro de ruta de objeto y
mostrado:

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

Use busctl en línea usando los servicios de onworks.net