summaryrefslogtreecommitdiffstats
path: root/xyz/openbmc_project/ObjectMapper.interface.yaml
diff options
context:
space:
mode:
authorBrad Bishop <bradleyb@fuzziesquirrel.com>2016-11-01 12:47:24 -0500
committerBrad Bishop <bradleyb@us.ibm.com>2016-11-01 12:56:26 -0500
commit938b1d5dd83bddcb21389e5e23987b0530459eef (patch)
treeb8b41da9158ef9cf723d495cf9fa049cef935f9c /xyz/openbmc_project/ObjectMapper.interface.yaml
parenta948d268ffed67381d75fe17607fd84ecb498e8b (diff)
downloadphosphor-dbus-interfaces-938b1d5dd83bddcb21389e5e23987b0530459eef.tar.gz
phosphor-dbus-interfaces-938b1d5dd83bddcb21389e5e23987b0530459eef.zip
Document existing ObjectMapper interface
With one caveat - moved to xyz namespace. Change-Id: I14bdd1d0bdae8879cdbf976184e1aa462a254281 Signed-off-by: Brad Bishop <bradleyb@fuzziesquirrel.com>
Diffstat (limited to 'xyz/openbmc_project/ObjectMapper.interface.yaml')
-rw-r--r--xyz/openbmc_project/ObjectMapper.interface.yaml75
1 files changed, 75 insertions, 0 deletions
diff --git a/xyz/openbmc_project/ObjectMapper.interface.yaml b/xyz/openbmc_project/ObjectMapper.interface.yaml
new file mode 100644
index 0000000..aa0f6e1
--- /dev/null
+++ b/xyz/openbmc_project/ObjectMapper.interface.yaml
@@ -0,0 +1,75 @@
+description: >
+ Implement to provide DBus service lookup features.
+
+ Any OpenBMC implementation must provide exactly one implementation of
+ xyz.openbmc_project.ObjectMapper on /xyz/openbmc_project/ObjectMapper.
+methods:
+ - name: GetObject
+ description: >
+ Obtain a dictionary of service -> implemented interface(s)
+ for the given path.
+ parameters:
+ - name: path
+ type: s # TODO: o
+ description: >
+ The object path for which the result should be fetched.
+ returns:
+ - name: services
+ type: a{sas}
+ description: >
+ A dictionary of service -> implemented interface(s).
+ - name: GetAncestors
+ description: >
+ Obtain a dictionary of ancestor -> services where ancestor is an
+ ancestor of path and services is of the type returned by the
+ GetObject method.
+ parameters:
+ - name: path
+ type: s # TODO: o
+ description: >
+ The path for which the result should be fetched.
+ returns:
+ - name: ancestors
+ type: a{sa{sas}} # TODO a{oa{sas}}
+ description: >
+ A dictionary of ancestor -> services.
+ - name: GetSubTree
+ description: >
+ Obtain a dictionary of path -> services where path is in
+ sutbtree and services is of the type returned by the
+ GetObject method.
+ parameters:
+ - name: subtree
+ type: s # TODO: o
+ description: >
+ The subtree path for which the result should be fetched.
+ - name: depth
+ type: i
+ description: >
+ The maximum subtree depth for which results should be fetched.
+ For unconstrained fetches use a depth of zero.
+ returns:
+ - name: objects
+ type: a{sa{sas}} # TODO a{oa{sas}}
+ description: >
+ A dictionary of path -> services.
+ - name: GetSubTreePaths
+ description: >
+ Obtain an array of paths where array elements are in subtree.
+ parameters:
+ - name: subtree
+ type: s # TODO: o
+ description: >
+ The subtree path for which the result should be fetched.
+ - name: depth
+ type: i
+ description: >
+ The maximum subtree depth for which results should be fetched.
+ For unconstrained fetches use a depth of zero.
+ returns:
+ - name: paths
+ type: as # TODO ao
+ description: >
+ An array of paths.
+
+# vim: tabstop=8 expandtab shiftwidth=4 softtabstop=4
OpenPOWER on IntegriCloud