
README
======

lsdbus is a small utility to scan the system and session message
bus for participants and prints their names an unique bus identifiers.

This tool needs a running dbus daemon to work properly. Otherwise
it will print an error message.


LEGAL NOTICE
============
Copyright 2005 Matthias Grimm (matthiasgrimm@users.sourceforge.net).

This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation; either version
2 of the License, or (at your option) any later version.


INSTALL
=======

First of all the program has to be compiled. This is a rather simple
job because it is a simple program.

The program depends on the glib and the dbus glib bindings. Please
asure that appropriate developer files (header files) are installed
on your system. The Makefile will determine compiler flags and library
locations by its own with the program pkg-config, which should be set
up properly if you use a GNU/Linux distribution.

1. unpack the archive in an directory of your choice with following
   commands:
                  tar -xvf lsdbus.tgz

   After that you will find following files in the same directory:

     lsdbus.c     - The programm code
     lsdbus.h     - Some header information needed by lsdbus.c
     lsdbus.1     - the man page
     Makefile     - Makefile to compile the programm
     README       - This text

2. Now type: make

3. After some seconds you will find another executable file lsdbus
   in your directory

4. Copy the manfile lsdbus.1 to /usr/local/man/man1

5. That's it. That wasn't very difficult, was it.


HOW IT WORKS
============

lsdbus opens a connection to the session and to the system dbus daemon
and asks them for clients at the bus. It tries to determine the unique
bus identifier for each name and print the results to the terminal
window.

The output should look like something like the following:

Session bus:
  No session bus available.

System bus:
  org.freedesktop.DBus           (--)
  org.freedesktop.Hal            (:1.1)
	  

  Thank you and enjoy
    Matthias Grimm

