[opensm patch 5/6] opensm/osm_service.h: Fix and add some comments

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



From: Honggang Li <honli@xxxxxxxxxx>

Signed-off-by: Honggang Li <honli@xxxxxxxxxx>
---
 include/opensm/osm_service.h | 91 +++++++++++++++++++++++++++++++++++++++++---
 1 file changed, 86 insertions(+), 5 deletions(-)

diff --git a/include/opensm/osm_service.h b/include/opensm/osm_service.h
index 446b8883..9a41878e 100644
--- a/include/opensm/osm_service.h
+++ b/include/opensm/osm_service.h
@@ -96,10 +96,10 @@ typedef struct osm_svcr {
 } osm_svcr_t;
 /*
 * FIELDS
-*	map_item
-*		Map Item for qmap linkage.  Must be first element!!
+*	list_item
+*		List Item for Quick List linkage.  Must be first element!!
 *
-*	svc_rec
+*	service_record
 *		IB Service record structure
 *
 *	modified_time
@@ -150,7 +150,7 @@ void osm_svcr_init(IN osm_svcr_t * p_svcr,
 		   IN const ib_service_record_t * p_svc_rec);
 /*
 * PARAMETERS
-*	p_svc_rec
+*	p_svcr
 *		[in] Pointer to osm_svcr_t structure
 *	p_svc_rec
 *		[in] Pointer to the ib_service_record_t
@@ -171,21 +171,102 @@ void osm_svcr_init(IN osm_svcr_t * p_svcr,
 void osm_svcr_delete(IN osm_svcr_t * p_svcr);
 /*
 * PARAMETERS
-*	p_svc_rec
+*	p_svcr
 *		[in] Pointer to osm_svcr_t structure
 *
 * SEE ALSO
 *	Service Record, osm_svcr_new
 *********/
 
+/****f* OpenSM: Service Record/osm_svcr_get_by_rid
+* NAME
+*	osm_svcr_get_by_rid
+*
+* DESCRIPTION
+*	Search the Service Record Database by record service_id,
+* service_gid and service_pkey.
+*
+* SYNOPSIS
+*/
 osm_svcr_t *osm_svcr_get_by_rid(IN osm_subn_t const *p_subn,
 				IN osm_log_t * p_log,
 				IN ib_service_record_t * p_svc_rec);
+/*
+* PARAMETERS
+*	p_subn
+*		[in] Pointer to Subnet structure
+*
+*	p_log
+*		[in] Pointer to osm_log_t
+*
+*	p_svc_rec
+*		[in] Pointer to IB Service Record
+*
+* RETURN VALUES
+*	If found a matched record, pointer to osm_svcr_t structure.
+*	Otherwise, pointer to NULL.
+*
+* SEE ALSO
+*	Service Record
+*********/
 
+/****f* OpenSM: Service Record/osm_svcr_insert_to_db
+* NAME
+*	osm_svcr_insert_to_db
+*
+* DESCRIPTION
+*	Insert new Service Record into Database
+*
+* SYNOPSIS
+*/
 void osm_svcr_insert_to_db(IN osm_subn_t * p_subn, IN osm_log_t * p_log,
 			   IN osm_svcr_t * p_svcr);
+/*
+* PARAMETERS
+*	p_subn
+*		[in] Pointer to Subnet structure
+*
+*	p_log
+*		[in] Pointer to osm_log_t
+*
+*	p_svcr
+*		[in] Pointer to IB Service Record to be inserted
+*
+* RETURN VALUES
+*	This function does not return a value.
+*
+* SEE ALSO
+*	Service Record, osm_svcr_remove_from_db
+*********/
+
+/****f* OpenSM: Service Record/osm_svcr_remove_from_db
+* NAME
+*	osm_svcr_remove_from_db
+*
+* DESCRIPTION
+*	Remove a Service Record from Database
+*
+* SYNOPSIS
+*/
 void osm_svcr_remove_from_db(IN osm_subn_t * p_subn, IN osm_log_t * p_log,
 			     IN osm_svcr_t * p_svcr);
+/*
+* PARAMETERS
+*	p_subn
+*		[in] Pointer to Subnet structure
+*
+*	p_log
+*		[in] Pointer to osm_log_t
+*
+*	p_svcr
+*		[in] Pointer to IB Service Record to be removed
+*
+* RETURN VALUES
+*	This function does not return a value.
+*
+* SEE ALSO
+*	Service Record, osm_svcr_insert_to_db
+*********/
 
 END_C_DECLS
 #endif				/* _OSM_SVCR_H_ */
-- 
2.14.4




[Index of Archives]     [Linux USB Devel]     [Video for Linux]     [Linux Audio Users]     [Photo]     [Yosemite News]     [Yosemite Photos]     [Linux Kernel]     [Linux SCSI]     [XFree86]

  Powered by Linux