summaryrefslogtreecommitdiffstats
path: root/udkapi/com/sun/star/connection
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 09:06:44 +0000
commited5640d8b587fbcfed7dd7967f3de04b37a76f26 (patch)
tree7a5f7c6c9d02226d7471cb3cc8fbbf631b415303 /udkapi/com/sun/star/connection
parentInitial commit. (diff)
downloadlibreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.tar.xz
libreoffice-ed5640d8b587fbcfed7dd7967f3de04b37a76f26.zip
Adding upstream version 4:7.4.7.upstream/4%7.4.7upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'udkapi/com/sun/star/connection')
-rw-r--r--udkapi/com/sun/star/connection/Acceptor.idl41
-rw-r--r--udkapi/com/sun/star/connection/AlreadyAcceptingException.idl36
-rw-r--r--udkapi/com/sun/star/connection/ConnectionSetupException.idl36
-rw-r--r--udkapi/com/sun/star/connection/Connector.idl40
-rw-r--r--udkapi/com/sun/star/connection/NoConnectException.idl36
-rw-r--r--udkapi/com/sun/star/connection/SocketPermission.idl95
-rw-r--r--udkapi/com/sun/star/connection/XAcceptor.idl76
-rw-r--r--udkapi/com/sun/star/connection/XConnection.idl92
-rw-r--r--udkapi/com/sun/star/connection/XConnection2.idl58
-rw-r--r--udkapi/com/sun/star/connection/XConnectionBroadcaster.idl57
-rw-r--r--udkapi/com/sun/star/connection/XConnector.idl64
11 files changed, 631 insertions, 0 deletions
diff --git a/udkapi/com/sun/star/connection/Acceptor.idl b/udkapi/com/sun/star/connection/Acceptor.idl
new file mode 100644
index 000000000..9448a1f71
--- /dev/null
+++ b/udkapi/com/sun/star/connection/Acceptor.idl
@@ -0,0 +1,41 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef __com_sun_star_connection_Acceptor_idl__
+#define __com_sun_star_connection_Acceptor_idl__
+
+
+ module com { module sun { module star { module connection {
+
+published interface XAcceptor;
+
+
+/** allows to accept connection attempts from another process.
+ <p>
+ Acceptor is a delegating service. You can add further acceptors by giving
+ them a service name com.sun.star.connection.Acceptor.xxx, where xxx is the
+ connection type used in the connection string during accept()/connect() call.
+
+ */
+published service Acceptor: XAcceptor;
+
+
+}; }; }; };
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/AlreadyAcceptingException.idl b/udkapi/com/sun/star/connection/AlreadyAcceptingException.idl
new file mode 100644
index 000000000..ab9e3a154
--- /dev/null
+++ b/udkapi/com/sun/star/connection/AlreadyAcceptingException.idl
@@ -0,0 +1,36 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_ALREADYACCEPTINGEXCEPTION_IDL_
+#define _COM_SUN_STAR_CONNECTION_ALREADYACCEPTINGEXCEPTION_IDL_
+#include <com/sun/star/uno/Exception.idl>
+
+ module com { module sun { module star { module connection {
+
+/** Is thrown, when there is another thread already accepting on this instance.
+ */
+published exception AlreadyAcceptingException: com::sun::star::uno::Exception
+{
+};
+
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/ConnectionSetupException.idl b/udkapi/com/sun/star/connection/ConnectionSetupException.idl
new file mode 100644
index 000000000..816454afd
--- /dev/null
+++ b/udkapi/com/sun/star/connection/ConnectionSetupException.idl
@@ -0,0 +1,36 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_CONNECTIONSETUPEXCEPTION_IDL_
+#define _COM_SUN_STAR_CONNECTION_CONNECTIONSETUPEXCEPTION_IDL_
+#include <com/sun/star/uno/Exception.idl>
+
+ module com { module sun { module star { module connection {
+
+/** Is thrown, when it is not possible to accept on a local resource.
+ */
+published exception ConnectionSetupException: com::sun::star::uno::Exception
+{
+};
+
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/Connector.idl b/udkapi/com/sun/star/connection/Connector.idl
new file mode 100644
index 000000000..b5fecbb66
--- /dev/null
+++ b/udkapi/com/sun/star/connection/Connector.idl
@@ -0,0 +1,40 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef __com_sun_star_connection_Connector_idl__
+#define __com_sun_star_connection_Connector_idl__
+
+
+ module com { module sun { module star { module connection {
+
+published interface XConnector;
+
+
+/** allows to establish a connection to another process.
+ <p>
+ Connector is a delegating service. You can add further connectors by giving
+ them a service name com.sun.star.connection.Connector.xxx, where xxx is the
+ connection type used in the connection string during accept()/connect() call.
+ */
+published service Connector: XConnector;
+
+
+}; }; }; };
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/NoConnectException.idl b/udkapi/com/sun/star/connection/NoConnectException.idl
new file mode 100644
index 000000000..63044bdf3
--- /dev/null
+++ b/udkapi/com/sun/star/connection/NoConnectException.idl
@@ -0,0 +1,36 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_NOCONNECTEXCEPTION_IDL_
+#define _COM_SUN_STAR_CONNECTION_NOCONNECTEXCEPTION_IDL_
+#include <com/sun/star/uno/Exception.idl>
+
+module com { module sun { module star { module connection {
+
+/** Is thrown in case no one is accepting on the specified resource.
+ */
+published exception NoConnectException: com::sun::star::uno::Exception
+{
+};
+
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/SocketPermission.idl b/udkapi/com/sun/star/connection/SocketPermission.idl
new file mode 100644
index 000000000..7f838a25f
--- /dev/null
+++ b/udkapi/com/sun/star/connection/SocketPermission.idl
@@ -0,0 +1,95 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef __com_sun_star_connection_SocketPermission_idl__
+#define __com_sun_star_connection_SocketPermission_idl__
+
+
+module com { module sun { module star { module connection {
+
+
+/** This permission represents access to a network via sockets.
+ A SocketPermission consists of a host specification and a set of actions
+ specifying ways to connect to that host. The host is specified as
+ <pre>
+ host = (hostname | IPaddress)[:portrange]
+ portrange = portnumber | -portnumber | portnumber-[portnumber]
+ </pre>
+ The host is expressed as a DNS name, as a numerical IP address, or as
+ <code>"localhost"</code> (for the local machine). The wildcard <code>"*"</code>
+ may be included once
+ in a DNS name host specification. If it is included, it must be in the
+ leftmost position, as in <code>"*.sun.com"</code>.
+ <br>
+ The port or portrange is optional. A port specification of the form <code>"N-"</code>,
+ where <code>N</code> is a port number, signifies all ports numbered <code>N</code> and above,
+ while a specification of the form <code>"-N"</code> indicates all ports numbered
+ <code>N</code> and below.
+
+ <p>
+ The possible ways to connect to the host are
+ <ul>
+ <li><code>accept</code></li>
+ <li><code>connect</code></li>
+ <li><code>listen</code></li>
+ <li><code>resolve</code></li>
+ </ul><br>
+ The <code>"listen"</code> action is only meaningful when used with <code>"localhost"</code>.
+ The <code>"resolve"</code> (resolve host/ip name service lookups) action is implied when
+ any of the other actions are present.
+ <br>
+ As an example of the creation and meaning of SocketPermissions, note that if
+ the following permission
+<pre>
+SocketPermission("foo.bar.com:7777", "connect,accept");
+</pre>
+ is granted, it allows to connect to port 7777 on foo.bar.com, and to
+ accept connections on that port.
+ <br>
+ Similarly, if the following permission
+<pre>
+SocketPermission("localhost:1024-", "accept,connect,listen");
+</pre>
+ is granted, it allows that code to accept connections on, connect to, or listen
+ on any port between 1024 and 65535 on the local host.
+ </p>
+
+ @attention
+ Granting code permission to accept or make connections to remote hosts may be
+ dangerous because malevolent code can then more easily transfer and share
+ confidential data among parties who may not otherwise have access to the data.
+ </p>
+
+ @since OOo 1.1.2
+*/
+published struct SocketPermission
+{
+ /** target host with optional portrange
+ */
+ string Host;
+ /** comma separated actions list
+ */
+ string Actions;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/XAcceptor.idl b/udkapi/com/sun/star/connection/XAcceptor.idl
new file mode 100644
index 000000000..c75469d81
--- /dev/null
+++ b/udkapi/com/sun/star/connection/XAcceptor.idl
@@ -0,0 +1,76 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_XACCEPTOR_IDL_
+#define _COM_SUN_STAR_CONNECTION_XACCEPTOR_IDL_
+
+#include <com/sun/star/connection/ConnectionSetupException.idl>
+#include <com/sun/star/connection/AlreadyAcceptingException.idl>
+#include <com/sun/star/lang/IllegalArgumentException.idl>
+#include <com/sun/star/connection/XConnection.idl>
+
+
+module com { module sun { module star { module connection {
+
+/** allows to passively accept connection attempts from other processes.
+
+ <p>
+ This is the counterpart to the XConnector interface.
+ */
+published interface XAcceptor: com::sun::star::uno::XInterface
+{
+ /** accepts an interprocess connection. Waits until someone connects to the resource.
+ <p>
+ After a successful return, the method may be called again to accept
+ further connections, but the parameter string MUST be left unchanged.
+
+
+ @param sConnectionDescription
+ contains the kind of the connection plus a
+ comma separated list of attributes,
+ e.g., <em>socket,host=localhost,port=2345</em> for a tcpip connection.
+
+ @return null reference,
+ stopAccepting was called.
+ Otherwise a valid XConnection reference.
+
+ @throws AlreadyAcceptingException
+ Only one acceptor-thread per instance allowed.
+ @throws ConnectionSetupException
+ Problems during setting up the acceptor.
+ (e.g., Security-reasons, socket already busy, etc.)
+ @throws com::sun::star::lang::IllegalArgumentException
+ sConnectionDescription could not be interpreted
+
+ */
+ XConnection accept( [in] string sConnectionDescription )
+ raises( AlreadyAcceptingException,
+ ConnectionSetupException,
+ com::sun::star::lang::IllegalArgumentException);
+
+
+ /** pushes acceptor out of the accept-call.
+ */
+ void stopAccepting();
+};
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/XConnection.idl b/udkapi/com/sun/star/connection/XConnection.idl
new file mode 100644
index 000000000..e8325775c
--- /dev/null
+++ b/udkapi/com/sun/star/connection/XConnection.idl
@@ -0,0 +1,92 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_XCONNECTION_IDL_
+#define _COM_SUN_STAR_CONNECTION_XCONNECTION_IDL_
+
+#include <com/sun/star/io/IOException.idl>
+
+
+module com { module sun { module star { module connection {
+
+/** A bidirectional bytestream.
+
+ <p> You should additionally implement XConnection2.
+
+ @see XConnection2
+ */
+published interface XConnection: com::sun::star::uno::XInterface
+{
+
+ /** reads a requested number of bytes from the connection.
+ <p> This method is blocking, meaning that it always returns a bytesequence
+ with the requested number of bytes, unless it has reached end of file (which
+ often means, that close() has been called).
+
+ <p> please see also the readSomeBytes() method of XConnection2.
+
+ @return The read number of bytes.
+ The return value and the length of the
+ returned sequence must be identical.
+ @param aReadBytes
+ The buffer to receive the read bytes.
+ @param nBytesToRead
+ The number of bytes to be read from the stream.
+
+ @throws com::sun::star::io::IOException
+ in case an error occurred during reading from the stream.
+ */
+ long read( [out] sequence < byte > aReadBytes , [in] long nBytesToRead )
+ raises( com::sun::star::io::IOException );
+
+ /** writes the given bytesequence to the stream.
+ <p>The method blocks until the whole sequence is written.
+
+ @throws com::sun::star::io::IOException
+ in case an error occurred during writing to the stream.
+ */
+ void write( [in] sequence < byte > aData )
+ raises( com::sun::star::io::IOException );
+
+
+ /** Empties all internal buffers.
+ */
+ void flush( )
+ raises( com::sun::star::io::IOException );
+
+ /** Immediately terminates any ongoing read or write calls.
+ All subsequent read or write calls()
+ */
+ void close( )
+ raises( com::sun::star::io::IOException );
+
+
+ /** A unique string describing the connection.
+
+ <p>This string is different from the arguments to XConnection::accept()
+ and XConnector::connect(). In general, the string contains an additional
+ handle value. For example, "socket,host=localhost,port=2002,uniqueValue=2324". </p>
+ */
+ string getDescription();
+};
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/XConnection2.idl b/udkapi/com/sun/star/connection/XConnection2.idl
new file mode 100644
index 000000000..74e4796d5
--- /dev/null
+++ b/udkapi/com/sun/star/connection/XConnection2.idl
@@ -0,0 +1,58 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_XCONNECTION2_IDL_
+#define _COM_SUN_STAR_CONNECTION_XCONNECTION2_IDL_
+
+#include <com/sun/star/io/IOException.idl>
+#include <com/sun/star/io/BufferSizeExceededException.idl>
+#include <com/sun/star/io/NotConnectedException.idl>
+
+#include <com/sun/star/connection/XConnection.idl>
+
+
+module com { module sun { module star { module connection {
+
+
+
+
+/**
+ XConnection2 extends the <code>XConnection</code> interface
+ with <code>available</code> and <code>readSomeBytes</code>
+*/
+published interface XConnection2: com::sun::star::connection::XConnection
+{
+
+ /** Gives the number of bytes available via <code>read</code>
+ without blocking.
+ */
+ long available() raises(com::sun::star::io::IOException);
+
+ /** Blocks if no data is available otherwise reads at
+ max <var>nMaxBytesToRead</var> but at least 1 byte.
+ </p>
+ */
+ long readSomeBytes([out] sequence<byte> aData, [in] long nMaxBytesToRead)
+ raises(com::sun::star::io::IOException);
+};
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/XConnectionBroadcaster.idl b/udkapi/com/sun/star/connection/XConnectionBroadcaster.idl
new file mode 100644
index 000000000..b60b3c5c5
--- /dev/null
+++ b/udkapi/com/sun/star/connection/XConnectionBroadcaster.idl
@@ -0,0 +1,57 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_XCONNECTIONBROADCASTER_IDL_
+#define _COM_SUN_STAR_CONNECTION_XCONNECTIONBROADCASTER_IDL_
+
+#include <com/sun/star/io/XStreamListener.idl>
+
+
+ module com { module sun { module star { module connection {
+
+
+
+
+/** allows to add listeners to a connection.
+ <p> Maybe supported by connections returned from XAcceptor::accept()
+ or XConnector::connect().
+ */
+published interface XConnectionBroadcaster: com::sun::star::uno::XInterface
+{
+
+ /** registers an object to receive events from this connection.
+
+ <p>It is suggested to allow multiple registration of the same listener,
+ thus for each time a listener is added, it has to be removed.
+ */
+ void addStreamListener( [in] com::sun::star::io::XStreamListener aListener );
+
+
+ /** unregisters an object to receive events from this connection.
+
+ <p>It is suggested to allow multiple registration of the same listener,
+ thus for each time a listener is added, it has to be removed.
+ */
+ void removeStreamListener( [in] com::sun::star::io::XStreamListener aListener );
+};
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
diff --git a/udkapi/com/sun/star/connection/XConnector.idl b/udkapi/com/sun/star/connection/XConnector.idl
new file mode 100644
index 000000000..93709195f
--- /dev/null
+++ b/udkapi/com/sun/star/connection/XConnector.idl
@@ -0,0 +1,64 @@
+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * This file incorporates work covered by the following license notice:
+ *
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright
+ * ownership. The ASF licenses this file to you under the Apache
+ * License, Version 2.0 (the "License"); you may not use this file
+ * except in compliance with the License. You may obtain a copy of
+ * the License at http://www.apache.org/licenses/LICENSE-2.0 .
+ */
+#ifndef _COM_SUN_STAR_CONNECTION_XCONNECTOR_IDL_
+#define _COM_SUN_STAR_CONNECTION_XCONNECTOR_IDL_
+
+#include <com/sun/star/connection/ConnectionSetupException.idl>
+#include <com/sun/star/connection/NoConnectException.idl>
+#include <com/sun/star/lang/IllegalArgumentException.idl>
+#include <com/sun/star/connection/XConnection.idl>
+
+
+module com { module sun { module star { module connection {
+
+/**
+ allows to actively establish an interprocess connection.
+ */
+published interface XConnector: com::sun::star::uno::XInterface
+{
+ /** creates a new connection interprocess connection.
+ <p>
+ Tries to connect to an XAcceptor. Behavior is unspecified
+ if a call to connect is made when another call to connect either has not
+ yet returned or has returned successfully without raising an exception.
+
+ @param sConnectionDescription
+ contains the kind of the connection plus a
+ comma separated list of attributes,
+ e.g., <em>socket,host=localhost,port=2345</em> for a tcpip connection.
+
+ @throws ConnectionSetupException
+ Problems during setting up the connector
+ on client side, (e.g., Security-reasons, socket already busy .. ),
+ or the string could not be interpreted correctly.
+
+ @throws NoConnectException
+ Couldn't reach a server (e.g. network failure),
+ no server is listening
+ */
+ XConnection connect( [in] string sConnectionDescription )
+ raises( NoConnectException,ConnectionSetupException );
+};
+
+
+};};};};
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab: */