re16.html 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218
  1. <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
  2. <html>
  3. <head>
  4. <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  5. <title>&lt;%GLibFileError&gt;: </title>
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.2">
  7. <link rel="home" href="index.html" title="">
  8. <link rel="up" href="ch01.html" title="GLib">
  9. <link rel="prev" href="re15.html" title="&lt;%GLibErrorType&gt;">
  10. <link rel="next" href="re17.html" title="&lt;%GLibFileSetContentsFlags&gt;">
  11. <meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
  12. <link rel="stylesheet" href="style.css" type="text/css">
  13. </head>
  14. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  15. <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
  16. <td width="100%" align="left" class="shortcuts"></td>
  17. <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
  18. <td><img src="up-insensitive.png" width="16" height="16" border="0"></td>
  19. <td><a accesskey="p" href="re15.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
  20. <td><a accesskey="n" href="re17.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
  21. </tr></table>
  22. <div class="refentry">
  23. <a name="id-1.1.17"></a><div class="titlepage"></div>
  24. <div class="refnamediv">
  25. <h2>&lt;%GLibFileError&gt;</h2>
  26. <p>&lt;%GLibFileError&gt;</p>
  27. </div>
  28. <div class="refsect1">
  29. <a name="id-1.1.17.2"></a><h2>Description</h2>
  30. <p>Values corresponding to <em class="parameter"><code>errno</code></em> codes returned from file operations
  31. on UNIX. Unlike <em class="parameter"><code>errno</code></em> codes, GFileError values are available on
  32. all systems, even Windows. The exact meaning of each code depends
  33. on what sort of file operation you were performing; the UNIX
  34. documentation gives more details. The following error code descriptions
  35. come from the GNU C Library manual, and are under the copyright
  36. of that manual.
  37. </p>
  38. <p>It's not very portable to make detailed assumptions about exactly
  39. which errors will be returned from a given operation. Some errors
  40. don't occur on some systems, etc., sometimes there are subtle
  41. differences in when a system will report a given error, etc.</p>
  42. </div>
  43. <div class="refsect1">
  44. <a name="id-1.1.17.3"></a><h2>Members</h2>
  45. <div class="refsect2">
  46. <a name="id-1.1.17.3.2"></a><h3>exist</h3>
  47. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_EXIST</code></span></em></p>
  48. <p>Operation not permitted; only the owner of
  49. the file (or other resource) or processes with special privileges
  50. can perform the operation.</p>
  51. </div>
  52. <div class="refsect2">
  53. <a name="id-1.1.17.3.3"></a><h3>isdir</h3>
  54. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_ISDIR</code></span></em></p>
  55. <p>File is a directory; you cannot open a directory
  56. for writing, or create or remove hard links to it.</p>
  57. </div>
  58. <div class="refsect2">
  59. <a name="id-1.1.17.3.4"></a><h3>acces</h3>
  60. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_ACCES</code></span></em></p>
  61. <p>Permission denied; the file permissions do not
  62. allow the attempted operation.</p>
  63. </div>
  64. <div class="refsect2">
  65. <a name="id-1.1.17.3.5"></a><h3>nametoolong</h3>
  66. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NAMETOOLONG</code></span></em></p>
  67. <p>Filename too long.</p>
  68. </div>
  69. <div class="refsect2">
  70. <a name="id-1.1.17.3.6"></a><h3>noent</h3>
  71. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NOENT</code></span></em></p>
  72. <p>No such file or directory. This is a "file
  73. doesn't exist" error for ordinary files that are referenced in
  74. contexts where they are expected to already exist.</p>
  75. </div>
  76. <div class="refsect2">
  77. <a name="id-1.1.17.3.7"></a><h3>notdir</h3>
  78. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NOTDIR</code></span></em></p>
  79. <p>A file that isn't a directory was specified when
  80. a directory is required.</p>
  81. </div>
  82. <div class="refsect2">
  83. <a name="id-1.1.17.3.8"></a><h3>nxio</h3>
  84. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NXIO</code></span></em></p>
  85. <p>No such device or address. The system tried to
  86. use the device represented by a file you specified, and it
  87. couldn't find the device. This can mean that the device file was
  88. installed incorrectly, or that the physical device is missing or
  89. not correctly attached to the computer.</p>
  90. </div>
  91. <div class="refsect2">
  92. <a name="id-1.1.17.3.9"></a><h3>nodev</h3>
  93. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NODEV</code></span></em></p>
  94. <p>The underlying file system of the specified file
  95. does not support memory mapping.</p>
  96. </div>
  97. <div class="refsect2">
  98. <a name="id-1.1.17.3.10"></a><h3>rofs</h3>
  99. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_ROFS</code></span></em></p>
  100. <p>The directory containing the new link can't be
  101. modified because it's on a read-only file system.</p>
  102. </div>
  103. <div class="refsect2">
  104. <a name="id-1.1.17.3.11"></a><h3>txtbsy</h3>
  105. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_TXTBSY</code></span></em></p>
  106. <p>Text file busy.</p>
  107. </div>
  108. <div class="refsect2">
  109. <a name="id-1.1.17.3.12"></a><h3>fault</h3>
  110. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_FAULT</code></span></em></p>
  111. <p>You passed in a pointer to bad memory.
  112. (GLib won't reliably return this, don't pass in pointers to bad
  113. memory.)</p>
  114. </div>
  115. <div class="refsect2">
  116. <a name="id-1.1.17.3.13"></a><h3>loop</h3>
  117. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_LOOP</code></span></em></p>
  118. <p>Too many levels of symbolic links were encountered
  119. in looking up a file name. This often indicates a cycle of symbolic
  120. links.</p>
  121. </div>
  122. <div class="refsect2">
  123. <a name="id-1.1.17.3.14"></a><h3>nospc</h3>
  124. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NOSPC</code></span></em></p>
  125. <p>No space left on device; write operation on a
  126. file failed because the disk is full.</p>
  127. </div>
  128. <div class="refsect2">
  129. <a name="id-1.1.17.3.15"></a><h3>nomem</h3>
  130. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NOMEM</code></span></em></p>
  131. <p>No memory available. The system cannot allocate
  132. more virtual memory because its capacity is full.</p>
  133. </div>
  134. <div class="refsect2">
  135. <a name="id-1.1.17.3.16"></a><h3>mfile</h3>
  136. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_MFILE</code></span></em></p>
  137. <p>The current process has too many files open and
  138. can't open any more. Duplicate descriptors do count toward this
  139. limit.</p>
  140. </div>
  141. <div class="refsect2">
  142. <a name="id-1.1.17.3.17"></a><h3>nfile</h3>
  143. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NFILE</code></span></em></p>
  144. <p>There are too many distinct file openings in the
  145. entire system.</p>
  146. </div>
  147. <div class="refsect2">
  148. <a name="id-1.1.17.3.18"></a><h3>badf</h3>
  149. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_BADF</code></span></em></p>
  150. <p>Bad file descriptor; for example, I/O on a
  151. descriptor that has been closed or reading from a descriptor open
  152. only for writing (or vice versa).</p>
  153. </div>
  154. <div class="refsect2">
  155. <a name="id-1.1.17.3.19"></a><h3>inval</h3>
  156. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_INVAL</code></span></em></p>
  157. <p>Invalid argument. This is used to indicate
  158. various kinds of problems with passing the wrong argument to a
  159. library function.</p>
  160. </div>
  161. <div class="refsect2">
  162. <a name="id-1.1.17.3.20"></a><h3>pipe</h3>
  163. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_PIPE</code></span></em></p>
  164. <p>Broken pipe; there is no process reading from the
  165. other end of a pipe. Every library function that returns this
  166. error code also generates a 'SIGPIPE' signal; this signal
  167. terminates the program if not handled or blocked. Thus, your
  168. program will never actually see this code unless it has handled
  169. or blocked 'SIGPIPE'.</p>
  170. </div>
  171. <div class="refsect2">
  172. <a name="id-1.1.17.3.21"></a><h3>again</h3>
  173. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_AGAIN</code></span></em></p>
  174. <p>Resource temporarily unavailable; the call might
  175. work if you try again later.</p>
  176. </div>
  177. <div class="refsect2">
  178. <a name="id-1.1.17.3.22"></a><h3>intr</h3>
  179. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_INTR</code></span></em></p>
  180. <p>Interrupted function call; an asynchronous signal
  181. occurred and prevented completion of the call. When this
  182. happens, you should try the call again.</p>
  183. </div>
  184. <div class="refsect2">
  185. <a name="id-1.1.17.3.23"></a><h3>io</h3>
  186. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_IO</code></span></em></p>
  187. <p>Input/output error; usually used for physical read
  188. or write errors. i.e. the disk or other physical device hardware
  189. is returning errors.</p>
  190. </div>
  191. <div class="refsect2">
  192. <a name="id-1.1.17.3.24"></a><h3>perm</h3>
  193. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_PERM</code></span></em></p>
  194. <p>Operation not permitted; only the owner of the
  195. file (or other resource) or processes with special privileges can
  196. perform the operation.</p>
  197. </div>
  198. <div class="refsect2">
  199. <a name="id-1.1.17.3.25"></a><h3>nosys</h3>
  200. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_NOSYS</code></span></em></p>
  201. <p>Function not implemented; this indicates that
  202. the system is missing some functionality.</p>
  203. </div>
  204. <div class="refsect2">
  205. <a name="id-1.1.17.3.26"></a><h3>failed</h3>
  206. <p class="remark"><em><span class="remark">alias <code class="code">G_FILE_ERROR_FAILED</code></span></em></p>
  207. <p>Does not correspond to a UNIX error code; this
  208. is the standard "failed for unspecified reason" error code present
  209. in all <span class="type">GError</span> error code enumerations. Returned if no specific
  210. code applies.</p>
  211. </div>
  212. </div>
  213. </div>
  214. <div class="footer">
  215. <hr>Generated by GTK-Doc V1.33.1</div>
  216. </body>
  217. </html>