From mboxrd@z Thu Jan  1 00:00:00 1970
From: Mats Petersson <mats.petersson@citrix.com>
Subject: Re: [PATCH] Add doc-comment to get_domain_by_id
Date: Fri, 18 Jan 2013 13:46:19 +0000
Message-ID: <50F9522B.1030007@citrix.com>
References: <9662deb217d7869d35dc.1358516092@localmatsp-T3500>
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"; Format="flowed"
Content-Transfer-Encoding: 7bit
Return-path: <xen-devel-bounces@lists.xen.org>
In-Reply-To: <9662deb217d7869d35dc.1358516092@localmatsp-T3500>
List-Unsubscribe: <http://lists.xen.org/cgi-bin/mailman/options/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=unsubscribe>
List-Post: <mailto:xen-devel@lists.xen.org>
List-Help: <mailto:xen-devel-request@lists.xen.org?subject=help>
List-Subscribe: <http://lists.xen.org/cgi-bin/mailman/listinfo/xen-devel>,
	<mailto:xen-devel-request@lists.xen.org?subject=subscribe>
Sender: xen-devel-bounces@lists.xen.org
Errors-To: xen-devel-bounces@lists.xen.org
To: xen-devel@lists.xen.org
List-Id: xen-devel@lists.xenproject.org

On 18/01/13 13:34, Mats Petersson wrote:
> # HG changeset patch
> # User Mats Petersson <mats.petersson@citrix.com>
> # Date 1358516011 0
> # Node ID 9662deb217d7869d35dce5587ae8a1b45296b3a0
> # Parent  126ce5f1855ba21ae24fc1c0981e5c05a3245bad
> Add doc-comment to get_domain_by_id
>
> diff --git a/xen/common/domain.c b/xen/common/domain.c
> --- a/xen/common/domain.c
> +++ b/xen/common/domain.c
> @@ -373,7 +373,16 @@
>       free_cpumask_var(cpumask);
>   }
>   
> -
> +/**
> + * This function finds a domain from a domain id. The domain's
> + * reference count is incremented as part of this function.
> + * The caller must call put_domain to un-reference the domain.
> + *
> + * @param dom       Domain ID of the domain to be found.
> + *
> + * @return         On success the pointer to a struct domain.
> + *                 On failure, return NULL.
> + */
>   struct domain *get_domain_by_id(domid_t dom)
>   {
>       struct domain *d;
>
> _______________________________________________
> Xen-devel mailing list
> Xen-devel@lists.xen.org
> http://lists.xen.org/xen-devel
>
>
Sorry for the badly formatted patch - will submit a V2 with "better" 
formatting & signed off... "hg email" is a bit different to "git 
send-email", I just learned... ;)

--
Mats