ERR_PTR PTR_ERR IS_ERR ERROR

在linux-x.xx/include/uapi/asm-generic/errno-base.h和errno.h里分别定义了返回错误的信息。

errno-base.h:

 #ifndef _ASM_GENERIC_ERRNO_BASE_H
 #define _ASM_GENERIC_ERRNO_BASE_H

 #define    EPERM         1    /* Operation not permitted */
 #define    ENOENT         2    /* No such file or directory */
 #define    ESRCH         3    /* No such process */
 ......
 ......
 ......
 #define    EDOM        33    /* Math argument out of domain of func */
 #define    ERANGE        34    /* Math result not representable */

 #endif

errno.h:

 #define _ASM_GENERIC_ERRNO_H

 #include <asm-generic/errno-base.h>

 #define EDEADLK         35      /* Resource deadlock would occur */
 #define ENAMETOOLONG    36      /* File name too long */
 #define ENOLCK          37      /* No record locks available */
 ......
 ......
 ......
 #define ERFKILL         132     /* Operation not possible due to RF-kill */

 #define EHWPOISON       133     /* Memory page has hardware error */

 #endif

以上可知错误信息在1~133之间，返回错误会添加－号，故返回-133~-1。

部分函数内部有记录错误的信息并且返回。

对于返回非指针的函数，一般返回-ERROR。对于返回指针的函数，需要把ERROR转化为指针。

ERR_PTR、PTR_ERR和IS_ERR定义在linux-x.xx/include/linux/err.h：

 #define MAX_ERRNO    4095

 #ifndef __ASSEMBLY__
 EPERM
 #define IS_ERR_VALUE(x) unlikely((x) >= (unsigned long)-MAX_ERRNO)
 ERROR
 static inline void * __must_check ERR_PTR(long error)        //把错误转化指针
 {
     return (void *) error;
 }

 static inline long __must_check PTR_ERR(const void *ptr)            //把指针转化错误
 {
     return (long) ptr;
 }

 static inline long __must_check IS_ERR(const void *ptr)        //判断是否错误指针
 {
     return IS_ERR_VALUE((unsigned long)ptr);
 }

 static inline long __must_check IS_ERR_OR_NULL(const void *ptr)        //判断空指针或者错误指针
 {
     return !ptr || IS_ERR_VALUE((unsigned long)ptr);
 }

重点关注IS_ERR的实现。首先把指针转化成long，然后和(unsigned long)-4095比较。

对于32位系统，-4095=0xFFFF F001，对于64位系统，-4095=0xFFFF FFFF FFFF F001

对于32位系统，内核从0xFFFF F001 ~ 0xFFFF FFFF是冗余空间，对于64位系统，内核从0xFFFF FFFF FFFF F001 ~ 0xFFFF FFFF FFFF FFFF是冗余空间。

分配任何指针不可能到达这个区域，而错误信息在-133~-1在这个区域，故可判断系统的错误指针，从而判断返回的错误指针。