BUSCTL

中文man手册

BUSCTL

NAME
SYNOPSIS
æè¿°
éé¡¹
å½ä»¤
åæ°æ ¼å¼
ä¾å
åè§
NOTES
è·

NAME

busctl - åçä¸çè§ D-Bus æ»çº¿

SYNOPSIS

busctl [OPTIONS...] [COMMAND] [NAME...]

æè¿°

busctl å¯ç¨äºåçä¸çè§ D-Bus æ»çº¿

éé¡¹

è½å¤è¯å«çå½ä»¤è¡éé¡¹å¦ä¸ï¼

--address=ADDRESS

è¿æ¥å° ADDRESS æå®çæ»çº¿ï¼ èä¸æ¯é»è®¤çæ»çº¿(æ è®ºæ¯ --system ç³»ç»æ»çº¿è¿æ¯ --user ç¨æ·æ»çº¿)ã

--show-machine

å¨ä½¿ç¨ list å½ä»¤æ¾ç¤ºæ»çº¿ä¸çææ peer åè¡¨æ¶ï¼ é¢å¤æ¾ç¤ºä¸ä¸ª"MACHINE"åï¼ææå¶æå±å®¹å¨çåç§°ãåè§ systemd-machined.service(8) æåã

--unique

å¨ä½¿ç¨ list å½ä»¤æ¾ç¤ºæ»çº¿ä¸çææ peer åè¡¨æ¶ï¼ä»æ¾ç¤º ":number.number" æ ¼å¼ç"å¯ä¸å"(UniqueName)ã

--acquired

å¨ä½¿ç¨ list å½ä»¤æ¾ç¤ºæ»çº¿ä¸çææ peer åè¡¨æ¶ï¼ä¸ --unique éé¡¹æ- £å¥½ç¸åï¼ ä»æ¾ç¤º"æè¯»å"(well-known name)ã

--activatable

--match=MATCH

å¨ä½¿ç¨ monitor å½ä»¤çè§å·²äº¤æ¢çæ¶æ¯æ¶ï¼ ä»æ¾ç¤ºä¸ MATCH å¹éçæ¶æ¯ã åè§ sd_bus_add_match(3)

--size=

--list

--quiet

--verbose

ä¸ call æ get-property å½ä»¤è¿ç¨ï¼ è¡¨ç¤ºä»¥è¯¦ç»æ¨¡å¼æ¾ç¤ºè¾åºã

--expect-reply=BOOL

--auto-start=BOOL

--allow-interactive-authorization=BOOL

--timeout=SECS

ä¸ call å½ä»¤è¿ç¨ï¼ è®¾ç½®çåæ¹æ³å®æçæå¤§ç§æ°ã æ³¨æï¼æ- ¤å¤çè¶æ¶è®¾ç½®å¯¹ --expect-reply=no æ æã å¯ä½¿ç¨æç¡®çæ¶é´åä½åç¼ï¼ us, ms, s, min, h, d, w, month, y ã é»è®¤å¼æ¯"25s" (æ³¨æï¼è®¾ä¸º"0"ä¹çä»·äº"25s")ã

--augment-creds=BOOL

--user

--system

-H, --host=

æä½æå®çè¿ç¨ä¸»æºãå¯ä»¥ä»æå®ä¸ä¸ªä¸»æºå(hostname)ï¼ ä¹å¯ä»¥ä½¿ç¨ "username@hostname" æ ¼å¼ã hostname åé¢è¿å¯ä»¥å ä¸å®¹å¨å(ä»¥åå·åé)ï¼ ä¹å°±æ¯å½¢å¦ "hostname:container" çæ ¼å¼ï¼ ä»¥è¡¨ç¤ºç´æ¥è¿æ¥å°æå®ä¸»æºçæå®å®¹å¨åã æä½å°éè¿SSHåè®®è¿è¡ï¼ä»¥ç¡®ä¿å®å¨ã å¯ä»¥éè¿ machinectl -H HOST å½ä»¤ååºè¿ç¨ä¸»æºä¸çææå®¹å¨åç§°ã

-M, --machine=

å¨æ¬å°å®¹å¨åæ§è¡æä½ã å¿é¡»æç¡®æå®å®¹å¨çåç§°ã

--no-pager

ä¸å°ç¨åºçè¾åºåå®¹ç®¡é(pipe)ç»åé¡µç¨åºã

