前言

今天在一個群里面看到的一個朋友提交，說of_property_read_string 這個函數(shù)有兩個定義，到底是用了哪個呢？

所以這篇文章就說下這個函數(shù)。

函數(shù)引用的頭文件

引用的頭文件位置在

\kernel-4.4\include\linux\of.h

其中一個是

extern int of_property_read_string(struct device_node *np,
				   const char *propname,
				   const char **out_string);

還有一個是

static inline int of_property_read_string(struct device_node *np,
					  const char *propname,
					  const char **out_string)
{
	return -ENOSYS;
}

但是并不是兩個都用到，他們用了一個宏  CONFIG_OF 來選擇

CONFIG_OF 宏有什么用？

這個宏的解釋是

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ū)動。

他是名字是

called Device Tree (DT)

DTS，那很明顯了，開了這個宏，就表示使用了DTS設(shè)備樹的方式來連接設(shè)備和驅(qū)動程序。

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對應(yīng)dts節(jié)點(diǎn)對應(yīng)的值。

使用方式：

傳入np，就是設(shè)備樹的節(jié)點(diǎn)，然后返回 "clock-output-names" 字符串對應(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 這個是找到這個dts節(jié)點(diǎn)，怎么找，可以再去這個函數(shù)分析一下。
• strnlen功能「獲取字符串實(shí)際字符個數(shù)，不包括結(jié)尾的'\0'；如果實(shí)際個數(shù) <= 第二個參數(shù)，則返回字符串實(shí)際字符個數(shù)，否則返回第二個參數(shù)?！?
• prop->length 是之前預(yù)設(shè)的一個值，strnlen正常情況返回的就是字符串的長度 減1「去掉\n字符」。
• *out_string = prop->value 這里就是二級指針起到作用了，沒有重新分配內(nèi)存，直接把指針指向字符串位置。

我們再看看prop 的結(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)于二級指針舉個例子

#include "stdio.h"

char *str = "helloworld";
char **p = NULL;
int main(void)
{
	p = &str;
	printf("%s\n",*p);
	return (0);
}

===========