<?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>