dbus/com.ubuntu.Upstart.Job.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!-- upstart

     com.ubuntu.Upstart.Job.xml - interface definition for job objects

     Copyright © 2009 Canonical Ltd.
     Author: Scott James Remnant <scott@netsplit.com>.

     This file is free software; Canonical Ltd gives unlimited permission
     to copy and/or distribute it, with or without modifications, as long
     as this notice is preserved.

     Communication and interaction with Upstart through this interface is
     permitted without restriction.
  -->

<!DOCTYPE node PUBLIC
  "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
  "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">

<node>
  <interface name="com.ubuntu.Upstart0_6.Job">
    <!-- Get object paths for instances, while you can figure these out too,
         it's still better form to use these -->
    <method name="GetInstance">
      <arg name="env" type="as" direction="in" />
      <arg name="instance" type="o" direction="out" />
    </method>
    <method name="GetInstanceByName">
      <arg name="name" type="s" direction="in" />
      <arg name="instance" type="o" direction="out" />
    </method>
    <method name="GetAllInstances">
      <arg name="instances" type="ao" direction="out" />
    </method>

    <!-- Signals for changes to the instance list for a job -->
    <signal name="InstanceAdded">
      <arg name="instance" type="o" />
    </signal>
    <signal name="InstanceRemoved">
      <arg name="instance" type="o" />
    </signal>

    <!-- Job control; the environment arguments are used for both instance
         selection and for passing environment to the processes of the job. -->
    <method name="Start">
      <annotation name="com.netsplit.Nih.Method.Async" value="true" />
      <arg name="env" type="as" direction="in" />
      <arg name="wait" type="b" direction="in" />
      <arg name="instance" type="o" direction="out" />
    </method>
    <method name="Stop">
      <annotation name="com.netsplit.Nih.Method.Async" value="true" />
      <arg name="env" type="as" direction="in" />
      <arg name="wait" type="b" direction="in" />
    </method>
    <method name="Restart">
      <annotation name="com.netsplit.Nih.Method.Async" value="true" />
      <arg name="env" type="as" direction="in" />
      <arg name="wait" type="b" direction="in" />
      <arg name="instance" type="o" direction="out" />
    </method>

    <!-- Basic information about a Job -->
    <property name="name" type="s" access="read" />
    <property name="description" type="s" access="read" />
    <property name="author" type="s" access="read" />
    <property name="version" type="s" access="read" />
  </interface>
</node>