#!/usr/bin/env python

"""Usage: python list-system-services.py [--session|--system]

List services on the system bus (default) or the session bus."""

# Copyright (C) 2004-2006 Red Hat Inc. <http://www.redhat.com/>

# Copyright (C) 2005-2007 Collabora Ltd. <http://www.collabora.co.uk/>

#

# Permission is hereby granted, free of charge, to any person

# obtaining a copy of this software and associated documentation

# files (the "Software"), to deal in the Software without

# restriction, including without limitation the rights to use, copy,

# modify, merge, publish, distribute, sublicense, and/or sell copies

# of the Software, and to permit persons to whom the Software is

# furnished to do so, subject to the following conditions:

#

# The above copyright notice and this permission notice shall be

# included in all copies or substantial portions of the Software.

#

# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,

# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF

# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND

# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT

# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,

# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER

# DEALINGS IN THE SOFTWARE.

import sys

import dbus

def main(argv):

    factory = dbus.SystemBus

    if len(argv) > 2:

        sys.exit(__doc__)

    elif len(argv) == 2:

        if argv[1] == '--session':

            factory = dbus.SessionBus

        elif argv[1] != '--system':

            sys.exit(__doc__)

    # Get a connection to the system or session bus as appropriate

    # We're only using blocking calls, so don't actually need a main loop here

    bus = factory()

    # This could be done by calling bus.list_names(), but here's

    # more or less what that means:

    # Get a reference to the desktop bus' standard object, denoted

    # by the path /org/freedesktop/DBus.

    dbus_object = bus.get_object('org.freedesktop.DBus',

                                 '/org/freedesktop/DBus')

    # The object /org/freedesktop/DBus

    # implements the 'org.freedesktop.DBus' interface

    dbus_iface = dbus.Interface(dbus_object, 'org.freedesktop.DBus')

    # One of the member functions in the org.freedesktop.DBus interface

    # is ListNames(), which provides a list of all the other services

    # registered on this bus. Call it, and print the list.

    services = dbus_iface.ListNames()

    services.sort()

    for service in services:

        print service

if __name__ == '__main__':

    main(sys.argv)