Commit 7557f189 authored by Kriish Sharma's avatar Kriish Sharma Committed by Greg Kroah-Hartman
Browse files

binder: Fix missing kernel-doc entries in binder.c 



Fix several kernel-doc warnings in `drivers/android/binder.c` caused by
undocumented struct members and function parameters.

In particular, add missing documentation for the `@thread` parameter in
binder_free_buf_locked().

Signed-off-by: default avatarKriish Sharma <kriish.sharma2006@gmail.com>
Acked-by: default avatarCarlos Llamas <cmllamas@google.com>
Signed-off-by: default avatarGreg Kroah-Hartman <gregkh@linuxfoundation.org>
parent b5ce7a5c

drivers/android/binder.c

+14 −13
Original line number Diff line number Diff line
@@ -2418,10 +2418,10 @@ static int binder_translate_fd(u32 fd, binder_size_t fd_offset, 


/**

 * struct binder_ptr_fixup - data to be fixed-up in target buffer

 * @offset	offset in target buffer to fixup

 * @skip_size	bytes to skip in copy (fixup will be written later)

 * @fixup_data	data to write at fixup offset

 * @node	list node

 * @offset:      offset in target buffer to fixup

 * @skip_size:   bytes to skip in copy (fixup will be written later)

 * @fixup_data:  data to write at fixup offset

 * @node:        list node

 *

 * This is used for the pointer fixup list (pf) which is created and consumed

 * during binder_transaction() and is only accessed locally. No
@@ -2438,10 +2438,10 @@ struct binder_ptr_fixup { 


/**

 * struct binder_sg_copy - scatter-gather data to be copied

 * @offset		offset in target buffer

 * @sender_uaddr	user address in source buffer

 * @length		bytes to copy

 * @node		list node

 * @offset:        offset in target buffer

 * @sender_uaddr:  user address in source buffer

 * @length:        bytes to copy

 * @node:          list node

 *

 * This is used for the sg copy list (sgc) which is created and consumed

 * during binder_transaction() and is only accessed locally. No
@@ -4064,13 +4064,14 @@ binder_freeze_notification_done(struct binder_proc *proc, 
/**

 * binder_free_buf() - free the specified buffer

 * @proc:       binder proc that owns buffer

 * @thread:     binder thread performing the buffer release

 * @buffer:     buffer to be freed

 * @is_failure: failed to send transaction

 *

 * If buffer for an async transaction, enqueue the next async

 * If the buffer is for an async transaction, enqueue the next async

 * transaction from the node.

 *

 * Cleanup buffer and free it.

 * Cleanup the buffer and free it.

 */

static void

binder_free_buf(struct binder_proc *proc,