err.h@ 10975

Last change on this file since 10975 was 10768, checked in by vboxsync, 16 years ago
Some early commit of the handle table code (home -> work).
Property svn:eol-style set to `native` Property svn:keywords set to `Author Date Id Revision`
File size: 35.2 KB

Line
1	/** @file
2	* IPRT - Status Codes.
3	*/
4
5	/*
6	* Copyright (C) 2006-2007 Sun Microsystems, Inc.
7	*
8	* This file is part of VirtualBox Open Source Edition (OSE), as
9	* available from http://www.virtualbox.org. This file is free software;
10	* you can redistribute it and/or modify it under the terms of the GNU
11	* General Public License (GPL) as published by the Free Software
12	* Foundation, in version 2 as it comes in the "COPYING" file of the
13	* VirtualBox OSE distribution. VirtualBox OSE is distributed in the
14	* hope that it will be useful, but WITHOUT ANY WARRANTY of any kind.
15	*
16	* The contents of this file may alternatively be used under the terms
17	* of the Common Development and Distribution License Version 1.0
18	* (CDDL) only, as it comes in the "COPYING.CDDL" file of the
19	* VirtualBox OSE distribution, in which case the provisions of the
20	* CDDL are applicable instead of those of the GPL.
21	*
22	* You may elect to license modified versions of this file under the
23	* terms and conditions of either the GPL or the CDDL or both.
24	*
25	* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa
26	* Clara, CA 95054 USA or visit http://www.sun.com if you need
27	* additional information or have any questions.
28	*/
29
30	#ifndef ___iprt_err_h
31	#define ___iprt_err_h
32
33	#include <iprt/cdefs.h>
34	#include <iprt/types.h>
35
36	__BEGIN_DECLS
37
38	/** @defgroup grp_rt_err RTErr - Status Codes
39	* @ingroup grp_rt
40	* @{
41	*/
42
43	/** @defgroup grp_rt_err_hlp Status Code Helpers
44	* @ingroup grp_rt_err
45	* @{
46	*/
47
48	/** @def RT_SUCCESS
49	* Check for success. We expect success in normal cases, that is the code path depending on
50	* this check is normally taken. To prevent any prediction use RT_SUCCESS_NP instead.
51	*
52	* @returns true if rc indicates success.
53	* @returns false if rc indicates failure.
54	*
55	* @param rc The iprt status code to test.
56	*/
57	#define RT_SUCCESS(rc) ( RT_LIKELY((int)(rc) >= VINF_SUCCESS) )
58
59	/** @def RT_SUCCESS_NP
60	* Check for success. Don't predict the result.
61	*
62	* @returns true if rc indicates success.
63	* @returns false if rc indicates failure.
64	*
65	* @param rc The iprt status code to test.
66	*/
67	#define RT_SUCCESS_NP(rc) ( (int)(rc) >= VINF_SUCCESS )
68
69	/** @def RT_FAILURE
70	* Check for failure. We don't expect in normal cases, that is the code path depending on
71	* this check is normally NOT taken. To prevent any prediction use RT_FAILURE_NP instead.
72	*
73	* @returns true if rc indicates failure.
74	* @returns false if rc indicates success.
75	*
76	* @param rc The iprt status code to test.
77	*/
78	#define RT_FAILURE(rc) ( RT_UNLIKELY(!RT_SUCCESS_NP(rc)) )
79
80	/** @def RT_FAILURE_NP
81	* Check for failure. Don't predict the result.
82	*
83	* @returns true if rc indicates failure.
84	* @returns false if rc indicates success.
85	*
86	* @param rc The iprt status code to test.
87	*/
88	#define RT_FAILURE_NP(rc) ( !RT_SUCCESS_NP(rc) )
89
90	/**
91	* Converts a Darwin HRESULT error to an iprt status code.
92	*
93	* @returns iprt status code.
94	* @param iNativeCode HRESULT error code.
95	* @remark Darwin ring-3 only.
96	*/
97	RTDECL(int) RTErrConvertFromDarwinCOM(int32_t iNativeCode);
98
99	/**
100	* Converts a Darwin IOReturn error to an iprt status code.
101	*
102	* @returns iprt status code.
103	* @param iNativeCode IOReturn error code.
104	* @remark Darwin only.
105	*/
106	RTDECL(int) RTErrConvertFromDarwinIO(int iNativeCode);
107
108	/**
109	* Converts a Darwin kern_return_t error to an iprt status code.
110	*
111	* @returns iprt status code.
112	* @param iNativeCode kern_return_t error code.
113	* @remark Darwin only.
114	*/
115	RTDECL(int) RTErrConvertFromDarwinKern(int iNativeCode);
116
117	/**
118	* Converts a Darwin error to an iprt status code.
119	*
120	* This will consult RTErrConvertFromDarwinKern, RTErrConvertFromDarwinIO
121	* and RTErrConvertFromDarwinCOM in this order. The latter is ring-3 only as it
122	* doesn't apply elsewhere.
123	*
124	* @returns iprt status code.
125	* @param iNativeCode Darwin error code.
126	* @remarks Darwin only.
127	* @remarks This is recommended over RTErrConvertFromDarwinKern and RTErrConvertFromDarwinIO
128	* since these are really just subsets of the same error space.
129	*/
130	RTDECL(int) RTErrConvertFromDarwin(int iNativeCode);
131
132	/**
133	* Converts errno to iprt status code.
134	*
135	* @returns iprt status code.
136	* @param uNativeCode errno code.
137	*/
138	RTDECL(int) RTErrConvertFromErrno(unsigned uNativeCode);
139
140	/**
141	* Converts a L4 errno to a iprt status code.
142	*
143	* @returns iprt status code.
144	* @param uNativeCode l4 errno.
145	* @remark L4 only.
146	*/
147	RTDECL(int) RTErrConvertFromL4Errno(unsigned uNativeCode);
148
149	/**
150	* Converts NT status code to iprt status code.
151	*
152	* Needless to say, this is only available on NT and winXX targets.
153	*
154	* @returns iprt status code.
155	* @param lNativeCode NT status code.
156	* @remark Windows only.
157	*/
158	RTDECL(int) RTErrConvertFromNtStatus(long lNativeCode);
159
160	/**
161	* Converts OS/2 error code to iprt status code.
162	*
163	* @returns iprt status code.
164	* @param uNativeCode OS/2 error code.
165	* @remark OS/2 only.
166	*/
167	RTDECL(int) RTErrConvertFromOS2(unsigned uNativeCode);
168
169	/**
170	* Converts Win32 error code to iprt status code.
171	*
172	* @returns iprt status code.
173	* @param uNativeCode Win32 error code.
174	* @remark Windows only.
175	*/
176	RTDECL(int) RTErrConvertFromWin32(unsigned uNativeCode);
177
178	/**
179	* Converts an iprt status code to a errno status code.
180	*
181	* @returns errno status code.
182	* @param iErr iprt status code.
183	*/
184	RTDECL(int) RTErrConvertToErrno(int iErr);
185
186
187	#ifdef IN_RING3
188
189	/**
190	* iprt status code message.
191	*/
192	typedef struct RTSTATUSMSG
193	{
194	/** Pointer to the short message string. */
195	const char *pszMsgShort;
196	/** Pointer to the full message string. */
197	const char *pszMsgFull;
198	/** Pointer to the define string. */
199	const char *pszDefine;
200	/** Status code number. */
201	int iCode;
202	} RTSTATUSMSG;
203	/** Pointer to iprt status code message. */
204	typedef RTSTATUSMSG *PRTSTATUSMSG;
205	/** Pointer to const iprt status code message. */
206	typedef const RTSTATUSMSG *PCRTSTATUSMSG;
207
208	/**
209	* Get the message structure corresponding to a given iprt status code.
210	*
211	* @returns Pointer to read-only message description.
212	* @param rc The status code.
213	*/
214	RTDECL(PCRTSTATUSMSG) RTErrGet(int rc);
215
216	/**
217	* Get the define corresponding to a given iprt status code.
218	*
219	* @returns Pointer to read-only string with the \#define identifier.
220	* @param rc The status code.
221	*/
222	#define RTErrGetDefine(rc) (RTErrGet(rc)->pszDefine)
223
224	/**
225	* Get the short description corresponding to a given iprt status code.
226	*
227	* @returns Pointer to read-only string with the description.
228	* @param rc The status code.
229	*/
230	#define RTErrGetShort(rc) (RTErrGet(rc)->pszMsgShort)
231
232	/**
233	* Get the full description corresponding to a given iprt status code.
234	*
235	* @returns Pointer to read-only string with the description.
236	* @param rc The status code.
237	*/
238	#define RTErrGetFull(rc) (RTErrGet(rc)->pszMsgFull)
239
240	#ifdef RT_OS_WINDOWS
241	/**
242	* Windows error code message.
243	*/
244	typedef struct RTWINERRMSG
245	{
246	/** Pointer to the full message string. */
247	const char *pszMsgFull;
248	/** Pointer to the define string. */
249	const char *pszDefine;
250	/** Error code number. */
251	long iCode;
252	} RTWINERRMSG;
253	/** Pointer to Windows error code message. */
254	typedef RTWINERRMSG *PRTWINERRMSG;
255	/** Pointer to const Windows error code message. */
256	typedef const RTWINERRMSG *PCRTWINERRMSG;
257
258	/**
259	* Get the message structure corresponding to a given Windows error code.
260	*
261	* @returns Pointer to read-only message description.
262	* @param rc The status code.
263	*/
264	RTDECL(PCRTWINERRMSG) RTErrWinGet(long rc);
265
266	/** On windows COM errors are part of the Windows error database. */
267	typedef RTWINERRMSG RTCOMERRMSG;
268
269	#else /* !RT_OS_WINDOWS */
270
271	/**
272	* COM/XPCOM error code message.
273	*/
274	typedef struct RTCOMERRMSG
275	{
276	/** Pointer to the full message string. */
277	const char *pszMsgFull;
278	/** Pointer to the define string. */
279	const char *pszDefine;
280	/** Error code number. */
281	uint32_t iCode;
282	} RTCOMERRMSG;
283	#endif /* !RT_OS_WINDOWS */
284	/** Pointer to a XPCOM/COM error code message. */
285	typedef RTCOMERRMSG *PRTCOMERRMSG;
286	/** Pointer to const a XPCOM/COM error code message. */
287	typedef const RTCOMERRMSG *PCRTCOMERRMSG;
288
289	/**
290	* Get the message structure corresponding to a given COM/XPCOM error code.
291	*
292	* @returns Pointer to read-only message description.
293	* @param rc The status code.
294	*/
295	RTDECL(PCRTCOMERRMSG) RTErrCOMGet(uint32_t rc);
296
297	#endif /* IN_RING3 */
298
299	/** @} */
300
301
302	/* SED-START */
303
304	/** @name Misc. Status Codes
305	* @{
306	*/
307	/** Success. */
308	#define VINF_SUCCESS 0
309
310	/** General failure - DON'T USE THIS!!! */
311	#define VERR_GENERAL_FAILURE (-1)
312	/** Invalid parameter. */
313	#define VERR_INVALID_PARAMETER (-2)
314	/** Invalid parameter. */
315	#define VWRN_INVALID_PARAMETER 2
316	/** Invalid magic or cookie. */
317	#define VERR_INVALID_MAGIC (-3)
318	/** Invalid magic or cookie. */
319	#define VWRN_INVALID_MAGIC 3
320	/** Invalid loader handle. */
321	#define VERR_INVALID_HANDLE (-4)
322	/** Invalid loader handle. */
323	#define VWRN_INVALID_HANDLE 4
324	/** Failed to lock the address range. */
325	#define VERR_LOCK_FAILED (-5)
326	/** Invalid memory pointer. */
327	#define VERR_INVALID_POINTER (-6)
328	/** Failed to patch the IDT. */
329	#define VERR_IDT_FAILED (-7)
330	/** Memory allocation failed. */
331	#define VERR_NO_MEMORY (-8)
332	/** Already loaded. */
333	#define VERR_ALREADY_LOADED (-9)
334	/** Permission denied. */
335	#define VERR_PERMISSION_DENIED (-10)
336	/** Version mismatch. */
337	#define VERR_VERSION_MISMATCH (-11)
338	/** The request function is not implemented. */
339	#define VERR_NOT_IMPLEMENTED (-12)
340
341	/** Failed to allocate temporary memory. */
342	#define VERR_NO_TMP_MEMORY (-20)
343	/** Invalid file mode mask (RTFMODE). */
344	#define VERR_INVALID_FMODE (-21)
345	/** Incorrect call order. */
346	#define VERR_WRONG_ORDER (-22)
347	/** There is no TLS (thread local storage) available for storing the current thread. */
348	#define VERR_NO_TLS_FOR_SELF (-23)
349	/** Failed to set the TLS (thread local storage) entry which points to our thread structure. */
350	#define VERR_FAILED_TO_SET_SELF_TLS (-24)
351	/** Not able to allocate contiguous memory. */
352	#define VERR_NO_CONT_MEMORY (-26)
353	/** No memory available for page table or page directory. */
354	#define VERR_NO_PAGE_MEMORY (-27)
355	/** Already initialized. */
356	#define VINF_ALREADY_INITIALIZED 28
357	/** The specified thread is dead. */
358	#define VERR_THREAD_IS_DEAD (-29)
359	/** The specified thread is not waitable. */
360	#define VERR_THREAD_NOT_WAITABLE (-30)
361	/** Pagetable not present. */
362	#define VERR_PAGE_TABLE_NOT_PRESENT (-31)
363	/** Internal error - we're screwed if this happens. */
364	#define VERR_INTERNAL_ERROR (-32)
365	/** The per process timer is busy. */
366	#define VERR_TIMER_BUSY (-33)
367	/** Address conflict. */
368	#define VERR_ADDRESS_CONFLICT (-34)
369	/** Unresolved (unknown) host platform error. */
370	#define VERR_UNRESOLVED_ERROR (-35)
371	/** Invalid function. */
372	#define VERR_INVALID_FUNCTION (-36)
373	/** Not supported. */
374	#define VERR_NOT_SUPPORTED (-37)
375	/** Access denied. */
376	#define VERR_ACCESS_DENIED (-38)
377	/** Call interrupted. */
378	#define VERR_INTERRUPTED (-39)
379	/** Timeout. */
380	#define VERR_TIMEOUT (-40)
381	/** Buffer too small to save result. */
382	#define VERR_BUFFER_OVERFLOW (-41)
383	/** Buffer too small to save result. */
384	#define VINF_BUFFER_OVERFLOW 41
385	/** Data size overflow. */
386	#define VERR_TOO_MUCH_DATA (-42)
387	/** Max threads number reached. */
388	#define VERR_MAX_THRDS_REACHED (-43)
389	/** Max process number reached. */
390	#define VERR_MAX_PROCS_REACHED (-44)
391	/** The recipient process has refused the signal. */
392	#define VERR_SIGNAL_REFUSED (-45)
393	/** A signal is already pending. */
394	#define VERR_SIGNAL_PENDING (-46)
395	/** The signal being posted is not correct. */
396	#define VERR_SIGNAL_INVALID (-47)
397	/** The state changed.
398	* This is a generic error message and needs a context to make sense. */
399	#define VERR_STATE_CHANGED (-48)
400	/** Warning, the state changed.
401	* This is a generic error message and needs a context to make sense. */
402	#define VWRN_STATE_CHANGED 48
403	/** Error while parsing UUID string */
404	#define VERR_INVALID_UUID_FORMAT (-49)
405	/** The specified process was not found. */
406	#define VERR_PROCESS_NOT_FOUND (-50)
407	/** The process specified to a non-block wait had not exitted. */
408	#define VERR_PROCESS_RUNNING (-51)
409	/** Retry the operation. */
410	#define VERR_TRY_AGAIN (-52)
411	/** Generic parse error. */
412	#define VERR_PARSE_ERROR (-53)
413	/** Value out of range. */
414	#define VERR_OUT_OF_RANGE (-54)
415	/** A numeric convertion encountered a value which was too big for the target. */
416	#define VERR_NUMBER_TOO_BIG (-55)
417	/** A numeric convertion encountered a value which was too big for the target. */
418	#define VWRN_NUMBER_TOO_BIG 55
419	/** The number begin converted (string) contained no digits. */
420	#define VERR_NO_DIGITS (-56)
421	/** The number begin converted (string) contained no digits. */
422	#define VWRN_NO_DIGITS 56
423	/** Encountered a '-' during convertion to an unsigned value. */
424	#define VERR_NEGATIVE_UNSIGNED (-57)
425	/** Encountered a '-' during convertion to an unsigned value. */
426	#define VWRN_NEGATIVE_UNSIGNED 57
427	/** Error while characters translation (unicode and so). */
428	#define VERR_NO_TRANSLATION (-58)
429	/** Encountered unicode code point which is reserved for use as endian indicator (0xffff or 0xfffe). */
430	#define VERR_CODE_POINT_ENDIAN_INDICATOR (-59)
431	/** Encountered unicode code point in the surrogate range (0xd800 to 0xdfff). */
432	#define VERR_CODE_POINT_SURROGATE (-60)
433	/** A string claiming to be UTF-8 is incorrectly encoded. */
434	#define VERR_INVALID_UTF8_ENCODING (-61)
435	/** Ad string claiming to be in UTF-16 is incorrectly encoded. */
436	#define VERR_INVALID_UTF16_ENCODING (-62)
437	/** Encountered a unicode code point which cannot be represented as UTF-16. */
438	#define VERR_CANT_RECODE_AS_UTF16 (-63)
439	/** Got an out of memory condition trying to allocate a string. */
440	#define VERR_NO_STR_MEMORY (-64)
441	/** Got an out of memory condition trying to allocate a UTF-16 (/UCS-2) string. */
442	#define VERR_NO_UTF16_MEMORY (-65)
443	/** Get an out of memory condition trying to allocate a code point array. */
444	#define VERR_NO_CODE_POINT_MEMORY (-66)
445	/** Can't free the memory because it's used in mapping. */
446	#define VERR_MEMORY_BUSY (-67)
447	/** The timer can't be started because it's already active. */
448	#define VERR_TIMER_ACTIVE (-68)
449	/** The timer can't be stopped because i's already suspended. */
450	#define VERR_TIMER_SUSPENDED (-69)
451	/** The operation was cancelled by the user. */
452	#define VERR_CANCELLED (-70)
453	/** Failed to initialize a memory object.
454	* Exactly what this means is OS specific. */
455	#define VERR_MEMOBJ_INIT_FAILED (-71)
456	/** Out of memory condition when allocating memory with low physical backing. */
457	#define VERR_NO_LOW_MEMORY (-72)
458	/** Out of memory condition when allocating physical memory (without mapping). */
459	#define VERR_NO_PHYS_MEMORY (-73)
460	/** The address (virtual or physical) is too big. */
461	#define VERR_ADDRESS_TOO_BIG (-74)
462	/** Failed to map a memory object. */
463	#define VERR_MAP_FAILED (-75)
464	/** Trailing characters. */
465	#define VERR_TRAILING_CHARS (-76)
466	/** Trailing characters. */
467	#define VWRN_TRAILING_CHARS 76
468	/** Trailing spaces. */
469	#define VERR_TRAILING_SPACES (-77)
470	/** Trailing spaces. */
471	#define VWRN_TRAILING_SPACES 77
472	/** Generic not found error. */
473	#define VERR_NOT_FOUND (-78)
474	/** Generic not found warning. */
475	#define VWRN_NOT_FOUND 78
476	/** Generic invalid state error. */
477	#define VERR_INVALID_STATE (-79)
478	/** Generic invalid state warning. */
479	#define VWRN_INVALID_STATE 79
480	/** Generic out of resources error. */
481	#define VERR_OUT_OF_RESOURCES (-80)
482	/** Generic out of resources warning. */
483	#define VWRN_OUT_OF_RESOURCES 80
484	/** No more handles available, too many open handles. */
485	#define VERR_NO_MORE_HANDLES (-81)
486	/** @} */
487
488
489	/** @name Common File/Disk/Pipe/etc Status Codes
490	* @{
491	*/
492	/** Unresolved (unknown) file i/o error. */
493	#define VERR_FILE_IO_ERROR (-100)
494	/** File/Device open failed. */
495	#define VERR_OPEN_FAILED (-101)
496	/** File not found. */
497	#define VERR_FILE_NOT_FOUND (-102)
498	/** Path not found. */
499	#define VERR_PATH_NOT_FOUND (-103)
500	/** Invalid (malformed) file/path name. */
501	#define VERR_INVALID_NAME (-104)
502	/** File/Device already exists. */
503	#define VERR_ALREADY_EXISTS (-105)
504	/** Too many open files. */
505	#define VERR_TOO_MANY_OPEN_FILES (-106)
506	/** Seek error. */
507	#define VERR_SEEK (-107)
508	/** Seek below file start. */
509	#define VERR_NEGATIVE_SEEK (-108)
510	/** Trying to seek on device. */
511	#define VERR_SEEK_ON_DEVICE (-109)
512	/** Reached the end of the file. */
513	#define VERR_EOF (-110)
514	/** Reached the end of the file. */
515	#define VINF_EOF 110
516	/** Generic file read error. */
517	#define VERR_READ_ERROR (-111)
518	/** Generic file write error. */
519	#define VERR_WRITE_ERROR (-112)
520	/** Write protect error. */
521	#define VERR_WRITE_PROTECT (-113)
522	/** Sharing violation, file is being used by another process. */
523	#define VERR_SHARING_VIOLATION (-114)
524	/** Unable to lock a region of a file. */
525	#define VERR_FILE_LOCK_FAILED (-115)
526	/** File access error, another process has locked a portion of the file. */
527	#define VERR_FILE_LOCK_VIOLATION (-116)
528	/** File or directory can't be created. */
529	#define VERR_CANT_CREATE (-117)
530	/** Directory can't be deleted. */
531	#define VERR_CANT_DELETE_DIRECTORY (-118)
532	/** Can't move file to another disk. */
533	#define VERR_NOT_SAME_DEVICE (-119)
534	/** The filename or extension is too long. */
535	#define VERR_FILENAME_TOO_LONG (-120)
536	/** Media not present in drive. */
537	#define VERR_MEDIA_NOT_PRESENT (-121)
538	/** The type of media was not recognized. Not formatted? */
539	#define VERR_MEDIA_NOT_RECOGNIZED (-122)
540	/** Can't unlock - region was not locked. */
541	#define VERR_FILE_NOT_LOCKED (-123)
542	/** Unrecoverable error: lock was lost. */
543	#define VERR_FILE_LOCK_LOST (-124)
544	/** Can't delete directory with files. */
545	#define VERR_DIR_NOT_EMPTY (-125)
546	/** A directory operation was attempted on a non-directory object. */
547	#define VERR_NOT_A_DIRECTORY (-126)
548	/** A non-directory operation was attempted on a directory object. */
549	#define VERR_IS_A_DIRECTORY (-127)
550	/** Tried to grow a file beyond the limit imposed by the process or the filesystem. */
551	#define VERR_FILE_TOO_BIG (-128)
552	/** @} */
553
554
555	/** @name Generic Filesystem I/O Status Codes
556	* @{
557	*/
558	/** Unresolved (unknown) disk i/o error. */
559	#define VERR_DISK_IO_ERROR (-150)
560	/** Invalid drive number. */
561	#define VERR_INVALID_DRIVE (-151)
562	/** Disk is full. */
563	#define VERR_DISK_FULL (-152)
564	/** Disk was changed. */
565	#define VERR_DISK_CHANGE (-153)
566	/** Drive is locked. */
567	#define VERR_DRIVE_LOCKED (-154)
568	/** The specified disk or diskette cannot be accessed. */
569	#define VERR_DISK_INVALID_FORMAT (-155)
570	/** Too many symbolic links. */
571	#define VERR_TOO_MANY_SYMLINKS (-156)
572	/** @} */
573
574
575	/** @name Generic Directory Enumeration Status Codes
576	* @{
577	*/
578	/** Unresolved (unknown) search error. */
579	#define VERR_SEARCH_ERROR (-200)
580	/** No more files found. */
581	#define VERR_NO_MORE_FILES (-201)
582	/** No more search handles available. */
583	#define VERR_NO_MORE_SEARCH_HANDLES (-202)
584	/** RTDirReadEx() failed to retrieve the extra data which was requested. */
585	#define VWRN_NO_DIRENT_INFO 203
586	/** @} */
587
588
589	/** @name Generic Device I/O Status Codes
590	* @{
591	*/
592	/** Unresolved (unknown) device i/o error. */
593	#define VERR_DEV_IO_ERROR (-250)
594	/** Device i/o: Bad unit. */
595	#define VERR_IO_BAD_UNIT (-251)
596	/** Device i/o: Not ready. */
597	#define VERR_IO_NOT_READY (-252)
598	/** Device i/o: Bad command. */
599	#define VERR_IO_BAD_COMMAND (-253)
600	/** Device i/o: CRC error. */
601	#define VERR_IO_CRC (-254)
602	/** Device i/o: Bad length. */
603	#define VERR_IO_BAD_LENGTH (-255)
604	/** Device i/o: Sector not found. */
605	#define VERR_IO_SECTOR_NOT_FOUND (-256)
606	/** Device i/o: General failure. */
607	#define VERR_IO_GEN_FAILURE (-257)
608	/** @} */
609
610
611	/** @name Generic Pipe I/O Status Codes
612	* @{
613	*/
614	/** Unresolved (unknown) pipe i/o error. */
615	#define VERR_PIPE_IO_ERROR (-300)
616	/** Broken pipe. */
617	#define VERR_BROKEN_PIPE (-301)
618	/** Bad pipe. */
619	#define VERR_BAD_PIPE (-302)
620	/** Pipe is busy. */
621	#define VERR_PIPE_BUSY (-303)
622	/** No data in pipe. */
623	#define VERR_NO_DATA (-304)
624	/** Pipe is not connected. */
625	#define VERR_PIPE_NOT_CONNECTED (-305)
626	/** More data available in pipe. */
627	#define VERR_MORE_DATA (-306)
628	/** @} */
629
630
631	/** @name Generic Semaphores Status Codes
632	* @{
633	*/
634	/** Unresolved (unknown) semaphore error. */
635	#define VERR_SEM_ERROR (-350)
636	/** Too many semaphores. */
637	#define VERR_TOO_MANY_SEMAPHORES (-351)
638	/** Exclusive semaphore is owned by another process. */
639	#define VERR_EXCL_SEM_ALREADY_OWNED (-352)
640	/** The semaphore is set and cannot be closed. */
641	#define VERR_SEM_IS_SET (-353)
642	/** The semaphore cannot be set again. */
643	#define VERR_TOO_MANY_SEM_REQUESTS (-354)
644	/** Attempt to release mutex not owned by caller. */
645	#define VERR_NOT_OWNER (-355)
646	/** The semaphore has been opened too many times. */
647	#define VERR_TOO_MANY_OPENS (-356)
648	/** The maximum posts for the event semaphore has been reached. */
649	#define VERR_TOO_MANY_POSTS (-357)
650	/** The event semaphore has already been posted. */
651	#define VERR_ALREADY_POSTED (-358)
652	/** The event semaphore has already been reset. */
653	#define VERR_ALREADY_RESET (-359)
654	/** The semaphore is in use. */
655	#define VERR_SEM_BUSY (-360)
656	/** The previous ownership of this semaphore has ended. */
657	#define VERR_SEM_OWNER_DIED (-361)
658	/** Failed to open semaphore by name - not found. */
659	#define VERR_SEM_NOT_FOUND (-362)
660	/** Semaphore destroyed while waiting. */
661	#define VERR_SEM_DESTROYED (-363)
662	/** Nested ownership requests are not permitted for this semaphore type. */
663	#define VERR_SEM_NESTED (-364)
664	/** Deadlock detected. */
665	#define VERR_DEADLOCK (-365)
666	/** Ping-Pong listen or speak out of turn error. */
667	#define VERR_SEM_OUT_OF_TURN (-366)
668	/** @} */
669
670
671	/** @name Generic Network I/O Status Codes
672	* @{
673	*/
674	/** Unresolved (unknown) network error. */
675	#define VERR_NET_IO_ERROR (-400)
676	/** The network is busy or is out of resources. */
677	#define VERR_NET_OUT_OF_RESOURCES (-401)
678	/** Net host name not found. */
679	#define VERR_NET_HOST_NOT_FOUND (-402)
680	/** Network path not found. */
681	#define VERR_NET_PATH_NOT_FOUND (-403)
682	/** General network printing error. */
683	#define VERR_NET_PRINT_ERROR (-404)
684	/** The machine is not on the network. */
685	#define VERR_NET_NO_NETWORK (-405)
686	/** Name is not unique on the network. */
687	#define VERR_NET_NOT_UNIQUE_NAME (-406)
688
689	/* These are BSD networking error codes - numbers correspond, don't mess! */
690	/** Operation in progress. */
691	#define VERR_NET_IN_PROGRESS (-436)
692	/** Operation already in progress. */
693	#define VERR_NET_ALREADY_IN_PROGRESS (-437)
694	/** Attempted socket operation with a non-socket handle.
695	* (This includes closed handles.) */
696	#define VERR_NET_NOT_SOCKET (-438)
697	/** Destination address required. */
698	#define VERR_NET_DEST_ADDRESS_REQUIRED (-439)
699	/** Message too long. */
700	#define VERR_NET_MSG_SIZE (-440)
701	/** Protocol wrong type for socket. */
702	#define VERR_NET_PROTOCOL_TYPE (-441)
703	/** Protocol not available. */
704	#define VERR_NET_PROTOCOL_NOT_AVAILABLE (-442)
705	/** Protocol not supported. */
706	#define VERR_NET_PROTOCOL_NOT_SUPPORTED (-443)
707	/** Socket type not supported. */
708	#define VERR_NET_SOCKET_TYPE_NOT_SUPPORTED (-444)
709	/** Operation not supported. */
710	#define VERR_NET_OPERATION_NOT_SUPPORTED (-445)
711	/** Protocol family not supported. */
712	#define VERR_NET_PROTOCOL_FAMILY_NOT_SUPPORTED (-446)
713	/** Address family not supported by protocol family. */
714	#define VERR_NET_ADDRESS_FAMILY_NOT_SUPPORTED (-447)
715	/** Address already in use. */
716	#define VERR_NET_ADDRESS_IN_USE (-448)
717	/** Can't assign requested address. */
718	#define VERR_NET_ADDRESS_NOT_AVAILABLE (-449)
719	/** Network is down. */
720	#define VERR_NET_DOWN (-450)
721	/** Network is unreachable. */
722	#define VERR_NET_UNREACHABLE (-451)
723	/** Network dropped connection on reset. */
724	#define VERR_NET_CONNECTION_RESET (-452)
725	/** Software caused connection abort. */
726	#define VERR_NET_CONNECTION_ABORTED (-453)
727	/** Connection reset by peer. */
728	#define VERR_NET_CONNECTION_RESET_BY_PEER (-454)
729	/** No buffer space available. */
730	#define VERR_NET_NO_BUFFER_SPACE (-455)
731	/** Socket is already connected. */
732	#define VERR_NET_ALREADY_CONNECTED (-456)
733	/** Socket is not connected. */
734	#define VERR_NET_NOT_CONNECTED (-457)
735	/** Can't send after socket shutdown. */
736	#define VERR_NET_SHUTDOWN (-458)
737	/** Too many references: can't splice. */
738	#define VERR_NET_TOO_MANY_REFERENCES (-459)
739	/** Too many references: can't splice. */
740	#define VERR_NET_CONNECTION_TIMED_OUT (-460)
741	/** Connection refused. */
742	#define VERR_NET_CONNECTION_REFUSED (-461)
743	/* ELOOP is not net. */
744	/* ENAMETOOLONG is not net. */
745	/** Host is down. */
746	#define VERR_NET_HOST_DOWN (-464)
747	/** No route to host. */
748	#define VERR_NET_HOST_UNREACHABLE (-465)
749	/** Protocol error. */
750	#define VERR_NET_PROTOCOL_ERROR (-466)
751	/** @} */
752
753
754	/** @name TCP Status Codes
755	* @{
756	*/
757	/** Stop the TCP server. */
758	#define VERR_TCP_SERVER_STOP (-500)
759	/** The server was stopped. */
760	#define VINF_TCP_SERVER_STOP 500
761	/** @} */
762
763
764	/** @name L4 Specific Status Codes
765	* @{
766	*/
767	/** Invalid offset in an L4 dataspace */
768	#define VERR_L4_INVALID_DS_OFFSET (-550)
769	/** IPC error */
770	#define VERR_IPC (-551)
771	/** Item already used */
772	#define VERR_RESOURCE_IN_USE (-552)
773	/** Source/destination not found */
774	#define VERR_IPC_PROCESS_NOT_FOUND (-553)
775	/** Receive timeout */
776	#define VERR_IPC_RECEIVE_TIMEOUT (-554)
777	/** Send timeout */
778	#define VERR_IPC_SEND_TIMEOUT (-555)
779	/** Receive cancelled */
780	#define VERR_IPC_RECEIVE_CANCELLED (-556)
781	/** Send cancelled */
782	#define VERR_IPC_SEND_CANCELLED (-557)
783	/** Receive aborted */
784	#define VERR_IPC_RECEIVE_ABORTED (-558)
785	/** Send aborted */
786	#define VERR_IPC_SEND_ABORTED (-559)
787	/** Couldn't map pages during receive */
788	#define VERR_IPC_RECEIVE_MAP_FAILED (-560)
789	/** Couldn't map pages during send */
790	#define VERR_IPC_SEND_MAP_FAILED (-561)
791	/** Send pagefault timeout in receive */
792	#define VERR_IPC_RECEIVE_SEND_PF_TIMEOUT (-562)
793	/** Send pagefault timeout in send */
794	#define VERR_IPC_SEND_SEND_PF_TIMEOUT (-563)
795	/** (One) receive buffer was too small, or too few buffers */
796	#define VINF_IPC_RECEIVE_MSG_CUT 564
797	/** (One) send buffer was too small, or too few buffers */
798	#define VINF_IPC_SEND_MSG_CUT 565
799	/** Dataspace manager server not found */
800	#define VERR_L4_DS_MANAGER_NOT_FOUND (-566)
801	/** @} */
802
803
804	/** @name Loader Status Codes.
805	* @{
806	*/
807	/** Invalid executable signature. */
808	#define VERR_INVALID_EXE_SIGNATURE (-600)
809	/** The iprt loader recognized a ELF image, but doesn't support loading it. */
810	#define VERR_ELF_EXE_NOT_SUPPORTED (-601)
811	/** The iprt loader recognized a PE image, but doesn't support loading it. */
812	#define VERR_PE_EXE_NOT_SUPPORTED (-602)
813	/** The iprt loader recognized a LX image, but doesn't support loading it. */
814	#define VERR_LX_EXE_NOT_SUPPORTED (-603)
815	/** The iprt loader recognized a LE image, but doesn't support loading it. */
816	#define VERR_LE_EXE_NOT_SUPPORTED (-604)
817	/** The iprt loader recognized a NE image, but doesn't support loading it. */
818	#define VERR_NE_EXE_NOT_SUPPORTED (-605)
819	/** The iprt loader recognized a MZ image, but doesn't support loading it. */
820	#define VERR_MZ_EXE_NOT_SUPPORTED (-606)
821	/** The iprt loader recognized an a.out image, but doesn't support loading it. */
822	#define VERR_AOUT_EXE_NOT_SUPPORTED (-607)
823	/** Bad executable. */
824	#define VERR_BAD_EXE_FORMAT (-608)
825	/** Symbol (export) not found. */
826	#define VERR_SYMBOL_NOT_FOUND (-609)
827	/** Module not found. */
828	#define VERR_MODULE_NOT_FOUND (-610)
829	/** The loader resolved an external symbol to an address to big for the image format. */
830	#define VERR_SYMBOL_VALUE_TOO_BIG (-611)
831	/** The image is too big. */
832	#define VERR_IMAGE_TOO_BIG (-612)
833	/** The image base address is to high for this image type. */
834	#define VERR_IMAGE_BASE_TOO_HIGH (-614)
835	/** The PE loader encountered delayed imports, a feature which hasn't been implemented yet. */
836	#define VERR_LDRPE_DELAY_IMPORT (-620)
837	/** The PE loader doesn't have a clue what the security data directory entry is all about. */
838	#define VERR_LDRPE_SECURITY (-621)
839	/** The PE loader doesn't know how to deal with the global pointer data directory entry yet. */
840	#define VERR_LDRPE_GLOBALPTR (-622)
841	/** The PE loader doesn't support the TLS data directory yet. */
842	#define VERR_LDRPE_TLS (-623)
843	/** The PE loader doesn't grok the COM descriptor data directory entry. */
844	#define VERR_LDRPE_COM_DESCRIPTOR (-624)
845	/** The PE loader encountered an unknown load config directory/header size. */
846	#define VERR_LDRPE_LOAD_CONFIG_SIZE (-625)
847	/** The PE loader encountered a lock prefix table, a feature which hasn't been implemented yet. */
848	#define VERR_LDRPE_LOCK_PREFIX_TABLE (-626)
849	/** The ELF loader doesn't handle foreign endianness. */
850	#define VERR_LDRELF_ODD_ENDIAN (-630)
851	/** The ELF image is 'dynamic', the ELF loader can only deal with 'relocatable' images at present. */
852	#define VERR_LDRELF_DYN (-631)
853	/** The ELF image is 'executable', the ELF loader can only deal with 'relocatable' images at present. */
854	#define VERR_LDRELF_EXEC (-632)
855	/** The ELF image was created for an unsupported target machine type. */
856	#define VERR_LDRELF_MACHINE (-633)
857	/** The ELF version is not supported. */
858	#define VERR_LDRELF_VERSION (-634)
859	/** The ELF loader cannot handle multiple SYMTAB sections. */
860	#define VERR_LDRELF_MULTIPLE_SYMTABS (-635)
861	/** The ELF loader encountered a relocation type which is not implemented. */
862	#define VERR_LDRELF_RELOCATION_NOT_SUPPORTED (-636)
863	/** The ELF loader encountered a bad symbol index. */
864	#define VERR_LDRELF_INVALID_SYMBOL_INDEX (-637)
865	/** The ELF loader encountered an invalid symbol name offset. */
866	#define VERR_LDRELF_INVALID_SYMBOL_NAME_OFFSET (-638)
867	/** The ELF loader encountered an invalid relocation offset. */
868	#define VERR_LDRELF_INVALID_RELOCATION_OFFSET (-639)
869	/** The ELF loader didn't find the symbol/string table for the image. */
870	#define VERR_LDRELF_NO_SYMBOL_OR_NO_STRING_TABS (-640)
871	/** @}*/
872
873	/** @name Debug Info Reader Status Codes.
874	* @{
875	*/
876	/** The specified segment:offset address was invalid. Typically an attempt at
877	* addressing outside the segment boundrary. */
878	#define VERR_DBGMOD_INVALID_ADDRESS (-650)
879	/** @} */
880
881	/** @name Request Packet Status Codes.
882	* @{
883	*/
884	/** Invalid RT request type.
885	* For the RTReqAlloc() case, the caller just specified an illegal enmType. For
886	* all the other occurences it means indicates corruption, broken logic, or stupid
887	* interface user. */
888	#define VERR_RT_REQUEST_INVALID_TYPE (-700)
889	/** Invalid RT request state.
890	* The state of the request packet was not the expected and accepted one(s). Either
891	* the interface user screwed up, or we've got corruption/broken logic. */
892	#define VERR_RT_REQUEST_STATE (-701)
893	/** Invalid RT request packet.
894	* One or more of the RT controlled packet members didn't contain the correct
895	* values. Some thing's broken. */
896	#define VERR_RT_REQUEST_INVALID_PACKAGE (-702)
897	/** The status field has not been updated yet as the request is still
898	* pending completion. Someone queried the iStatus field before the request
899	* has been fully processed. */
900	#define VERR_RT_REQUEST_STATUS_STILL_PENDING (-703)
901	/** The request has been freed, don't read the status now.
902	* Someone is reading the iStatus field of a freed request packet. */
903	#define VERR_RT_REQUEST_STATUS_FREED (-704)
904	/** @} */
905
906	/** @name Environment Status Code
907	* @{
908	*/
909	/** The specified environment variable was not found. (RTEnvGetEx) */
910	#define VERR_ENV_VAR_NOT_FOUND (-750)
911	/** The specified environment variable was not found. (RTEnvUnsetEx) */
912	#define VINF_ENV_VAR_NOT_FOUND (750)
913	/** @} */
914
915	/** @name Multiprocessor Status Codes.
916	* @{
917	*/
918	/** The specified cpu is offline. */
919	#define VERR_CPU_OFFLINE (-800)
920	/** The specified cpu was not found. */
921	#define VERR_CPU_NOT_FOUND (-801)
922	/** @} */
923
924	/** @name RTGetOpt status codes
925	* @{ */
926	/** RTGetOpt: command line option not recognized. */
927	#define VERR_GETOPT_UNKNOWN_OPTION (-825)
928	/** RTGetOpt: command line option needs argument. */
929	#define VERR_GETOPT_REQUIRED_ARGUMENT_MISSING (-826)
930	/** RTGetOpt: command line option has argument with bad format. */
931	#define VERR_GETOPT_INVALID_ARGUMENT_FORMAT (-827)
932	/** @} */
933
934	/** @name RTCache status codes
935	* @{ */
936	/** RTCache: cache is full. */
937	#define VERR_CACHE_FULL (-850)
938	/** RTCache: cache is empty. */
939	#define VERR_CACHE_EMPTY (-851)
940	/** @} */
941
942	/* SED-END */
943
944	/** @} */
945
946	__END_DECLS
947
948	#endif
949

Note: See TracBrowser for help on using the repository browser.

source: vbox/trunk/include/iprt/err.h@ 10975

Download in other formats: