[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <f93138ac-cddd-4738-b034-19ecde6c3d4e@ryhl.io>
Date: Fri, 17 Nov 2023 19:27:07 +0100
From: Alice Ryhl <alice@...l.io>
To: Andrew Lunn <andrew@...n.ch>
Cc: benno.lossin@...ton.me, fujita.tomonori@...il.com,
miguel.ojeda.sandonis@...il.com, netdev@...r.kernel.org,
rust-for-linux@...r.kernel.org, tmgross@...ch.edu, wedsonaf@...il.com,
Alice Ryhl <aliceryhl@...gle.com>
Subject: Re: [PATCH net-next v7 1/5] rust: core abstractions for network PHY
drivers
On 11/17/23 17:28, Andrew Lunn wrote:>>>> /// # Invariants
>>>> ///
>>>> /// Referencing a `phy_device` using this struct asserts that the user
>>>> /// is inside a Y scope as defined in Documentation/foo/bar.
>>>> #[repr(transparent)]
>>>> pub struct Device(Opaque<bindings::phy_device>);
>>>
>>> There is no such documentation that i know of, except it does get
>>> repeated again and again on the mailling lists. Its tribal knowledge.
>>
>> Then, my suggestion would be to write down that tribal knowledge in the
>> safety comments.
>
> O.K, we can do that.
Do you have a link to one of those email threads that you mentioned?
Alice
Powered by blists - more mailing lists