From patchwork Mon Jan 21 12:30:14 2013 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Paolo Bonzini X-Patchwork-Id: 214146 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (Client did not present a certificate) by ozlabs.org (Postfix) with ESMTPS id 1BD2F2C0082 for ; Tue, 22 Jan 2013 00:18:24 +1100 (EST) Received: from localhost ([::1]:42713 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TxGXF-0006VN-GJ for incoming@patchwork.ozlabs.org; Mon, 21 Jan 2013 07:31:33 -0500 Received: from eggs.gnu.org ([208.118.235.92]:43508) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TxGWO-0004xU-E9 for qemu-devel@nongnu.org; Mon, 21 Jan 2013 07:30:50 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1TxGWM-0006dh-Vw for qemu-devel@nongnu.org; Mon, 21 Jan 2013 07:30:40 -0500 Received: from mail-ea0-f181.google.com ([209.85.215.181]:50814) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1TxGWM-0006dV-Q1 for qemu-devel@nongnu.org; Mon, 21 Jan 2013 07:30:38 -0500 Received: by mail-ea0-f181.google.com with SMTP id i13so1462915eaa.12 for ; Mon, 21 Jan 2013 04:30:38 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=x-received:sender:from:to:cc:subject:date:message-id:x-mailer :in-reply-to:references; bh=GvsUHz5h7ROti5oRitruNdc0FgPL5pQ9TThQBWyRYvE=; b=O4qFo0xz3LogrGskdUq5WRBU/i+Czov98b7Z3fS84avivxTqITwKjNdHgkKkPvd21g FQju7IfCpgnP4ewojsZxTL14ChKpNmlek3oqGZRKny09JcVSy8U+jrzOgBCR+EGiXGQ8 ze21HvrIIoIH2n9iHZsXnudGNhZ4SXCtGUYUdolAqlD5SBh+51W0KdYaMNV9h1HfTmyY XXHu0GgjeCBSUC1HaAW64IGyVOHRGfylLFkNlEhPPTT+slVu586ZDvdY7CHk5fJMeIR+ A/DwSpFXLDpD2wUtlY/0iRAnJsrwUDdjU3TzVf6C5g7CYUGy44AqJpVGi3RXf0H36Pup b1hA== X-Received: by 10.14.207.195 with SMTP id n43mr59669381eeo.38.1358771437920; Mon, 21 Jan 2013 04:30:37 -0800 (PST) Received: from yakj.lan (93-34-179-137.ip50.fastwebnet.it. [93.34.179.137]) by mx.google.com with ESMTPS id 46sm22102581eeg.4.2013.01.21.04.30.35 (version=TLSv1.2 cipher=RC4-SHA bits=128/128); Mon, 21 Jan 2013 04:30:37 -0800 (PST) From: Paolo Bonzini To: qemu-devel@nongnu.org Date: Mon, 21 Jan 2013 13:30:14 +0100 Message-Id: <1358771422-14282-5-git-send-email-pbonzini@redhat.com> X-Mailer: git-send-email 1.8.1 In-Reply-To: <1358771422-14282-1-git-send-email-pbonzini@redhat.com> References: <1358771422-14282-1-git-send-email-pbonzini@redhat.com> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [fuzzy] X-Received-From: 209.85.215.181 Cc: aliguori@us.ibm.com, afaerber@suse.de Subject: [Qemu-devel] [PATCH v2 04/12] qom: document reference counting of link properties X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Sender: qemu-devel-bounces+incoming=patchwork.ozlabs.org@nongnu.org Signed-off-by: Paolo Bonzini --- include/qom/object.h | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/include/qom/object.h b/include/qom/object.h index 8e16ea8..5e8e528 100644 --- a/include/qom/object.h +++ b/include/qom/object.h @@ -1033,6 +1033,11 @@ void object_property_add_child(Object *obj, const char *name, * between objects. * * Links form the graph in the object model. + * + * Ownership of the pointer that @child points to is transferred to the + * link property. The reference count for *@child is + * managed by the property from after the function returns till the + * property is deleted with object_property_del(). */ void object_property_add_link(Object *obj, const char *name, const char *type, Object **child,