Mercurial Mercurial > oss > FCL > sftools > depl > docscontent / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Symbian3/PDK/Source/GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita
changeset 1 25a17d01db0c
child 3 46218c8b8afa 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/PDK/Source/GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita	Fri Jan 22 18:26:19 2010 +0000
@@ -0,0 +1,91 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- Copyright (c) 2007-2010 Nokia Corporation and/or its subsidiary(-ies) All rights reserved. -->
+<!-- This component and the accompanying materials are made available under the terms of the License 
+"Eclipse Public License v1.0" which accompanies this distribution, 
+and is available at the URL "http://www.eclipse.org/legal/epl-v10.html". -->
+<!-- Initial Contributors:
+    Nokia Corporation - initial contribution.
+Contributors: 
+-->
+<!DOCTYPE concept
+  PUBLIC "-//OASIS//DTD DITA Concept//EN" "concept.dtd">
+<concept id="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB" xml:lang="en"><title> Connecting
+and Disconnecting a Remote Host Tutorial</title><shortdesc>This topic describes how to connect and disconnect a remote host. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>
+
+<section><title>Introduction</title><p>To send and receive the data packets,
+a connection must be established with a remote host. This tutorial describes
+the following: </p><ul>
+<li><p> <xref href="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita#GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB/GUID-E832AD84-7441-5AC2-9884-AAC0C736CCBE">How
+to Connect to a Remote Host</xref>  </p> </li>
+<li><p>  <xref href="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita#GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB/GUID-A1FD6397-0110-50FE-89E2-CB0734FD5D22">How
+to Disconnect from a Remote Host</xref>  </p> </li>
+<li><p>  <xref href="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita#GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB/GUID-D1876052-357C-5D1B-AC2D-23536CC60FF6">How
+to Listen to a Connect Request</xref> </p> </li>
+<li><p>  <xref href="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita#GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB/GUID-90E124C2-4B2C-51FE-AF07-923853C617B7">How
+to Accept a Connect Request</xref>  </p> </li>
+<li><p>  <xref href="GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB.dita#GUID-182A7A60-80BD-5E54-917A-8F4C26BB94CB/GUID-7727C0A0-5D80-5325-991E-0BA627B1356C">How
+to Shut down a Connection</xref>  </p> </li>
+</ul> </section>
+<section><title>How
+to Connect to a Remote Host</title><p>The high level steps to connect to a
+remote host are as follows:</p> <ol id="GUID-46E4E5C3-E121-5B53-8E52-E00C6FE664AB">
+<li id="GUID-84078269-543D-533E-B0C8-F571AFD0B049"><p>The <xref href="GUID-D4F08503-F1EF-3531-9C3C-4AF24A6255F0.dita#GUID-D4F08503-F1EF-3531-9C3C-4AF24A6255F0/GUID-AC5A49E9-337D-334A-9CD0-DB8226372306"><apiname>RSocket::Connect()</apiname></xref> function
+connects to a remote host. The <codeph>RSocket::Connect()</codeph> parameters
+identifies the required type of socket connection. For more information, see <xref href="GUID-B8DEA3EE-7BA7-5A29-9A27-B87EE0EB254F.dita#GUID-B8DEA3EE-7BA7-5A29-9A27-B87EE0EB254F/GUID-EB1C5A5A-E40C-559B-82E9-D19F8E4F4B49">important
+parameters</xref> . </p> <p>For TCP sockets </p> <ol id="GUID-FCF6E01D-A632-595C-A79C-A17D13A9EE63">
+<li id="GUID-D10BD1B0-549C-5766-B81E-D5B88B2C9F9F"><p>An active connection
+is made to the remote host. When the socket call completes successfully, the
+socket can send and receive data. To create a connection, the protocol must
+establish a network interface and a route to the destination. For more information
+about this process and return values, see the <xref href="GUID-D4F08503-F1EF-3531-9C3C-4AF24A6255F0.dita#GUID-D4F08503-F1EF-3531-9C3C-4AF24A6255F0/GUID-AC5A49E9-337D-334A-9CD0-DB8226372306"><apiname>RSocket::Connect()</apiname></xref> function. </p> </li>
+</ol> </li>
+<li id="GUID-37CC6747-BC8D-5C6E-8358-4EEEB5BC90C8"><p>For UDP </p> <ol id="GUID-1D9019A5-43C9-5D62-ABBC-8589472D24A1">
+<li id="GUID-54B60EA0-F3B1-5261-B795-E67A8D616C93"><p>UDP is a connectionless
+protocol which means the <codeph>RSocket::Connect()</codeph> does not have
+to be called before writing data with <codeph>RSocket::SendTo()</codeph>.
+It can be used to set the address for all data sent from the socket. In this
+case, <codeph>Send()/Write()</codeph> function can be used in addition to <codeph>SendTo()</codeph> function. </p> </li>
+</ol> </li>
+</ol><title>How to Disconnect from a Remote Host</title><p> For cancelling
+the connection  </p><p> The <codeph>RSocket::CancelConnect()</codeph> function
+cancels the outstanding connect operation with a remote host. This function
+also cancels any outstanding <codeph>RSocket::Ioctl()</codeph> calls. After
+this call, a socket can be reconnected by <codeph>RSocket::Connect()</codeph> function.
+ </p><title>How to Listen to a Connect Request</title><p> A TCP socket can
+be set to listen with <codeph>RSocket::Listen()</codeph>. The <codeph>aDataOut</codeph> argument
+is ignored.  </p><title>How to Accept a Connect Request</title><p> A connection
+request to a listening socket can be accepted with <codeph>RSocket::Accept()</codeph>.
+An <codeph>aConnectData</codeph> argument cannot be specified.  </p><title>How
+to Shut down a Connection</title><p> Use <codeph>RSocket::Shutdown()</codeph> to
+asynchronously shut down a TCP. Disconnection data is not supported.  </p><p> The
+following table describes the effects of different types of shut down for
+TCP:  </p><table id="GUID-278A0CA9-6C8E-4909-9D69-4535C025C51D">
+<tgroup cols="2"><colspec colname="col1"/><colspec colname="col2"/>
+<tbody>
+<row>
+<entry><b>Type</b></entry>
+<entry><b>Action</b></entry>
+</row>
+<row>
+<entry><codeph>ENormal</codeph></entry>
+<entry>Blocked reads and writes are terminated. No further data is accepted
+from the remote source and TCP disconnect is initiated. </entry>
+</row>
+<row>
+<entry><codeph>EStopInput</codeph></entry>
+<entry>Blocked reads are terminated. No further data is accepted from the
+remote source.</entry>
+</row>
+<row>
+<entry><codeph>EStopOutput</codeph></entry>
+<entry>Blocked writes are terminated. TCP disconnect is initiated.</entry>
+</row>
+<row>
+<entry><codeph>Eimmediate</codeph></entry>
+<entry>Blocked reads and writes are terminated. The connection is terminated
+by sending a reset.</entry>
+</row>
+</tbody>
+</tgroup>
+</table> </section>
+</conbody></concept>
\ No newline at end of file
FCL/sftools/depl/docscontent