Manual Pages for UNIX Operating System command usage for man dbus-monitor

User Commands                                     dbus-monitor(1)



NAME
     dbus-monitor - debug probe to print message bus messages

SYNOPSIS
     dbus-monitor [--system | --session] [--profile |  --monitor]
     [watch_expressions]

DESCRIPTION
     The dbus-monitor command is used to monitor  messages  going
     through a D-Bus message bus.

     There are two standard message buses:

       +o  systemwide message bus - Launched when  the  system  is
          started and is always available.  Additional systemwide
          services can be launched via D-Bus service  activation.
          However,   D-Bus  service  activation  is  disabled  on
          Solaris.

       +o  per-user-login-session message bus - Launched each time
          a user logs in.


     The --system and --session options  direct  dbus-monitor  to
     monitor  the  system or session buses respectively.  If nei-
     ther is specified, dbus-monitor monitors the session bus.

     dbus-monitor has two different output modes, the  'classic'-
     style monitoring mode and profiling mode. The profiling for-
     mat is a compact format with a single line per  message  and
     microsecond-resolution  timing  information.   The --profile
     and --monitor options select the  profiling  and  monitoring
     output  format respectively.  If neither is specified, dbus-
     monitor uses the monitoring output format.

     In order to get dbus-monitor to see  the  messages  you  are
     interested in, you should specify a set of watch expressions
     as you would expect to be passed to  the  dbus_bus_add_watch
     function.

     The message bus configuration  may  keep  dbus-monitor  from
     seeing  all messages, especially if you run the monitor as a
     non-root user.

OPTIONS
     The following options are supported:

     --monitor

         Use the monitoring output format (this is the default).





SunOS 5.11          Last change: 25 Feb 2009                    1






User Commands                                     dbus-monitor(1)



     --profile

         Use the profiling output format.



     --session

         Monitor the session message bus (this is the default).



     --system

         Monitor the system message bus.  The system bus is  dis-
         abled and unsupported on Solaris.



OPERANDS
     The following operands are supported:

     watch_expressions       In order to display the messages you
                             are   interested   in,   you  should
                             specify a set  of  watch_expressions
                             as  you would expect to be passed to
                             the dbus_bus_add_watch function.



EXAMPLES
     Example 1: How to use dbus-monitor to watch  for  the  GNOME
     typing monitor to say things

     example% dbus-monitor "type='signal',sender='org.gnome.TypingMonitor',interface='org.gnome.TypingMonitor'"

EXIT STATUS
     The following exit values are returned:

     0        Application exited successfully



     >0       Application exited with failure



FILES
     The following files are used by this application:

     /usr/bin/dbus-monitor           Executable for dbus-monitor




SunOS 5.11          Last change: 25 Feb 2009                    2






User Commands                                     dbus-monitor(1)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | system/library/dbus         |
    |_____________________________|_____________________________|
    | Interface stability         | Volatile                    |
    |_____________________________|_____________________________|


SEE ALSO
     More information can be found at:

     http://www.freedesktop.org/software/dbus/

     dbus-binding-tool(1),     dbus-cleanup-sockets(1),     dbus-
     daemon(1),  dbus-launch(1),  dbus-send(1),  dbus-uuidgen(1),
     libdbus-glib-1(3), attributes(5)

NOTES
     For       authorship       information       refer        to
     http://www.freedesktop.org/software/dbus/doc/AUTHORS.
     Updated by Brian Cameron, Sun Microsystems Inc., 2007.

     dbus-monitor was written by Philip Blundell.  The  profiling
     output mode was added by Olli Salli.

     Please send bug reports to the D-Bus  mailing  list  or  bug
     tracker, see http://www.freedesktop.org/software/dbus/























SunOS 5.11          Last change: 25 Feb 2009                    3