--no-legend

-h, --help

æ¾ç¤ºç®ççå¸®å©ä¿¡æ¯å¹¶éåºã

--version

æ¾ç¤ºç®çççæ¬ä¿¡æ¯å¹¶éåºã

å½ä»¤

è½å¤è¯å«çå½ä»¤å¦ä¸ï¼

list

æ¾ç¤ºæ»çº¿ä¸çææpeer(ä¾æ®æå¡åç§°)ï¼è¿æ¯é»è®¤å½ä»¤ã é»è®¤åæ¶æ¾ç¤º"å¯ä¸å"(UniqueName)ä¸"æè¯»å"(well-known name)ï¼ ä½æ¯å¯ä»¥ä½¿ç¨ --unique ä¸ --acquired éé¡¹è¿è¡ä¿®æ¹ã

status [SERVICE]

monitor [SERVICE...]

capture [SERVICE...]

ä¸ monitor å½ä»¤ç±»ä¼¼ï¼ ä¸åä¹å¤å¨äºä»¥ pcap æ ¼å¼è¾åº(è¯¦è§ Libpcap File Format [1] )ã å¼ºçæ¨èå° STDOUT éå®åå°ä¸ä¸ªæä»¶ä¸- ï¼ç¶åä½¿ç¨ wireshark(1) å·¥å·æ¥çä¸åæã

tree [SERVICE...]

introspect SERVICE OBJECT [INTERFACE]

æ¾ç¤ºSERVICEæå¡ä¸OBJECTå¯¹è±¡(ä»¥è·¯å¾è¡¨ç¤º)ç interface, method, property, signal å¼ã å¦ææå®äº INTERFACE åæ°ï¼ é£ä¹ä»è¾åºæå®æ¥å£ä¸çæåã

call SERVICE OBJECT INTERFACE METHOD [SIGNATURE [ARGUMENT...]]

è°ç¨ä¸ä¸ªæ¹æ³å¹¶æ¾ç¤ºåºçã å¿é¡»æå®æå¡åç§°(SERVICE)ãå¯¹è±¡è·¯å¾(OBJECT)ãæ¥å£åç§°(INTERFACE)ãæ¹æ³åç§°(METHOD)ã å¦æè¦ç»æ¹æ³ä¼ éåæ°ï¼ é£ä¹å¿é¡»ä½¿ç¨ç±»åæ è®°(SIGNATURE)åè·ä¸ä¸ªåæ°åç¬¦ä¸²(ARGUMENT)ã æ ¼å¼ç»èåè§ä¸é¢ç"åæ°æ ¼å¼"å°èã å¯ä»¥ä½¿ç¨ --quiet éé¡¹æå¶è¾åºã

get-property SERVICE OBJECT INTERFACE PROPERTY...

set-property SERVICE OBJECT INTERFACE PROPERTY SIGNATURE ARGUMENT...

è®¾ç½®å¯¹è±¡å±æ§çå½åå¼ã å¿é¡»æå®ä¸ååæ°ï¼ æå¡åç§°(SERVICE)ãå¯¹è±¡è·¯å¾(OBJECT)ãæ¥å£åç§°(INTERFACE)ã å±æ§åç§°(PROPERTY)ãç±»åæ è®°(SIGNATURE)ãåæ°åç¬¦ä¸²(ARGUMENT)ã

help

æ¾ç¤ºè¯æ³å¸®å©

åæ°æ ¼å¼

call ä¸ set-property å½ä»¤é½æ¥æ¶ä¸ä¸ªç±»åæ è®°(SIGNATURE)ä¸å¤ä¸ªåæ°å- ç¬¦ä¸²(ARGUMENT)ã æå³"ç±»åæ è®°"çè¯¦ç»è¯´æï¼ åè§ Type system chapter of the D-Bus specification [2] ææ¡£ç"Type System"å°èã å¯¹äºç®åç±»å(Basic types)ï¼ ç±»åæ è®°(SIGNATURE)åé¢çæ¯ä¸ªåæ°(ARGUMENT)é½å¿é¡»æ¯åæ°å¼çå- ç¬¦ä¸²è¡¨ç¤ºã å¸å°ç±»åçå¼å¯ä»¥è¡¨ç¤ºä¸º "true", "yes", "on", "1" ï¼ å¸å°ç±»ååå¼å¯ä»¥è¡¨ç¤ºä¸º "false", "no", "off", "0" ã å¯¹äºæ°ç»ï¼åæ¯ä¸ä¸ªè¡¨ç¤ºæ°ç»é¡¹æ°çæ°åï¼ç¶åè·çæ°ç»ä¸çæ¯ä¸é¡¹ã å¯¹äºåéï¼åæ¯ä¸ä¸ªè¡¨ç¤ºåéç±»åçåç¬¦ï¼ç¶åè·çåéçå¼ã å¯¹äºå- å¸ä¸ç»æï¼ç´æ¥æå®å¶åå®¹å³å¯ã

