前言

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

所以這篇文章就說(shuō)下這個(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 來(lái)選擇

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

他提供了一種更好的方式來(lái)連接設(shè)備和驅(qū)動(dòng)。

他是名字是

called Device Tree (DT)

DTS，那很明顯了，開了這個(gè)宏，就表示使用了DTS設(shè)備樹的方式來(lái)連接設(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í)指針起到作用了，沒(méi)有重新分配內(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);
}

===========