User Commands                                     dbus-monitor(1)



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

SYNOPSIS
     dbus-monitor [--system  --session] [--profile   --monitor]
     [watchexpressions]

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 - Disabled and not supported  on
          Solaris,  but  installed  on  many systems as the "mes-
          sagebus" init service.

       ]o  per-user-login-session message bus - Enabled  and  sup-
          ported  on  Solaris,  and started 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.

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

     See   http:/www.freedesktop.org/software/dbus/   for   more
     information.

OPTIONS
     The following options are supported:

     --monitor

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



     --profile




SunOS 5.11          Last change: 19 Nov 2007                    1






User Commands                                     dbus-monitor(1)



         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:

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



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



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






SunOS 5.11          Last change: 19 Nov 2007                    2






User Commands                                     dbus-monitor(1)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWdbus                    
    
     Interface stability          Volatile                    
    


SEE ALSO
     dbus-cleanup-sockets(1),   dbus-daemon(1),   dbus-launch(1),
     dbus-send(1),   dbus-uuidgen(1),  libdbus-glib-1(3),  attri-
     butes(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: 19 Nov 2007                    3