在内核的代码和驱动程序中经常见到ERR_PTR, IS_ERR, PTR_ERR这三个内联函数。
许多的内核函数需要返回一个指针,但是函数的调用可能失败,一般我们处理这样的情形都是返回一个NULL指针,就像malloc或kmalloc在没有获得指定的空间申请时的返回值一样。但是有时我们想知道导致函数失败的原因,但是返回NULL就显得信息不够。因此有些函数返回一个实际的错误编码以便对引起错误的原因做一些处理。很多内核接口通过把错误值编码到一个指针值中来返回错误信息。当处理这样的函数时,判断是否成功调用就不能是简单的和NULL进行比较。为了方便使用这样的类型接口,2.6的内核在linux/err.h中实现了三个内联函数:
inline void *ERR_PTR(long error)
{
return (void *) error;
}
返回指针类型的函数可以通过这个函数来返回一个错误值。这里的error是通常的负的错误编码。调用者可以使用IS_ERR来检查所返回的指针是否是一个错误编码。
inline long IS_ERR(const void *ptr)
{
return (unsigned long)ptr > (unsigned long)-1000L;
}
如果需要实际的错误编码,可以通过PTR_ERR函数提取
inline long PTR_ERR(const void *ptr)
{
return (long) ptr;
}
只有在IS_ERR返回真的时候才能使用PTR_ERR。