Linux驱动开发——指针和错误值

参考：

《Linux设备驱动程序》第三版 P294

　　许多内部的内核函数返回一个指针值给调用者，而这些函数中很多可能会失败。在大部分情况下，失败是通过返回一个NULL指针值来表示的。这种技巧有作用，但是它不能传递问题的确切性质。某些接口确实需要返回一个实际的错误编码，以使调用者可以根据实际出错的情况做出正确的决策。

　　许多内核接口通过把错误值编码到一个指针值中来返回错误信息。这种函数必须小心使用，因为他们的返回值不能简单地和NULL比较。为了帮助创建和使用这种类型的接口，<linux/err.h>中提供了一小组函数。

　　返回指针类型的函数可以通过如下函数返回一个错误值：

　　　　void *ERR_PTR(long err);

　　这里error是通常的负的错误编码。调用者可以使用IS_ERR来检查所返回的指针是否是一个错误编码：

　　　　long IS_ERR(const void *ptr);

　　如果需要实际的错误编码，可以通过如下函数把它提取出来：

　　　　long PTR_ERR(const void *ptr);

　　应该使用IS_ERR对某值返回真值时才对该值使用PTR_ERR，因为任何其他值都是有效指针。

补充：

在include/linux/err.h中定义如下几个宏：

1、void * ERR_PTR(long error)：将错误编码转为指针

2、long PTR_ERR(const void *ptr)：将指针转为错误编码

3、bool IS_ERR(const void *ptr)：检查返回指针是否为一个错误编码，如果返回真，表示确实发生了错误

4、bool IS_ERR_OR_NULL(const void *ptr)：检查返回的指针是否为NULL或是否为一个错误编码

5、int PTR_ERR_OR_ZERO(const void *ptr)：将返回的指针转为0或者错误编码

6、void * ERR_CAST(const void *ptr)：将const void *转为void *，防止编译报错

 #define MAX_ERRNO    4095

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

 static inline void * __must_check ERR_PTR(long error)
 {
     return (void *) error;
 }

 static inline long __must_check PTR_ERR(__force const void *ptr)
 {
     return (long) ptr;
 }

 static inline bool __must_check IS_ERR(__force const void *ptr)
 {
     return IS_ERR_VALUE((unsigned long)ptr);
 }

 static inline bool __must_check IS_ERR_OR_NULL(__force const void *ptr)
 {
     return unlikely(!ptr) || IS_ERR_VALUE((unsigned long)ptr);
 }

 /**
  * ERR_CAST - Explicitly cast an error-valued pointer to another pointer type
  * @ptr: The pointer to cast.
  *
  * Explicitly cast an error-valued pointer to another pointer type in such a
  * way as to make it clear that's what's going on.
  */
 static inline void * __must_check ERR_CAST(__force const void *ptr)
 {
     /* cast away the const */
     return (void *) ptr;
 }

 static inline int __must_check PTR_ERR_OR_ZERO(__force const void *ptr)
 {
     if (IS_ERR(ptr))
         return PTR_ERR(ptr);
     else
         return ;
 }

示例：

1、比如函数_devm_regulator_get用于获得指定的regulator指针：

 static struct regulator *_devm_regulator_get(struct device *dev, const char *id,
                          int get_type)
 {
     struct regulator **ptr, *regulator;

     ptr = devres_alloc(devm_regulator_release, sizeof(*ptr), GFP_KERNEL);
     if (!ptr)
         return ERR_PTR(-ENOMEM);

     switch (get_type) {
     case NORMAL_GET:
         regulator = regulator_get(dev, id);
         break;
     case EXCLUSIVE_GET:
         regulator = regulator_get_exclusive(dev, id);
         break;
     case OPTIONAL_GET:
         regulator = regulator_get_optional(dev, id);
         break;
     default:
         regulator = ERR_PTR(-EINVAL);
     }

     if (!IS_ERR(regulator)) {
         *ptr = regulator;
         devres_add(dev, ptr);
     } else {
         devres_free(ptr);
     }

     return regulator;
 }

第7行返回NULL，表示内存分配失败，但是由于该函数需要返回的是指针类型，所以我们用ERR_PTR对-ENOMEM进行包装

第21行，表示传入的参数不合法，此时用ERR_PTR对-EINVAL进行包装

下面是调用devm_regulator_get的地方：

     case snd_soc_dapm_regulator_supply:
         w->regulator = devm_regulator_get(dapm->dev, w->name);
         if (IS_ERR(w->regulator)) {
             ret = PTR_ERR(w->regulator);
             dev_err(dapm->dev, "ASoC: Failed to request %s: %d\n",
                 w->name, ret);
             return NULL;
         }

第3行，如果IS_ERR返回指针确实是一个错误编码对应的指针，第4行就会用PTR_ERR将该指针转为一个错误编码给ret，后面可以根据需要处理该ret。

第7行，除了使用return NULL之外，还可以使用ERR_CAST(w->regulator)

 

完。