• Skip to content
• Skip to link menu

KDE 3.5 API Reference

• KDE API Reference
• API Reference

• Sitemap
• Contact Us

 

dcop

ICElibint.h

Go to the documentation of this file.

/* $Xorg: ICElibint.h,v 1.3 2000/08/17 19:44:10 cpqbld Exp $ */
/******************************************************************************


Copyright (c) 1993, 1998  The Open Group

All Rights Reserved.

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
OPEN GROUP 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.

Except as contained in this notice, the name of The Open Group shall not be
used in advertising or otherwise to promote the sale, use or other dealings
in this Software without prior written authorization from The Open Group.

Author: Ralph Mor, X Consortium
******************************************************************************/
/* $XFree86: xc/lib/ICE/ICElibint.h,v 1.4 2001/01/17 19:41:29 dawes Exp $ */
#ifndef _ICELIBINT_H_
#define _ICELIBINT_H_

#include "config.h"
#if defined Q_WS_X11 && ! defined K_WS_QTONLY
#include <X11/Xos.h>
#include <X11/Xfuncs.h>
#include <X11/Xmd.h> //schroder
#else
#define _SIZEOF(x) sz_##x
#define SIZEOF(x) _SIZEOF(x)
#endif
#include <KDE-ICE/ICEproto.h>
#include <KDE-ICE/ICEconn.h>
#include <KDE-ICE/ICEmsg.h>

#ifndef X_NOT_STDC_ENV
#include <stdlib.h>
#else
char *malloc();
#endif

#ifndef NULL
#define NULL 0
#endif


/*
 * Vendor & Release
 */

#define IceVendorString  "MIT"
#define IceReleaseString "1.0"


/*
 * Pad to a 64 bit boundary
 */

#define PAD64(_bytes) ((8 - ((unsigned int) (_bytes) % 8)) % 8)

#define PADDED_BYTES64(_bytes) (_bytes + PAD64 (_bytes))


/*
 * Pad to 32 bit boundary
 */

#define PAD32(_bytes) ((4 - ((unsigned int) (_bytes) % 4)) % 4)

#define PADDED_BYTES32(_bytes) (_bytes + PAD32 (_bytes))


/*
 * Number of 8 byte units in _bytes.
 */

#define WORD64COUNT(_bytes) (((unsigned int) ((_bytes) + 7)) >> 3)


/*
 * Number of 4 byte units in _bytes.
 */

#define WORD32COUNT(_bytes) (((unsigned int) ((_bytes) + 3)) >> 2)


/*
 * Given a string, compute the number of bytes for the STRING representation
 */

#define STRING_BYTES(_string) \
    (2 + strlen (_string) + PAD32 (2 + strlen (_string)))


/*
 * Size of ICE input/output buffers
 */

#define ICE_INBUFSIZE 1024

#define ICE_OUTBUFSIZE 1024


/*
 * Maxium number of ICE authentication methods allowed, and maxiumum
 * number of authentication data entries allowed to be set in the
 * IceSetPaAuthData function.
 *
 * We should use linked lists, but this is easier and should suffice.
 */

#define MAX_ICE_AUTH_NAMES 32
#define ICE_MAX_AUTH_DATA_ENTRIES 100


/*
 * ICE listen object
 */

struct _IceListenObj {
    struct _XtransConnInfo  *trans_conn; /* transport connection object */
    char            *network_id;
    IceHostBasedAuthProc    host_based_auth_proc;
};


/*
 * Some internal data structures for processing ICE messages.
 */

typedef void (*_IceProcessCoreMsgProc) (
#if NeedFunctionPrototypes
    IceConn         /* iceConn */,
    int         /* opcode */,
    unsigned long   /* length */,
    Bool        /* swap */,
    IceReplyWaitInfo *  /* replyWait */,
    Bool *      /* replyReadyRet */,
    Bool *      /* connectionClosedRet */
#endif
);

typedef struct {
    int             major_version;
    int             minor_version;
    _IceProcessCoreMsgProc  process_core_msg_proc;
} _IceVersion;


/*
 * STORE FOO
 */

