summaryrefslogtreecommitdiff
path: root/drivers/xen/grant-table.c
diff options
context:
space:
mode:
authorAnnie Li <annie.li@oracle.com>2011-12-12 18:13:57 +0800
committerKonrad Rzeszutek Wilk <konrad.wilk@oracle.com>2011-12-16 11:23:05 -0500
commit9dbc71d53ce4e0260d0a8307838cd9ebddc07a12 (patch)
tree4020fb401672ea02d366dcd42f02078039ab8b22 /drivers/xen/grant-table.c
parent4313d88c93df8c096adde516b08f1fb2f2e8b844 (diff)
downloadlwn-9dbc71d53ce4e0260d0a8307838cd9ebddc07a12.tar.gz
lwn-9dbc71d53ce4e0260d0a8307838cd9ebddc07a12.zip
xen/granttable: Improve comments for function pointers
Signed-off-by: Annie Li <annie.li@oracle.com> Signed-off-by: Konrad Rzeszutek Wilk <konrad.wilk@oracle.com>
Diffstat (limited to 'drivers/xen/grant-table.c')
-rw-r--r--drivers/xen/grant-table.c48
1 files changed, 24 insertions, 24 deletions
diff --git a/drivers/xen/grant-table.c b/drivers/xen/grant-table.c
index bd325fd0000b..1589ea1a2445 100644
--- a/drivers/xen/grant-table.c
+++ b/drivers/xen/grant-table.c
@@ -76,50 +76,50 @@ static union {
/*This is a structure of function pointers for grant table*/
struct gnttab_ops {
/*
- * Mapping a list of frames for storing grant entries. First input
- * parameter is used to storing grant table address when grant table
- * being setup, second parameter is the number of frames to map grant
- * table. Returning GNTST_okay means success and negative value means
- * failure.
+ * Mapping a list of frames for storing grant entries. Frames parameter
+ * is used to store grant table address when grant table being setup,
+ * nr_gframes is the number of frames to map grant table. Returning
+ * GNTST_okay means success and negative value means failure.
*/
- int (*map_frames)(unsigned long *, unsigned int);
+ int (*map_frames)(unsigned long *frames, unsigned int nr_gframes);
/*
* Release a list of frames which are mapped in map_frames for grant
* entry status.
*/
void (*unmap_frames)(void);
/*
- * Introducing a valid entry into the grant table, granting the frame
- * of this grant entry to domain for accessing, or transfering, or
- * transitively accessing. First input parameter is reference of this
- * introduced grant entry, second one is domid of granted domain, third
- * one is the frame to be granted, and the last one is status of the
- * grant entry to be updated.
+ * Introducing a valid entry into the grant table, granting the frame of
+ * this grant entry to domain for accessing or transfering. Ref
+ * parameter is reference of this introduced grant entry, domid is id of
+ * granted domain, frame is the page frame to be granted, and flags is
+ * status of the grant entry to be updated.
*/
- void (*update_entry)(grant_ref_t, domid_t, unsigned long, unsigned);
+ void (*update_entry)(grant_ref_t ref, domid_t domid,
+ unsigned long frame, unsigned flags);
/*
- * Stop granting a grant entry to domain for accessing. First input
- * parameter is reference of a grant entry whose grant access will be
- * stopped, second one is not in use now. If the grant entry is
+ * Stop granting a grant entry to domain for accessing. Ref parameter is
+ * reference of a grant entry whose grant access will be stopped,
+ * readonly is not in use in this function. If the grant entry is
* currently mapped for reading or writing, just return failure(==0)
* directly and don't tear down the grant access. Otherwise, stop grant
* access for this entry and return success(==1).
*/
- int (*end_foreign_access_ref)(grant_ref_t, int);
+ int (*end_foreign_access_ref)(grant_ref_t ref, int readonly);
/*
- * Stop granting a grant entry to domain for transfer. If tranfer has
- * not started, just reclaim the grant entry and return failure(==0).
- * Otherwise, wait for the transfer to complete and then return the
- * frame.
+ * Stop granting a grant entry to domain for transfer. Ref parameter is
+ * reference of a grant entry whose grant transfer will be stopped. If
+ * tranfer has not started, just reclaim the grant entry and return
+ * failure(==0). Otherwise, wait for the transfer to complete and then
+ * return the frame.
*/
- unsigned long (*end_foreign_transfer_ref)(grant_ref_t);
+ unsigned long (*end_foreign_transfer_ref)(grant_ref_t ref);
/*
- * Query the status of a grant entry. Input parameter is reference of
+ * Query the status of a grant entry. Ref parameter is reference of
* queried grant entry, return value is the status of queried entry.
* Detailed status(writing/reading) can be gotten from the return value
* by bit operations.
*/
- int (*query_foreign_access)(grant_ref_t);
+ int (*query_foreign_access)(grant_ref_t ref);
};
static struct gnttab_ops *gnttab_interface;