在內核的代碼和驅動程序中經常見到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