#define STORE_CARD8(_pBuf, _val) \
{ \
    *((CARD8 *) _pBuf) = _val; \
    _pBuf += 1; \
}

#ifndef WORD64

#define STORE_CARD16(_pBuf, _val) \
{ \
    *((CARD16 *) _pBuf) = _val; \
    _pBuf += 2; \
}

#define STORE_CARD32(_pBuf, _val) \
{ \
    *((CARD32 *) _pBuf) = _val; \
    _pBuf += 4; \
}

#else /* WORD64 */

#define STORE_CARD16(_pBuf, _val) \
{ \
    struct { \
        int value   :16; \
        int pad     :16; \
    } _d; \
    _d.value = _val; \
    memcpy (_pBuf, &_d, 2); \
    _pBuf += 2; \
}

#define STORE_CARD32(_pBuf, _val) \
{ \
    struct { \
        int value   :32; \
    } _d; \
    _d.value = _val; \
    memcpy (_pBuf, &_d, 4); \
    _pBuf += 4; \
}

#endif /* WORD64 */

#define STORE_STRING(_pBuf, _string) \
{ \
    CARD16 _len = strlen (_string); \
    STORE_CARD16 (_pBuf, _len); \
    memcpy (_pBuf, _string, _len); \
    _pBuf += _len; \
    if (PAD32 (2 + _len)) \
        _pBuf += PAD32 (2 + _len); \
}


/*
 * EXTRACT FOO
 */

#define EXTRACT_CARD8(_pBuf, _val) \
{ \
    _val = *((CARD8 *) _pBuf); \
    _pBuf += 1; \
}

#ifndef WORD64

#define EXTRACT_CARD16(_pBuf, _swap, _val) \
{ \
    _val = *((CARD16 *) _pBuf); \
    _pBuf += 2; \
    if (_swap) \
        _val = lswaps (_val); \
}

#define EXTRACT_CARD32(_pBuf, _swap, _val) \
{ \
    _val = *((CARD32 *) _pBuf); \
    _pBuf += 4; \
    if (_swap) \
        _val = lswapl (_val); \
}

#else /* WORD64 */

#define EXTRACT_CARD16(_pBuf, _swap, _val) \
{ \
    _val = *(_pBuf + 0) & 0xff;     /* 0xff incase _pBuf is signed */ \
    _val <<= 8; \
    _val |= *(_pBuf + 1) & 0xff;\
    _pBuf += 2; \
    if (_swap) \
        _val = lswaps (_val); \
}

#define EXTRACT_CARD32(_pBuf, _swap, _val) \
{ \
    _val = *(_pBuf + 0) & 0xff;     /* 0xff incase _pBuf is signed */ \
    _val <<= 8; \
    _val |= *(_pBuf + 1) & 0xff;\
    _val <<= 8; \
    _val |= *(_pBuf + 2) & 0xff;\
    _val <<= 8; \
    _val |= *(_pBuf + 3) & 0xff;\
    _pBuf += 4; \
    if (_swap) \
        _val = lswapl (_val); \
}

#endif /* WORD64 */

#define EXTRACT_STRING(_pBuf, _swap, _string) \
{ \
    CARD16 _len; \
    EXTRACT_CARD16 (_pBuf, _swap, _len); \
    _string = (char *) malloc (_len + 1); \
    memcpy (_string, _pBuf, _len); \
    _pBuf += _len; \
    _string[_len] = '\0'; \
    if (PAD32 (2 + _len)) \
        _pBuf += PAD32 (2 + _len); \
}

#define EXTRACT_LISTOF_STRING(_pBuf, _swap, _count, _strings) \
{ \
    int _i; \
    for (_i = 0; _i < _count; _i++) \
        EXTRACT_STRING (_pBuf, _swap, _strings[_i]); \
}


#define SKIP_STRING(_pBuf, _swap, _end, _bail) \
{ \
    CARD16 _len; \
    EXTRACT_CARD16 (_pBuf, _swap, _len); \
   _pBuf += _len + PAD32(2+_len); \
    if (_pBuf > _end) { \
       _bail; \
    } \
}

