Document the kernel_recvmsg() function
Subsystems (2)
PATCH 1/1 Document the kernel_recvmsg() function
Hi,
so, today we spent all day figuring out how the kernel_sendmsg() function *actually* works. This patch adds some documentation to help the next poor sod.
-mato
Quoted 1 line
From
b29ccddeec4b782d710ffe34e0e5e4a0f5e9c24bMon Sep 17 00:00:00 2001
From: Martin Lucina <[email protected]>
Date: Thu, 9 Dec 2010 17:11:18 +0100
Subject: [PATCH] Document the kernel_recvmsg() function
--- net/socket.c | 15 +++++++++++++++ 1 files changed, 15 insertions(+), 0 deletions(-)
net/socket.c +15 -0
@@ -732,6 +732,21 @@ static int sock_recvmsg_nosec(struct socket *sock, struct msghdr *msg,return ret; } +/** +* kernel_recvmsg() - Receive a message from a socket (kernel space) +* @sock: The socket to receive the message from +* @msg: Received message +* @vec: Input s/g array for message data +* @num: Size of input s/g array +* @size: Number of bytes to read +* @flags: Message flags (MSG_DONTWAIT, etc...) +* +* On return the msg structure contains the scatter/gather array passed in the +* vec argument. The array is modified so that it consists of the unfilled +* portion of the original array. +* +* The returned value is the total number of bytes received, or an error. +*/ int kernel_recvmsg (struct socket *sock,struct msghdr *msg,struct kvec *vec,size_t num,size_t size,int flags) {
Signature · 1 line
1.7.1
Quoted 6 lines · Martin Lucina
Hi,
so, today we spent all day figuring out how the
kernel_sendmsg()function *actually* works. This patch adds some documentation to help the next poor sod.
Network patches should be sent to [email protected] and David Miller, as mentioned in MAINTAINERS file :
NETWORKING [GENERAL]
M: "David S. Miller" <[email protected]> L: [email protected] W: http://www.linuxfoundation.org/en/Net W: http://patchwork.ozlabs.org/project/netdev/list/ T: git git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-2.6.git T: git git://git.kernel.org/pub/scm/linux/kernel/git/davem/net-next-2.6.git S: Maintained F: net/ F: include/net/ F: include/linux/in.h F: include/linux/net.h F: include/linux/netdevice.h
Quoted 17 lines
-mato
From
b29ccddeec4b782d710ffe34e0e5e4a0f5e9c24bMon Sep 17 00:00:00 2001
From: Martin Lucina <[email protected]>
Date: Thu, 9 Dec 2010 17:11:18 +0100
Subject: [PATCH] Document thekernel_recvmsg()functionSigned-off-by Martin Lucina <[email protected]>--- net/socket.c | 15 +++++++++++++++ 1 files changed, 15 insertions(+), 0 deletions(-)net/socket.c +0
-0
net/socket.c static int sock_recvmsg_nosec(struct socket *sock, struct msghdr *msg, · line 736
Quoted 5 lines
net/socket.c +2
-0@@ -732,6 +732,21 @@ static int sock_recvmsg_nosec(struct socket *sock, struct msghdr *msg,return ret; } +/** +* kernel_recvmsg() - Receive a message from a socket (kernel space)
no need for ()
Quoted 16 lines
net/socket.c +13
-0+* @sock: The socket to receive the message from +* @msg: Received message +* @vec: Input s/g array for message data +* @num: Size of input s/g array +* @size: Number of bytes to read +* @flags: Message flags (MSG_DONTWAIT, etc...) +* +* On return the msg structure contains the scatter/gather array passed in the +* vec argument. The array is modified so that it consists of the unfilled +* portion of the original array. +* +* The returned value is the total number of bytes received, or an error. +*/ int kernel_recvmsg (struct socket *sock,struct msghdr *msg,struct kvec *vec,size_t num,size_t size,int flags) {