isphinx.addnodesdocument)}( rawsourcechildren]( translations LanguagesNode)}(hhh](h pending_xref)}(hhh]docutils.nodesTextEnglish}parenthsba attributes}(ids]classes]names]dupnames]backrefs] refdomainstdreftypedoc reftarget/core-api/krefmodnameN classnameN refexplicitutagnamehhh ubh)}(hhh]hChinese (Traditional)}hh2sbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/zh_TW/core-api/krefmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hItalian}hhFsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/it_IT/core-api/krefmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hJapanese}hhZsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/ja_JP/core-api/krefmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hKorean}hhnsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/ko_KR/core-api/krefmodnameN classnameN refexplicituh1hhh ubh)}(hhh]hSpanish}hhsbah}(h]h ]h"]h$]h&] refdomainh)reftypeh+ reftarget!/translations/sp_SP/core-api/krefmodnameN classnameN refexplicituh1hhh ubeh}(h]h ]h"]h$]h&]current_languageChinese (Simplified)uh1h hh _documenthsourceNlineNubhnote)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]h paragraph)}(hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。h]hX{此文件的目的是为让中文读者更容易阅读和理解，而不是作为一个分支。 因此， 如果您对此文件有任何意见或更新，请先尝试更新原始英文文件。 如果您发现本文档与原始文件有任何不同或者有翻译问题，请发建议或者补丁给 该文件的译者，或者请求中文文档维护者和审阅者的帮助。}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hh5Documentation/translations/zh_CN/disclaimer-zh_CN.rsthKhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhNubh field_list)}(hhh]hfield)}(hhh](h field_name)}(hOriginalh]hOriginal}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhN/var/lib/git/docbuild/linux/Documentation/translations/zh_CN/core-api/kref.rsthKubh field_body)}(h Documentation/core-api/kref.rst h]h)}(hDocumentation/core-api/kref.rsth]hDocumentation/core-api/kref.rst}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhubah}(h]h ]h"]h$]h&]uh1hhhubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubah}(h]h ]h"]h$]h&]uh1hhhhhhhhKubh)}(h翻译:h]h翻译:}(hhhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h,司延腾 Yanteng Si h](h司延腾 Yanteng Si <}(hj hhhNhNubh reference)}(hsiyanteng@loongson.cnh]hsiyanteng@loongson.cn}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:siyanteng@loongson.cnuh1jhj ubh>}(hj hhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhhhhubh)}(h 校译：h]h 校译：}(hj1hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hhhhubh block_quote)}(hH<此处请校译员签名（自愿），我将在下一个版本添加> h]h)}(hG<此处请校译员签名（自愿），我将在下一个版本添加>h]hG<此处请校译员签名（自愿），我将在下一个版本添加>}(hjEhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK hjAubah}(h]h ]h"]h$]h&]uh1j?hhhK hhhhubhtarget)}(h.. _cn_core_api_kref.rst:h]h}(h]h ]h"]h$]h&]refidcn-core-api-kref-rstuh1jYhKhhhhhhubhsection)}(hhh](htitle)}(h/为内核对象添加引用计数器（krefs）h]h/为内核对象添加引用计数器（krefs）}(hjnhhhNhNubah}(h]h ]h"]h$]h&]uh1jlhjihhhhhKubh)}(hhh](h)}(hhh](h)}(h作者h]h作者}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhKubh)}(hCorey Minyard h]h)}(hjh](hCorey Minyard <}(hjhhhNhNubj)}(hminyard@acm.orgh]hminyard@acm.org}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:minyard@acm.orguh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhj|hhubh)}(hhh](h)}(h作者h]h作者}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhjhhhKubh)}(h)Thomas Hellstrom h]h)}(h(Thomas Hellstrom h](hThomas Hellstrom <}(hjhhhNhNubj)}(hthellstrom@vmware.comh]hthellstrom@vmware.com}(hjhhhNhNubah}(h]h ]h"]h$]h&]refurimailto:thellstrom@vmware.comuh1jhjubh>}(hjhhhNhNubeh}(h]h ]h"]h$]h&]uh1hhhhKhjubah}(h]h ]h"]h$]h&]uh1hhjubeh}(h]h ]h"]h$]h&]uh1hhhhKhj|hhubeh}(h]h ]h"]h$]h&]uh1hhjihhhhhKubh)}(h其中很多内容都是从Greg Kroah-Hartman2004年关于krefs的OLS论文和演讲中摘 录的，可以在以下网址找到:h]h其中很多内容都是从Greg Kroah-Hartman2004年关于krefs的OLS论文和演讲中摘 录的，可以在以下网址找到:}(hj hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjihhubj@)}(h- http://www.kroah.com/linux/talks/ols_2004_kref_paper/Reprint-Kroah-Hartman-OLS2004.pdf - http://www.kroah.com/linux/talks/ols_2004_kref_talk/ h]h bullet_list)}(hhh](h list_item)}(hVhttp://www.kroah.com/linux/talks/ols_2004_kref_paper/Reprint-Kroah-Hartman-OLS2004.pdfh]h)}(hj%h]j)}(hj%h]hVhttp://www.kroah.com/linux/talks/ols_2004_kref_paper/Reprint-Kroah-Hartman-OLS2004.pdf}(hj*hhhNhNubah}(h]h ]h"]h$]h&]refurij%uh1jhj'ubah}(h]h ]h"]h$]h&]uh1hhhhKhj#ubah}(h]h ]h"]h$]h&]uh1j!hjubj")}(h5http://www.kroah.com/linux/talks/ols_2004_kref_talk/ h]h)}(h4http://www.kroah.com/linux/talks/ols_2004_kref_talk/h]j)}(hjJh]h4http://www.kroah.com/linux/talks/ols_2004_kref_talk/}(hjLhhhNhNubah}(h]h ]h"]h$]h&]refurijJuh1jhjHubah}(h]h ]h"]h$]h&]uh1hhhhKhjDubah}(h]h ]h"]h$]h&]uh1j!hjubeh}(h]h ]h"]h$]h&]bullet-uh1jhhhKhjubah}(h]h ]h"]h$]h&]uh1j?hhhKhjihhubjh)}(hhh](jm)}(h简介h]h简介}(hjwhhhNhNubah}(h]h ]h"]h$]h&]uh1jlhjthhhhhKubh)}(hkrefs允许你为你的对象添加引用计数器。如果你有在多个地方使用和传递的对象， 而你没有refcounts，你的代码几乎肯定是坏的。如果你想要引用计数，krefs是个 好办法。h]hkrefs允许你为你的对象添加引用计数器。如果你有在多个地方使用和传递的对象， 而你没有refcounts，你的代码几乎肯定是坏的。如果你想要引用计数，krefs是个 好办法。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhjthhubh)}(h?要使用kref，请在你的数据结构中添加一个，如::h]h>要使用kref，请在你的数据结构中添加一个，如:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK#hjthhubh literal_block)}(hEstruct my_data { . . struct kref refcount; . . };h]hEstruct my_data { . . struct kref refcount; . . };}hjsbah}(h]h ]h"]h$]h&] xml:spacepreserveuh1jhhhK%hjthhubh)}(h7kref可以出现在数据结构体中的任何地方。h]h7kref可以出现在数据结构体中的任何地方。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK.hjthhubeh}(h]id1ah ]h"]简介ah$]h&]uh1jghjihhhhhKubjh)}(hhh](jm)}(h 初始化h]h 初始化}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jlhjhhhhhK1ubh)}(h^你必须在分配kref之后初始化它。 要做到这一点，可以这样调用kref_init::h]h]你必须在分配kref之后初始化它。 要做到这一点，可以这样调用kref_init:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhK3hjhhubj)}(hstruct my_data *data; data = kmalloc(sizeof(*data), GFP_KERNEL); if (!data) return -ENOMEM; kref_init(&data->refcount);h]hstruct my_data *data; data = kmalloc(sizeof(*data), GFP_KERNEL); if (!data) return -ENOMEM; kref_init(&data->refcount);}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhK5hjhhubh)}(h%这将kref中的refcount设置为1。h]h%这将kref中的refcount设置为1。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKrefcount); 如果你已经有了一个指向kref-ed结构体的有效指针（refcount不能为零），你 可以在没有锁的情况下这样做。 h](h)}(h如果你对一个指针做了一个非临时性的拷贝，特别是如果它可以被传递给另一个执 行线程，你必须在传递之前用kref_get()增加refcount::h]h如果你对一个指针做了一个非临时性的拷贝，特别是如果它可以被传递给另一个执 行线程，你必须在传递之前用kref_get()增加refcount:}(hj4hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKChj0ubj)}(hkref_get(&data->refcount); 如果你已经有了一个指向kref-ed结构体的有效指针（refcount不能为零），你 可以在没有锁的情况下这样做。h]hkref_get(&data->refcount); 如果你已经有了一个指向kref-ed结构体的有效指针（refcount不能为零），你 可以在没有锁的情况下这样做。}hjBsbah}(h]h ]h"]h$]h&]jjuh1jhhhKFhj0ubeh}(h]h ]h"]h$]h&]uh1j!hj-hhhhhNubj")}(hXu当你完成对一个指针的处理时，你必须调用kref_put():: kref_put(&data->refcount, data_release); 如果这是对该指针的最后一次引用，释放程序将被调用。如果代码从来没有尝试过 在没有已经持有有效指针的情况下获得一个kref-ed结构体的有效指针，那么在没 有锁的情况下这样做是安全的。 h](h)}(hE当你完成对一个指针的处理时，你必须调用kref_put()::h]hD当你完成对一个指针的处理时，你必须调用kref_put():}(hjZhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKKhjVubj)}(h(kref_put(&data->refcount, data_release);h]h(kref_put(&data->refcount, data_release);}hjhsbah}(h]h ]h"]h$]h&]jjuh1jhhhKMhjVubh)}(h如果这是对该指针的最后一次引用，释放程序将被调用。如果代码从来没有尝试过 在没有已经持有有效指针的情况下获得一个kref-ed结构体的有效指针，那么在没 有锁的情况下这样做是安全的。h]h如果这是对该指针的最后一次引用，释放程序将被调用。如果代码从来没有尝试过 在没有已经持有有效指针的情况下获得一个kref-ed结构体的有效指针，那么在没 有锁的情况下这样做是安全的。}(hjvhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKOhjVubeh}(h]h ]h"]h$]h&]uh1j!hj-hhhhhNubj")}(h如果代码试图获得对一个kref-ed结构体的引用，而不持有一个有效的指针，它必 须按顺序访问，在kref_put()期间不能发生kref_get()，并且该结构体在kref_get() 期间必须保持有效。 h]h)}(h如果代码试图获得对一个kref-ed结构体的引用，而不持有一个有效的指针，它必 须按顺序访问，在kref_put()期间不能发生kref_get()，并且该结构体在kref_get() 期间必须保持有效。h]h如果代码试图获得对一个kref-ed结构体的引用，而不持有一个有效的指针，它必 须按顺序访问，在kref_put()期间不能发生kref_get()，并且该结构体在kref_get() 期间必须保持有效。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKShjubah}(h]h ]h"]h$]h&]uh1j!hj-hhhhhNubeh}(h]h ]h"]h$]h&]enumtypearabicprefixhsuffix)uh1j+hj hhhhhKCubh)}(hY例如，如果你分配了一些数据，然后将其传递给另一个线程来处理::h]hX例如，如果你分配了一些数据，然后将其传递给另一个线程来处理:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKWhj hhubj)}(hXkvoid data_release(struct kref *ref) { struct my_data *data = container_of(ref, struct my_data, refcount); kfree(data); } void more_data_handling(void *cb_data) { struct my_data *data = cb_data; . . do stuff with data here . kref_put(&data->refcount, data_release); } int my_data_handler(void) { int rv = 0; struct my_data *data; struct task_struct *task; data = kmalloc(sizeof(*data), GFP_KERNEL); if (!data) return -ENOMEM; kref_init(&data->refcount); kref_get(&data->refcount); task = kthread_run(more_data_handling, data, "more_data_handling"); if (task == ERR_PTR(-ENOMEM)) { rv = -ENOMEM; kref_put(&data->refcount, data_release); goto out; } . . do stuff with data here . out: kref_put(&data->refcount, data_release); return rv; }h]hXkvoid data_release(struct kref *ref) { struct my_data *data = container_of(ref, struct my_data, refcount); kfree(data); } void more_data_handling(void *cb_data) { struct my_data *data = cb_data; . . do stuff with data here . kref_put(&data->refcount, data_release); } int my_data_handler(void) { int rv = 0; struct my_data *data; struct task_struct *task; data = kmalloc(sizeof(*data), GFP_KERNEL); if (!data) return -ENOMEM; kref_init(&data->refcount); kref_get(&data->refcount); task = kthread_run(more_data_handling, data, "more_data_handling"); if (task == ERR_PTR(-ENOMEM)) { rv = -ENOMEM; kref_put(&data->refcount, data_release); goto out; } . . do stuff with data here . out: kref_put(&data->refcount, data_release); return rv; }}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKYhj hhubh)}(hX;这样，两个线程处理数据的顺序并不重要，kref_put()处理知道数据不再被引用并释 放它。kref_get()不需要锁，因为我们已经有了一个有效的指针，我们拥有一个 refcount。put不需要锁，因为没有任何东西试图在没有持有指针的情况下获取数据。h]hX;这样，两个线程处理数据的顺序并不重要，kref_put()处理知道数据不再被引用并释 放它。kref_get()不需要锁，因为我们已经有了一个有效的指针，我们拥有一个 refcount。put不需要锁，因为没有任何东西试图在没有持有指针的情况下获取数据。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(h在上面的例子中，kref_put()在成功和错误路径中都会被调用2次。这是必要的，因 为引用计数被kref_init()和kref_get()递增了2次。h]h在上面的例子中，kref_put()在成功和错误路径中都会被调用2次。这是必要的，因 为引用计数被kref_init()和kref_get()递增了2次。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hR请注意，规则1中的 "before "是非常重要的。你不应该做类似于::h]hU请注意，规则1中的 “before “是非常重要的。你不应该做类似于:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(htask = kthread_run(more_data_handling, data, "more_data_handling"); if (task == ERR_PTR(-ENOMEM)) { rv = -ENOMEM; goto out; } else /* BAD BAD BAD - 在交接后得到 */ kref_get(&data->refcount);h]htask = kthread_run(more_data_handling, data, "more_data_handling"); if (task == ERR_PTR(-ENOMEM)) { rv = -ENOMEM; goto out; } else /* BAD BAD BAD - 在交接后得到 */ kref_get(&data->refcount);}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(hXb不要以为你知道自己在做什么而使用上述构造。首先，你可能不知道自己在做什么。 其次，你可能知道自己在做什么（有些情况下涉及到锁，上述做法可能是合法的）， 但其他不知道自己在做什么的人可能会改变代码或复制代码。这是很危险的作风。请 不要这样做。h]hXb不要以为你知道自己在做什么而使用上述构造。首先，你可能不知道自己在做什么。 其次，你可能知道自己在做什么（有些情况下涉及到锁，上述做法可能是合法的）， 但其他不知道自己在做什么的人可能会改变代码或复制代码。这是很危险的作风。请 不要这样做。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(h在有些情况下，你可以优化get和put。例如，如果你已经完成了一个对象，并且给其 他对象排队，或者把它传递给其他对象，那么就没有理由先做一个get，然后再做一个 put::h]h在有些情况下，你可以优化get和put。例如，如果你已经完成了一个对象，并且给其 他对象排队，或者把它传递给其他对象，那么就没有理由先做一个get，然后再做一个 put:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(hs/* 糟糕的额外获取(get)和输出(put) */ kref_get(&obj->ref); enqueue(obj); kref_put(&obj->ref, obj_cleanup);h]hs/* 糟糕的额外获取(get)和输出(put) */ kref_get(&obj->ref); enqueue(obj); kref_put(&obj->ref, obj_cleanup);}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(hL只要做enqueue就可以了。 我们随时欢迎对这个问题的评论::h]hK只要做enqueue就可以了。 我们随时欢迎对这个问题的评论:}(hj+hhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(henqueue(obj); /* 我们已经完成了对obj的处理，所以我们把我们的refcount传给了队列。 在这之后不要再碰obj了! */h]henqueue(obj); /* 我们已经完成了对obj的处理，所以我们把我们的refcount传给了队列。 在这之后不要再碰obj了! */}hj9sbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(hXc最后一条规则（规则3）是最难处理的一条。例如，你有一个每个项目都被krefed的列表， 而你希望得到第一个项目。你不能只是从列表中抽出第一个项目，然后kref_get()它。 这违反了规则3，因为你还没有持有一个有效的指针。你必须添加一个mutex（或其他锁）。 比如说::h]hXb最后一条规则（规则3）是最难处理的一条。例如，你有一个每个项目都被krefed的列表， 而你希望得到第一个项目。你不能只是从列表中抽出第一个项目，然后kref_get()它。 这违反了规则3，因为你还没有持有一个有效的指针。你必须添加一个mutex（或其他锁）。 比如说:}(hjGhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(hXstatic DEFINE_MUTEX(mutex); static LIST_HEAD(q); struct my_data { struct kref refcount; struct list_head link; }; static struct my_data *get_entry() { struct my_data *entry = NULL; mutex_lock(&mutex); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); kref_get(&entry->refcount); } mutex_unlock(&mutex); return entry; } static void release_entry(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); list_del(&entry->link); kfree(entry); } static void put_entry(struct my_data *entry) { mutex_lock(&mutex); kref_put(&entry->refcount, release_entry); mutex_unlock(&mutex); }h]hXstatic DEFINE_MUTEX(mutex); static LIST_HEAD(q); struct my_data { struct kref refcount; struct list_head link; }; static struct my_data *get_entry() { struct my_data *entry = NULL; mutex_lock(&mutex); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); kref_get(&entry->refcount); } mutex_unlock(&mutex); return entry; } static void release_entry(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); list_del(&entry->link); kfree(entry); } static void put_entry(struct my_data *entry) { mutex_lock(&mutex); kref_put(&entry->refcount, release_entry); mutex_unlock(&mutex); }}hjUsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(h如果你不想在整个释放操作过程中持有锁，kref_put()的返回值是有用的。假设你不想在 上面的例子中在持有锁的情况下调用kfree()（因为这样做有点无意义）。你可以使用kref_put()， 如下所示::h]h如果你不想在整个释放操作过程中持有锁，kref_put()的返回值是有用的。假设你不想在 上面的例子中在持有锁的情况下调用kfree()（因为这样做有点无意义）。你可以使用kref_put()， 如下所示:}(hjchhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(hXstatic void release_entry(struct kref *ref) { /* 所有的工作都是在从kref_put()返回后完成的。*/ } static void put_entry(struct my_data *entry) { mutex_lock(&mutex); if (kref_put(&entry->refcount, release_entry)) { list_del(&entry->link); mutex_unlock(&mutex); kfree(entry); } else mutex_unlock(&mutex); }h]hXstatic void release_entry(struct kref *ref) { /* 所有的工作都是在从kref_put()返回后完成的。*/ } static void put_entry(struct my_data *entry) { mutex_lock(&mutex); if (kref_put(&entry->refcount, release_entry)) { list_del(&entry->link); mutex_unlock(&mutex); kfree(entry); } else mutex_unlock(&mutex); }}hjqsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(hX 如果你必须调用其他程序作为释放操作的一部分，而这些程序可能需要很长的时间，或者可 能要求相同的锁，那么这真的更有用。请注意，在释放例程中做所有的事情还是比较好的， 因为它比较整洁。h]hX 如果你必须调用其他程序作为释放操作的一部分，而这些程序可能需要很长的时间，或者可 能要求相同的锁，那么这真的更有用。请注意，在释放例程中做所有的事情还是比较好的， 因为它比较整洁。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubh)}(hK上面的例子也可以用kref_get_unless_zero()来优化，方法如下::h]hJ上面的例子也可以用kref_get_unless_zero()来优化，方法如下:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhKhj hhubj)}(hXstatic struct my_data *get_entry() { struct my_data *entry = NULL; mutex_lock(&mutex); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); if (!kref_get_unless_zero(&entry->refcount)) entry = NULL; } mutex_unlock(&mutex); return entry; } static void release_entry(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); mutex_lock(&mutex); list_del(&entry->link); mutex_unlock(&mutex); kfree(entry); } static void put_entry(struct my_data *entry) { kref_put(&entry->refcount, release_entry); }h]hXstatic struct my_data *get_entry() { struct my_data *entry = NULL; mutex_lock(&mutex); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); if (!kref_get_unless_zero(&entry->refcount)) entry = NULL; } mutex_unlock(&mutex); return entry; } static void release_entry(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); mutex_lock(&mutex); list_del(&entry->link); mutex_unlock(&mutex); kfree(entry); } static void put_entry(struct my_data *entry) { kref_put(&entry->refcount, release_entry); }}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhKhj hhubh)}(hX这对于在put_entry()中移除kref_put()周围的mutex锁是很有用的，但是重要的是 kref_get_unless_zero被封装在查找表中的同一关键部分，否则kref_get_unless_zero 可能引用已经释放的内存。注意，在不检查其返回值的情况下使用kref_get_unless_zero 是非法的。如果你确信（已经有了一个有效的指针）kref_get_unless_zero()会返回true， 那么就用kref_get()代替。h]hX这对于在put_entry()中移除kref_put()周围的mutex锁是很有用的，但是重要的是 kref_get_unless_zero被封装在查找表中的同一关键部分，否则kref_get_unless_zero 可能引用已经释放的内存。注意，在不检查其返回值的情况下使用kref_get_unless_zero 是非法的。如果你确信（已经有了一个有效的指针）kref_get_unless_zero()会返回true， 那么就用kref_get()代替。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhj hhubeh}(h]krefah ]h"] kref规则ah$]h&]uh1jghjihhhhhK?ubjh)}(hhh](jm)}(h Krefs和RCUh]h Krefs和RCU}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1jlhjhhhhhM ubh)}(h[函数kref_get_unless_zero也使得在上述例子中使用rcu锁进行查找成为可能::h]hZ函数kref_get_unless_zero也使得在上述例子中使用rcu锁进行查找成为可能:}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhMhjhhubj)}(hXEstruct my_data { struct rcu_head rhead; . struct kref refcount; . . }; static struct my_data *get_entry_rcu() { struct my_data *entry = NULL; rcu_read_lock(); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); if (!kref_get_unless_zero(&entry->refcount)) entry = NULL; } rcu_read_unlock(); return entry; } static void release_entry_rcu(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); mutex_lock(&mutex); list_del_rcu(&entry->link); mutex_unlock(&mutex); kfree_rcu(entry, rhead); } static void put_entry(struct my_data *entry) { kref_put(&entry->refcount, release_entry_rcu); }h]hXEstruct my_data { struct rcu_head rhead; . struct kref refcount; . . }; static struct my_data *get_entry_rcu() { struct my_data *entry = NULL; rcu_read_lock(); if (!list_empty(&q)) { entry = container_of(q.next, struct my_data, link); if (!kref_get_unless_zero(&entry->refcount)) entry = NULL; } rcu_read_unlock(); return entry; } static void release_entry_rcu(struct kref *ref) { struct my_data *entry = container_of(ref, struct my_data, refcount); mutex_lock(&mutex); list_del_rcu(&entry->link); mutex_unlock(&mutex); kfree_rcu(entry, rhead); } static void put_entry(struct my_data *entry) { kref_put(&entry->refcount, release_entry_rcu); }}hjsbah}(h]h ]h"]h$]h&]jjuh1jhhhMhjhhubh)}(hX-但要注意的是，在调用release_entry_rcu后，结构kref成员需要在有效内存中保留一个rcu 宽限期。这可以通过使用上面的kfree_rcu(entry, rhead)来实现，或者在使用kfree之前 调用synchronize_rcu()，但注意synchronize_rcu()可能会睡眠相当长的时间。h]hX-但要注意的是，在调用release_entry_rcu后，结构kref成员需要在有效内存中保留一个rcu 宽限期。这可以通过使用上面的kfree_rcu(entry, rhead)来实现，或者在使用kfree之前 调用synchronize_rcu()，但注意synchronize_rcu()可能会睡眠相当长的时间。}(hjhhhNhNubah}(h]h ]h"]h$]h&]uh1hhhhM5hjhhubeh}(h]krefsrcuah ]h"] krefs和rcuah$]h&]uh1jghjihhhhhM ubeh}(h](krefsjfeh ]h"](/为内核对象添加引用计数器（krefs）cn_core_api_kref.rsteh$]h&]uh1jghhhhhhhKexpect_referenced_by_name}jj[sexpect_referenced_by_id}jfj[subeh}(h]h ]h"]h$]h&]sourcehuh1hcurrent_sourceN current_lineNsettingsdocutils.frontendValues)}(jlN generatorN datestampN source_linkN source_urlN toc_backlinksentryfootnote_backlinksK sectnum_xformKstrip_commentsNstrip_elements_with_classesN strip_classesN report_levelK halt_levelKexit_status_levelKdebugNwarning_streamN tracebackinput_encoding utf-8-siginput_encoding_error_handlerstrictoutput_encodingutf-8output_encoding_error_handlerj2error_encodingutf-8error_encoding_error_handlerbackslashreplace language_codeenrecord_dependenciesNconfigN id_prefixhauto_id_prefixid dump_settingsNdump_internalsNdump_transformsNdump_pseudo_xmlNexpose_internalsNstrict_visitorN_disable_configN_sourceh، _destinationN _config_files]7/var/lib/git/docbuild/linux/Documentation/docutils.confafile_insertion_enabled raw_enabledKline_length_limitM'pep_referencesN pep_base_urlhttps://peps.python.org/pep_file_url_templatepep-%04drfc_referencesN rfc_base_url&https://datatracker.ietf.org/doc/html/ tab_widthKtrim_footnote_reference_spacesyntax_highlightlong smart_quotessmartquotes_locales]character_level_inline_markupdoctitle_xform docinfo_xformKsectsubtitle_xform image_loadinglinkembed_stylesheetcloak_email_addressessection_self_linkenvNubreporterNindirect_targets]substitution_defs}substitution_names}refnames}refids}jf]j[asnameids}(jjfjjjjj jjjjju nametypes}(jjjj jjuh}(jfjijjijjtjjjj jju footnote_refs} citation_refs} autofootnotes]autofootnote_refs]symbol_footnotes]symbol_footnote_refs] footnotes] citations]autofootnote_startKsymbol_footnote_startK id_counter collectionsCounter}j@KsRparse_messages]transform_messages]hsystem_message)}(hhh]h)}(hhh]h:Hyperlink target "cn-core-api-kref-rst" is not referenced.}hjsbah}(h]h ]h"]h$]h&]uh1hhjubah}(h]h ]h"]h$]h&]levelKtypeINFOsourceh،lineKuh1juba transformerN include_log]2Documentation/translations/zh_CN/core-api/kref.rst(NNNNta decorationNhhub.