ä¾å¦ï¼

s jawoll

æ¯ä¸ä¸ªç®åçåç¬¦ä¸² "jawoll" ï¼ "s"æ¯ç±»åæ è®°ï¼"jawoll"æ¯åæ°åç¬¦ä¸²ã

as 3 hello world foobar

æ¯ä¸ä¸ªåç¬¦ä¸²æ°ç»ï¼åå«3ä¸ªæåï¼åå«æ¯ "hello", "world", "foobar"

a{sv} 3 One s Eins Two u 2 Yes b true

æ³¨æï¼ call, get-property, introspect å½ä»¤å¨è¾åºåºç- æ¶ä¹åæ ·æ¯è¿ä¸ªæ ¼å¼ã ç±äºè¿ä¸ªæ ¼å¼è¿äºç²¾ç®ä¸æçè§£ï¼ æä»¥ call ä¸ get-property å½ä»¤æä¾äº --verbose éé¡¹ç¨äºè¾åºè¯¦ç»çã æäºçè§£çå¤è¡è¾åºæ ¼å¼ã

ä¾å

Example 1. è¯»åå±æ§

ä¸é¢çä¸¤ä¸ªå½ä»¤ï¼é¦ååå¥ä¸ä¸ªå±æ§ï¼ç¶ååè¯»åå®ã è¯¥å±æ§ä½äº "org.freedesktop.systemd1" æå¡ç "/org/freedesktop/systemd1" å¯¹è±¡ä¸ï¼ å±æ§åæ¯ "org.freedesktop.systemd1.Manager" æ¥å£ä¸ç "LogLevel" ï¼ æ- ¤å±æ§æ¯ä¸ä¸ªç®åçåç¬¦ä¸²ï¼

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

Example 2. ç²¾ç®è¾åºä¸è¯¦ç»è¾åº

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager Environment
as 2 "LANG=en_US.utf8" "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.utf8";
STRING "PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin";
};

Example 3. è°ç¨æ¹æ³

ä¸é¢çå½ä»¤ï¼ å¨ "org.freedesktop.systemd1" æå¡ç "/org/freedesktop/systemd1" å¯¹è±¡ç "org.freedesktop.systemd1.Manager" æ¥å£ä¸è°ç¨äº "StartUnit" æ¹æ³ï¼ å¹¶ä¸ç»æ¤æ¹æ³ä¼ éäº "cups.service" ä¸ "replace" ä¸¤ä¸ªåç¬¦ä¸²ã èæ¤æ¹æ³è¿åäºä¸ä¸ªå¯¹è±¡è·¯å¾ï¼

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

åè§

dbus-daemon(1), D-Bus [3] , sd-bus(3), systemd(1), machinectl(1), wireshark(1)

NOTES

Libpcap File Format

http://wiki.wireshark.org/Development/LibpcapFileFormat

Type system chapter of the D-Bus specification

http://dbus.freedesktop.org/doc/dbus-specification.html#type-system

D-Bus

http://freedesktop.org/wiki/Software/dbus

è·

æ¬é¡µé¢ä¸æçç±ä¸æ man æåé¡µè®¡åæä¾ã

ç¿»è¯äººåï¼éæ¥å½
éæ¥å½ä½åéï¼http://www.jinbuguo.com
ä¸æ man æåé¡µè®¡åï¼https://github.com/man-pages-zh/manpages-zh

手册导航

man1

man2

man3

man4

man5

man6

man7

man8

BUSCTL

目录

BUSCTL

NAME

SYNOPSIS

æè¿°

éé¡¹

å½ä»¤

åæ°æ ¼å¼

ä¾å

åè§

NOTES

è·