[openib-general] [PATCH][SDP][28/33] Fix comment style in sdp_recv.c

Tom Duffy Tom.Duffy at Sun.COM
Thu Feb 17 14:13:17 PST 2005


Signed-off-by: Tom Duffy <tduffy at sun.com>

--- drivers/infiniband/ulp/sdp-orig/sdp_recv.c	2005-02-14 13:58:45.877005000 -0800
+++ drivers/infiniband/ulp/sdp/sdp_recv.c	2005-02-17 12:03:28.285005000 -0800
@@ -1,34 +1,46 @@
 /*
-  This software is available to you under a choice of one of two
-  licenses.  You may choose to be licensed under the terms of the GNU
-  General Public License (GPL) Version 2, available at
-  <http://www.fsf.org/copyleft/gpl.html>, or the OpenIB.org BSD
-  license, available in the LICENSE.TXT file accompanying this
-  software.  These details are also available at
-  <http://openib.org/license.html>.
-
-  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
-  BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
-  ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-  CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-  SOFTWARE.
+ * Copyright (c) 2005 Topspin Communications.  All rights reserved.
+ *
+ * This software is available to you under a choice of one of two
+ * licenses.  You may choose to be licensed under the terms of the GNU
+ * General Public License (GPL) Version 2, available from the file
+ * COPYING in the main directory of this source tree, or the
+ * OpenIB.org BSD license below:
+ *
+ *     Redistribution and use in source and binary forms, with or
+ *     without modification, are permitted provided that the following
+ *     conditions are met:
+ *
+ *      - Redistributions of source code must retain the above
+ *        copyright notice, this list of conditions and the following
+ *        disclaimer.
+ *
+ *      - Redistributions in binary form must reproduce the above
+ *        copyright notice, this list of conditions and the following
+ *        disclaimer in the documentation and/or other materials
+ *        provided with the distribution.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+ * NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS
+ * BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN
+ * ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+ * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ *
+ * $Id$
+ */
 
-  Copyright (c) 2005 Topspin Communications.  All rights reserved.
+#include "sdp_main.h"
 
-  $Id: sdp_recv.c 836 2004-09-14 20:50:32Z roland $
-*/
+/*
+ * Receive posting function(s)
+ */
 
-#include "sdp_main.h"
-/* --------------------------------------------------------------------- */
-/*                                                                       */
-/* Receive posting function(s)                                           */
-/*                                                                       */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*.._sdp_post_recv_buff -- post a single buffers for data recv */
+/*
+ * _sdp_post_recv_buff - post a single buffers for data recv
+ */
 static int _sdp_post_recv_buff(struct sdp_opt *conn)
 {
 	struct ib_recv_wr receive_param = { NULL };
@@ -104,8 +116,9 @@ error:
 	return result;
 } /* _sdp_post_recv_buff */
 
-/* ========================================================================= */
-/*.._sdp_post_rdma_buff -- post a single buffers for rdma read on a conn */
+/*
+ * _sdp_post_rdma_buff - post a single buffers for rdma read on a conn
+ */
 static int _sdp_post_rdma_buff(struct sdp_opt *conn)
 {
 	struct ib_send_wr send_param = { NULL };
@@ -233,8 +246,9 @@ done:
 	return result;
 } /* _sdp_post_rdma_buff */
 
-/* ========================================================================= */
-/*.._sdp_post_rdma_iocb_src -- post a iocb for rdma read on a conn */
+/*
+ * _sdp_post_rdma_iocb_src - post a iocb for rdma read on a conn
+ */
 static int _sdp_post_rdma_iocb_src(struct sdp_opt *conn)
 {
 	struct ib_send_wr send_param = { NULL };
@@ -388,8 +402,9 @@ done:
 	return result;
 } /* _sdp_post_rdma_iocb_src */
 
-/* ========================================================================= */
-/*.._sdp_post_rdma_iocb_snk -- post a iocb for rdma read on a conn */
+/*
+ * _sdp_post_rdma_iocb_snk - post a iocb for rdma read on a conn
+ */
 static int _sdp_post_rdma_iocb_snk(struct sdp_opt *conn)
 {
 	struct sdpc_iocb *iocb;
@@ -497,8 +512,9 @@ error:
 	return result;
 } /* _sdp_post_rdma_iocb_snk */
 
-/* ========================================================================= */
-/*.._sdp_post_rdma -- post a rdma based requests for a connection */
+/*
+ * _sdp_post_rdma - post a rdma based requests for a connection
+ */
 static int _sdp_post_rdma(struct sdp_opt *conn)
 {
 	int result = 0;
@@ -592,8 +608,9 @@ done:
 	return result;
 } /* _sdp_post_rdma */
 
-/* ========================================================================= */
-/*..sdp_recv_flush -- post a certain number of buffers on a connection */
+/*
+ * sdp_recv_flush - post a certain number of buffers on a connection
+ */
 int sdp_recv_flush(struct sdp_opt *conn)
 {
 	int result = 0;
@@ -701,13 +718,13 @@ done:
 	return result;
 } /* sdp_recv_flush */
 
