Drivers: hv: vmbus: Fix the descriptions of some function parameters
No functional change. Added descriptions for some parameters. Fixed some typos. Removed some out-of-date comments. Signed-off-by: Dexuan Cui <decui@microsoft.com> Cc: Jonathan Corbet <corbet@lwn.net> Cc: linux-doc@vger.kernel.org Cc: K. Y. Srinivasan <kys@microsoft.com> Cc: Haiyang Zhang <haiyangz@microsoft.com> Cc: Stephen Hemminger <sthemmin@microsoft.com> Signed-off-by: K. Y. Srinivasan <kys@microsoft.com> Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
This commit is contained in:
parent
a007734618
commit
fe857bb40f
@ -743,15 +743,16 @@ EXPORT_SYMBOL_GPL(vmbus_close);
|
||||
|
||||
/**
|
||||
* vmbus_sendpacket() - Send the specified buffer on the given channel
|
||||
* @channel: Pointer to vmbus_channel structure.
|
||||
* @buffer: Pointer to the buffer you want to receive the data into.
|
||||
* @bufferlen: Maximum size of what the the buffer will hold
|
||||
* @channel: Pointer to vmbus_channel structure
|
||||
* @buffer: Pointer to the buffer you want to send the data from.
|
||||
* @bufferlen: Maximum size of what the buffer holds.
|
||||
* @requestid: Identifier of the request
|
||||
* @type: Type of packet that is being send e.g. negotiate, time
|
||||
* packet etc.
|
||||
* @type: Type of packet that is being sent e.g. negotiate, time
|
||||
* packet etc.
|
||||
* @flags: 0 or VMBUS_DATA_PACKET_FLAG_COMPLETION_REQUESTED
|
||||
*
|
||||
* Sends data in @buffer directly to hyper-v via the vmbus
|
||||
* This will send the data unparsed to hyper-v.
|
||||
* Sends data in @buffer directly to Hyper-V via the vmbus.
|
||||
* This will send the data unparsed to Hyper-V.
|
||||
*
|
||||
* Mainly used by Hyper-V drivers.
|
||||
*/
|
||||
@ -884,12 +885,13 @@ int vmbus_sendpacket_mpb_desc(struct vmbus_channel *channel,
|
||||
EXPORT_SYMBOL_GPL(vmbus_sendpacket_mpb_desc);
|
||||
|
||||
/**
|
||||
* vmbus_recvpacket() - Retrieve the user packet on the specified channel
|
||||
* @channel: Pointer to vmbus_channel structure.
|
||||
* __vmbus_recvpacket() - Retrieve the user packet on the specified channel
|
||||
* @channel: Pointer to vmbus_channel structure
|
||||
* @buffer: Pointer to the buffer you want to receive the data into.
|
||||
* @bufferlen: Maximum size of what the the buffer will hold
|
||||
* @buffer_actual_len: The actual size of the data after it was received
|
||||
* @bufferlen: Maximum size of what the buffer can hold.
|
||||
* @buffer_actual_len: The actual size of the data after it was received.
|
||||
* @requestid: Identifier of the request
|
||||
* @raw: true means keep the vmpacket_descriptor header in the received data.
|
||||
*
|
||||
* Receives directly from the hyper-v vmbus and puts the data it received
|
||||
* into Buffer. This will receive the data unparsed from hyper-v.
|
||||
|
@ -198,24 +198,19 @@ static u16 hv_get_dev_type(const struct vmbus_channel *channel)
|
||||
}
|
||||
|
||||
/**
|
||||
* vmbus_prep_negotiate_resp() - Create default response for Hyper-V Negotiate message
|
||||
* vmbus_prep_negotiate_resp() - Create default response for Negotiate message
|
||||
* @icmsghdrp: Pointer to msg header structure
|
||||
* @icmsg_negotiate: Pointer to negotiate message structure
|
||||
* @buf: Raw buffer channel data
|
||||
* @fw_version: The framework versions we can support.
|
||||
* @fw_vercnt: The size of @fw_version.
|
||||
* @srv_version: The service versions we can support.
|
||||
* @srv_vercnt: The size of @srv_version.
|
||||
* @nego_fw_version: The selected framework version.
|
||||
* @nego_srv_version: The selected service version.
|
||||
*
|
||||
* Note: Versions are given in decreasing order.
|
||||
*
|
||||
* @icmsghdrp is of type &struct icmsg_hdr.
|
||||
* Set up and fill in default negotiate response message.
|
||||
*
|
||||
* The fw_version and fw_vercnt specifies the framework version that
|
||||
* we can support.
|
||||
*
|
||||
* The srv_version and srv_vercnt specifies the service
|
||||
* versions we can support.
|
||||
*
|
||||
* Versions are given in decreasing order.
|
||||
*
|
||||
* nego_fw_version and nego_srv_version store the selected protocol versions.
|
||||
*
|
||||
* Mainly used by Hyper-V drivers.
|
||||
*/
|
||||
bool vmbus_prep_negotiate_resp(struct icmsg_hdr *icmsghdrp,
|
||||
|
Loading…
Reference in New Issue
Block a user