#define SKIP_LISTOF_STRING(_pBuf, _swap, _count, _end, _bail) \
{ \
    int _i; \
    for (_i = 0; _i < _count; _i++) \
        SKIP_STRING (_pBuf, _swap, _end, _bail); \
}



/*
 * Byte swapping
 */

/* byte swap a long literal */
#define lswapl(_val) ((((_val) & 0xff) << 24) |\
           (((_val) & 0xff00) << 8) |\
           (((_val) & 0xff0000) >> 8) |\
           (((_val) >> 24) & 0xff))

/* byte swap a short literal */
#define lswaps(_val) ((((_val) & 0xff) << 8) | (((_val) >> 8) & 0xff))



/*
 * ICE replies (not processed via callbacks because we block)
 */

#define ICE_CONNECTION_REPLY    1
#define ICE_CONNECTION_ERROR    2
#define ICE_PROTOCOL_REPLY  3
#define ICE_PROTOCOL_ERROR  4

typedef struct {
    int       type;
    int       version_index;
    char      *vendor;
    char          *release;
} _IceConnectionReply;

typedef struct {
    int       type;
    char      *error_message;
} _IceConnectionError;

typedef struct {
    int       type;
    int       major_opcode;
    int       version_index;
    char      *vendor;
    char      *release;
} _IceProtocolReply;

typedef struct {
    int       type;
    char      *error_message;
} _IceProtocolError;


typedef union {
    int         type;
    _IceConnectionReply connection_reply;
    _IceConnectionError connection_error;
    _IceProtocolReply   protocol_reply;
    _IceProtocolError   protocol_error;
} _IceReply;


/*
 * Watch for ICE connection create/destroy.
 */

typedef struct _IceWatchedConnection {
    IceConn             iceConn;
    IcePointer              watch_data;
    struct _IceWatchedConnection    *next;
} _IceWatchedConnection;

typedef struct _IceWatchProc {
    IceWatchProc        watch_proc;
    IcePointer          client_data;
    _IceWatchedConnection   *watched_connections;
    struct _IceWatchProc    *next;
} _IceWatchProc;


/*
 * Locking
 */

#define IceLockConn(_iceConn)
#define IceUnlockConn(_iceConn)


/*
 * Extern declarations
 */

extern IceConn      _IceConnectionObjs[];
extern char         *_IceConnectionStrings[];
extern int          _IceConnectionCount;

extern int      _IceAuthCount;
extern const char   *_IceAuthNames[];
extern IcePoAuthProc    _IcePoAuthProcs[];
extern IcePaAuthProc    _IcePaAuthProcs[];

extern int      _IceVersionCount;

#define _IceErrorBadMajor _kde_IceErrorBadMajor


extern void _IceErrorBadMajor (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMajor */,
    int         /* offendingMinor */,
    int         /* severity */
#endif
);

#define _IceErrorNoAuthentication _kde_IceErrorNoAuthentication

extern void _IceErrorNoAuthentication (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMinor */
#endif
);

#define _IceErrorNoVersion _kde_IceErrorNoVersion

extern void _IceErrorNoVersion (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMinor */
#endif
);

#define _IceErrorSetupFailed _kde_IceErrorSetupFailed

extern void _IceErrorSetupFailed (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMinor */,
    const char *    /* reason */
#endif
);

#define _IceErrorAuthenticationRejected _kde_IceErrorAuthenticationRejected

extern void _IceErrorAuthenticationRejected (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMinor */,
    const char *    /* reason */
#endif
);

#define _IceErrorAuthenticationFailed _kde_IceErrorAuthenticationFailed

extern void _IceErrorAuthenticationFailed (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* offendingMinor */,
    const char *    /* reason */
#endif
);

#define _IceErrorProtocolDuplicate _kde_IceErrorProtocolDuplicate

extern void _IceErrorProtocolDuplicate (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    const char *    /* protocolName */
#endif
);

#define _IceErrorMajorOpcodeDuplicate _kde_IceErrorMajorOpcodeDuplicate

