IS_ERR

原文地址：http://blog.csdn.net/xxu0123456789/article/details/6339625

像struct class *cls = class_create();这种语句，其中返回的指针值并不行kmalloc一样这么简单，只判断是否为NULL就可以了，内核是返回其错误值。那么我怎么来判断它呢，总不能用if()来将每个错误例出来吧，这里我们的IS_ERR()宏就发挥作用了。先看源代码，再讲原理，看看内核中的巧妙设计思路。

/*    include/linux/err.h    */
static inline long __must_check IS_ERR(const void *ptr)
{
return IS_ERR_VALUE((unsigned long)ptr);
}

#define IS_ERR_VALUE(x) unlikely((x) >= (unsigned long)-MAX_ERRNO)


内核中的函数常常返回指针，问题是如果出错，也希望能够通过返回的指针体现出来。
所幸的是，内核返回的指针一般是指向页面的边界(4K边界)，即

ptr & 0xfff == 0

这样ptr的值不可能落在（0xfffff000，0xffffffff）之间，而一般内核的出错代码也是一个小负数，在-1000到0之间，转变成unsigned long，正好在（0xfffff000，0xffffffff)之间。因此可以用

(unsigned long)ptr > (unsigned long)-1000L

也就等效于(x) >= (unsigned long)-MAX_ERRNO
其中MAX_ERRNO 为4095

来判断内核函数的返回值是一个有效的指针，还是一个出错代码。

涉及到的任何一个指针,必然有三种情况,一种是有效指针,一种是NULL,空指针,一种是错误指针,或者说无效指针.而所谓的错误指针就是指其已经到达了 最后一个page.比如对于32bit的系统来说,内核空间最高地址0xffffffff,那么最后一个page就是指的 0xfffff000~0xffffffff(假设4k一个page).这段地址是被保留的，如果超过这个地址，则肯定是错误的。

而我们的错误码的值在内存中定义都是这样的(include/linux/errno.h):
......
#define    ENOLCK        77    /* No record locks available */
#define    ENOSYS        78    /* Function not implemented */
#define    ENOMSG        80    /* No message of desired type */
#define    EIDRM        81    /* Identifier removed */
#define    ENOSR        82    /* Out of streams resources */
#define    ETIME        83    /* Timer expired */
#define    EBADMSG        84    /* Not a data message */
#define    EPROTO        85    /* Protocol error */
#define    ENODATA        86    /* No data available */
#define    ENOSTR        87    /* Device not a stream */.
........

现在应该知道为什么我写返回错误码的时候也加个负号如 -ENOSYS这样子了。

至于PTR_ERR(), ERR_PTR()，只是强制转换以下而已，源代码如下(include/linux/err.h) :
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;
}



所以像上面的cls例子可以这样写:
struct class *cls = class_create(....);
if(IS_ERR(cls))
{
ret =PTR_ERR(cls);
return ret;
}

分享到：