本文介绍Linux 4.4内核IS_ERR()函数。
文件：include/linux/err.h，定义如下：
#define MAX_ERRNO 4095
## 对于64位系统，判断x是否在0xffff ffff ffff f001 ~ 0xffff ffff ffff ffff
#define IS_ERR_VALUE(x) unlikely((x) >= (unsigned long)-MAX_ERRNO)
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);
}
一、功能
功能：判断传入的指针ptr是否有效。
Linux内核指针包括：有效指针、空指针（NULL）和错误指针。
Linux内核用最后4K空间保存指针的出错码，64位的系统地址为：0xffff ffff ffff f001 ~ 0xffff ffff ffff ffff。
如果是错误指针，配合PTR_ERR()函数判断错误代码。
文件：include/uapi/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 EINTR 4 /* Interrupted system call */
#define EIO 5 /* I/O error */
#define ENXIO 6 /* No such device or address */
#define E2BIG 7 /* Argument list too long */
#define ENOEXEC 8 /* Exec format error */
#define EBADF 9 /* Bad file number */
#define ECHILD 10 /* No child processes */
#define EAGAIN 11 /* Try again */
#define ENOMEM 12 /* Out of memory */
...
文件：include/uapi/asm-generic/errno.h，定义如下：
#define EDEADLK 35 /* Resource deadlock would occur */
#define ENAMETOOLONG 36 /* File name too long */
#define ENOLCK 37 /* No record locks available */
#define ENOSYS 38 /* Invalid system call number */
#define ENOTEMPTY 39 /* Directory not empty */
#define ELOOP 40 /* Too many symbolic links encountered */
...
文件：include/linux/errno.h，定义如下：
#define ERESTARTSYS 512
#define ERESTARTNOINTR 513
#define ERESTARTNOHAND 514 /* restart if no handler.. */
#define ENOIOCTLCMD 515 /* No ioctl command */
#define ERESTART_RESTARTBLOCK 516 /* restart by calling sys_restart_syscall */
#define EPROBE_DEFER 517 /* Driver requests probe retry */
...
二、说明
1）inline：内联函数。内联函数的代码会直接嵌入到调用它的位置，调用几次就嵌入几次。
2）__must_check：指调用函数一定要处理函数的返回值，否则编译器会给出警告。
3）__force：表示变量可进行强制转换。
4）unlikely后续专门介绍。
4）(unsigned long)-MAX_ERRNO：用补码的方式表示-4095，64位系统为0xffff ffff ffff f001。
三、示例
文件：drivers/gpu/drm/rockchip/rockchip_drm_drv.c
printk(KERN_ERR" ==== unsigned long 0x%lx \n", (unsigned long)-MAX_ERRNO);
...
private->devfreq = devfreq_get_devfreq_by_phandle(dev, 0);
printk(KERN_ERR"==== IS_ERR(private->devfreq) %d , private->devfreq %p\n", \
IS_ERR(private->devfreq), private->devfreq);
## 1、判断是否有效指针
if (IS_ERR(private->devfreq)) {
## 2、判断错误码
if (PTR_ERR(private->devfreq) == -EPROBE_DEFER) {
parent_np = of_parse_phandle(np, "devfreq", 0);
if (parent_np &&
of_device_is_available(parent_np)) {
...
} else {
## 3、运行到此处
dev_info(dev, "dmc is disabled\n");
}
} else {
...
}
...
}
...
private->hdmi_pll.pll = devm_clk_get(dev, "hdmi-tmds-pll");
printk(KERN_ERR"==== IS_ERR(private->hdmi_pll.pll) %d , private->hdmi_pll.pll %p\n", \
IS_ERR(private->hdmi_pll.pll), private->hdmi_pll.pll);
程序运行后，相关日志如下：
[ 2.270871] ==== unsigned long 0xfffffffffffff001
[ 2.271322] ==== IS_ERR(private->devfreq) 1 , private->devfreq fffffffffffffdfb
[ 2.271993] rockchip-drm display-subsystem: dmc is disabled
[ 2.272504] ==== IS_ERR(private->hdmi_pll.pll) 0 , private->hdmi_pll.pll ffffffc0782e6340
通过上面日志可以看出：
1）private->devfreq值为0xfffffffffffffdfb（值为-517），对应错误码EPROBE_DEFER，此时IS_ERR返回1。
2）private->hdmi_pll.pll值为0xffffffc0782e6340，是有效指针，IS_ERR返回0。
