linux-kernel - Re: [PATCH net-next v3 02/14] docs: networking: Add PPE driver documentation for Qualcomm IPQ9574 SoC

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] [thread-next>] [day] [month] [year] [list]

Message-ID: <Z6lhPB1y3BBFI4ux@archie.me>
Date: Mon, 10 Feb 2025 09:15:24 +0700
From: Bagas Sanjaya <bagasdotme@...il.com>
To: Luo Jie <quic_luoj@...cinc.com>, Andrew Lunn <andrew+netdev@...n.ch>,
	"David S. Miller" <davem@...emloft.net>,
	Eric Dumazet <edumazet@...gle.com>,
	Jakub Kicinski <kuba@...nel.org>, Paolo Abeni <pabeni@...hat.com>,
	Rob Herring <robh@...nel.org>,
	Krzysztof Kozlowski <krzk+dt@...nel.org>,
	Conor Dooley <conor+dt@...nel.org>,
	Lei Wei <quic_leiwei@...cinc.com>,
	Suruchi Agarwal <quic_suruchia@...cinc.com>,
	Pavithra R <quic_pavir@...cinc.com>,
	Simon Horman <horms@...nel.org>, Jonathan Corbet <corbet@....net>,
	Kees Cook <kees@...nel.org>,
	"Gustavo A. R. Silva" <gustavoars@...nel.org>,
	Philipp Zabel <p.zabel@...gutronix.de>
Cc: linux-arm-msm@...r.kernel.org, netdev@...r.kernel.org,
	devicetree@...r.kernel.org, linux-kernel@...r.kernel.org,
	linux-doc@...r.kernel.org, linux-hardening@...r.kernel.org,
	quic_kkumarcs@...cinc.com, quic_linchen@...cinc.com,
	srinivas.kandagatla@...aro.org, bartosz.golaszewski@...aro.org,
	john@...ozen.org
Subject: Re: [PATCH net-next v3 02/14] docs: networking: Add PPE driver
 documentation for Qualcomm IPQ9574 SoC

On Sun, Feb 09, 2025 at 10:29:36PM +0800, Luo Jie wrote:
> +The Ethernet functionality in the PPE (Packet Process Engine) is comprised of three
> +components: the switch core, port wrapper and Ethernet DMA.
> +
> +The Switch core in the IPQ9574 PPE has maximum of 6 front panel ports and two FIFO
> +interfaces. One of the two FIFO interfaces is used for Ethernet port to host CPU
> +communication using Ethernet DMA. The other is used communicating to the EIP engine
                                    "The other one is used ..."
> +which is used for IPsec offload. On the IPQ9574, the PPE includes 6 GMAC/XGMACs that
> +can be connected with external Ethernet PHY. Switch core also includes BM (Buffer
> +Management), QM (Queue Management) and SCH (Scheduler) modules for supporting the
> +packet processing.
> +
> <snipped>...
> +The PPE driver files in drivers/net/ethernet/qualcomm/ppe/ are listed as below:
> +
> +- Makefile
> +- ppe.c
> +- ppe.h
> +- ppe_config.c
> +- ppe_config.h
> +- ppe_debugfs.c
> +- ppe_debugfs.h
> +- ppe_regs.h

If somehow new source files were added, should the list above be updated to
keep up?

> +Enabling the Driver
> +===================
> +
> +The driver is located in the menu structure at:
> +
> +  -> Device Drivers
> +    -> Network device support (NETDEVICES [=y])
> +      -> Ethernet driver support
> +        -> Qualcomm devices
> +          -> Qualcomm Technologies, Inc. PPE Ethernet support

Literal code block should format above nicer, but plain paragraph is fine.

> +
> +If this driver is built as a module, we can use below commands to install and remove it:
> +
> +- insmod qcom-ppe.ko
> +- rmmod qcom-ppe.ko

"If the driver is built as a module, the module will be called qcom-ppe."
(I assume that readers know how to insert/remove modules).

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

Download attachment "signature.asc" of type "application/pgp-signature" (229 bytes)