VirtualBox

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

Last change on this file since 36522 was 35182, checked in by vboxsync, 14 years ago

iprt/err.h: Added RTErrInfo* for supplementing the IPRT style status codes with an error message.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Author Date Id Revision
File size: 59.8 KB
Line 
1/** @file
2 * IPRT - Status Codes.
3 */
4
5/*
6 * Copyright (C) 2006-2010 Oracle Corporation
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
26#ifndef ___iprt_err_h
27#define ___iprt_err_h
28
29#include <iprt/cdefs.h>
30#include <iprt/types.h>
31#include <iprt/stdarg.h>
32
33
34/** @defgroup grp_rt_err RTErr - Status Codes
35 * @ingroup grp_rt
36 *
37 * The IPRT status codes are in two ranges: {0..999} and {22000..32766}. The
38 * IPRT users are free to use the range {1000..21999}. See RTERR_RANGE1_FIRST,
39 * RTERR_RANGE1_LAST, RTERR_RANGE2_FIRST, RTERR_RANGE2_LAST, RTERR_USER_FIRST
40 * and RTERR_USER_LAST.
41 *
42 * @{
43 */
44
45/** @defgroup grp_rt_err_hlp Status Code Helpers
46 * @ingroup grp_rt_err
47 * @{
48 */
49
50#ifdef __cplusplus
51/**
52 * Strict type validation class.
53 *
54 * This is only really useful for type checking the arguments to RT_SUCCESS,
55 * RT_SUCCESS_NP, RT_FAILURE and RT_FAILURE_NP. The RTErrStrictType2
56 * constructor is for integration with external status code strictness regimes.
57 */
58class RTErrStrictType
59{
60protected:
61 int32_t m_rc;
62
63public:
64 /**
65 * Constructor for interaction with external status code strictness regimes.
66 *
67 * This is a special constructor for helping external return code validator
68 * classes interact cleanly with RT_SUCCESS, RT_SUCCESS_NP, RT_FAILURE and
69 * RT_FAILURE_NP while barring automatic cast to integer.
70 *
71 * @param rcObj IPRT status code object from an automatic cast.
72 */
73 RTErrStrictType(RTErrStrictType2 const rcObj)
74 : m_rc(rcObj.getValue())
75 {
76 }
77
78 /**
79 * Integer constructor used by RT_SUCCESS_NP.
80 *
81 * @param rc IPRT style status code.
82 */
83 RTErrStrictType(int32_t rc)
84 : m_rc(rc)
85 {
86 }
87
88#if 0 /** @todo figure where int32_t is long instead of int. */
89 /**
90 * Integer constructor used by RT_SUCCESS_NP.
91 *
92 * @param rc IPRT style status code.
93 */
94 RTErrStrictType(signed int rc)
95 : m_rc(rc)
96 {
97 }
98#endif
99
100 /**
101 * Test for success.
102 */
103 bool success() const
104 {
105 return m_rc >= 0;
106 }
107
108private:
109 /** @name Try ban a number of wrong types.
110 * @{ */
111 RTErrStrictType(uint8_t rc) : m_rc(-999) { NOREF(rc); }
112 RTErrStrictType(uint16_t rc) : m_rc(-999) { NOREF(rc); }
113 RTErrStrictType(uint32_t rc) : m_rc(-999) { NOREF(rc); }
114 RTErrStrictType(uint64_t rc) : m_rc(-999) { NOREF(rc); }
115 RTErrStrictType(int8_t rc) : m_rc(-999) { NOREF(rc); }
116 RTErrStrictType(int16_t rc) : m_rc(-999) { NOREF(rc); }
117 RTErrStrictType(int64_t rc) : m_rc(-999) { NOREF(rc); }
118 /** @todo fight long here - clashes with int32_t/int64_t on some platforms. */
119 /** @} */
120};
121#endif /* __cplusplus */
122
123
124/** @def RTERR_STRICT_RC
125 * Indicates that RT_SUCCESS_NP, RT_SUCCESS, RT_FAILURE_NP and RT_FAILURE should
126 * make type enforcing at compile time.
127 *
128 * @remarks Only define this for C++ code.
129 */
130#if defined(__cplusplus) \
131 && !defined(RTERR_STRICT_RC) \
132 && ( defined(DOXYGEN_RUNNING) \
133 || defined(DEBUG) \
134 || defined(RT_STRICT) )
135# define RTERR_STRICT_RC 1
136#endif
137
138
139/** @def RT_SUCCESS
140 * Check for success. We expect success in normal cases, that is the code path depending on
141 * this check is normally taken. To prevent any prediction use RT_SUCCESS_NP instead.
142 *
143 * @returns true if rc indicates success.
144 * @returns false if rc indicates failure.
145 *
146 * @param rc The iprt status code to test.
147 */
148#define RT_SUCCESS(rc) ( RT_LIKELY(RT_SUCCESS_NP(rc)) )
149
150/** @def RT_SUCCESS_NP
151 * Check for success. Don't predict the result.
152 *
153 * @returns true if rc indicates success.
154 * @returns false if rc indicates failure.
155 *
156 * @param rc The iprt status code to test.
157 */
158#ifdef RTERR_STRICT_RC
159# define RT_SUCCESS_NP(rc) ( RTErrStrictType(rc).success() )
160#else
161# define RT_SUCCESS_NP(rc) ( (int)(rc) >= VINF_SUCCESS )
162#endif
163
164/** @def RT_FAILURE
165 * Check for failure. We don't expect in normal cases, that is the code path depending on
166 * this check is normally NOT taken. To prevent any prediction use RT_FAILURE_NP instead.
167 *
168 * @returns true if rc indicates failure.
169 * @returns false if rc indicates success.
170 *
171 * @param rc The iprt status code to test.
172 */
173#define RT_FAILURE(rc) ( RT_UNLIKELY(!RT_SUCCESS_NP(rc)) )
174
175/** @def RT_FAILURE_NP
176 * Check for failure. Don't predict the result.
177 *
178 * @returns true if rc indicates failure.
179 * @returns false if rc indicates success.
180 *
181 * @param rc The iprt status code to test.
182 */
183#define RT_FAILURE_NP(rc) ( !RT_SUCCESS_NP(rc) )
184
185RT_C_DECLS_BEGIN
186
187/**
188 * Converts a Darwin HRESULT error to an iprt status code.
189 *
190 * @returns iprt status code.
191 * @param iNativeCode HRESULT error code.
192 * @remark Darwin ring-3 only.
193 */
194RTDECL(int) RTErrConvertFromDarwinCOM(int32_t iNativeCode);
195
196/**
197 * Converts a Darwin IOReturn error to an iprt status code.
198 *
199 * @returns iprt status code.
200 * @param iNativeCode IOReturn error code.
201 * @remark Darwin only.
202 */
203RTDECL(int) RTErrConvertFromDarwinIO(int iNativeCode);
204
205/**
206 * Converts a Darwin kern_return_t error to an iprt status code.
207 *
208 * @returns iprt status code.
209 * @param iNativeCode kern_return_t error code.
210 * @remark Darwin only.
211 */
212RTDECL(int) RTErrConvertFromDarwinKern(int iNativeCode);
213
214/**
215 * Converts a Darwin error to an iprt status code.
216 *
217 * This will consult RTErrConvertFromDarwinKern, RTErrConvertFromDarwinIO
218 * and RTErrConvertFromDarwinCOM in this order. The latter is ring-3 only as it
219 * doesn't apply elsewhere.
220 *
221 * @returns iprt status code.
222 * @param iNativeCode Darwin error code.
223 * @remarks Darwin only.
224 * @remarks This is recommended over RTErrConvertFromDarwinKern and RTErrConvertFromDarwinIO
225 * since these are really just subsets of the same error space.
226 */
227RTDECL(int) RTErrConvertFromDarwin(int iNativeCode);
228
229/**
230 * Converts errno to iprt status code.
231 *
232 * @returns iprt status code.
233 * @param uNativeCode errno code.
234 */
235RTDECL(int) RTErrConvertFromErrno(unsigned uNativeCode);
236
237/**
238 * Converts a L4 errno to a iprt status code.
239 *
240 * @returns iprt status code.
241 * @param uNativeCode l4 errno.
242 * @remark L4 only.
243 */
244RTDECL(int) RTErrConvertFromL4Errno(unsigned uNativeCode);
245
246/**
247 * Converts NT status code to iprt status code.
248 *
249 * Needless to say, this is only available on NT and winXX targets.
250 *
251 * @returns iprt status code.
252 * @param lNativeCode NT status code.
253 * @remark Windows only.
254 */
255RTDECL(int) RTErrConvertFromNtStatus(long lNativeCode);
256
257/**
258 * Converts OS/2 error code to iprt status code.
259 *
260 * @returns iprt status code.
261 * @param uNativeCode OS/2 error code.
262 * @remark OS/2 only.
263 */
264RTDECL(int) RTErrConvertFromOS2(unsigned uNativeCode);
265
266/**
267 * Converts Win32 error code to iprt status code.
268 *
269 * @returns iprt status code.
270 * @param uNativeCode Win32 error code.
271 * @remark Windows only.
272 */
273RTDECL(int) RTErrConvertFromWin32(unsigned uNativeCode);
274
275/**
276 * Converts an iprt status code to a errno status code.
277 *
278 * @returns errno status code.
279 * @param iErr iprt status code.
280 */
281RTDECL(int) RTErrConvertToErrno(int iErr);
282
283#ifdef IN_RING3
284
285/**
286 * iprt status code message.
287 */
288typedef struct RTSTATUSMSG
289{
290 /** Pointer to the short message string. */
291 const char *pszMsgShort;
292 /** Pointer to the full message string. */
293 const char *pszMsgFull;
294 /** Pointer to the define string. */
295 const char *pszDefine;
296 /** Status code number. */
297 int iCode;
298} RTSTATUSMSG;
299/** Pointer to iprt status code message. */
300typedef RTSTATUSMSG *PRTSTATUSMSG;
301/** Pointer to const iprt status code message. */
302typedef const RTSTATUSMSG *PCRTSTATUSMSG;
303
304/**
305 * Get the message structure corresponding to a given iprt status code.
306 *
307 * @returns Pointer to read-only message description.
308 * @param rc The status code.
309 */
310RTDECL(PCRTSTATUSMSG) RTErrGet(int rc);
311
312/**
313 * Get the define corresponding to a given iprt status code.
314 *
315 * @returns Pointer to read-only string with the \#define identifier.
316 * @param rc The status code.
317 */
318#define RTErrGetDefine(rc) (RTErrGet(rc)->pszDefine)
319
320/**
321 * Get the short description corresponding to a given iprt status code.
322 *
323 * @returns Pointer to read-only string with the description.
324 * @param rc The status code.
325 */
326#define RTErrGetShort(rc) (RTErrGet(rc)->pszMsgShort)
327
328/**
329 * Get the full description corresponding to a given iprt status code.
330 *
331 * @returns Pointer to read-only string with the description.
332 * @param rc The status code.
333 */
334#define RTErrGetFull(rc) (RTErrGet(rc)->pszMsgFull)
335
336#ifdef RT_OS_WINDOWS
337/**
338 * Windows error code message.
339 */
340typedef struct RTWINERRMSG
341{
342 /** Pointer to the full message string. */
343 const char *pszMsgFull;
344 /** Pointer to the define string. */
345 const char *pszDefine;
346 /** Error code number. */
347 long iCode;
348} RTWINERRMSG;
349/** Pointer to Windows error code message. */
350typedef RTWINERRMSG *PRTWINERRMSG;
351/** Pointer to const Windows error code message. */
352typedef const RTWINERRMSG *PCRTWINERRMSG;
353
354/**
355 * Get the message structure corresponding to a given Windows error code.
356 *
357 * @returns Pointer to read-only message description.
358 * @param rc The status code.
359 */
360RTDECL(PCRTWINERRMSG) RTErrWinGet(long rc);
361
362/** On windows COM errors are part of the Windows error database. */
363typedef RTWINERRMSG RTCOMERRMSG;
364
365#else /* !RT_OS_WINDOWS */
366
367/**
368 * COM/XPCOM error code message.
369 */
370typedef struct RTCOMERRMSG
371{
372 /** Pointer to the full message string. */
373 const char *pszMsgFull;
374 /** Pointer to the define string. */
375 const char *pszDefine;
376 /** Error code number. */
377 uint32_t iCode;
378} RTCOMERRMSG;
379#endif /* !RT_OS_WINDOWS */
380/** Pointer to a XPCOM/COM error code message. */
381typedef RTCOMERRMSG *PRTCOMERRMSG;
382/** Pointer to const a XPCOM/COM error code message. */
383typedef const RTCOMERRMSG *PCRTCOMERRMSG;
384
385/**
386 * Get the message structure corresponding to a given COM/XPCOM error code.
387 *
388 * @returns Pointer to read-only message description.
389 * @param rc The status code.
390 */
391RTDECL(PCRTCOMERRMSG) RTErrCOMGet(uint32_t rc);
392
393#endif /* IN_RING3 */
394
395/** @defgroup RTERRINFO_FLAGS_XXX RTERRINFO::fFlags
396 * @{ */
397/** Custom structure (the default). */
398#define RTERRINFO_FLAGS_T_CUSTOM UINT32_C(0)
399/** Static structure (RTERRINFOSTATIC). */
400#define RTERRINFO_FLAGS_T_STATIC UINT32_C(1)
401/** Allocated structure (RTErrInfoAlloc). */
402#define RTERRINFO_FLAGS_T_ALLOC UINT32_C(2)
403/** Reserved type. */
404#define RTERRINFO_FLAGS_T_RESERVED UINT32_C(3)
405/** Type mask. */
406#define RTERRINFO_FLAGS_T_MASK UINT32_C(3)
407/** Error info is set. */
408#define RTERRINFO_FLAGS_SET RT_BIT_32(2)
409/** Fixed flags (magic). */
410#define RTERRINFO_FLAGS_MAGIC UINT32_C(0xbabe0000)
411/** The bit mask for the magic value. */
412#define RTERRINFO_FLAGS_MAGIC_MASK UINT32_C(0xffff0000)
413/** @} */
414
415/**
416 * Initializes an error info structure.
417 *
418 * @returns @a pErrInfo.
419 * @param pErrInfo The error info structure to init.
420 * @param pszMsg The message buffer. Must be at least one byte.
421 * @param cbMsg The size of the message buffer.
422 */
423DECLINLINE(PRTERRINFO) RTErrInfoInit(PRTERRINFO pErrInfo, char *pszMsg, size_t cbMsg)
424{
425 *pszMsg = '\0';
426
427 pErrInfo->fFlags = RTERRINFO_FLAGS_T_CUSTOM | RTERRINFO_FLAGS_MAGIC;
428 pErrInfo->rc = /*VINF_SUCCESS*/ 0;
429 pErrInfo->pszMsg = pszMsg;
430 pErrInfo->cbMsg = cbMsg;
431 pErrInfo->apvReserved[0] = NULL;
432 pErrInfo->apvReserved[1] = NULL;
433
434 return pErrInfo;
435}
436
437/**
438 * Initialize a static error info structure.
439 *
440 * @param pStaticErrInfo The static error info structure to init.
441 */
442DECLINLINE(void) RTErrInfoInitStatic(PRTERRINFOSTATIC pStaticErrInfo)
443{
444 RTErrInfoInit(&pStaticErrInfo->Core, pStaticErrInfo->szMsg, sizeof(pStaticErrInfo->szMsg));
445 pStaticErrInfo->Core.fFlags = RTERRINFO_FLAGS_T_STATIC | RTERRINFO_FLAGS_MAGIC;
446}
447
448/**
449 * Allocates a error info structure with a buffer at least the given size.
450 *
451 * @returns Pointer to an error info structure on success, NULL on failure.
452 *
453 * @param cbMsg The minimum message buffer size. Use 0 to get
454 * the default buffer size.
455 */
456RTDECL(PRTERRINFO) RTErrInfoAlloc(size_t cbMsg);
457
458/**
459 * Same as RTErrInfoAlloc, except that an IPRT status code is returned.
460 *
461 * @returns IPRT status code.
462 *
463 * @param cbMsg The minimum message buffer size. Use 0 to get
464 * the default buffer size.
465 * @param ppErrInfo Where to store the pointer to the allocated
466 * error info structure on success. This is
467 * always set to NULL.
468 */
469RTDECL(int) RTErrInfoAllocEx(size_t cbMsg, PRTERRINFO *ppErrInfo);
470
471/**
472 * Frees an error info structure allocated by RTErrInfoAlloc or
473 * RTErrInfoAllocEx.
474 *
475 * @param pErrInfo The error info structure.
476 */
477RTDECL(void) RTErrInfoFree(PRTERRINFO pErrInfo);
478
479/**
480 * Fills in the error info details.
481 *
482 * @returns @a rc.
483 *
484 * @param pErrInfo The error info structure to fill in.
485 * @param rc The status code to return.
486 * @param pszMsg The error message string.
487 */
488RTDECL(int) RTErrInfoSet(PRTERRINFO pErrInfo, int rc, const char *pszMsg);
489
490/**
491 * Fills in the error info details, with a sprintf style message.
492 *
493 * @returns @a rc.
494 *
495 * @param pErrInfo The error info structure to fill in.
496 * @param rc The status code to return.
497 * @param pszFormat The format string.
498 * @param ... The format arguments.
499 */
500RTDECL(int) RTErrInfoSetF(PRTERRINFO pErrInfo, int rc, const char *pszFormat, ...);
501
502/**
503 * Fills in the error info details, with a vsprintf style message.
504 *
505 * @returns @a rc.
506 *
507 * @param pErrInfo The error info structure to fill in.
508 * @param rc The status code to return.
509 * @param pszFormat The format string.
510 * @param va The format arguments.
511 */
512RTDECL(int) RTErrInfoSetV(PRTERRINFO pErrInfo, int rc, const char *pszFormat, va_list va);
513
514/**
515 * Checks if the error info is set.
516 *
517 * @returns true if set, false if not.
518 * @param pErrInfo The error info structure. NULL is OK.
519 */
520DECLINLINE(bool) RTErrInfoIsSet(PCRTERRINFO pErrInfo)
521{
522 if (!pErrInfo)
523 return false;
524 return (pErrInfo->fFlags & (RTERRINFO_FLAGS_MAGIC_MASK | RTERRINFO_FLAGS_SET))
525 == (RTERRINFO_FLAGS_MAGIC | RTERRINFO_FLAGS_SET);
526}
527
528/**
529 * Clears the error info structure.
530 *
531 * @param pErrInfo The error info structure. NULL is OK.
532 */
533DECLINLINE(void) RTErrInfoClear(PRTERRINFO pErrInfo)
534{
535 if (pErrInfo)
536 {
537 pErrInfo->fFlags &= ~RTERRINFO_FLAGS_SET;
538 pErrInfo->rc = /*VINF_SUCCESS*/0;
539 *pErrInfo->pszMsg = '\0';
540 }
541}
542
543RT_C_DECLS_END
544
545/** @} */
546
547/** @name Status Code Ranges
548 * @{ */
549/** The first status code in the primary IPRT range. */
550#define RTERR_RANGE1_FIRST 0
551/** The last status code in the primary IPRT range. */
552#define RTERR_RANGE1_LAST 999
553
554/** The first status code in the secondary IPRT range. */
555#define RTERR_RANGE2_FIRST 22000
556/** The last status code in the secondary IPRT range. */
557#define RTERR_RANGE2_LAST 32766
558
559/** The first status code in the user range. */
560#define RTERR_USER_FIRST 1000
561/** The last status code in the user range. */
562#define RTERR_USER_LAST 21999
563/** @} */
564
565
566/* SED-START */
567
568/** @name Misc. Status Codes
569 * @{
570 */
571/** Success. */
572#define VINF_SUCCESS 0
573
574/** General failure - DON'T USE THIS!!! */
575#define VERR_GENERAL_FAILURE (-1)
576/** Invalid parameter. */
577#define VERR_INVALID_PARAMETER (-2)
578/** Invalid parameter. */
579#define VWRN_INVALID_PARAMETER 2
580/** Invalid magic or cookie. */
581#define VERR_INVALID_MAGIC (-3)
582/** Invalid magic or cookie. */
583#define VWRN_INVALID_MAGIC 3
584/** Invalid loader handle. */
585#define VERR_INVALID_HANDLE (-4)
586/** Invalid loader handle. */
587#define VWRN_INVALID_HANDLE 4
588/** Failed to lock the address range. */
589#define VERR_LOCK_FAILED (-5)
590/** Invalid memory pointer. */
591#define VERR_INVALID_POINTER (-6)
592/** Failed to patch the IDT. */
593#define VERR_IDT_FAILED (-7)
594/** Memory allocation failed. */
595#define VERR_NO_MEMORY (-8)
596/** Already loaded. */
597#define VERR_ALREADY_LOADED (-9)
598/** Permission denied. */
599#define VERR_PERMISSION_DENIED (-10)
600/** Permission denied. */
601#define VINF_PERMISSION_DENIED 10
602/** Version mismatch. */
603#define VERR_VERSION_MISMATCH (-11)
604/** The request function is not implemented. */
605#define VERR_NOT_IMPLEMENTED (-12)
606
607/** Not equal. */
608#define VERR_NOT_EQUAL (-18)
609/** The specified path does not point at a symbolic link. */
610#define VERR_NOT_SYMLINK (-19)
611/** Failed to allocate temporary memory. */
612#define VERR_NO_TMP_MEMORY (-20)
613/** Invalid file mode mask (RTFMODE). */
614#define VERR_INVALID_FMODE (-21)
615/** Incorrect call order. */
616#define VERR_WRONG_ORDER (-22)
617/** There is no TLS (thread local storage) available for storing the current thread. */
618#define VERR_NO_TLS_FOR_SELF (-23)
619/** Failed to set the TLS (thread local storage) entry which points to our thread structure. */
620#define VERR_FAILED_TO_SET_SELF_TLS (-24)
621/** Not able to allocate contiguous memory. */
622#define VERR_NO_CONT_MEMORY (-26)
623/** No memory available for page table or page directory. */
624#define VERR_NO_PAGE_MEMORY (-27)
625/** Already initialized. */
626#define VINF_ALREADY_INITIALIZED 28
627/** The specified thread is dead. */
628#define VERR_THREAD_IS_DEAD (-29)
629/** The specified thread is not waitable. */
630#define VERR_THREAD_NOT_WAITABLE (-30)
631/** Pagetable not present. */
632#define VERR_PAGE_TABLE_NOT_PRESENT (-31)
633/** Invalid context.
634 * Typically an API was used by the wrong thread. */
635#define VERR_INVALID_CONTEXT (-32)
636/** The per process timer is busy. */
637#define VERR_TIMER_BUSY (-33)
638/** Address conflict. */
639#define VERR_ADDRESS_CONFLICT (-34)
640/** Unresolved (unknown) host platform error. */
641#define VERR_UNRESOLVED_ERROR (-35)
642/** Invalid function. */
643#define VERR_INVALID_FUNCTION (-36)
644/** Not supported. */
645#define VERR_NOT_SUPPORTED (-37)
646/** Not supported. */
647#define VINF_NOT_SUPPORTED 37
648/** Access denied. */
649#define VERR_ACCESS_DENIED (-38)
650/** Call interrupted. */
651#define VERR_INTERRUPTED (-39)
652/** Call interrupted. */
653#define VINF_INTERRUPTED 39
654/** Timeout. */
655#define VERR_TIMEOUT (-40)
656/** Timeout. */
657#define VINF_TIMEOUT 40
658/** Buffer too small to save result. */
659#define VERR_BUFFER_OVERFLOW (-41)
660/** Buffer too small to save result. */
661#define VINF_BUFFER_OVERFLOW 41
662/** Data size overflow. */
663#define VERR_TOO_MUCH_DATA (-42)
664/** Max threads number reached. */
665#define VERR_MAX_THRDS_REACHED (-43)
666/** Max process number reached. */
667#define VERR_MAX_PROCS_REACHED (-44)
668/** The recipient process has refused the signal. */
669#define VERR_SIGNAL_REFUSED (-45)
670/** A signal is already pending. */
671#define VERR_SIGNAL_PENDING (-46)
672/** The signal being posted is not correct. */
673#define VERR_SIGNAL_INVALID (-47)
674/** The state changed.
675 * This is a generic error message and needs a context to make sense. */
676#define VERR_STATE_CHANGED (-48)
677/** Warning, the state changed.
678 * This is a generic error message and needs a context to make sense. */
679#define VWRN_STATE_CHANGED 48
680/** Error while parsing UUID string */
681#define VERR_INVALID_UUID_FORMAT (-49)
682/** The specified process was not found. */
683#define VERR_PROCESS_NOT_FOUND (-50)
684/** The process specified to a non-block wait had not exited. */
685#define VERR_PROCESS_RUNNING (-51)
686/** Retry the operation. */
687#define VERR_TRY_AGAIN (-52)
688/** Retry the operation. */
689#define VINF_TRY_AGAIN 52
690/** Generic parse error. */
691#define VERR_PARSE_ERROR (-53)
692/** Value out of range. */
693#define VERR_OUT_OF_RANGE (-54)
694/** A numeric conversion encountered a value which was too big for the target. */
695#define VERR_NUMBER_TOO_BIG (-55)
696/** A numeric conversion encountered a value which was too big for the target. */
697#define VWRN_NUMBER_TOO_BIG 55
698/** The number begin converted (string) contained no digits. */
699#define VERR_NO_DIGITS (-56)
700/** The number begin converted (string) contained no digits. */
701#define VWRN_NO_DIGITS 56
702/** Encountered a '-' during conversion to an unsigned value. */
703#define VERR_NEGATIVE_UNSIGNED (-57)
704/** Encountered a '-' during conversion to an unsigned value. */
705#define VWRN_NEGATIVE_UNSIGNED 57
706/** Error while characters translation (unicode and so). */
707#define VERR_NO_TRANSLATION (-58)
708/** Encountered unicode code point which is reserved for use as endian indicator (0xffff or 0xfffe). */
709#define VERR_CODE_POINT_ENDIAN_INDICATOR (-59)
710/** Encountered unicode code point in the surrogate range (0xd800 to 0xdfff). */
711#define VERR_CODE_POINT_SURROGATE (-60)
712/** A string claiming to be UTF-8 is incorrectly encoded. */
713#define VERR_INVALID_UTF8_ENCODING (-61)
714/** Ad string claiming to be in UTF-16 is incorrectly encoded. */
715#define VERR_INVALID_UTF16_ENCODING (-62)
716/** Encountered a unicode code point which cannot be represented as UTF-16. */
717#define VERR_CANT_RECODE_AS_UTF16 (-63)
718/** Got an out of memory condition trying to allocate a string. */
719#define VERR_NO_STR_MEMORY (-64)
720/** Got an out of memory condition trying to allocate a UTF-16 (/UCS-2) string. */
721#define VERR_NO_UTF16_MEMORY (-65)
722/** Get an out of memory condition trying to allocate a code point array. */
723#define VERR_NO_CODE_POINT_MEMORY (-66)
724/** Can't free the memory because it's used in mapping. */
725#define VERR_MEMORY_BUSY (-67)
726/** The timer can't be started because it's already active. */
727#define VERR_TIMER_ACTIVE (-68)
728/** The timer can't be stopped because i's already suspended. */
729#define VERR_TIMER_SUSPENDED (-69)
730/** The operation was cancelled by the user (copy) or another thread (local ipc). */
731#define VERR_CANCELLED (-70)
732/** Failed to initialize a memory object.
733 * Exactly what this means is OS specific. */
734#define VERR_MEMOBJ_INIT_FAILED (-71)
735/** Out of memory condition when allocating memory with low physical backing. */
736#define VERR_NO_LOW_MEMORY (-72)
737/** Out of memory condition when allocating physical memory (without mapping). */
738#define VERR_NO_PHYS_MEMORY (-73)
739/** The address (virtual or physical) is too big. */
740#define VERR_ADDRESS_TOO_BIG (-74)
741/** Failed to map a memory object. */
742#define VERR_MAP_FAILED (-75)
743/** Trailing characters. */
744#define VERR_TRAILING_CHARS (-76)
745/** Trailing characters. */
746#define VWRN_TRAILING_CHARS 76
747/** Trailing spaces. */
748#define VERR_TRAILING_SPACES (-77)
749/** Trailing spaces. */
750#define VWRN_TRAILING_SPACES 77
751/** Generic not found error. */
752#define VERR_NOT_FOUND (-78)
753/** Generic not found warning. */
754#define VWRN_NOT_FOUND 78
755/** Generic invalid state error. */
756#define VERR_INVALID_STATE (-79)
757/** Generic invalid state warning. */
758#define VWRN_INVALID_STATE 79
759/** Generic out of resources error. */
760#define VERR_OUT_OF_RESOURCES (-80)
761/** Generic out of resources warning. */
762#define VWRN_OUT_OF_RESOURCES 80
763/** No more handles available, too many open handles. */
764#define VERR_NO_MORE_HANDLES (-81)
765/** Preemption is disabled.
766 * The requested operation can only be performed when preemption is enabled. */
767#define VERR_PREEMPT_DISABLED (-82)
768/** End of string. */
769#define VERR_END_OF_STRING (-83)
770/** End of string. */
771#define VINF_END_OF_STRING 83
772/** A page count is out of range. */
773#define VERR_PAGE_COUNT_OUT_OF_RANGE (-84)
774/** Generic object destroyed status. */
775#define VERR_OBJECT_DESTROYED (-85)
776/** Generic object was destroyed by the call status. */
777#define VINF_OBJECT_DESTROYED 85
778/** Generic dangling objects status. */
779#define VERR_DANGLING_OBJECTS (-86)
780/** Generic dangling objects status. */
781#define VWRN_DANGLING_OBJECTS 86
782/** Invalid Base64 encoding. */
783#define VERR_INVALID_BASE64_ENCODING (-87)
784/** Return instigated by a callback or similar. */
785#define VERR_CALLBACK_RETURN (-88)
786/** Return instigated by a callback or similar. */
787#define VINF_CALLBACK_RETURN 88
788/** Authentication failure. */
789#define VERR_AUTHENTICATION_FAILURE (-89)
790/** Not a power of two. */
791#define VERR_NOT_POWER_OF_TWO (-90)
792/** Status code, typically given as a parameter, that isn't supposed to be used. */
793#define VERR_IGNORED (-91)
794/** Concurrent access to the object is not allowed. */
795#define VERR_CONCURRENT_ACCESS (-92)
796/** The caller does not have a reference to the object.
797 * This status is used when two threads is caught sharing the same object
798 * reference. */
799#define VERR_CALLER_NO_REFERENCE (-93)
800/** Generic no change error. */
801#define VERR_NO_CHANGE (-95)
802/** Generic no change info. */
803#define VINF_NO_CHANGE 95
804/** Out of memory condition when allocating executable memory. */
805#define VERR_NO_EXEC_MEMORY (-96)
806/** The alignment is not supported. */
807#define VERR_UNSUPPORTED_ALIGNMENT (-97)
808/** The alignment is not really supported, however we got lucky with this
809 * allocation. */
810#define VINF_UNSUPPORTED_ALIGNMENT 97
811/** Duplicate something. */
812#define VERR_DUPLICATE (-98)
813/** Something is missing. */
814#define VERR_MISSING (-99)
815/** @} */
816
817
818/** @name Common File/Disk/Pipe/etc Status Codes
819 * @{
820 */
821/** Unresolved (unknown) file i/o error. */
822#define VERR_FILE_IO_ERROR (-100)
823/** File/Device open failed. */
824#define VERR_OPEN_FAILED (-101)
825/** File not found. */
826#define VERR_FILE_NOT_FOUND (-102)
827/** Path not found. */
828#define VERR_PATH_NOT_FOUND (-103)
829/** Invalid (malformed) file/path name. */
830#define VERR_INVALID_NAME (-104)
831/** The object in question already exists. */
832#define VERR_ALREADY_EXISTS (-105)
833/** The object in question already exists. */
834#define VWRN_ALREADY_EXISTS 105
835/** Too many open files. */
836#define VERR_TOO_MANY_OPEN_FILES (-106)
837/** Seek error. */
838#define VERR_SEEK (-107)
839/** Seek below file start. */
840#define VERR_NEGATIVE_SEEK (-108)
841/** Trying to seek on device. */
842#define VERR_SEEK_ON_DEVICE (-109)
843/** Reached the end of the file. */
844#define VERR_EOF (-110)
845/** Reached the end of the file. */
846#define VINF_EOF 110
847/** Generic file read error. */
848#define VERR_READ_ERROR (-111)
849/** Generic file write error. */
850#define VERR_WRITE_ERROR (-112)
851/** Write protect error. */
852#define VERR_WRITE_PROTECT (-113)
853/** Sharing violation, file is being used by another process. */
854#define VERR_SHARING_VIOLATION (-114)
855/** Unable to lock a region of a file. */
856#define VERR_FILE_LOCK_FAILED (-115)
857/** File access error, another process has locked a portion of the file. */
858#define VERR_FILE_LOCK_VIOLATION (-116)
859/** File or directory can't be created. */
860#define VERR_CANT_CREATE (-117)
861/** Directory can't be deleted. */
862#define VERR_CANT_DELETE_DIRECTORY (-118)
863/** Can't move file to another disk. */
864#define VERR_NOT_SAME_DEVICE (-119)
865/** The filename or extension is too long. */
866#define VERR_FILENAME_TOO_LONG (-120)
867/** Media not present in drive. */
868#define VERR_MEDIA_NOT_PRESENT (-121)
869/** The type of media was not recognized. Not formatted? */
870#define VERR_MEDIA_NOT_RECOGNIZED (-122)
871/** Can't unlock - region was not locked. */
872#define VERR_FILE_NOT_LOCKED (-123)
873/** Unrecoverable error: lock was lost. */
874#define VERR_FILE_LOCK_LOST (-124)
875/** Can't delete directory with files. */
876#define VERR_DIR_NOT_EMPTY (-125)
877/** A directory operation was attempted on a non-directory object. */
878#define VERR_NOT_A_DIRECTORY (-126)
879/** A non-directory operation was attempted on a directory object. */
880#define VERR_IS_A_DIRECTORY (-127)
881/** Tried to grow a file beyond the limit imposed by the process or the filesystem. */
882#define VERR_FILE_TOO_BIG (-128)
883/** No pending request the aio context has to wait for completion. */
884#define VERR_FILE_AIO_NO_REQUEST (-129)
885/** The request could not be canceled or prepared for another transfer
886 * because it is still in progress. */
887#define VERR_FILE_AIO_IN_PROGRESS (-130)
888/** The request could not be canceled because it already completed. */
889#define VERR_FILE_AIO_COMPLETED (-131)
890/** The I/O context couldn't be destroyed because there are still pending requests. */
891#define VERR_FILE_AIO_BUSY (-132)
892/** The requests couldn't be submitted because that would exceed the capacity of the context. */
893#define VERR_FILE_AIO_LIMIT_EXCEEDED (-133)
894/** The request was canceled. */
895#define VERR_FILE_AIO_CANCELED (-134)
896/** The request wasn't submitted so it can't be canceled. */
897#define VERR_FILE_AIO_NOT_SUBMITTED (-135)
898/** A request was not prepared and thus could not be submitted. */
899#define VERR_FILE_AIO_NOT_PREPARED (-136)
900/** Not all requests could be submitted due to resource shortage. */
901#define VERR_FILE_AIO_INSUFFICIENT_RESSOURCES (-137)
902/** Device or resource is busy. */
903#define VERR_RESOURCE_BUSY (-138)
904/** A file operation was attempted on a non-file object. */
905#define VERR_NOT_A_FILE (-139)
906/** A non-file operation was attempted on a file object. */
907#define VERR_IS_A_FILE (-140)
908/** Unexpected filesystem object type. */
909#define VERR_UNEXPECTED_FS_OBJ_TYPE (-141)
910/** A path does not start with a root specification. */
911#define VERR_PATH_DOES_NOT_START_WITH_ROOT (-142)
912/** A path is relative, expected an absolute path. */
913#define VERR_PATH_IS_RELATIVE (-143)
914/** A path is not relative (start with root), expected an relative path. */
915#define VERR_PATH_IS_NOT_RELATIVE (-144)
916/** @} */
917
918
919/** @name Generic Filesystem I/O Status Codes
920 * @{
921 */
922/** Unresolved (unknown) disk i/o error. */
923#define VERR_DISK_IO_ERROR (-150)
924/** Invalid drive number. */
925#define VERR_INVALID_DRIVE (-151)
926/** Disk is full. */
927#define VERR_DISK_FULL (-152)
928/** Disk was changed. */
929#define VERR_DISK_CHANGE (-153)
930/** Drive is locked. */
931#define VERR_DRIVE_LOCKED (-154)
932/** The specified disk or diskette cannot be accessed. */
933#define VERR_DISK_INVALID_FORMAT (-155)
934/** Too many symbolic links. */
935#define VERR_TOO_MANY_SYMLINKS (-156)
936/** The OS does not support setting the time stamps on a symbolic link. */
937#define VERR_NS_SYMLINK_SET_TIME (-157)
938/** The OS does not support changing the owner of a symbolic link. */
939#define VERR_NS_SYMLINK_CHANGE_OWNER (-158)
940/** @} */
941
942
943/** @name Generic Directory Enumeration Status Codes
944 * @{
945 */
946/** Unresolved (unknown) search error. */
947#define VERR_SEARCH_ERROR (-200)
948/** No more files found. */
949#define VERR_NO_MORE_FILES (-201)
950/** No more search handles available. */
951#define VERR_NO_MORE_SEARCH_HANDLES (-202)
952/** RTDirReadEx() failed to retrieve the extra data which was requested. */
953#define VWRN_NO_DIRENT_INFO 203
954/** @} */
955
956
957/** @name Internal Processing Errors
958 * @{
959 */
960/** Internal error - we're screwed if this happens. */
961#define VERR_INTERNAL_ERROR (-225)
962/** Internal error no. 2. */
963#define VERR_INTERNAL_ERROR_2 (-226)
964/** Internal error no. 3. */
965#define VERR_INTERNAL_ERROR_3 (-227)
966/** Internal error no. 4. */
967#define VERR_INTERNAL_ERROR_4 (-228)
968/** Internal error no. 5. */
969#define VERR_INTERNAL_ERROR_5 (-229)
970/** Internal error: Unexpected status code. */
971#define VERR_IPE_UNEXPECTED_STATUS (-230)
972/** Internal error: Unexpected status code. */
973#define VERR_IPE_UNEXPECTED_INFO_STATUS (-231)
974/** Internal error: Unexpected status code. */
975#define VERR_IPE_UNEXPECTED_ERROR_STATUS (-232)
976/** Internal error: Uninitialized status code.
977 * @remarks This is used by value elsewhere. */
978#define VERR_IPE_UNINITIALIZED_STATUS (-233)
979/** @} */
980
981
982/** @name Generic Device I/O Status Codes
983 * @{
984 */
985/** Unresolved (unknown) device i/o error. */
986#define VERR_DEV_IO_ERROR (-250)
987/** Device i/o: Bad unit. */
988#define VERR_IO_BAD_UNIT (-251)
989/** Device i/o: Not ready. */
990#define VERR_IO_NOT_READY (-252)
991/** Device i/o: Bad command. */
992#define VERR_IO_BAD_COMMAND (-253)
993/** Device i/o: CRC error. */
994#define VERR_IO_CRC (-254)
995/** Device i/o: Bad length. */
996#define VERR_IO_BAD_LENGTH (-255)
997/** Device i/o: Sector not found. */
998#define VERR_IO_SECTOR_NOT_FOUND (-256)
999/** Device i/o: General failure. */
1000#define VERR_IO_GEN_FAILURE (-257)
1001/** @} */
1002
1003
1004/** @name Generic Pipe I/O Status Codes
1005 * @{
1006 */
1007/** Unresolved (unknown) pipe i/o error. */
1008#define VERR_PIPE_IO_ERROR (-300)
1009/** Broken pipe. */
1010#define VERR_BROKEN_PIPE (-301)
1011/** Bad pipe. */
1012#define VERR_BAD_PIPE (-302)
1013/** Pipe is busy. */
1014#define VERR_PIPE_BUSY (-303)
1015/** No data in pipe. */
1016#define VERR_NO_DATA (-304)
1017/** Pipe is not connected. */
1018#define VERR_PIPE_NOT_CONNECTED (-305)
1019/** More data available in pipe. */
1020#define VERR_MORE_DATA (-306)
1021/** @} */
1022
1023
1024/** @name Generic Semaphores Status Codes
1025 * @{
1026 */
1027/** Unresolved (unknown) semaphore error. */
1028#define VERR_SEM_ERROR (-350)
1029/** Too many semaphores. */
1030#define VERR_TOO_MANY_SEMAPHORES (-351)
1031/** Exclusive semaphore is owned by another process. */
1032#define VERR_EXCL_SEM_ALREADY_OWNED (-352)
1033/** The semaphore is set and cannot be closed. */
1034#define VERR_SEM_IS_SET (-353)
1035/** The semaphore cannot be set again. */
1036#define VERR_TOO_MANY_SEM_REQUESTS (-354)
1037/** Attempt to release mutex not owned by caller. */
1038#define VERR_NOT_OWNER (-355)
1039/** The semaphore has been opened too many times. */
1040#define VERR_TOO_MANY_OPENS (-356)
1041/** The maximum posts for the event semaphore has been reached. */
1042#define VERR_TOO_MANY_POSTS (-357)
1043/** The event semaphore has already been posted. */
1044#define VERR_ALREADY_POSTED (-358)
1045/** The event semaphore has already been reset. */
1046#define VERR_ALREADY_RESET (-359)
1047/** The semaphore is in use. */
1048#define VERR_SEM_BUSY (-360)
1049/** The previous ownership of this semaphore has ended. */
1050#define VERR_SEM_OWNER_DIED (-361)
1051/** Failed to open semaphore by name - not found. */
1052#define VERR_SEM_NOT_FOUND (-362)
1053/** Semaphore destroyed while waiting. */
1054#define VERR_SEM_DESTROYED (-363)
1055/** Nested ownership requests are not permitted for this semaphore type. */
1056#define VERR_SEM_NESTED (-364)
1057/** Deadlock detected. */
1058#define VERR_DEADLOCK (-365)
1059/** Ping-Pong listen or speak out of turn error. */
1060#define VERR_SEM_OUT_OF_TURN (-366)
1061/** Tried to take a semaphore in a bad context. */
1062#define VERR_SEM_BAD_CONTEXT (-367)
1063/** Don't spin for the semaphore, but it is safe to try grab it. */
1064#define VINF_SEM_BAD_CONTEXT (367)
1065/** Wrong locking order detected. */
1066#define VERR_SEM_LV_WRONG_ORDER (-368)
1067/** Wrong release order detected. */
1068#define VERR_SEM_LV_WRONG_RELEASE_ORDER (-369)
1069/** Attempt to recursively enter a non-recurisve lock. */
1070#define VERR_SEM_LV_NESTED (-370)
1071/** Invalid parameters passed to the lock validator. */
1072#define VERR_SEM_LV_INVALID_PARAMETER (-371)
1073/** The lock validator detected a deadlock. */
1074#define VERR_SEM_LV_DEADLOCK (-372)
1075/** The lock validator detected an existing deadlock.
1076 * The deadlock was not caused by the current operation, but existed already. */
1077#define VERR_SEM_LV_EXISTING_DEADLOCK (-373)
1078/** Not the lock owner according our records. */
1079#define VERR_SEM_LV_NOT_OWNER (-374)
1080/** An illegal lock upgrade was attempted. */
1081#define VERR_SEM_LV_ILLEGAL_UPGRADE (-375)
1082/** The thread is not a valid signaller of the event. */
1083#define VERR_SEM_LV_NOT_SIGNALLER (-376)
1084/** Internal error in the lock validator or related components. */
1085#define VERR_SEM_LV_INTERNAL_ERROR (-377)
1086/** @} */
1087
1088
1089/** @name Generic Network I/O Status Codes
1090 * @{
1091 */
1092/** Unresolved (unknown) network error. */
1093#define VERR_NET_IO_ERROR (-400)
1094/** The network is busy or is out of resources. */
1095#define VERR_NET_OUT_OF_RESOURCES (-401)
1096/** Net host name not found. */
1097#define VERR_NET_HOST_NOT_FOUND (-402)
1098/** Network path not found. */
1099#define VERR_NET_PATH_NOT_FOUND (-403)
1100/** General network printing error. */
1101#define VERR_NET_PRINT_ERROR (-404)
1102/** The machine is not on the network. */
1103#define VERR_NET_NO_NETWORK (-405)
1104/** Name is not unique on the network. */
1105#define VERR_NET_NOT_UNIQUE_NAME (-406)
1106
1107/* These are BSD networking error codes - numbers correspond, don't mess! */
1108/** Operation in progress. */
1109#define VERR_NET_IN_PROGRESS (-436)
1110/** Operation already in progress. */
1111#define VERR_NET_ALREADY_IN_PROGRESS (-437)
1112/** Attempted socket operation with a non-socket handle.
1113 * (This includes closed handles.) */
1114#define VERR_NET_NOT_SOCKET (-438)
1115/** Destination address required. */
1116#define VERR_NET_DEST_ADDRESS_REQUIRED (-439)
1117/** Message too long. */
1118#define VERR_NET_MSG_SIZE (-440)
1119/** Protocol wrong type for socket. */
1120#define VERR_NET_PROTOCOL_TYPE (-441)
1121/** Protocol not available. */
1122#define VERR_NET_PROTOCOL_NOT_AVAILABLE (-442)
1123/** Protocol not supported. */
1124#define VERR_NET_PROTOCOL_NOT_SUPPORTED (-443)
1125/** Socket type not supported. */
1126#define VERR_NET_SOCKET_TYPE_NOT_SUPPORTED (-444)
1127/** Operation not supported. */
1128#define VERR_NET_OPERATION_NOT_SUPPORTED (-445)
1129/** Protocol family not supported. */
1130#define VERR_NET_PROTOCOL_FAMILY_NOT_SUPPORTED (-446)
1131/** Address family not supported by protocol family. */
1132#define VERR_NET_ADDRESS_FAMILY_NOT_SUPPORTED (-447)
1133/** Address already in use. */
1134#define VERR_NET_ADDRESS_IN_USE (-448)
1135/** Can't assign requested address. */
1136#define VERR_NET_ADDRESS_NOT_AVAILABLE (-449)
1137/** Network is down. */
1138#define VERR_NET_DOWN (-450)
1139/** Network is unreachable. */
1140#define VERR_NET_UNREACHABLE (-451)
1141/** Network dropped connection on reset. */
1142#define VERR_NET_CONNECTION_RESET (-452)
1143/** Software caused connection abort. */
1144#define VERR_NET_CONNECTION_ABORTED (-453)
1145/** Connection reset by peer. */
1146#define VERR_NET_CONNECTION_RESET_BY_PEER (-454)
1147/** No buffer space available. */
1148#define VERR_NET_NO_BUFFER_SPACE (-455)
1149/** Socket is already connected. */
1150#define VERR_NET_ALREADY_CONNECTED (-456)
1151/** Socket is not connected. */
1152#define VERR_NET_NOT_CONNECTED (-457)
1153/** Can't send after socket shutdown. */
1154#define VERR_NET_SHUTDOWN (-458)
1155/** Too many references: can't splice. */
1156#define VERR_NET_TOO_MANY_REFERENCES (-459)
1157/** Too many references: can't splice. */
1158#define VERR_NET_CONNECTION_TIMED_OUT (-460)
1159/** Connection refused. */
1160#define VERR_NET_CONNECTION_REFUSED (-461)
1161/* ELOOP is not net. */
1162/* ENAMETOOLONG is not net. */
1163/** Host is down. */
1164#define VERR_NET_HOST_DOWN (-464)
1165/** No route to host. */
1166#define VERR_NET_HOST_UNREACHABLE (-465)
1167/** Protocol error. */
1168#define VERR_NET_PROTOCOL_ERROR (-466)
1169/** @} */
1170
1171
1172/** @name TCP Status Codes
1173 * @{
1174 */
1175/** Stop the TCP server. */
1176#define VERR_TCP_SERVER_STOP (-500)
1177/** The server was stopped. */
1178#define VINF_TCP_SERVER_STOP 500
1179/** The TCP server was shut down using RTTcpServerShutdown. */
1180#define VERR_TCP_SERVER_SHUTDOWN (-501)
1181/** The TCP server was destroyed. */
1182#define VERR_TCP_SERVER_DESTROYED (-502)
1183/** The TCP server has no client associated with it. */
1184#define VINF_TCP_SERVER_NO_CLIENT 503
1185/** @} */
1186
1187
1188/** @name L4 Specific Status Codes
1189 * @{
1190 */
1191/** Invalid offset in an L4 dataspace */
1192#define VERR_L4_INVALID_DS_OFFSET (-550)
1193/** IPC error */
1194#define VERR_IPC (-551)
1195/** Item already used */
1196#define VERR_RESOURCE_IN_USE (-552)
1197/** Source/destination not found */
1198#define VERR_IPC_PROCESS_NOT_FOUND (-553)
1199/** Receive timeout */
1200#define VERR_IPC_RECEIVE_TIMEOUT (-554)
1201/** Send timeout */
1202#define VERR_IPC_SEND_TIMEOUT (-555)
1203/** Receive cancelled */
1204#define VERR_IPC_RECEIVE_CANCELLED (-556)
1205/** Send cancelled */
1206#define VERR_IPC_SEND_CANCELLED (-557)
1207/** Receive aborted */
1208#define VERR_IPC_RECEIVE_ABORTED (-558)
1209/** Send aborted */
1210#define VERR_IPC_SEND_ABORTED (-559)
1211/** Couldn't map pages during receive */
1212#define VERR_IPC_RECEIVE_MAP_FAILED (-560)
1213/** Couldn't map pages during send */
1214#define VERR_IPC_SEND_MAP_FAILED (-561)
1215/** Send pagefault timeout in receive */
1216#define VERR_IPC_RECEIVE_SEND_PF_TIMEOUT (-562)
1217/** Send pagefault timeout in send */
1218#define VERR_IPC_SEND_SEND_PF_TIMEOUT (-563)
1219/** (One) receive buffer was too small, or too few buffers */
1220#define VINF_IPC_RECEIVE_MSG_CUT 564
1221/** (One) send buffer was too small, or too few buffers */
1222#define VINF_IPC_SEND_MSG_CUT 565
1223/** Dataspace manager server not found */
1224#define VERR_L4_DS_MANAGER_NOT_FOUND (-566)
1225/** @} */
1226
1227
1228/** @name Loader Status Codes.
1229 * @{
1230 */
1231/** Invalid executable signature. */
1232#define VERR_INVALID_EXE_SIGNATURE (-600)
1233/** The iprt loader recognized a ELF image, but doesn't support loading it. */
1234#define VERR_ELF_EXE_NOT_SUPPORTED (-601)
1235/** The iprt loader recognized a PE image, but doesn't support loading it. */
1236#define VERR_PE_EXE_NOT_SUPPORTED (-602)
1237/** The iprt loader recognized a LX image, but doesn't support loading it. */
1238#define VERR_LX_EXE_NOT_SUPPORTED (-603)
1239/** The iprt loader recognized a LE image, but doesn't support loading it. */
1240#define VERR_LE_EXE_NOT_SUPPORTED (-604)
1241/** The iprt loader recognized a NE image, but doesn't support loading it. */
1242#define VERR_NE_EXE_NOT_SUPPORTED (-605)
1243/** The iprt loader recognized a MZ image, but doesn't support loading it. */
1244#define VERR_MZ_EXE_NOT_SUPPORTED (-606)
1245/** The iprt loader recognized an a.out image, but doesn't support loading it. */
1246#define VERR_AOUT_EXE_NOT_SUPPORTED (-607)
1247/** Bad executable. */
1248#define VERR_BAD_EXE_FORMAT (-608)
1249/** Symbol (export) not found. */
1250#define VERR_SYMBOL_NOT_FOUND (-609)
1251/** Module not found. */
1252#define VERR_MODULE_NOT_FOUND (-610)
1253/** The loader resolved an external symbol to an address to big for the image format. */
1254#define VERR_SYMBOL_VALUE_TOO_BIG (-611)
1255/** The image is too big. */
1256#define VERR_IMAGE_TOO_BIG (-612)
1257/** The image base address is to high for this image type. */
1258#define VERR_IMAGE_BASE_TOO_HIGH (-614)
1259/** Mismatching architecture. */
1260#define VERR_LDR_ARCH_MISMATCH (-615)
1261/** Mismatch between IPRT and native loader. */
1262#define VERR_LDR_MISMATCH_NATIVE (-616)
1263/** Failed to resolve an imported (external) symbol. */
1264#define VERR_LDR_IMPORTED_SYMBOL_NOT_FOUND (-617)
1265/** Generic loader failure. */
1266#define VERR_LDR_GENERAL_FAILURE (-618)
1267/** Code signing error. */
1268#define VERR_LDR_IMAGE_HASH (-619)
1269/** The PE loader encountered delayed imports, a feature which hasn't been implemented yet. */
1270#define VERR_LDRPE_DELAY_IMPORT (-620)
1271/** The PE loader encountered a malformed certificate. */
1272#define VERR_LDRPE_CERT_MALFORMED (-621)
1273/** The PE loader encountered a certificate with an unsupported type or structure revision. */
1274#define VERR_LDRPE_CERT_UNSUPPORTED (-622)
1275/** The PE loader doesn't know how to deal with the global pointer data directory entry yet. */
1276#define VERR_LDRPE_GLOBALPTR (-623)
1277/** The PE loader doesn't support the TLS data directory yet. */
1278#define VERR_LDRPE_TLS (-624)
1279/** The PE loader doesn't grok the COM descriptor data directory entry. */
1280#define VERR_LDRPE_COM_DESCRIPTOR (-625)
1281/** The PE loader encountered an unknown load config directory/header size. */
1282#define VERR_LDRPE_LOAD_CONFIG_SIZE (-626)
1283/** The PE loader encountered a lock prefix table, a feature which hasn't been implemented yet. */
1284#define VERR_LDRPE_LOCK_PREFIX_TABLE (-627)
1285/** The ELF loader doesn't handle foreign endianness. */
1286#define VERR_LDRELF_ODD_ENDIAN (-630)
1287/** The ELF image is 'dynamic', the ELF loader can only deal with 'relocatable' images at present. */
1288#define VERR_LDRELF_DYN (-631)
1289/** The ELF image is 'executable', the ELF loader can only deal with 'relocatable' images at present. */
1290#define VERR_LDRELF_EXEC (-632)
1291/** The ELF image was created for an unsupported target machine type. */
1292#define VERR_LDRELF_MACHINE (-633)
1293/** The ELF version is not supported. */
1294#define VERR_LDRELF_VERSION (-634)
1295/** The ELF loader cannot handle multiple SYMTAB sections. */
1296#define VERR_LDRELF_MULTIPLE_SYMTABS (-635)
1297/** The ELF loader encountered a relocation type which is not implemented. */
1298#define VERR_LDRELF_RELOCATION_NOT_SUPPORTED (-636)
1299/** The ELF loader encountered a bad symbol index. */
1300#define VERR_LDRELF_INVALID_SYMBOL_INDEX (-637)
1301/** The ELF loader encountered an invalid symbol name offset. */
1302#define VERR_LDRELF_INVALID_SYMBOL_NAME_OFFSET (-638)
1303/** The ELF loader encountered an invalid relocation offset. */
1304#define VERR_LDRELF_INVALID_RELOCATION_OFFSET (-639)
1305/** The ELF loader didn't find the symbol/string table for the image. */
1306#define VERR_LDRELF_NO_SYMBOL_OR_NO_STRING_TABS (-640)
1307/** @}*/
1308
1309/** @name Debug Info Reader Status Codes.
1310 * @{
1311 */
1312/** The module contains no line number information. */
1313#define VERR_DBG_NO_LINE_NUMBERS (-650)
1314/** The module contains no symbol information. */
1315#define VERR_DBG_NO_SYMBOLS (-651)
1316/** The specified segment:offset address was invalid. Typically an attempt at
1317 * addressing outside the segment boundary. */
1318#define VERR_DBG_INVALID_ADDRESS (-652)
1319/** Invalid segment index. */
1320#define VERR_DBG_INVALID_SEGMENT_INDEX (-653)
1321/** Invalid segment offset. */
1322#define VERR_DBG_INVALID_SEGMENT_OFFSET (-654)
1323/** Invalid image relative virtual address. */
1324#define VERR_DBG_INVALID_RVA (-655)
1325/** Invalid image relative virtual address. */
1326#define VERR_DBG_SPECIAL_SEGMENT (-656)
1327/** Address conflict within a module/segment.
1328 * Attempted to add a segment, symbol or line number that fully or partially
1329 * overlaps with an existing one. */
1330#define VERR_DBG_ADDRESS_CONFLICT (-657)
1331/** Duplicate symbol within the module.
1332 * Attempted to add a symbol which name already exists within the module. */
1333#define VERR_DBG_DUPLICATE_SYMBOL (-658)
1334/** The segment index specified when adding a new segment is already in use. */
1335#define VERR_DBG_SEGMENT_INDEX_CONFLICT (-659)
1336/** No line number was found for the specified address/ordinal/whatever. */
1337#define VERR_DBG_LINE_NOT_FOUND (-660)
1338/** The length of the symbol name is out of range.
1339 * This means it is an empty string or that it's greater or equal to
1340 * RTDBG_SYMBOL_NAME_LENGTH. */
1341#define VERR_DBG_SYMBOL_NAME_OUT_OF_RANGE (-661)
1342/** The length of the file name is out of range.
1343 * This means it is an empty string or that it's greater or equal to
1344 * RTDBG_FILE_NAME_LENGTH. */
1345#define VERR_DBG_FILE_NAME_OUT_OF_RANGE (-662)
1346/** The length of the segment name is out of range.
1347 * This means it is an empty string or that it is greater or equal to
1348 * RTDBG_SEGMENT_NAME_LENGTH. */
1349#define VERR_DBG_SEGMENT_NAME_OUT_OF_RANGE (-663)
1350/** The specified address range wraps around. */
1351#define VERR_DBG_ADDRESS_WRAP (-664)
1352/** The file is not a valid NM map file. */
1353#define VERR_DBG_NOT_NM_MAP_FILE (-665)
1354/** The file is not a valid /proc/kallsyms file. */
1355#define VERR_DBG_NOT_LINUX_KALLSYMS (-666)
1356/** No debug module interpreter matching the debug info. */
1357#define VERR_DBG_NO_MATCHING_INTERPRETER (-667)
1358/** @} */
1359
1360/** @name Request Packet Status Codes.
1361 * @{
1362 */
1363/** Invalid RT request type.
1364 * For the RTReqAlloc() case, the caller just specified an illegal enmType. For
1365 * all the other occurrences it means indicates corruption, broken logic, or stupid
1366 * interface user. */
1367#define VERR_RT_REQUEST_INVALID_TYPE (-700)
1368/** Invalid RT request state.
1369 * The state of the request packet was not the expected and accepted one(s). Either
1370 * the interface user screwed up, or we've got corruption/broken logic. */
1371#define VERR_RT_REQUEST_STATE (-701)
1372/** Invalid RT request packet.
1373 * One or more of the RT controlled packet members didn't contain the correct
1374 * values. Some thing's broken. */
1375#define VERR_RT_REQUEST_INVALID_PACKAGE (-702)
1376/** The status field has not been updated yet as the request is still
1377 * pending completion. Someone queried the iStatus field before the request
1378 * has been fully processed. */
1379#define VERR_RT_REQUEST_STATUS_STILL_PENDING (-703)
1380/** The request has been freed, don't read the status now.
1381 * Someone is reading the iStatus field of a freed request packet. */
1382#define VERR_RT_REQUEST_STATUS_FREED (-704)
1383/** @} */
1384
1385/** @name Environment Status Code
1386 * @{
1387 */
1388/** The specified environment variable was not found. (RTEnvGetEx) */
1389#define VERR_ENV_VAR_NOT_FOUND (-750)
1390/** The specified environment variable was not found. (RTEnvUnsetEx) */
1391#define VINF_ENV_VAR_NOT_FOUND (750)
1392/** @} */
1393
1394/** @name Multiprocessor Status Codes.
1395 * @{
1396 */
1397/** The specified cpu is offline. */
1398#define VERR_CPU_OFFLINE (-800)
1399/** The specified cpu was not found. */
1400#define VERR_CPU_NOT_FOUND (-801)
1401/** @} */
1402
1403/** @name RTGetOpt status codes
1404 * @{ */
1405/** RTGetOpt: Command line option not recognized. */
1406#define VERR_GETOPT_UNKNOWN_OPTION (-825)
1407/** RTGetOpt: Command line option needs argument. */
1408#define VERR_GETOPT_REQUIRED_ARGUMENT_MISSING (-826)
1409/** RTGetOpt: Command line option has argument with bad format. */
1410#define VERR_GETOPT_INVALID_ARGUMENT_FORMAT (-827)
1411/** RTGetOpt: Not an option. */
1412#define VINF_GETOPT_NOT_OPTION 828
1413/** RTGetOpt: Command line option needs an index. */
1414#define VERR_GETOPT_INDEX_MISSING (-829)
1415/** @} */
1416
1417/** @name RTCache status codes
1418 * @{ */
1419/** RTCache: cache is full. */
1420#define VERR_CACHE_FULL (-850)
1421/** RTCache: cache is empty. */
1422#define VERR_CACHE_EMPTY (-851)
1423/** @} */
1424
1425/** @name RTMemCache status codes
1426 * @{ */
1427/** Reached the max cache size. */
1428#define VERR_MEM_CACHE_MAX_SIZE (-855)
1429/** @} */
1430
1431/** @name RTS3 status codes
1432 * @{ */
1433/** Access denied error. */
1434#define VERR_S3_ACCESS_DENIED (-875)
1435/** The bucket/key wasn't found. */
1436#define VERR_S3_NOT_FOUND (-876)
1437/** Bucket already exists. */
1438#define VERR_S3_BUCKET_ALREADY_EXISTS (-877)
1439/** Can't delete bucket with keys. */
1440#define VERR_S3_BUCKET_NOT_EMPTY (-878)
1441/** The current operation was canceled. */
1442#define VERR_S3_CANCELED (-879)
1443/** @} */
1444
1445/** @name RTManifest status codes
1446 * @{ */
1447/** A digest type used in the manifest file isn't supported. */
1448#define VERR_MANIFEST_UNSUPPORTED_DIGEST_TYPE (-900)
1449/** An entry in the manifest file couldn't be interpreted correctly. */
1450#define VERR_MANIFEST_WRONG_FILE_FORMAT (-901)
1451/** A digest doesn't match the corresponding file. */
1452#define VERR_MANIFEST_DIGEST_MISMATCH (-902)
1453/** The file list doesn't match to the content of the manifest file. */
1454#define VERR_MANIFEST_FILE_MISMATCH (-903)
1455/** @} */
1456
1457/** @name RTTar status codes
1458 * @{ */
1459/** The checksum of a tar header record doesn't match. */
1460#define VERR_TAR_CHKSUM_MISMATCH (-925)
1461/** The tar end of file record was read. */
1462#define VERR_TAR_END_OF_FILE (-926)
1463/** The tar file ended unexpectedly. */
1464#define VERR_TAR_UNEXPECTED_EOS (-927)
1465/** The tar termination records was encountered without reaching the end of
1466 * the input stream. */
1467#define VERR_TAR_EOS_MORE_INPUT (-928)
1468/** A number tar header field was malformed. */
1469#define VERR_TAR_BAD_NUM_FIELD (-929)
1470/** A numeric tar header field was not terminated correctly. */
1471#define VERR_TAR_BAD_NUM_FIELD_TERM (-930)
1472/** A number tar header field was encoded using base-256 which this
1473 * tar implementation currently does not support. */
1474#define VERR_TAR_BASE_256_NOT_SUPPORTED (-931)
1475/** A number tar header field yielded a value too large for the internal
1476 * variable of the tar interpreter. */
1477#define VERR_TAR_NUM_VALUE_TOO_LARGE (-932)
1478/** The combined minor and major device number type is too small to hold the
1479 * value stored in the tar header. */
1480#define VERR_TAR_DEV_VALUE_TOO_LARGE (-933)
1481/** The mode field in a tar header is bad. */
1482#define VERR_TAR_BAD_MODE_FIELD (-934)
1483/** The mode field should not include the type. */
1484#define VERR_TAR_MODE_WITH_TYPE (-935)
1485/** The size field should be zero for links and symlinks. */
1486#define VERR_TAR_SIZE_NOT_ZERO (-936)
1487/** Encountered an unknown type flag. */
1488#define VERR_TAR_UNKNOWN_TYPE_FLAG (-937)
1489/** The tar header is all zeros. */
1490#define VERR_TAR_ZERO_HEADER (-938)
1491/** Not a uniform standard tape v0.0 archive header. */
1492#define VERR_TAR_NOT_USTAR_V00 (-939)
1493/** The name is empty. */
1494#define VERR_TAR_EMPTY_NAME (-940)
1495/** A non-directory entry has a name ending with a slash. */
1496#define VERR_TAR_NON_DIR_ENDS_WITH_SLASH (-941)
1497/** Encountered an unsupported portable archive exchange (pax) header. */
1498#define VERR_TAR_UNSUPPORTED_PAX_TYPE (-942)
1499/** Encountered an unsupported Solaris Tar extension. */
1500#define VERR_TAR_UNSUPPORTED_SOLARIS_HDR_TYPE (-943)
1501/** Encountered an unsupported GNU Tar extension. */
1502#define VERR_TAR_UNSUPPORTED_GNU_HDR_TYPE (-944)
1503/** Malformed checksum field in the tar header. */
1504#define VERR_TAR_BAD_CHKSUM_FIELD (-945)
1505/** Malformed checksum field in the tar header. */
1506#define VERR_TAR_MALFORMED_GNU_LONGXXXX (-946)
1507/** Too long name or link string. */
1508#define VERR_TAR_NAME_TOO_LONG (-947)
1509/** @} */
1510
1511/** @name RTPoll status codes
1512 * @{ */
1513/** The handle is not pollable. */
1514#define VERR_POLL_HANDLE_NOT_POLLABLE (-950)
1515/** The handle ID is already present in the poll set. */
1516#define VERR_POLL_HANDLE_ID_EXISTS (-951)
1517/** The handle ID was not found in the set. */
1518#define VERR_POLL_HANDLE_ID_NOT_FOUND (-952)
1519/** The poll set is full. */
1520#define VERR_POLL_SET_IS_FULL (-953)
1521/** @} */
1522
1523/** @name RTZip status codes
1524 * @{ */
1525/** Generic zip error. */
1526#define VERR_ZIP_ERROR (-22000)
1527/** The compressed data was corrupted. */
1528#define VERR_ZIP_CORRUPTED (-22001)
1529/** Ran out of memory while compressing or uncompressing. */
1530#define VERR_ZIP_NO_MEMORY (-22002)
1531/** The compression format version is unsupported. */
1532#define VERR_ZIP_UNSUPPORTED_VERSION (-22003)
1533/** The compression method is unsupported. */
1534#define VERR_ZIP_UNSUPPORTED_METHOD (-22004)
1535/** The compressed data started with a bad header. */
1536#define VERR_ZIP_BAD_HEADER (-22005)
1537/** @} */
1538
1539/** @name RTVfs status codes
1540 * @{ */
1541/** The VFS chain specification does not have a valid prefix. */
1542#define VERR_VFS_CHAIN_NO_PREFIX (-22100)
1543/** The VFS chain specification is empty. */
1544#define VERR_VFS_CHAIN_EMPTY (-22101)
1545/** Expected an element. */
1546#define VERR_VFS_CHAIN_EXPECTED_ELEMENT (-22102)
1547/** The VFS object type is not known. */
1548#define VERR_VFS_CHAIN_UNKNOWN_TYPE (-22103)
1549/** Expected a left paranthese. */
1550#define VERR_VFS_CHAIN_EXPECTED_LEFT_PARENTHESES (-22104)
1551/** Expected a right paranthese. */
1552#define VERR_VFS_CHAIN_EXPECTED_RIGHT_PARENTHESES (-22105)
1553/** Expected a provider name. */
1554#define VERR_VFS_CHAIN_EXPECTED_PROVIDER_NAME (-22106)
1555/** Expected an action (> or |). */
1556#define VERR_VFS_CHAIN_EXPECTED_ACTION (-22107)
1557/** Only one action element is currently supported. */
1558#define VERR_VFS_CHAIN_MULTIPLE_ACTIONS (-22108)
1559/** Expected to find a driving action (>), but there is none. */
1560#define VERR_VFS_CHAIN_NO_ACTION (-22109)
1561/** Expected pipe action. */
1562#define VERR_VFS_CHAIN_EXPECTED_PIPE (-22110)
1563/** Unexpected action type. */
1564#define VERR_VFS_CHAIN_UNEXPECTED_ACTION_TYPE (-22111)
1565/** @} */
1566
1567/* SED-END */
1568
1569/** @} */
1570
1571#endif
1572
Note: See TracBrowser for help on using the repository browser.

© 2024 Oracle Support Privacy / Do Not Sell My Info Terms of Use Trademark Policy Automated Access Etiquette