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

  PUBLIC "-//OASIS//DTD DITA Task//EN" "task.dtd">

<task id="GUID-B8DEA3EE-7BA7-5A29-9A27-B87EE0EB254F" xml:lang="en"><title>Accessing

TCP/IP Sockets Tutorial</title><shortdesc>This topic describes how to access TCP/IP sockets. </shortdesc><prolog><metadata><keywords/></metadata></prolog><taskbody>

<prereq><p>You must be familiar with <codeph>RSocketServ()</codeph> and <codeph>RSocket()</codeph> to

understand this tutorial. </p> </prereq>

<context><p>Client programs access TCP/IP sockets through the generic socket

interface <codeph>RSocket()</codeph>. The <codeph>RSocket()</codeph> specifies

the protocol-specific behaviour through argument values. This tutorial contains

notes on the usage of <codeph>RSocket()</codeph> functions for TCP and UDP

sockets. </p><p> The high level steps to access the TCP/IP sockets are as

follows: </p> </context>

<steps id="GUID-613D3E19-02F2-578A-89AC-B639B8952357">

<step id="GUID-B608A9CE-1A99-5A6F-AE6D-63015A0BE089"><cmd>The <codeph>RSocket()</codeph> function

takes a number of parameters that determine the type of socket connection

to provide. </cmd>

<info>The following are the important parameters for TCP/IP or UDP: </info>

<substeps id="GUID-507B471D-EFD5-5DD2-B457-76AF61A863C9">

<substep id="GUID-1743A72D-3FB7-57CE-AF20-4CB4452334B9"><cmd/>

<info>addrFamily </info>

</substep>

<substep id="GUID-111B511D-1F1B-52FD-8820-8A4F8DF7DB66"><cmd/>

<info>sockType </info>

</substep>

<substep id="GUID-0049E8E2-3A84-5C5D-97ED-09367BA11259"><cmd/>

<info>protocol </info>

</substep>

</substeps>

</step>

<step id="GUID-D63213B5-180D-5B82-A699-4CD1FF8AC066"><cmd/>

<info>The following constant values must be used for TCP/IP: </info>

<info>addrFamily: <codeph>KAfInet</codeph> or <codeph>KAfInet6</codeph> for

IPv6 </info>

<info>sockType: <codeph>KSockStream</codeph> for TCP/IP or <codeph>KSockDatagram</codeph> for

UDP </info>

<info>protocol: <codeph>KProtocolInetTCP</codeph> or <codeph>KProtocolInetUDP</codeph>  </info>

</step>

</steps>

<example><title>Example</title> <p>The following code is an example to access

the TCP/IP socket: </p> <codeblock id="GUID-E61E7089-2F9C-5E8A-ADFB-4BF25451AA59" xml:space="preserve">

void Example::open(void)

{    

    TInt err;

    RSocketServ ss;

    RSocket sock;

    err = ss.Connect();

    err = sock.Open(ss, KAfInet, KSockStream, KProtocolInetTcp);

    // ... now connect to the socket to send and receive data

</codeblock> </example>

</taskbody><related-links>

<link href="GUID-61E0CD76-A2E3-5066-84A8-146EECA8ADCD.dita"><linktext>Sockets Server</linktext>

</link>

</related-links></task>