kobject之kobject_uevent.c文件分析

struct      kset_uevent_ops {

       int                 (*filter)(struct kset *kset, struct kobject *kobj);          //过滤函数,kset中的kobj是否需要处理

       const char      *(*name)(struct kset *kset, struct kobject *kobj);        //返回name

       int                 (*uevent)(struct kset *kset, struct kobject *kobj,         //uevent函数

                    struct kobj_uevent_env *env);

};

 

struct      kobj_uevent_env {

       char       *envp[UEVENT_NUM_ENVP];         //buf中每一段字符串的开始地址

       int          envp_idx;                                          //有几个envp,或者说buf中有几段字符串

       char       buf[UEVENT_BUFFER_SIZE];          //缓存(可以保存好几段字符串)

       int          buflen;                                              //buf尾

};

 

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

 

 

int   kobject_uevent_env(struct kobject *kobj, enum kobject_action action, char *envp_ext[])

调用kset-> uevent_ops-> uevent()函数

 

int   add_uevent_var(struct kobj_uevent_env *env, const char *format, ...)

将格式化信息保存进env->buf中,关于env结构体可参考kobject.c的文件分析开头

 

int   kobject_action_type(const char *buf, size_t count,      enum kobject_action *type)

查找buf属于哪一个action动作,属于的动作返回到type中

 

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

由于kref.c代码很少,所以就把这两个文件合在一起分析了

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//原子的操作refcount,将其设置为1

void       kref_init(struct kref *kref)

{

       atomic_set(&kref->refcount,1);

       smp_mb();

}

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//计数加1

void       kref_get(struct kref *kref)

{

       atomic_inc(&kref->refcount);

       smp_mb__after_atomic_inc();

}

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//计数减1,为0则调用release函数

int   kref_put(struct kref *kref,    void (*release)(struct kref *kref))

{

       if (atomic_dec_and_test(&kref->refcount)) {

              release(kref);

              return 1;

       }

       return 0;

}

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//关于uevent,目前猜测他应该是和热插拔有关

u64        uevent_seqnum;

char       uevent_helper[UEVENT_HELPER_PATH_LEN] =           //256

       CONFIG_UEVENT_HELPER_PATH;        // "/sbin/hotplug",这个定义在autoconf中

 

static      DEFINE_SPINLOCK(sequence_lock);

static      struct sock     *uevent_sock;

 

//这几个状态都是定义在kobject.h的枚举结构之中

static const char     *kobject_actions[] = {

       [KOBJ_ADD] =                   "add",

       [KOBJ_REMOVE] =           "remove",

       [KOBJ_CHANGE] =            "change",

       [KOBJ_MOVE] =                "move",

       [KOBJ_ONLINE] =             "online",

       [KOBJ_OFFLINE] =            "offline",

};

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

跳读一下,在分析kobject.c文件时,我们看得最多的是kobject_uevent和kobject_uevent_env函数,所以我们先来看看这两个函数是干什么用的。

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//这个基本没什么说的了,直接调用了env

int   kobject_uevent(struct kobject *kobj,    enum kobject_action action)

{

       return     kobject_uevent_env(kobj, action, NULL);

}

EXPORT_SYMBOL_GPL(kobject_uevent);

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//好长一个函数啊,为了方便理解,我们先从kobject.c中拿出一个调用实例来比较

//在rename函数中有这样的调用:

kobject_uevent_env(kobj, KOBJ_MOVE, envp);

其中envp的第一个元素保存的是更名前的kobj路径,第二个元素为空

sprintf(devpath_string, "DEVPATH_OLD=%s", devpath);

envp[0] = devpath_string;

envp[1] = NULL;

 

这个函数很长,但也是超级的绕,绕到最后,其实就一个核心操作:

retval = uevent_ops->uevent(kset, kobj, env);

其中kset为kobj的宿主kset, kobj的参数传入,而env则是一些字符串信息

int   kobject_uevent_env(

       struct kobject                      *kobj,                  //操作obj

       enum kobject_action     action,                   //动作( KOBJ_MOVE )

       char                            *envp_ext[])          //这个信息也只是添加进env->buf

{

       struct kobj_uevent_env *env;

       const char *action_string = kobject_actions[action];    //根据动作参数获取字符串"move"

       const char *devpath = NULL;

       const char *subsystem;

       struct kobject *top_kobj;

       struct kset *kset;

       struct kset_uevent_ops *uevent_ops;

       u64 seq;

       int i = 0;

       int retval = 0;

 

       //--------------------------------------------------------------------------------------------

       //这一块代码的功能是找到kobj的宿主kset,然后从中提取出热插拔的操作函数

       //--------------------------------------------------------------------------------------------

       //找到根kobj,或者关联上了kset宿主

       top_kobj = kobj;

       while (!top_kobj->kset && top_kobj->parent)

              top_kobj = top_kobj->parent;

 

       //根obj没有关联kset,出错

       if (!top_kobj->kset) {

              pr_debug("kobject attempted to send uevent without kset!\n");

              return -EINVAL;

       }

 

       //获取宿主kset,并从kset中提取出热插拔操作的ops

       kset = top_kobj->kset;

       uevent_ops = kset->uevent_ops;

 

       //--------------------------------------------------------------------------------------------

       //如果ops的filter()和name()函数有指定,则先执行他们

       //--------------------------------------------------------------------------------------------

       //如果ops存在 且 filter函数(过滤函数)有设置,则执行该函数

       //filter的作用应该是看看kobj是否被kset过滤到

       if (uevent_ops && uevent_ops->filter)

              if (!uevent_ops->filter(kset, kobj)) {

                     pr_debug("kobject filter function caused the event to drop!\n");

                     return 0;

              }

 

       //给subsystem指定name,如果ops->name()函数有指定,则从该函数返回,否则就获取kset->kobj的name。

       if (uevent_ops && uevent_ops->name)

              subsystem = uevent_ops->name(kset, kobj);

       else

              subsystem = kobject_name(&kset->kobj);

 

       //name为空,出错返回

       if (!subsystem) {

              pr_debug("unset subsystem caused the event to drop!\n");

              return 0;

       }

 

       //--------------------------------------------------------------------------------------------

       //申请一块env结构体,并填充他的env->buf字符串信息

       //--------------------------------------------------------------------------------------------

       //申请一快env内存

       env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL);

       if (!env)

              return -ENOMEM;

 

       //获取kobj的完整路径

       devpath = kobject_get_path(kobj, GFP_KERNEL);

       if (!devpath) {

              retval = -ENOENT;

              goto exit;

       }

 

       //这里出现了一个新的函数,add_uevent_var,OK,我们先中断这里,跳到后面去先分析这个函数

       //分析完add_uevent_var函数后,发现这个函数只是将参数的字符串保存进env->buf中,所以这一串函数只是保存一些字符串信息

       retval = add_uevent_var(env, "ACTION=%s", action_string);    //动作名

       if (retval)

              goto exit;

       retval = add_uevent_var(env, "DEVPATH=%s", devpath);         //kobj路径

       if (retval)

              goto exit;

       retval = add_uevent_var(env, "SUBSYSTEM=%s", subsystem); //subsys名

       if (retval)

              goto exit;

 

       //如果参数三不为空,再保存参数三的字符串信息

       if (envp_ext) {

              for (i = 0; envp_ext[i]; i++) {

                     retval = add_uevent_var(env, envp_ext[i]);

                     if (retval)

                            goto exit;

              }

       }

       //--------------------------------------------------------------------------------------------

 

       //最后执行ops->uevent函数

       //绕了个大圈,最后却又调用了ops中指定的uevent

       if (uevent_ops && uevent_ops->uevent) {

              retval = uevent_ops->uevent(kset, kobj, env);

              if (retval) {

                     pr_debug ("%s - uevent() returned %d\n",

                              __FUNCTION__, retval);

                     goto exit;

              }

       }

 

       //将全局变量uevent_seqnum加1

       spin_lock(&sequence_lock);

       seq = ++uevent_seqnum;

       spin_unlock(&sequence_lock);

       retval = add_uevent_var(env, "SEQNUM=%llu", (unsigned long long)seq);

       if (retval)

              goto exit;

 

       //帮助信息,uevent_helper在申明时就已经给了一个默认的路径

       //这一块的代码实际和这个函数的关联不是很大了,所以可以不用理会

       if (uevent_helper[0]) {

              char *argv [3];

 

              argv [0] = uevent_helper;             // "/sbin/hotplug"

              argv [1] = (char *)subsystem;              // kset的name

              argv [2] = NULL;

              retval = add_uevent_var(env, "HOME=/");

              if (retval)

                     goto exit;

              retval = add_uevent_var(env, "PATH=/sbin:/bin:/usr/sbin:/usr/bin");

              if (retval)

                     goto exit;

 

              //让内核空间的驱动程序启用用户空间的若干应用程序,这个函数的简介可参考这个网址:http://linux.chinaunix.net/techdoc/beginner/2009/05/05/1110318.shtml

              call_usermodehelper (argv[0], argv, env->envp, UMH_WAIT_EXEC);

       }

 

