为什么linux内核函数出现错误,返回值是一个负数

该疑问出现与我看《linux内核设计与实现》这本书的12.3.2这节中下面一段代码:

page = __get_free_pages(GFP_KERNEL,3);
if (!page){
        /*没有足够的内存:你必须处理这种错误!*/
        return -ENOMEM;
    }

1.如何理解函数返回指针

内核中的函数通常以返回指针的形式来传递调用函数后执行的结果,返回值指针有三种结果:
(1)调用成功则返回一个有效指针
(2)调用失败返回NULL,例如malloc、kmalloc、vmalloc
(3)调用失败返回错误信息指针(无效指针)
我们就是通过这个错误指针来传递有关错误的信息。

2.怎么通过错误信息指针来返回错误信息呢?

在linux中虚拟内存空间的分配,0~3G是给用户空间的,而3G~4G是给linux内核的,而0xFFFFF000就位于linux内核的虚拟内存空间范围内,内核返回的指针(ptr)通常指向页的边界(4KB),也ptr指向的空间不会在(0xFFFFF000~0xFFFFFFFF)区间(因为小于一页),即:ptr & 0XFFF == 0;而一般内核出错代码返回值是一个负数,在 -1000~0之间,转变成unsigned long型,刚好在(0xFFFFF000~0xFFFFFFFF)区间。所以就可以用(unsigned long)ptr > (unsigned long)-1000L来判断内核函数的返回值是一个有效的指针,还是一个出错代码。

3.出错代码返回指针为什么在(-1000,0)区间?

(1)在include\asm-generic\errno-base.h文件下宏定义错误返回值

#define _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 */
#define EACCES 13 /* Permission denied */
#define EFAULT 14 /* Bad address */
#define ENOTBLK 15 /* Block device required */
#define EBUSY 16 /* Device or resource busy */
#define EEXIST 17 /* File exists */
#define EXDEV 18 /* Cross-device link */
#define ENODEV 19 /* No such device */
#define ENOTDIR 20 /* Not a directory */
#define EISDIR 21 /* Is a directory */
#define EINVAL 22 /* Invalid argument */
#define ENFILE 23 /* File table overflow */
#define EMFILE 24 /* Too many open files */
#define ENOTTY 25 /* Not a typewriter */
#define ETXTBSY 26 /* Text file busy */
#define EFBIG 27 /* File too large */
#define ENOSPC 28 /* No space left on device */
#define ESPIPE 29 /* Illegal seek */
#define EROFS 30 /* Read-only file system */
#define EMLINK 31 /* Too many links */
#define EPIPE 32 /* Broken pipe */
#define EDOM 33 /* Math argument out of domain of func */
#define ERANGE 34 /* Math result not representable */
#endif

(2)在include\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  /* Function not implemented */
#define ENOTEMPTY   39  /* Directory not empty */
#define ELOOP       40  /* Too many symbolic links encountered */
#define EWOULDBLOCK EAGAIN  /* Operation would block */
#define ENOMSG      42  /* No message of desired type */
#define EIDRM       43  /* Identifier removed */
#define ECHRNG      44  /* Channel number out of range */
#define EL2NSYNC    45  /* Level 2 not synchronized */
#define EL3HLT      46  /* Level 3 halted */
#define EL3RST      47  /* Level 3 reset */
......

有上述的宏定义可知,其返回都是在(0~1000)之间,如果加上个负号,就像 return -ENOMEM;那么其返回值就在(~1000,0)之间,这就是为什么return返回值要加负号的原因,也是为什么内核函数返回的都是一个负数的原因。

4.错误的判断和错误原因的打印

(1)错误的判断:

错误的判断是通过函数IS_ERR(const void *ptr)来判定的
该函数的在include\linux\err.h中

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

该函数只需传递一个参数:错误指针ptr,然后调用IS_ERR_VALUE((unsigned long)ptr)
该函数也是在该文件中被宏定义:

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

MAX_ERRNO被宏定义为4095,转换为(unsigned long)-MAX_ERRNO后为0xFFFFF000,该段代码的含义就是如果x在(0xFFFFF000~0xFFFFFFFF)区间,函数就返回一个真值,判断为假

(2)错误信息的返回:

错误信息的打印是通过函数PTR_ERR(const void *ptr)返回的,该函数的实现代码和上述函数在同一个文件下

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

该函数返回值ptr指针中存放的就是错误信息。

你可能感兴趣的:(linux,kernel,IS-ERR,内核函数错误,PTR-ERR)