From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 5356148A9C; Fri, 7 Nov 2025 15:39:17 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 22A1F40264; Fri, 7 Nov 2025 15:39:17 +0100 (CET) Received: from dkmailrelay1.smartsharesystems.com (smartserver.smartsharesystems.com [77.243.40.215]) by mails.dpdk.org (Postfix) with ESMTP id 228F24021F for ; Fri, 7 Nov 2025 15:39:15 +0100 (CET) Received: from smartserver.smartsharesystems.com (smartserver.smartsharesys.local [192.168.4.10]) by dkmailrelay1.smartsharesystems.com (Postfix) with ESMTP id F221820467; Fri, 7 Nov 2025 15:39:14 +0100 (CET) Content-class: urn:content-classes:message MIME-Version: 1.0 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: base64 Subject: RE: [PATCH] mbuf: improve mbuf comments Date: Fri, 7 Nov 2025 15:39:13 +0100 Message-ID: <98CBD80474FA8B44BF855DF32C47DC35F65543@smartserver.smartshare.dk> X-MimeOLE: Produced By Microsoft Exchange V6.5 In-Reply-To: <20251107143555.612710-1-mb@smartsharesystems.com> X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: [PATCH] mbuf: improve mbuf comments Thread-Index: AdxP89pg2Y2S8OkIRy+RWVjv7OX84gAAFwRQ References: <20251105112810.20838-1-mb@smartsharesystems.com> <20251107143555.612710-1-mb@smartsharesystems.com> From: =?UTF-8?B?TW9ydGVuIEJyw7hydXA=?= To: , "Thomas Monjalon" X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org UGxlYXNlIGlnbm9yZSB0aGlzIG9uZS4gRm9yZ290IHRvIHNhdmUgYmVmb3JlIHNlbmRpbmcuDQoN ClZlbmxpZyBoaWxzZW4gLyBLaW5kIHJlZ2FyZHMsDQotTW9ydGVuIEJyw7hydXANCg0KDQo+IC0t LS0tT3JpZ2luYWwgTWVzc2FnZS0tLS0tDQo+IEZyb206IE1vcnRlbiBCcsO4cnVwIFttYWlsdG86 bWJAc21hcnRzaGFyZXN5c3RlbXMuY29tXQ0KPiBTZW50OiBGcmlkYXksIDcgTm92ZW1iZXIgMjAy NSAxNS4zNg0KPiBUbzogZGV2QGRwZGsub3JnOyBUaG9tYXMgTW9uamFsb24NCj4gQ2M6IE1vcnRl biBCcsO4cnVwDQo+IFN1YmplY3Q6IFtQQVRDSF0gbWJ1ZjogaW1wcm92ZSBtYnVmIGNvbW1lbnRz DQo+IA0KPiBVcGRhdGVkIHRoZSBjb21tZW50IHByZWNlZGluZyB0aGUgJ3JlYXJtX2RhdGEnIGZp ZWxkcyB0byByZWZsZWN0IHRoYXQNCj4gc29tZQ0KPiBldGhkZXYgZHJpdmVycyBkb24ndCByZWFs bHkgc2V0IHRoZSByZWFybV9kYXRhIGZpZWxkcyBvbiBSeCBkZXNjcmlwdG9yDQo+IHJlYXJtLCBi dXQgcmF0aGVyIHdoZW4gcHVsbGluZyB0aGUgcGFja2V0IGZyb20gdGhlIGRlc2NyaXB0b3IuDQo+ IEJ5IGRvaW5nIHRoaXMsIHRoZXkgYXZvaWQgYSBzdG9yZSBvcGVyYXRpb24gaW50byB0aGUgbWJ1 ZiB3aGVuIHRoZXkNCj4gcmVhcm0NCj4gdGhlIFJ4IGRlc2NyaXB0b3IsIGFuZCBpbnN0ZWFkIHBv c3Rwb25lIGl0IHRvIGxhdGVyLCB3aGVyZSBpdCB3aWxsIGJlDQo+IGNvbWJpbmVkIHdpdGggb3Ro ZXIgc3RvcmUgb3BlcmF0aW9ucyBpbnRvIHRoZSBtYnVmLg0KPiANCj4gVXBkYXRlZCB0aGUgY29t bWVudCBkZXNjcmliaW5nIHdoYXQgdGhlIHNlY29uZCBjYWNoZSBsaW5lIGlzIHVzZWQgZm9yLA0K PiB0bw0KPiByZWZsZWN0IHRoYXQgdGhlcmUgYXJlIGV4Y2VwdGlvbnMsIHdoZXJlIHNvbWUgZmll bGRzIGFyZSBzZXQgb24gUnggdG9vLg0KPiANCj4gVXBkYXRlZCBjb21tZW50cyBkZXNjcmliaW5n IHdoYXQgbmVlZHMgdG8gYmUgdXBkYXRlZCB3aGVuIGFkZGluZyBuZXcgUngNCj4gYW5kIFR4IG9m ZmxvYWQgZmxhZ3MuDQo+IA0KPiBTaWduZWQtb2ZmLWJ5OiBNb3J0ZW4gQnLDuHJ1cCA8bWJAc21h cnRzaGFyZXN5c3RlbXMuY29tPg0KPiAtLS0NCj4gdjI6DQo+ICogRml4IHR5cG8gaW4gY29tbWl0 IG1lc3NhZ2UuDQo+ICogRml4IHNwZWxsaW5nOiBSWC9UWCBzaG91bGQgYmUgUngvVHguIChUaG9t YXMgTW9uamFsb24pDQo+IC0tLQ0KPiAgbGliL21idWYvcnRlX21idWZfY29yZS5oIHwgMjkgKysr KysrKysrKysrKysrKysrKysrKy0tLS0tLS0NCj4gIDEgZmlsZSBjaGFuZ2VkLCAyMiBpbnNlcnRp b25zKCspLCA3IGRlbGV0aW9ucygtKQ0KPiANCj4gZGlmZiAtLWdpdCBhL2xpYi9tYnVmL3J0ZV9t YnVmX2NvcmUuaCBiL2xpYi9tYnVmL3J0ZV9tYnVmX2NvcmUuaA0KPiBpbmRleCBhOWNhYWY0ZTE0 Li42ZDY2ZWFiMTFkIDEwMDY0NA0KPiAtLS0gYS9saWIvbWJ1Zi9ydGVfbWJ1Zl9jb3JlLmgNCj4g KysrIGIvbGliL21idWYvcnRlX21idWZfY29yZS5oDQo+IEBAIC0zNyw4ICszNyw4IEBAIGV4dGVy biAiQyIgew0KPiAgICogICBhZGRlZCB0byB0aGUgcmlnaHQgb2YgdGhlIHByZXZpb3VzbHkgZGVm aW5lZCBmbGFncyBpLmUuIHRoZXkNCj4gc2hvdWxkIGNvdW50DQo+ICAgKiAgIGRvd253YXJkcywg bm90IHVwd2FyZHMuDQo+ICAgKg0KPiAtICogS2VlcCB0aGVzZSBmbGFncyBzeW5jaHJvbml6ZWQg d2l0aCBydGVfZ2V0X3J4X29sX2ZsYWdfbmFtZSgpIGFuZA0KPiAtICogcnRlX2dldF90eF9vbF9m bGFnX25hbWUoKS4NCj4gKyAqIEtlZXAgdGhlc2UgZmxhZ3Mgc3luY2hyb25pemVkIHdpdGggcnRl X2dldF9yeF9vbF9mbGFnX25hbWUoKSwNCj4gcnRlX2dldF9yeF9vbF9mbGFnX2xpc3QoKSwNCj4g KyAqIHJ0ZV9nZXRfdHhfb2xfZmxhZ19uYW1lKCksIGFuZCBydGVfZ2V0X3R4X29sX2ZsYWdfbGlz dCgpLg0KPiAgICovDQo+IA0KPiAgLyoqDQo+IEBAIC0xODAsMTIgKzE4MCwyMCBAQCBleHRlcm4g IkMiIHsNCj4gICNkZWZpbmUgUlRFX01CVUZfRl9SWF9PVVRFUl9MNF9DS1NVTV9HT09ECSgxVUxM IDw8IDIyKQ0KPiAgI2RlZmluZSBSVEVfTUJVRl9GX1JYX09VVEVSX0w0X0NLU1VNX0lOVkFMSUQJ KCgxVUxMIDw8IDIxKSB8ICgxVUxMDQo+IDw8IDIyKSkNCj4gDQo+IC0vKiBhZGQgbmV3IFJYIGZs YWdzIGhlcmUsIGRvbid0IGZvcmdldCB0byB1cGRhdGUgUlRFX01CVUZfRl9GSVJTVF9GUkVFDQo+ ICovDQo+ICsvKg0KPiArICogQWRkIG5ldyBSeCBmbGFncyBoZXJlLg0KPiArICogRG9uJ3QgZm9y Z2V0IHRvIHVwZGF0ZSBSVEVfTUJVRl9GX0ZJUlNUX0ZSRUUsDQo+ICsgKiBydGVfZ2V0X3J4X29s X2ZsYWdfbmFtZSgpLCBhbmQgcnRlX2dldF9yeF9vbF9mbGFnX2xpc3QoKS4NCj4gKyAqLw0KPiAN Cj4gICNkZWZpbmUgUlRFX01CVUZfRl9GSVJTVF9GUkVFICgxVUxMIDw8IDIzKQ0KPiAgI2RlZmlu ZSBSVEVfTUJVRl9GX0xBU1RfRlJFRSAoMVVMTCA8PCA0MCkNCj4gDQo+IC0vKiBhZGQgbmV3IFRY IGZsYWdzIGhlcmUsIGRvbid0IGZvcmdldCB0byB1cGRhdGUgUlRFX01CVUZfRl9MQVNUX0ZSRUUN Cj4gKi8NCj4gKy8qDQo+ICsgKiBBZGQgbmV3IFR4IGZsYWdzIGhlcmUuDQo+ICsgKiBEb24ndCBm b3JnZXQgdG8gdXBkYXRlIFJURV9NQlVGX0ZfTEFTVF9GUkVFLA0KPiBSVEVfTUJVRl9GX1RYX09G RkxPQURfTUFTSywNCj4gKyAqIHJ0ZV9nZXRfdHhfb2xfZmxhZ19uYW1lKCksIGFuZCBydGVfZ2V0 X3R4X29sX2ZsYWdfbGlzdCgpLg0KPiArICovDQo+IA0KPiAgLyoqDQo+ICAgKiBPdXRlciBVRFAg Y2hlY2tzdW0gb2ZmbG9hZCBmbGFnLiBUaGlzIGZsYWcgaXMgdXNlZCBmb3IgZW5hYmxpbmcNCj4g QEAgLTQ4NSw3ICs0OTMsMTAgQEAgc3RydWN0IF9fcnRlX2NhY2hlX2FsaWduZWQgcnRlX21idWYg ew0KPiAgCXN0cnVjdCBydGVfbWJ1ZiAqbmV4dDsNCj4gICNlbmRpZg0KPiANCj4gLQkvKiBuZXh0 IDggYnl0ZXMgYXJlIGluaXRpYWxpc2VkIG9uIFJYIGRlc2NyaXB0b3IgcmVhcm0gKi8NCj4gKwkv Kg0KPiArCSAqIE5leHQgOCBieXRlcyBhcmUgaW5pdGlhbGlzZWQgb24gUnggZGVzY3JpcHRvciBy ZWFybSwNCj4gKwkgKiBvciBvbiBSeCB3aGVuIHB1bGxpbmcgcGFja2V0IGZyb20gZGVzY3JpcHRv ci4NCj4gKwkgKi8NCj4gIAl1bmlvbiB7DQo+ICAJCXVpbnQ2NF90IHJlYXJtX2RhdGFbMV07DQo+ ICAJCV9fZXh0ZW5zaW9uX18NCj4gQEAgLTUxNyw3ICs1MjgsNyBAQCBzdHJ1Y3QgX19ydGVfY2Fj aGVfYWxpZ25lZCBydGVfbWJ1ZiB7DQo+IA0KPiAgCXVpbnQ2NF90IG9sX2ZsYWdzOyAgICAgICAg LyoqPCBPZmZsb2FkIGZlYXR1cmVzLiAqLw0KPiANCj4gLQkvKiByZW1haW5pbmcgMjQgYnl0ZXMg YXJlIHNldCBvbiBSWCB3aGVuIHB1bGxpbmcgcGFja2V0IGZyb20NCj4gZGVzY3JpcHRvciAqLw0K PiArCS8qIFJlbWFpbmluZyAyNCBieXRlcyBhcmUgc2V0IG9uIFJ4IHdoZW4gcHVsbGluZyBwYWNr ZXQgZnJvbQ0KPiBkZXNjcmlwdG9yLiAqLw0KPiAgCXVuaW9uIHsNCj4gIAkJLyogdm9pZCAqIHR5 cGUgb2YgdGhlIGFycmF5IGVsZW1lbnRzIGlzIHJldGFpbmVkIGZvciBkcml2ZXINCj4gY29tcGF0 aWJpbGl0eS4gKi8NCj4gIAkJdm9pZCAqcnhfZGVzY3JpcHRvcl9maWVsZHMxWzI0IC8gc2l6ZW9m KHZvaWQgKildOw0KPiBAQCAtNjAzLDcgKzYxNCwxMSBAQCBzdHJ1Y3QgX19ydGVfY2FjaGVfYWxp Z25lZCBydGVfbWJ1ZiB7DQo+IA0KPiAgCXN0cnVjdCBydGVfbWVtcG9vbCAqcG9vbDsgLyoqPCBQ b29sIGZyb20gd2hpY2ggbWJ1ZiB3YXMNCj4gYWxsb2NhdGVkLiAqLw0KPiANCj4gLQkvKiBzZWNv bmQgY2FjaGUgbGluZSAtIGZpZWxkcyBvbmx5IHVzZWQgaW4gc2xvdyBwYXRoIG9yIG9uIFRYICov DQo+ICsJLyoNCj4gKwkgKiBTZWNvbmQgY2FjaGUgbGluZSAtIGZpZWxkcyBvbmx5IHVzZWQgaW4g c2xvdyBwYXRoIG9yIG9uIFR4Lg0KPiArCSAqIEluIHNwZWNpYWwgY2FzZXMsIHNvbWUgb2YgdGhl c2UgZmllbGRzIGFyZSBhbHNvIHNldCBvbiBSeCwNCj4gKwkgKiBtb3N0IG5vdGFibHkgdGhlICdu ZXh0JyBmaWVsZCBpcyBzZXQgb24gUnggc2NhdHRlcmVkIHBhY2tldHMuDQo+ICsJICovDQo+ICAj aWYgUlRFX0lPVkFfSU5fTUJVRg0KPiAgCS8qKg0KPiAgCSAqIE5leHQgc2VnbWVudCBvZiBzY2F0 dGVyZWQgcGFja2V0LiBNdXN0IGJlIE5VTEwgaW4gdGhlIGxhc3QNCj4gLS0NCj4gMi40My4wDQoN Cg==