Path: csiph.com!aioe.org!bofh.it!news.nic.it!robomod
From: "Hillf Danton" <hillf.zj@alibaba-inc.com>
Newsgroups: linux.kernel
Subject: Re: [PATCH v2 03/13] staging/android: move sync_file functions comments to sync.c
Date: Fri, 29 Apr 2016 10:40:02 +0200
Message-ID: <rtc7U-2Py-19@gated-at.bofh.it>
References: <rtc7U-2Py-21@gated-at.bofh.it>
Reply-To: "Hillf Danton" <hillf.zj@alibaba-inc.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Thread-Index: AQIkc7e2+aPWRjnCqJfOe/le4Cs/I576+reQ
Content-Language: zh-cn
Sender: robomod@news.nic.it
Approved: robomod@news.nic.it
Lines: 115
Organization: linux.* mail to news gateway
Xref: csiph.com linux.kernel:1390866

> 
> From: Gustavo Padovan <gustavo.padovan@collabora.co.uk>
> 
> To keep comments in line with drivers/dma-buf/ move all sync_file comments
> to sync.c.
> 
> Signed-off-by: Gustavo Padovan <gustavo.padovan@collabora.co.uk>
> Reviewed-by: Daniel Vetter <daniel.vetter@ffwll.ch>
> ---
Acked-by: Hillf Danton <hillf.zj@alibaba-inc.com>

>  drivers/staging/android/sync.c | 26 +++++++++++++++++++++++++-
>  drivers/staging/android/sync.h | 31 -------------------------------
>  2 files changed, 25 insertions(+), 32 deletions(-)
> 
> diff --git a/drivers/staging/android/sync.c b/drivers/staging/android/sync.c
> index b965e2a..a89ded0 100644
> --- a/drivers/staging/android/sync.c
> +++ b/drivers/staging/android/sync.c
> @@ -173,7 +173,14 @@ static void fence_check_cb_func(struct fence *f, struct fence_cb *cb)
>  		wake_up_all(&sync_file->wq);
>  }
> 
> -/* TODO: implement a create which takes more that one fence */
> +/**
> + * sync_fence_create() - creates a sync fence
> + * @name:	name of fence to create
> + * @fence:	fence to add to the sync_fence
> + *
> + * Creates a sync_file containg @fence. Once this is called, the sync_file
> + * takes ownership of @fence.
> + */
>  struct sync_file *sync_file_create(const char *name, struct fence *fence)
>  {
>  	struct sync_file *sync_file;
> @@ -198,6 +205,13 @@ struct sync_file *sync_file_create(const char *name, struct fence *fence)
>  }
>  EXPORT_SYMBOL(sync_file_create);
> 
> +/**
> + * sync_file_fdget() - get a sync_file from an fd
> + * @fd:		fd referencing a fence
> + *
> + * Ensures @fd references a valid sync_file, increments the refcount of the
> + * backing file. Returns the sync_file or NULL in case of error.
> + */
>  struct sync_file *sync_file_fdget(int fd)
>  {
>  	struct file *file = fget(fd);
> @@ -229,6 +243,16 @@ static void sync_file_add_pt(struct sync_file *sync_file, int *i,
>  	}
>  }
> 
> +/**
> + * sync_file_merge() - merge two sync_files
> + * @name:	name of new fence
> + * @a:		sync_file a
> + * @b:		sync_file b
> + *
> + * Creates a new sync_file which contains copies of all the fences in both
> + * @a and @b.  @a and @b remain valid, independent sync_file. Returns the
> + * new merged sync_file or NULL in case of error.
> + */
>  struct sync_file *sync_file_merge(const char *name,
>  				  struct sync_file *a, struct sync_file *b)
>  {
> diff --git a/drivers/staging/android/sync.h b/drivers/staging/android/sync.h
> index c45cc7b..925fba5 100644
> --- a/drivers/staging/android/sync.h
> +++ b/drivers/staging/android/sync.h
> @@ -167,40 +167,9 @@ void sync_timeline_signal(struct sync_timeline *obj);
>   */
>  struct fence *sync_pt_create(struct sync_timeline *parent, int size);
> 
> -/**
> - * sync_fence_create() - creates a sync fence
> - * @name:	name of fence to create
> - * @fence:	fence to add to the sync_fence
> - *
> - * Creates a sync_file containg @fence. Once this is called, the sync_file
> - * takes ownership of @fence.
> - */
>  struct sync_file *sync_file_create(const char *name, struct fence *fence);
> -
> -/*
> - * API for sync_file consumers
> - */
> -
> -/**
> - * sync_file_merge() - merge two sync_files
> - * @name:	name of new fence
> - * @a:		sync_file a
> - * @b:		sync_file b
> - *
> - * Creates a new sync_file which contains copies of all the fences in both
> - * @a and @b.  @a and @b remain valid, independent sync_file. Returns the
> - * new merged sync_file or NULL in case of error.
> - */
>  struct sync_file *sync_file_merge(const char *name,
>  				    struct sync_file *a, struct sync_file *b);
> -
> -/**
> - * sync_file_fdget() - get a sync_file from an fd
> - * @fd:		fd referencing a fence
> - *
> - * Ensures @fd references a valid sync_file, increments the refcount of the
> - * backing file. Returns the sync_file or NULL in case of error.
> - */
>  struct sync_file *sync_file_fdget(int fd);
> 
>  #ifdef CONFIG_DEBUG_FS
> --
> 2.5.5
> 
>