exit:

       kfree(devpath);             //释放kobj路径

       kfree(env);                   //释放env

       return retval;

}

EXPORT_SYMBOL_GPL(kobject_uevent_env);

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//直接从上面抓他的一个引用来说问题:

retval = add_uevent_var(env, "ACTION=%s", action_string);

//分析完这个函数后,发现这个函数只是将format中的字符保存进env->buf中

int   add_uevent_var(

       struct kobj_uevent_env *env,

       const char *format, ...)

{

       va_list args;           //获取格式化列表的参数

       int len;

 

       //idx大于等于envp指针数组的大小,出错返回

       if (env->envp_idx >= ARRAY_SIZE(env->envp)) {

              printk(KERN_ERR "add_uevent_var: too many keys\n");

              WARN_ON(1);

              return -ENOMEM;

       }

 

       //将格式化字符打印进env->buf中,

       //开始地址由env->buflen指定

       //最大长度由env->buf的大小 减去 env->buflen开始长度限制,以免越界

       va_start(args, format);

       len = vsnprintf(&env->buf[env->buflen],

                     sizeof(env->buf) - env->buflen,

                     format, args);

       va_end(args);

 

       //实际操作的长度在buf中越界了(实际是不可能的),出错返回

       if (len >= (sizeof(env->buf) - env->buflen)) {

              printk(KERN_ERR "add_uevent_var: buffer size too small\n");

              WARN_ON(1);

              return -ENOMEM;

       }

 

       //记录本段字符串的开始地址

       env->envp[env->envp_idx++] = &env->buf[env->buflen];

       env->buflen += len + 1;

       return 0;

}

EXPORT_SYMBOL_GPL(add_uevent_var);

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//根据输入的buf查找该buf属于哪一个action命令

int   kobject_action_type(

       const char      *buf,                    //要处理的字符串

       size_t            count,                   //要处理的字符串的长度

       enum kobject_action     *type)     //返回action类型

{

       enum kobject_action action;

       int ret = -EINVAL;

 

       //从buf中剔除最后一个回车换行字符

       if (count && buf[count-1] == '\n')

              count--;

 

       if (!count)

              goto out;

 

       for (action = 0; action < ARRAY_SIZE(kobject_actions); action++) {

              if (strncmp(kobject_actions[action], buf, count) != 0) //字符串不相等

                     continue;

 

              //长度不相等,以免将“a”,“ab”两个误匹配

              if (kobject_actions[action][count] != '\0')           

                     continue;

      

              //找到匹配的字符串

              *type = action;

              ret = 0;

              break;

       }

out:

       return ret;

}

 

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@

//创建一个sock,准备发送信息到网络上

static int __init      kobject_uevent_init(void)

{

       uevent_sock = netlink_kernel_create(&init_net, NETLINK_KOBJECT_UEVENT,

                                       1, NULL, NULL, THIS_MODULE);

       if (!uevent_sock) {

              printk(KERN_ERR

                     "kobject_uevent: unable to create netlink socket!\n");

              return -ENODEV;

       }

 

       return 0;

}

 

postcore_initcall(kobject_uevent_init);         //这个函数放置在指定区域,初始化执行

你可能感兴趣的:(kobject之kobject_uevent.c文件分析)