Mercurial Mercurial > oss > FCL > sftools > depl > docscontent / diff
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | file | latest | revisions | annotate | diff | comparison | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Symbian3/SDK/Source/GUID-1D25050A-4CC2-5017-BBE8-7AC380BAC027.dita
changeset 7 51a74ef9ed63 
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Symbian3/SDK/Source/GUID-1D25050A-4CC2-5017-BBE8-7AC380BAC027.dita	Wed Mar 31 11:11:55 2010 +0100
@@ -0,0 +1,193 @@
+<?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-1D25050A-4CC2-5017-BBE8-7AC380BAC027" xml:lang="en"><title>Category:
+FSCLIENT Panic</title><prolog><metadata><keywords/></metadata></prolog><conbody>
+<p>Panics with this category are raised on clients requesting services provided
+by the file server. Typically, they are caused by passing bad or contradictory
+values to class constructors or member functions. </p>
+<p>The thread causing the panic is terminated. </p>
+<p>To avoid confusion, we need to emphasise that the panic category is the
+14 character string <i>FSCLIENT panic</i>, and that the word panic is part
+of the panic category. </p>
+<table id="GUID-247E0C7D-0DBB-5873-8C05-A25A5EFFE6C7">
+<tgroup cols="2"><colspec colname="col0"/><colspec colname="col1"/>
+<tbody>
+<row>
+<entry><p> <codeph>0</codeph>  </p> </entry>
+<entry><p>This panic is raised by: </p> <ul>
+<li id="GUID-ED8D9E1E-8FAA-543B-9729-FDAC7BE30E2F"><p>the <codeph>TDriveUnit(TInt
+aDrive)</codeph> variant of the <xref href="GUID-9BDD476C-04E1-3271-AFD9-8F86D818CE46.dita"><apiname>TDriveUnit</apiname></xref> constructor, </p> </li>
+<li id="GUID-EACAAFC7-D828-5054-9B71-737E3968AC40"><p>the <codeph>(TInt aDrive)</codeph> variant
+of the <xref href="GUID-9BDD476C-04E1-3271-AFD9-8F86D818CE46.dita"><apiname>TDriveUnit</apiname></xref> assignment operator </p> </li>
+</ul> <p>when the specified drive number is greater than or equal to <codeph>KMaxDrives</codeph>,
+i.e. 26. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>1</codeph>  </p> </entry>
+<entry><p>This panic is raised by: </p> <ul>
+<li id="GUID-77317522-EAF0-59D3-9EF6-FDDF9891B5D4"><p>the <codeph>TDriveUnit(const
+TDesC&amp; aDriveText)</codeph> variant of the <xref href="GUID-9BDD476C-04E1-3271-AFD9-8F86D818CE46.dita"><apiname>TDriveUnit</apiname></xref> constructor, </p> </li>
+<li id="GUID-91779A42-CBD7-5533-A74E-5335B64B1123"><p>the <codeph>(const TDesC&amp;
+aDriveText)</codeph> variant of the <xref href="GUID-9BDD476C-04E1-3271-AFD9-8F86D818CE46.dita"><apiname>TDriveUnit</apiname></xref> assignment
+operator </p> </li>
+</ul> <p>when the specified drive letter is invalid, i.e. does not correspond
+to a drive number. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>2</codeph>  </p> </entry>
+<entry><p>This panic is raised when searching for the next file using <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-5CF0E979-3A6F-3CC6-9D1A-56FE50B7A0AC"><apiname>TFindFile::Find()</apiname></xref> or <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-095CE56D-FFCB-3756-A2D2-71036360A4A7"><apiname>TFindFile::FindWild()</apiname></xref> before the initial call specifying the search method. </p> <p>Calls to <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-5CF0E979-3A6F-3CC6-9D1A-56FE50B7A0AC"><apiname>TFindFile::Find()</apiname></xref> cannot
+be made until an initial call has been made to either of: </p> <ul>
+<li id="GUID-6628C775-90D5-5DFE-8676-1F6B884B976A"><p> <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-8C931E8E-7C5F-3EA5-9B87-8073E21CDDA6"><apiname>TFindFile::FindByDir()</apiname></xref>  </p> </li>
+<li id="GUID-FBA409DA-C9D0-5F09-A2EE-F8ADD902969D"><p> <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-6FF65FD0-86E6-3785-BEE8-23DB483DE130"><apiname>TFindFile::FindByPath()</apiname></xref>  </p> </li>
+</ul> <p>Calls to <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-095CE56D-FFCB-3756-A2D2-71036360A4A7"><apiname>TFindFile::FindWild()</apiname></xref> cannot be made
+until an initial call has been made to either of: </p> <ul>
+<li id="GUID-107C27C2-2DB0-5590-A896-D942CFE5497B"><p> <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-15BA9901-0159-33F0-B2F0-EEBD72EA2E17"><apiname>TFindFile::FindWildByDir()</apiname></xref>  </p> </li>
+<li id="GUID-AC2B1F94-EB71-525B-8680-CFAF01C87853"><p> <xref href="GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA.dita#GUID-98CC1E75-D2DE-3700-928C-7D530237ECBA/GUID-EFCA111B-808A-3AF8-903F-2E4CA5F7375B"><apiname>TFindFile::FindWildByPath()</apiname></xref>  </p> </li>
+</ul> </entry>
+</row>
+<row>
+<entry><p> <codeph>3</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>4</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>5</codeph>  </p> </entry>
+<entry><p>This panic is raised by a call to <xref href="GUID-95310602-EA12-3AEE-BDBD-F750FC17CAC4.dita#GUID-95310602-EA12-3AEE-BDBD-F750FC17CAC4/GUID-EBEDA043-5E46-3082-B473-62885DAC591C"><apiname>TFileText::Seek()</apiname></xref> when
+the seek mode passed to the function is neither <xref href="GUID-CA98DC2A-4B7D-336D-A251-C29120DDD444.dita#GUID-CA98DC2A-4B7D-336D-A251-C29120DDD444/GUID-002917A4-A1E6-3FBB-B133-A0734AB5C4DA"><apiname>TSeek::ESeekStart()</apiname></xref> nor <xref href="GUID-CA98DC2A-4B7D-336D-A251-C29120DDD444.dita#GUID-CA98DC2A-4B7D-336D-A251-C29120DDD444/GUID-5B88CF12-C882-33C8-833B-B4B9978431E7"><apiname>TSeek::ESeekEnd()</apiname></xref>. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>6</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>7</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>8</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>9</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>10</codeph>  </p> </entry>
+<entry><p>This panic is raised by the <xref href="GUID-82CEC14F-1479-3922-846A-9FCDB6465EF7.dita"><apiname>CFileMan</apiname></xref> implementation
+when the operation to be run is undefined. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>11</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-C1C0C7F9-2665-3475-B70F-61C41291BB4D.dita#GUID-C1C0C7F9-2665-3475-B70F-61C41291BB4D/GUID-9EC41897-DE6E-31EB-A092-4EFD608D6E0D"><apiname>CFileBase::CurrentEntry()</apiname></xref> if
+there is no current entry. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>12</codeph>  </p> </entry>
+<entry><p>The value returned by the file management observer functions: </p> <ul>
+<li id="GUID-8CC343EF-A37D-51FA-B7FB-F3FDAA8AC16F"><p> <xref href="GUID-E608485F-B3E3-3310-A80E-169D8B9D2234.dita#GUID-E608485F-B3E3-3310-A80E-169D8B9D2234/GUID-54D77B42-2AD9-3F82-89A7-3E651FAC2670"><apiname>MFileManObserver::NotifyFileManStarted()</apiname></xref>  </p> </li>
+<li id="GUID-A6D0E7B3-8776-50F0-8FA4-454B5235CF65"><p> <xref href="GUID-E608485F-B3E3-3310-A80E-169D8B9D2234.dita#GUID-E608485F-B3E3-3310-A80E-169D8B9D2234/GUID-A73812AF-0877-3322-90C9-8A8F43708C8E"><apiname>MFileManObserver::NotifyFileManEnded()</apiname></xref>  </p> </li>
+<li id="GUID-64372697-7364-558D-B216-35D721DBB655"><p> <xref href="GUID-E608485F-B3E3-3310-A80E-169D8B9D2234.dita#GUID-E608485F-B3E3-3310-A80E-169D8B9D2234/GUID-8D17D294-DE4A-3382-A832-9D318F522DE6"><apiname>MFileManObserver::NotifyFileManOperation()</apiname></xref> </p> </li>
+</ul> <p>is not a valid <xref href="GUID-E608485F-B3E3-3310-A80E-169D8B9D2234.dita#GUID-E608485F-B3E3-3310-A80E-169D8B9D2234/GUID-3147D2FB-F840-3780-8697-5053CA7EEF6D"><apiname>MFileManObserver::TControl()</apiname></xref> enum
+value. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>13</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>14</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>15</codeph>  </p> </entry>
+<entry><p> <i>This panic is raised in debug builds only.</i>  </p> <p>This
+panic is raised in a call to <xref href="GUID-C657AF2D-1183-3CD2-ACAF-3B0B00FC91BB.dita#GUID-C657AF2D-1183-3CD2-ACAF-3B0B00FC91BB/GUID-904B65E6-61DE-3A5D-A5E1-E7577D0FD2BB"><apiname>CDirScan::SetScanDataL()</apiname></xref> when
+the path does not contain at least one '\' character. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>16</codeph>  </p> </entry>
+<entry><p> <i>Not used.</i>  </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>17</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-4B12909C-0BC6-3FFE-8825-FA98312F74C2"><apiname>RFile::Lock()</apiname></xref> when the
+number of bytes defining the region to be locked is either zero or negative. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>18</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-9083CCAD-F9ED-36FB-9C80-79D2F1B46B77"><apiname>RFile::UnLock()</apiname></xref> when
+the number of bytes defining the region to be unlocked is either zero or negative. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>19</codeph>  </p> </entry>
+<entry><p>All variants of the <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-94CCC141-8E26-3FA3-A222-D9A658AEA8A9"><apiname>RFile::Read()</apiname></xref> and <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-325997F1-3252-358E-B278-44D3A5418FAC"><apiname>RFile::Write()</apiname></xref> functions
+take an argument denoting an offset value, in bytes, from the start of a file;
+the panic is raised by these functions when the offset value is negative. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>20</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-8592B60E-70E7-37D6-AFD2-4D2A1A87C886"><apiname>RFile::SetSize()</apiname></xref> when
+the argument denoting the size of the new file is negative. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>21</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-5CF35AAD-5D0E-356D-8E07-2948C191226E"><apiname>RFile::SetAtt()</apiname></xref> and <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-07929B06-ADEF-3BDF-97E8-9ACD7E105EFA"><apiname>RFile::Set()</apiname></xref> when
+the same attribute bit is set in both the bitmask that indicates the file
+attributes to be set and the bitmask that indicates the attributes to be cleared. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>22</codeph>  </p> </entry>
+<entry><p>The panic is raised by the <codeph>[]</codeph> operator of <xref href="GUID-0355B083-6DD8-30F0-BEDF-B6BE745E2AB6.dita"><apiname>TEntryArray</apiname></xref>,
+when the index value passed to the operator is greater than or equal to the
+number of elements in the array. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>23</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-15AEDE72-80FF-3689-A771-E00F1CF3EB88.dita#GUID-15AEDE72-80FF-3689-A771-E00F1CF3EB88/GUID-58902A06-4882-3BDD-AB36-82F9002C958E"><apiname>CDir::Sort()</apiname></xref> when the
+method of sorting, as defined by the single function argument, is none of
+the entries: </p> <ul>
+<li id="GUID-B154F18B-0F13-59FA-A03C-C1965BB18EC5"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-FB1EE9D2-4AE7-3B56-9E62-5047680FB645"><apiname>TEntryKey::ESortNone()</apiname></xref>  </p> </li>
+<li id="GUID-0E3B05EC-FD57-5573-B91F-F9B28AF601D4"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-566D8D24-4413-3A4B-9DDE-724803331462"><apiname>TEntryKey::ESortByDate()</apiname></xref>  </p> </li>
+<li id="GUID-BB51F6FB-55FD-596C-953C-E7B68E7C1B40"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-4A4AB0DC-F743-3F5F-B53D-289955F333B9"><apiname>TEntryKey::ESortBySize()</apiname></xref>  </p> </li>
+<li id="GUID-25B1E042-5C5E-59E1-AF3D-D694FE91496A"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-3427F521-49DE-30B3-BFE1-C5D193475EC9"><apiname>TEntryKey::ESortByExt()</apiname></xref>  </p> </li>
+<li id="GUID-79D81DEF-1098-58DA-ADB9-FCC6B9790BC6"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-141E1837-D913-39BE-9257-6CCEB40CE194"><apiname>TEntryKey::ESortByUid()</apiname></xref>  </p> </li>
+<li id="GUID-A3D55FFF-A2D6-5644-8880-27A05A2F09E8"><p> <xref href="GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E.dita#GUID-3110DC70-6DE1-3F80-82C0-74CD37782F2E/GUID-0626B5FC-7CCC-3870-8594-30A1F5D20FD4"><apiname>TEntryKey::ESortByName()</apiname></xref>  </p> </li>
+</ul> </entry>
+</row>
+<row>
+<entry><p> <codeph>24</codeph>  </p> </entry>
+<entry><p>This panic is raised by the <xref href="GUID-A6268E58-68EC-3041-93FD-5368CD230947.dita"><apiname>TParsePtr</apiname></xref> constructor
+that takes a reference to a filename, when the name cannot be parsed. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>25</codeph>  </p> </entry>
+<entry><p>This panic is raised by the <xref href="GUID-C65BCDAB-0476-3EAC-9BFC-37243AE43FE9.dita"><apiname>TParsePtrC</apiname></xref> constructor
+that takes a const reference to a filename, when the name cannot be parsed. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>26</codeph>  </p> </entry>
+<entry><p>This panic is raised by <xref href="GUID-E263C747-946F-35AA-9F1D-41833BD350FC.dita#GUID-E263C747-946F-35AA-9F1D-41833BD350FC/GUID-765B2E18-8062-3FF4-8E82-BBD54DC28EC9"><apiname>RFs::ReadFileSection()</apiname></xref> when
+the specified number of bytes to be read from the file is greater than the
+maximum length of the target descriptor. </p> </entry>
+</row>
+<row>
+<entry><p> <codeph>27</codeph>  </p> </entry>
+<entry><p> <i>This panic is raised in debug builds only.</i>  </p> <p>This
+panic is raised by the <xref href="GUID-BE0804F6-4375-3C8A-8C83-968F510466E0.dita#GUID-BE0804F6-4375-3C8A-8C83-968F510466E0/GUID-DBEDBF4B-C944-3F9F-9F94-E5408745FD84"><apiname>RFile::Write(const                 TDesC8&amp;,TInt)</apiname></xref> variant
+when the specified length is greater than the length of the source descriptor. </p> </entry>
+</row>
+</tbody>
+</tgroup>
+</table></conbody></concept>
\ No newline at end of file
FCL/sftools/depl/docscontent