linux内核中的IS_ERR()、PTR_ERR()、ERR_PTR()教程
linux内核中的IS\_ERR()、PTR\_ERR()、ERR\_PTR()
IS\_ERR宏定义在include/linux/err.h,如下所示:define MAX\_ERRNO 4095
// 判断x是不是在(0xfffff000,0xf fffffff)之间,注意这里用unlikely()的用意 #define IS\_ERR\_VALUE(x) unlikely((x) >= (unsigned long)-MAX\_ERRNO) //由错误码求指针,-1 -> 0xFFFFFFFF static inline void *ERR\_PTR(long error) { return (void *) error; }
//由指针求错误码,0xFFFFFFFF -> -1 ,依次类推 static inline long PTR\_ERR(const void *ptr) { return (long) ptr; } // 判断x是不是在(0xfffff000,0xffffffff)之间,x是不是一个有效的指针static inline long IS\_ERR(const void *ptr)
{ return IS\_ERR\_VALUE((unsigned long)ptr); }
要想明白IS\_ERR(),首先要理解内核空间,所有的驱动程序都运行在内核空间。内核空间虽然很大,但总是有限的。在这有限的空间中,其最后一个page是专门为错误码保留的,即内核用最后一页捕捉错误,一般人不可能用到内核空间最后一个page的指针。因此,在写设备驱动程序的过程中,涉及到的指针,必然有以下三种情况:有效指针;NULL,即空指针;错误指针,或者说无效指针。 而所谓的错误指针就是指其已经到达了最后一个page。比如,对于32位的 系统,内核空间最高地址为0xffffffff,那么最后一个page就是0xfffff000到 0xffffffff(假设4k一个page),这段地址是被保留的。如果你发现你的一个指针指向这个范围中的某个地址,那么你的代码肯定出错了。 IS\_ERR()就是用来判断指针是否有错,如果指针并不是指向最后一个page,那么没有问题;如果指针指向了最后一个page,那么说明实际上这不是一个有效的指针,这个指针里保存的实际上是一种错误代码。而通常很常用的方法就是先用IS\_ERR()来判断是否是错误,然后如果是,那么就调用PTR\_ERR()来返回这个错误代码。
错误码的值在内存中的定义(asm-generic/errno-base.h):
#define EPERM 1 #define ENOENT 2 #define ESRCH 3 #define EINTR 4 #define EIO 5 #define ENXIO 6 #define E2BIG 7 #define ENOEXEC 8 #define EBADF 9 #define ECHILD 10 #define EAGAIN 11 #define ENOMEM 12 #define EACCES 13 #define EFAULT 14 #define ENOTBLK 15 #define EBUSY 16 #define EEXIST 17 #define EXDEV 18 #define ENODEV 19 #define ENOTDIR 20 #define EISDIR 21 #define EINVAL 22 #define ENFILE 23 #define EMFILE 24 #define ENOTTY 25 #define ETXTBSY 26 #define EFBIG 27 #define ENOSPC 28 #define ESPIPE 29 #define EROFS 30 #define EMLINK 31 #define EPIPE 32 #define EDOM 33 #define ERANGE 34
如果指针指向了最后一个page,那么说明实际上这不是一个有效的指针。这个指针里保存的实际上是一种错误代码。而通常很常用的方法就是先用IS\_ERR()来判断是否是错误,然后如果是,那么就调用PTR\_ERR()来返回这个错误代码。返回错误码的时候一般加个负号,如-ENOSYS。