<?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-340C57A4-B799-502D-8B86-39955E2F4268" xml:lang="en"><title> Creating
an ESK File Tutorial</title><shortdesc>This topic describes how to create an ESK file. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody>

<section id="GUID-C40428B0-C6A8-4FAA-8943-2FC8BC98D8D5"><title>Introduction</title> <p>An <codeph>ESK</codeph> file is a
text file that specifies the order of the protocol modules. The socket server
loads the protocol modules. </p> <p>The <codeph>ESK</codeph> file has two
sections. The first section specifies the name of the new hook. The second
section specifies the name of the file. The name of the file must have the
extension and cannot have the full path name. </p> </section>
<section id="GUID-F7164347-5807-4A2F-A64C-0B9B1E4E90C9"><title>Location of the ESK file </title> <p>The location of the ESK
file is based on the OS version and the kernel architecture. In the Emulator,
the ESK file is found in the location <codeph>winscw\c\private\101F7989\ESock\</codeph>.
On the hardware, the ESK file is found in the location <codeph>Z:\private\101F7989\ESock\</codeph>. </p> <p>Symbian
platform supports only EKA2 architecture and <codeph>101F7989</codeph> specifies
the Secure Identifier (SID). </p> </section>
<section id="GUID-22DC0270-E891-4468-B7EA-868C8F9F4457"><title>Procedure</title> <ol id="GUID-ACE2F663-AFFE-544F-84B3-22BDA622240D">
<li id="GUID-DED4A791-FFA9-54DC-AC5D-2286CFC4D397"><p>Create a new <codeph>ESK</codeph> file
for every hook that binds the hook to another hook. </p> </li>
<li id="GUID-B578104C-3971-59F8-B1E1-1672A1209B22"><p>To bind the hook to
other protocols <codeph>bindto</codeph> and <codeph>bindfrom</codeph> directives
must be used. The <codeph>bindto</codeph> directive forward data packets from
one hook to other hooks and upper layer protocols. The <codeph>bindfrom</codeph> directive
receives the data packets from IP6. </p> </li>
</ol>  </section>
<example><title>ESK file example</title> <p>The following code is an example
of an <codeph>ESK</codeph> file: </p> <codeblock id="GUID-93D2CD8F-504F-5588-B4E6-741E0EE69BE6" xml:space="preserve">
[yourhook]
protocols= tcp,ip

[ip]
filename=tcpip6.prt
index=1
</codeblock> </example>
<section id="GUID-C338C04F-C3C6-4F83-8CB4-AECD41F0515B"><title>How to Create an ESK file</title> <p>The following code is
an example to create an <codeph>ESK</codeph> file to bind a new hook called
myhook: </p> <codeblock id="GUID-0D7F9FD9-53C6-5ED8-B2A6-C2CCEEE4F121" xml:space="preserve">
[sockman]
protocols=myhook,ip6
    
[myhook]
filename=myhook.prt
index=2
bindfrom=ip6
</codeblock> </section>
</conbody><related-links>
<link href="GUID-6998404B-CC51-5337-B04F-8444C32B99C9.dita"><linktext>Writing an
Inbound                 Hook</linktext></link>
</related-links></concept>