The code is published under ISC and can be found via git at git://git.openwrt.org/project/rpcd.git or via http at http://git.openwrt.org/?p=project/rpcd.git;a=summary. It's included in OpenWrt since r37877.
plugin executables
It is possible to expose shell script functionality over ubus by using rpcd plugin executables functionality. Executables stored in /usr/libexec/rpcd/ directory will be runned by rpcd. Lets look at the following example:
$ cat << EOF > /usr/libexec/rpcd/foo #!/bin/sh case "$1" in list) echo '{ "bar": { "arg1": true, "arg2": 32, "arg3": "str" }, "toto": { } }' ;; call) case "$2" in bar) # read the arguments read input; # optionally log the call logger -t "foo" "call" "$2" "$input" # return json object or an array echo '{ "hello": "world" }' ;; toto) # return json object or an array echo '[ "item1", "item2", "item3" ]' ;; esac ;; esac EOF $ chmod +x /usr/libexec/rpcd/foo
This will create new ubus functions which then can be used (after restarting rpcd):
$ ubus list -v ... 'foo' @686f0592 "bar":{"arg1":"Boolean","arg2":"Integer","arg3":"String"} "toto":{} ... $ ubus call -S foo bar '{"arg1": true }' {{"hello":"world"}} $ ubus -S call foo toto {["item1","item2","item3"]}
On startup rpcd will call all executables in /usr/libexec/rpcd/ with argv[1] set to "list". For a plugin, which responds with a valid list of methods and signatures, ubus method with appropriate arguments will be created. When a method provided by the plugin is about to be invoked, rpcd calls the binary with argv[1] set to "call" and argv[2] set to the invoked method name. The actual data is then sent by the ubus client via stdin. Ie, If you're testing the script itself, you need to use echo '{"arg1": 42}' | yourscript call yourmethod
. You cannot simply use yourscript call yourmethod '{"arg1": 42}
' as you might have expected.
The method signature is a simple object containing key:value pairs. The argument type is inferred from the value. If the value is a string (regardless of the contents) it is registered as string, if the value is a bool true or false, its registered as bool, if the value is an integer, it is registered as either int8, int16, int32 or int64 depending on the value ("foo": 16 will be INT16, "foo": 64 will be INT64, "foo": 8 will be INT8 and everything else will be INT32).
It is enough to issue '/etc/init.d/rpcd reload' to make it pick up new plugin executables, that way one does not lose active sessions. (NOTE: At least on CC builds, reload is not enough, and you must restart to pickup new plugins and changes to existing plugins)