-/* --------------------------------------------------------------------- */
-/*                                                                       */
-/* Receive incoming data function(s)                                     */
-/*                                                                       */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*..__sdp_read_buff_iocb -- read a SDP buffer into an IOCB  */
+/*
+ * Receive incoming data function(s)
+ */
+
+/*
+ * __sdp_read_buff_iocb - read a SDP buffer into an IOCB
+ */
 static int _sdp_read_buff_iocb(struct sdpc_iocb *iocb,
 			       struct sdpc_buff *buff)
 {
@@ -771,8 +788,9 @@ static int _sdp_read_buff_iocb(struct sd
 	return 0;
 } /* _sdp_read_buff_iocb */
 
-/* ========================================================================= */
-/*.._sdp_recv_buff_iocb_active -- Ease AIO read pending pressure */
+/*
+ * _sdp_recv_buff_iocb_active - Ease AIO read pending pressure
+ */
 static int _sdp_recv_buff_iocb_active(struct sdp_opt *conn,
 				      struct sdpc_buff *buff)
 {
@@ -825,8 +843,9 @@ static int _sdp_recv_buff_iocb_active(st
 	return (buff->tail - buff->data);
 } /* _sdp_recv_buff_iocb_active */
 
-/* ========================================================================= */
-/*.._sdp_recv_buff_iocb_pending -- Ease AIO read pending pressure */
+/*
+ * _sdp_recv_buff_iocb_pending - Ease AIO read pending pressure
+ */
 static int _sdp_recv_buff_iocb_pending(struct sdp_opt *conn,
 				       struct sdpc_buff *buff)
 {
@@ -890,8 +909,9 @@ static int _sdp_recv_buff_iocb_pending(s
 	return (buff->tail - buff->data);
 } /* _sdp_recv_buff_iocb_pending */
 
-/* ========================================================================= */
-/*..sdp_recv_buff -- Process a new buffer based on queue type. */
+/*
+ * sdp_recv_buff - Process a new buffer based on queue type
+ */
 int sdp_recv_buff(struct sdp_opt *conn, struct sdpc_buff *buff)
 {
 	int result;
@@ -996,13 +1016,13 @@ done:
 	return result;
 } /* sdp_recv_buff */
 
-/* --------------------------------------------------------------------- */
-/*                                                                       */
-/* User initiated receive data function(s)                               */
-/*                                                                       */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*.._sdp_read_src_lookup -- lookup function for cancelation */
+/*
+ * User initiated receive data function(s)
+ */
+
+/*
+ * _sdp_read_src_lookup - lookup function for cancelation
+ */
 static int _sdp_read_src_lookup(struct sdpc_desc *element, void *arg)
 {
 	struct sdpc_iocb *iocb = (struct sdpc_iocb *) element;
@@ -1021,8 +1041,9 @@ static int _sdp_read_src_lookup(struct s
 	}
 } /* _sdp_read_src_lookup */
 
-/* ========================================================================= */
-/*.._sdp_inet_read_cancel -- cancel an IO operation */
+/*
+ * _sdp_inet_read_cancel - cancel an IO operation
+ */
 static int _sdp_inet_read_cancel(struct kiocb *req,
 				 struct io_event *ev)
 {
@@ -1163,8 +1184,9 @@ done:
 	return result;
 } /* _sdp_inet_read_cancel */
 
-/* ========================================================================= */
-/*.._sdp_inet_recv_urg_test -- recv queue urgent data cleanup function */
+/*
+ * _sdp_inet_recv_urg_test - recv queue urgent data cleanup function
+ */
 static int _sdp_inet_recv_urg_test(struct sdpc_buff *buff, void *arg)
 {
 	SDP_CHECK_NULL(buff, -EINVAL);
@@ -1172,8 +1194,9 @@ static int _sdp_inet_recv_urg_test(struc
 	return ((buff->tail == buff->head) ? 1 : 0);
 } /* _sdp_inet_recv_urg_test */
 
-/* ========================================================================= */
-/*.._sdp_inet_recv_urg_trav -- recv queue urg data retreival function */
+/*
+ * _sdp_inet_recv_urg_trav - recv queue urg data retreival function
+ */
 static int _sdp_inet_recv_urg_trav(struct sdpc_buff *buff, void *arg)
 {
 	u8 *value = (u8 *) arg;
@@ -1201,8 +1224,9 @@ static int _sdp_inet_recv_urg_trav(struc
 	return 0;
 } /* _sdp_inet_recv_urg_trav */
 
-/* ========================================================================= */
-/*.._sdp_inet_recv_urg -- recv urgent data from the network to user space */
+/*
+ * _sdp_inet_recv_urg - recv urgent data from the network to user space
+ */
 static int _sdp_inet_recv_urg(struct sock *sk,
 			      struct msghdr *msg,
 			      int size,
@@ -1287,8 +1311,9 @@ done:
 	return result;
 } /* _sdp_inet_recv_urg */
 
-/* ========================================================================= */
-/*..sdp_inet_recv -- recv data from the network to user space. */
+/*
+ * sdp_inet_recv - recv data from the network to user space
+ */
 int sdp_inet_recv(struct kiocb  *req,
 		  struct socket *sock,
 		  struct msghdr *msg, 




More information about the general mailing list