of_property_read_string 剖析~
前言
今天在一個(gè)群里面看到的一個(gè)朋友提交,說of_property_read_string 這個(gè)函數(shù)有兩個(gè)定義,到底是用了哪個(gè)呢?
所以這篇文章就說下這個(gè)函數(shù)。
函數(shù)引用的頭文件
引用的頭文件位置在
\kernel-4.4\include\linux\of.h其中一個(gè)是
extern int of_property_read_string(struct device_node *np,const char *propname,const char **out_string);還有一個(gè)是
static inline int of_property_read_string(struct device_node *np,const char *propname,const char **out_string) {return -ENOSYS; }但是并不是兩個(gè)都用到,他們用了一個(gè)宏 ?CONFIG_OF 來選擇
CONFIG_OF 宏有什么用?
這個(gè)宏的解釋是
Open Firmware. This was invented long time ago when Apple was producing laptops based on PowerPC CPUs. Openfirmware provides a good description of the devices connected to the platform. In Linux kernel the part that works with device data is called Device Tree (DT). More details in theUsage model.
他的作用是
Openfirmware provides a good description of the devices connected to the platform
他提供了一種更好的方式來連接設(shè)備和驅(qū)動(dòng)。
他是名字是
called Device Tree (DT)
DTS,那很明顯了,開了這個(gè)宏,就表示使用了DTS設(shè)備樹的方式來連接設(shè)備和驅(qū)動(dòng)程序。
of_property_read_string 函數(shù)本體
函數(shù)位置
"./drivers/of/base.c"函數(shù)原型
/*** of_property_read_string - Find and read a string from a property* @np: device node from which the property value is to be read.* @propname: name of the property to be searched.* @out_string: pointer to null terminated return string, modified only if* return value is 0.** Search for a property in a device tree node and retrieve a null* terminated string value (pointer to data, not a copy). Returns 0 on* success, -EINVAL if the property does not exist, -ENODATA if property* does not have a value, and -EILSEQ if the string is not null-terminated* within the length of the property data.** The out_string pointer is modified only if a valid string can be decoded.*/ int of_property_read_string(struct device_node *np, const char *propname,const char **out_string) {struct property *prop = of_find_property(np, propname, NULL);if (!prop)return -EINVAL;if (!prop->value)return -ENODATA;if (strnlen(prop->value, prop->length) >= prop->length)return -EILSEQ;*out_string = prop->value;return 0; } EXPORT_SYMBOL_GPL(of_property_read_string);函數(shù)的作用:
返回propname對(duì)應(yīng)dts節(jié)點(diǎn)對(duì)應(yīng)的值。
使用方式:
傳入np,就是設(shè)備樹的節(jié)點(diǎn),然后返回 "clock-output-names" 字符串對(duì)應(yīng)的值,存入clk_name 里面。
of_property_read_string 函數(shù)剖析
int of_property_read_string(struct device_node *np, const char *propname,const char **out_string) {struct property *prop = of_find_property(np, propname, NULL);if (!prop)return -EINVAL;if (!prop->value)return -ENODATA;if (strnlen(prop->value, prop->length) >= prop->length)return -EILSEQ;*out_string = prop->value;return 0; } EXPORT_SYMBOL_GPL(of_property_read_string);of_find_property 這個(gè)是找到這個(gè)dts節(jié)點(diǎn),怎么找,可以再去這個(gè)函數(shù)分析一下。
strnlen功能「獲取字符串實(shí)際字符個(gè)數(shù),不包括結(jié)尾的'\0';如果實(shí)際個(gè)數(shù) <= 第二個(gè)參數(shù),則返回字符串實(shí)際字符個(gè)數(shù),否則返回第二個(gè)參數(shù)。」
prop->length 是之前預(yù)設(shè)的一個(gè)值,strnlen正常情況返回的就是字符串的長(zhǎng)度 減1「去掉\n字符」。
*out_string = prop->value 這里就是二級(jí)指針起到作用了,沒有重新分配內(nèi)存,直接把指針指向字符串位置。
我們?cè)倏纯磒rop 的結(jié)構(gòu)體,就一目了然了。
struct property {char *name;int length;void *value;struct property *next;unsigned long _flags;unsigned int unique_id;struct bin_attribute attr; };關(guān)于二級(jí)指針舉個(gè)例子
#include "stdio.h"char *str = "helloworld"; char **p = NULL; int main(void) {p = &str;printf("%s\n",*p);return (0); } 推薦閱讀我把我的所有文章都匯總了,在公眾號(hào)菜單也有。專輯|Linux文章匯總 專輯|程序人生===========
??
PS:想加入技術(shù)群的同學(xué),加了我好友后,就給我發(fā)「籃球的大肚子」這句話,有可能機(jī)器人打瞌睡,可以多發(fā)幾次,不要發(fā)與技術(shù)無關(guān)的消息或者推廣。
如果想獲取學(xué)習(xí)資料,就在公眾號(hào)后臺(tái)回復(fù)「1024」,足夠多的學(xué)習(xí)資料可以讓你學(xué)習(xí)。
總結(jié)
以上是生活随笔為你收集整理的of_property_read_string 剖析~的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 嵌入式杂谈之makefile补充
- 下一篇: 杨校老师课堂之Hadoop环境搭建(一)