[openib-general] [PATCH][SDP][2/33] Fix comment style in sdp_advt.c
Tom Duffy
Tom.Duffy at Sun.COM
Thu Feb 17 14:08:50 PST 2005
Signed-off-by: Tom Duffy <tduffy at sun.com>
--- drivers/infiniband/ulp/sdp-orig/sdp_advt.c 2005-02-10 18:42:56.537025000 -0800
+++ drivers/infiniband/ulp/sdp/sdp_advt.c 2005-02-17 10:22:17.245012000 -0800
@@ -1,44 +1,53 @@
/*
- 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.
-
- $Id: sdp_advt.c 619 2004-08-10 03:23:02Z roland $
-*/
+ * 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$
+ */
#include "sdp_main.h"
static kmem_cache_t *__sdp_advt_cache = NULL;
static kmem_cache_t *__sdp_advt_table = NULL;
-/* --------------------------------------------------------------------- */
-/* */
-/* module specific functions */
-/* */
-/* --------------------------------------------------------------------- */
-
-/* --------------------------------------------------------------------- */
-/* */
-/* public advertisment object functions for FIFO object table */
-/* */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*..sdp_advt_create - create an advertisment object */
+/*
+ * module specific functions
+ */
+
+/*
+ * public advertisment object functions for FIFO object table
+ */
+
+/*
+ * sdp_advt_create - create an advertisment object
+ */
struct sdpc_advt *sdp_advt_create(void)
{
struct sdpc_advt *advt;
@@ -60,8 +69,9 @@ struct sdpc_advt *sdp_advt_create(void)
return advt;
} /* sdp_advt_create */
-/* ========================================================================= */
-/*..sdp_advt_destroy - destroy an advertisment object */
+/*
+ * sdp_advt_destroy - destroy an advertisment object
+ */
int sdp_advt_destroy(struct sdpc_advt *advt)
{
SDP_CHECK_NULL(advt, -EINVAL);
@@ -78,8 +88,9 @@ int sdp_advt_destroy(struct sdpc_advt *a
return 0;
} /* sdp_advt_destroy */
-/* ========================================================================= */
-/*..sdp_advt_q_get - get, and remove, the object at the tables head */
+/*
+ * sdp_advt_q_get - get, and remove, the object at the tables head
+ */
struct sdpc_advt *sdp_advt_q_get(struct sdpc_advt_q *table)
{
struct sdpc_advt *advt;
@@ -116,8 +127,9 @@ struct sdpc_advt *sdp_advt_q_get(struct
return advt;
} /* sdp_advt_q_get */
-/* ========================================================================= */
-/*..sdp_advt_q_look - get, without removing, the object at the head */
+/*
+ * sdp_advt_q_look - get, without removing, the object at the head
+ */
struct sdpc_advt *sdp_advt_q_look(struct sdpc_advt_q *table)
{
SDP_CHECK_NULL(table, NULL);
@@ -125,8 +137,9 @@ struct sdpc_advt *sdp_advt_q_look(struct
return table->head;
} /* sdp_advt_q_look */
-/* ========================================================================= */
-/*..sdp_advt_q_put - put the advertisment object at the tables tail */
+/*
+ * sdp_advt_q_put - put the advertisment object at the tables tail
+ */
int sdp_advt_q_put(struct sdpc_advt_q *table, struct sdpc_advt *advt)
{
struct sdpc_advt *next;
@@ -157,13 +170,13 @@ int sdp_advt_q_put(struct sdpc_advt_q *t
return 0;
} /* sdp_advt_q_put */
-/* --------------------------------------------------------------------- */
-/* */
-/* public table functions */
-/* */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*..sdp_advt_q_create - create an advertisment table */
+/*
+ * public table functions
+ */
+
+/*
+ * sdp_advt_q_create - create an advertisment table
+ */
struct sdpc_advt_q *sdp_advt_q_create(int * result)
{
struct sdpc_advt_q *table = NULL;
@@ -184,8 +197,9 @@ struct sdpc_advt_q *sdp_advt_q_create(in
return table;
} /* sdp_advt_q_create */
-/* ========================================================================= */
-/*..sdp_advt_q_init - initialize a new empty advertisment table */
+/*
+ * sdp_advt_q_init - initialize a new empty advertisment table
+ */
int sdp_advt_q_init(struct sdpc_advt_q *table)
{
SDP_CHECK_NULL(table, -EINVAL);
@@ -196,8 +210,9 @@ int sdp_advt_q_init(struct sdpc_advt_q *
return 0;
} /* sdp_advt_q_init */
-/* ========================================================================= */
-/*..sdp_advt_q_clear - clear the contents of an advertisment table */
+/*
+ * sdp_advt_q_clear - clear the contents of an advertisment table
+ */
int sdp_advt_q_clear(struct sdpc_advt_q *table)
{
struct sdpc_advt *advt;
@@ -216,8 +231,9 @@ int sdp_advt_q_clear(struct sdpc_advt_q
return 0;
} /* sdp_advt_q_clear */
-/* ========================================================================= */
-/*..sdp_advt_q_destroy - destroy an advertisment table */
+/*
+ * sdp_advt_q_destroy - destroy an advertisment table
+ */
int sdp_advt_q_destroy(struct sdpc_advt_q *table)
{
struct sdpc_advt *advt;
@@ -240,13 +256,13 @@ int sdp_advt_q_destroy(struct sdpc_advt_
return 0;
} /* sdp_advt_q_destroy */
-/* --------------------------------------------------------------------- */
-/* */
-/* primary initialization/cleanup functions */
-/* */
-/* --------------------------------------------------------------------- */
-/* ========================================================================= */
-/*..sdp_main_advt_init -- initialize the advertisment caches. */
+/*
+ * primary initialization/cleanup functions
+ */
+
+/*
+ * sdp_main_advt_init - initialize the advertisment caches.
+ */
int sdp_main_advt_init(void)
{
int result;
@@ -289,8 +305,9 @@ error_advt_c:
return 0;
} /* sdp_main_advt_init */
-/* ========================================================================= */
-/*..sdp_main_advt_cleanup -- cleanup the advertisment caches. */
+/*
+ * sdp_main_advt_cleanup - cleanup the advertisment caches.
+ */
int sdp_main_advt_cleanup(void)
{
sdp_dbg_init("Advertisment cache cleanup.");
More information about the general
mailing list