net: socket: Move kerneldoc next to function it documents
authorAndrew Lunn <andrew@lunn.ch>
Sun, 12 Jul 2020 23:15:12 +0000 (01:15 +0200)
committerDavid S. Miller <davem@davemloft.net>
Tue, 14 Jul 2020 00:20:40 +0000 (17:20 -0700)
Fix the warning "Function parameter or member 'inode' not described in
'__sock_release'' due to the kerneldoc being placed before
__sock_release() not sock_release(), which does not take an inode
parameter.

Signed-off-by: Andrew Lunn <andrew@lunn.ch>
Signed-off-by: David S. Miller <davem@davemloft.net>
net/socket.c

index d87812a..770503c 100644 (file)
@@ -586,15 +586,6 @@ struct socket *sock_alloc(void)
 }
 EXPORT_SYMBOL(sock_alloc);
 
-/**
- *     sock_release - close a socket
- *     @sock: socket to close
- *
- *     The socket is released from the protocol stack if it has a release
- *     callback, and the inode is then released if the socket is bound to
- *     an inode not a file.
- */
-
 static void __sock_release(struct socket *sock, struct inode *inode)
 {
        if (sock->ops) {
@@ -620,6 +611,14 @@ static void __sock_release(struct socket *sock, struct inode *inode)
        sock->file = NULL;
 }
 
+/**
+ *     sock_release - close a socket
+ *     @sock: socket to close
+ *
+ *     The socket is released from the protocol stack if it has a release
+ *     callback, and the inode is then released if the socket is bound to
+ *     an inode not a file.
+ */
 void sock_release(struct socket *sock)
 {
        __sock_release(sock, NULL);