Commit | Line | Data |
---|---|---|
7217e0ca ML |
1 | D-BUS Configuration API v2 |
2 | ---------------------------- | |
3 | ||
4 | The X server will register the bus name org.x.config.displayN, and the | |
5 | object /org/x/config/N, where N is the display number. | |
6 | ||
7 | Currently only hotplugging of input devices is supported. | |
8 | ||
9 | org.x.config.input: | |
10 | org.x.config.input.version: | |
11 | Returns one unsigned int32, which is the API version. | |
12 | ||
13 | org.x.config.input.add: | |
14 | Takes an argument of key/value option pairs in arrays, e.g.: | |
15 | [ss][ss][ss][ss] | |
16 | is the signature for four options. These options will be passed | |
17 | to the input driver as with any others. | |
18 | Option names beginning with _ are not allowed; they are reserved | |
19 | for internal use. | |
20 | ||
21 | Returns a number of signed int32s. Positive integers are the | |
22 | device IDs of new devices; negative numbers are X error codes, | |
23 | as defined in X.h. BadMatch will be returned if the options | |
24 | given do not match any device. BadValue is returned for a malformed | |
25 | message. (Example: 8 is new device ID 8; -8 is BadMatch.) | |
26 | ||
27 | Notably, BadAlloc is never returned: the server internally signals | |
28 | to D-BUS that the attempt failed for lack of memory. | |
29 | ||
30 | org.x.config.input.remove: | |
31 | Takes one uint32 argument, which is the device ID to remove, i.e.: | |
32 | u | |
33 | is the signature. | |
34 | ||
35 | Returns one signed int32 which represents an X status as defined in | |
36 | X.h. See org.x.config.input.add. Error codes are negative numbers. | |
37 | ||
38 | org.x.config.input.listDevices: | |
39 | Lists the currently active devices. No argument. | |
40 | Return value is sequence of [<id> <name>] [<id> <name>] ..., i.e. [us]. |