Symbian3/PDK/Source/GUID-9430D718-6E4D-5AE1-8389-24A47DFAAF16.dita
author Dominic Pinkman <Dominic.Pinkman@Nokia.com>
Tue, 30 Mar 2010 11:42:04 +0100
changeset 4 4816d766a08a
parent 3 46218c8b8afa
child 5 f345bda72bc4
permissions -rw-r--r--
Week 12 contribution of SDK documentation_content. See release notes for details. Fixes Bug 1892, Bug 1522, Bug 1520, Bug 394, Bug 1319, Bug 344, Bug 1897

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