linux-kernel - Re: [PATCH v10 3/4] docs: Add documentation for userspace client interface

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Message-ID: <cc3055e5-9522-aeaa-4b29-e4f811b832a8@codeaurora.org>
Date:   Thu, 29 Oct 2020 19:16:11 -0700
From:   Hemant Kumar <hemantk@...eaurora.org>
To:     Randy Dunlap <rdunlap@...radead.org>,
        manivannan.sadhasivam@...aro.org, gregkh@...uxfoundation.org
Cc:     linux-arm-msm@...r.kernel.org, linux-kernel@...r.kernel.org,
        jhugo@...eaurora.org, bbhatt@...eaurora.org,
        loic.poulain@...aro.org, netdev@...r.kernel.org
Subject: Re: [PATCH v10 3/4] docs: Add documentation for userspace client
 interface

Hi Randy,

On 10/29/20 2:51 PM, Randy Dunlap wrote:
> Hi,
> 
> On 10/29/20 2:40 PM, Hemant Kumar wrote:
>> MHI userspace client driver is creating device file node
>> for user application to perform file operations. File
>> operations are handled by MHI core driver. Currently
>> Loopback MHI channel is supported by this driver.
>>
>> Signed-off-by: Hemant Kumar <hemantk@...eaurora.org>
>> ---
>>   Documentation/mhi/index.rst |  1 +
>>   Documentation/mhi/uci.rst   | 83 +++++++++++++++++++++++++++++++++++++++++++++
>>   2 files changed, 84 insertions(+)
>>   create mode 100644 Documentation/mhi/uci.rst
> 
> 
>> diff --git a/Documentation/mhi/uci.rst b/Documentation/mhi/uci.rst
>> new file mode 100644
>> index 0000000..fe901c4
>> --- /dev/null
>> +++ b/Documentation/mhi/uci.rst
>> @@ -0,0 +1,83 @@
>> +.. SPDX-License-Identifier: GPL-2.0
>> +
>> +=================================
>> +Userspace Client Interface (UCI)
>> +=================================
>> +
> 
> 
> Lots of TLAs.
> 
>> +
>> +read
>> +----
>> +
>> +When data transfer is completed on downlink channel, TRE buffer is copied to
>> +pending list. Reader is unblocked and data is copied to userspace buffer. TRE
>> +buffer is queued back to downlink channel transfer ring.
> 
> What is TRE?
Transfer Ring Element
i will add that in small bracket inline.
> 
>> +
>> +Usage
>> +=====
>> +
>> +Device file node is created with format:-
>> +
>> +/dev/mhi_<controller_name>_<mhi_device_name>
>> +
>> +controller_name is the name of underlying bus used to transfer data. mhi_device
>> +name is the name of the MHI channel being used by MHI client in userspace to
>> +send or receive data using MHI protocol.
>> +
>> +There is a separate character device file node created for each channel
>> +specified in mhi device id table. MHI channels are statically defined by MHI
> 
>                  MHI
> unless it is a variable name, like below: mhi_device_id
Done.
> 
>> +specification. The list of supported channels is in the channel list variable
>> +of mhi_device_id table in UCI driver.
>> +
> 
>> +Other Use Cases
>> +---------------
>> +
>> +Getting MHI device specific diagnostics information to userspace MHI diag client
> 
>                                                                          diagnostic client
Done.
> 
>> +using DIAG channel 4 (Host to device) and 5 (Device to Host).
>>
> 
> thanks.
> 

Thanks for reviewing it. Let me fix it and re-upload.

Thanks,
Hemant

-- 
The Qualcomm Innovation Center, Inc. is a member of the Code Aurora Forum,
a Linux Foundation Collaborative Project