Symbian3/SDK/Source/GUID-9430D718-6E4D-5AE1-8389-24A47DFAAF16.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Thu, 21 Jan 2010 18:18:20 +0000
changeset 0 89d6a7a84779
permissions -rw-r--r--
Initial contribution of Documentation_content according to Feature bug 1266 bug 1268 bug 1269 bug 1270 bug 1372 bug 1374 bug 1375 bug 1379 bug 1380 bug 1381 bug 1382 bug 1383 bug 1385

<?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 xml:lang="en" id="GUID-9430D718-6E4D-5AE1-8389-24A47DFAAF16"><title>What are ESK files?</title><shortdesc>ESK files contain protocol module information that is used to load ESock. </shortdesc><prolog><metadata><keywords/></metadata></prolog><conbody><p>Protocol modules are plug-ins to ESock that have .PRT extensions. Protocol modules implement a socket communication protocol, or a hook to a protocol. ESK files determine the protocol modules to load for ESock. ESK files also determine how the protocol modules are bound together. The ESK files are read during ESock startup and can also contain parameters specific to a particular protocol. </p> <p>The CMI file for an ESock worker thread specifies the ESK file to be processed and the protocols to be hosted. This is done using the EskMask parameter in the [IniData] section and then supplying a mask. For example: </p> <p> <codeph>EskMask = IP.*.ESK</codeph>  </p> <p>As a result of this example, all ESK files that start with "IP." are supplied to the specified ESock CPM. If required you can use EskMaskn (where n is an integer value between 1 and 8) for example EskMask1 = bt.*.esk. </p> <p> <b>Note:</b> The values for the EskMask and EskMask[1..8] parameters are limited to 16 characters. </p> <p>The EskMask parameter is specified in the <codeph>[IniData]</codeph> section of the CMI file because it is specific to ESock and is passed by Configurator onto the ESock server for interpretation. The parameter is ignored in the following circumstances: </p> <ul><li id="GUID-2D32B889-B830-5F16-9FC2-383C7AC5FB08"><p>If it is specified incorrectly in the [Loader] section of a CMI file </p> </li> <li id="GUID-94CCA305-6B59-5006-9BDB-01E6A6DC0AB3"><p>If it is specified incorrectly in a CMI file that does not run an ESock CPM. For example if FileName parameter is not esocksvr.dll. </p> </li> </ul> </conbody><related-links><link href="GUID-FEB6F717-C86C-54A5-B8D1-B2D882C5AC55.dita"><linktext>What are CMI files?</linktext> </link> </related-links></concept>