extern void _IceErrorMajorOpcodeDuplicate (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* majorOpcode */
#endif
);

#define _IceErrorUnknownProtocol _kde_IceErrorUnknownProtocol

extern void _IceErrorUnknownProtocol (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    const char *    /* protocolName */
#endif
);

#define _IceAddOpcodeMapping _kde_IceAddOpcodeMapping

extern void _IceAddOpcodeMapping (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* hisOpcode */,
    int         /* myOpcode */
#endif
);

#define _IceGetPeerName _kde_IceGetPeerName

extern char *_IceGetPeerName (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */
#endif
);

#define _IceFreeConnection _kde_IceFreeConnection

extern void _IceFreeConnection (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */
#endif
);

#define _IceAddReplyWait _kde_IceAddReplyWait

extern void _IceAddReplyWait (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    IceReplyWaitInfo *  /* replyWait */
#endif
);

#define _IceSearchReplyWaits _kde_IceSearchReplyWaits

extern IceReplyWaitInfo *_IceSearchReplyWaits (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    int         /* majorOpcode */
#endif
);

#define _IceSetReplyReady _kde_IceSetReplyReady

extern void _IceSetReplyReady (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    IceReplyWaitInfo *  /* replyWait */
#endif
);

#define _IceCheckReplyReady _kde_IceCheckReplyReady

extern Bool _IceCheckReplyReady (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */,
    IceReplyWaitInfo *  /* replyWait */
#endif
);

#define _IceConnectionOpened _kde_IceConnectionOpened

extern void _IceConnectionOpened (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */
#endif
);

#define _IceConnectionClosed _kde_IceConnectionClosed

extern void _IceConnectionClosed (
#if NeedFunctionPrototypes
    IceConn     /* iceConn */
#endif
);

#define _IceGetPoAuthData _kde_IceGetPoAuthData

extern void _IceGetPoAuthData (
#if NeedFunctionPrototypes
    const char *    /* protocol_name */,
    const char *    /* address */,
    const char *    /* auth_name */,
    unsigned short *    /* auth_data_length_ret */,
    char **     /* auth_data_ret */
#endif
);

#define _IceGetPaAuthData _kde_IceGetPaAuthData

extern void _IceGetPaAuthData (
#if NeedFunctionPrototypes
    const char *    /* protocol_name */,
    const char *    /* address */,
    const char *    /* auth_name */,
    unsigned short *    /* auth_data_length_ret */,
    char **     /* auth_data_ret */
#endif
);

#define _IceGetPoValidAuthIndices _kde_IceGetPoValidAuthIndices

extern void _IceGetPoValidAuthIndices (
#if NeedFunctionPrototypes
    const char *    /* protocol_name */,
    const char *    /* address */,
    int         /* num_auth_names */,
    const char **   /* auth_names */,
    int *       /* num_indices_ret */,
    int *       /* indices_ret */
#endif
);

#define _IceGetPaValidAuthIndices _kde_IceGetPaValidAuthIndices

extern void _IceGetPaValidAuthIndices (
#if NeedFunctionPrototypes
    const char *    /* protocol_name */,
    const char *    /* address */,
    int         /* num_auth_names */,
    const char **   /* auth_names */,
    int *       /* num_indices_ret */,
    int *       /* indices_ret */
#endif
);

#endif /* _ICELIBINT_H_ */

dcop

Skip menu "dcop"

• Main Page
• Modules
• Namespace List
• Class Hierarchy
• Alphabetical List
• Class List
• File List
• Class Members
• Related Pages

API Reference

Skip menu "API Reference"

• dcop
• DNSSD
• interfaces
• Kate
• kconf_update
• KDECore
• KDED
• kdefx
• KDEsu
• kdeui
• KDocTools
• KHTML
• KImgIO
• KInit
• kio
• kioslave
• KJS
• KNewStuff
• KParts
• KUtils

Generated for API Reference by doxygen 1.5.9
This website is maintained by Adriaan de Groot and Allen Winter.
KDE^® and the K Desktop Environment^® logo are registered trademarks of KDE e.V. | Legal