/***************************************************************************
                            kde_KCookie.h -  description
                             -------------------
    begin                : Wed Feb  6 15:12:26 2002
    copyright            : (C) 2000-2001 Lost Highway Ltd. All rights reserved.
    email                : Lost_Highway@tipitina.demon.co.uk
    generated by         : duke@tipitina on Wed Feb  6 15:12:26 2002, using kalyptus 0.9.
 ***************************************************************************/

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

#ifndef KDE_KCOOKIE
#define KDE_KCOOKIE

#include <qtc/qtc_types.h>

#include <kdec/kde_types.h>

/**

 Utility class to access the authentication tokens needed to run a KDE
 program (X11 and DCOP cookies).
 
 @short 
 Utility class to access the authentication tokens needed to run a KDE
 program (X11 and DCOP cookies).
*/
kde_KCookie * kde_new_KCookie();

/**  Returns the X11 display. 
*/
qt_QCString* kde_KCookie_display(kde_KCookie* instPointer);

/**  Returns the X11 magic cookie, if available. 
*/
qt_QCString* kde_KCookie_displayAuth(kde_KCookie* instPointer);

/**  Select the DCOP transport to look for. Default: "local" *
*/
void kde_KCookie_setDcopTransport(kde_KCookie* instPointer,qt_QCString* dcopTransport);

/**  Returns the netid where the dcopserver is running 
*/
qt_QCString* kde_KCookie_dcopServer(kde_KCookie* instPointer);

/**  
 Returns a list of magic cookies for DCOP protocol authentication. 
 The order is the same as in dcopServer().
     
*/
qt_QCString* kde_KCookie_dcopAuth(kde_KCookie* instPointer);

/**  Returns a list of magic cookies for the ICE protocol. 
*/
qt_QCString* kde_KCookie_iceAuth(kde_KCookie* instPointer);

#endif
