git.maemo.org Git - dbuscron/blob - doc/dbuscrontab

   1 # This is a system-wide dbuscron config file.
   2 # Lines starting with `#' are ignored.
   3 # Format of this file (table with whitespace-separated records):
   4 #
   5 # bus type sender interface path member destination arguments command
   6 #
   7 # Any field can have asterisk only (*) to match any value, each field can have
   8 # multiple values separated with comma (,), matching any of these values will
   9 # match. Only last (command) field can contain spaces. Bus field can be either
  10 # `S' for system bus or `s' for session bus, type field can have one of signal,
  11 # method_return, method_call or error values. Arguments consist of
  12 # semicolon-separated values to match arguments of DBUS events.
  13 #
  14 # Examples:
  15 #
  16 # Run command for every DBUS event:
  17 # * * * * * * * * command
  18 #
  19 # Run command on system bus event named Event with type either method_call or
  20 # method_return:
  21 # S method_call,method_return * * * * Event * command
  22 #
  23 # The same as above, by check if second argument equals either `foo' or `bar',
  24 # or first arguments is baz:
  25 # S method_call,method_return * * * * Event ;foo,;bar,baz command
  26 #
  27 # More practical examples:
  28 #
  29 # Run command on incoming call:
  30 # S signal * com.nokia.csd.Call /com/nokia/csd/call Coming * * run-standalone.sh incoming-call-hook.sh
  31 #
  32 # Run command on GPRS connected:
  33 # S signal * com.nokia.csd.GPRS.Context /com/nokia/csd/gprs/0 Connected * * run-standalone.sh gprs-connected-hook.sh
  34 #
  35 # This file can also contain any number of environmental variables settings, e.g.:
  36 # PATH = /usr/bin:/usr/sbin
  37 #
  38 # When command is running there're a number of environmental variables set so
  39 # the script can check DBUS event data. The variables are:
  40 #   DBUS_ARG# (where # is the number from 0 to DBUS_ARGN) - arguments of event,
  41 #   DBUS_ARGN - number of event arguments,
  42 #   DBUS_SENDER - event sender name,
  43 #   DBUS_DEST - event destination name,
  44 #   DBUS_IFACE - event interface,
  45 #   DBUS_PATH - event object path,
  46 #   DBUS_MEMBER - called event member,
  47 #   DBUS_BUS - bus event came from (`session' or `system'),
  48 #   DBUS_TYPE - event type as described above.
  49 #
  50