66     /// Callers must ensure that the `struct scatterlist` pointed to by `ptr` is valid for the
70         // SAFETY: The safety requirements of this function guarantee that `ptr` is a valid pointer  in from_raw()
86         // SAFETY: `self.as_raw()` is a valid pointer to a `struct scatterlist`.  in dma_address()
94         // SAFETY: `self.as_raw()` is a valid pointer to a `struct scatterlist`.  in dma_len()
141     /// - the `struct sg_table` pointed to by `ptr` is valid for the entire lifetime of `'a`,
145         // SAFETY: The safety requirements of this function guarantee that `ptr` is a valid pointer  in from_raw()
157         // SAFETY: `self.as_raw()` is a valid pointer to a `struct sg_table`.  in iter()
161             // SAFETY: `self.as_raw()` is a valid pointer to a `struct sg_table`.  in iter()
164             // SAFETY: `ptr` is guaranteed to be a valid pointer to a `struct scatterlist`.  in iter()
180 /// - `sgt` is a valid pointer to a `struct sg_table` for the entire lifetime of the
198     /// - `sgt` must be a valid pointer to a `struct sg_table` for the entire lifetime of the
208         // - `dev.as_raw()` is a valid pointer to a `struct device`, which is guaranteed to be  in new()
210         // - `sgt` is a valid pointer to a `struct sg_table`.  in new()
216         // valid for the entire lifetime of this object instance.  in new()
229         // - `self.dev.as_raw()` is a pointer to a valid `struct device`.  in drop()
231         // - `self.sgt.as_ptr()` is a valid pointer to a `struct sg_table` by the type invariants  in drop()
257     /// - `pages` must be a slice of valid `struct page *`.
258     /// - The pages pointed to by `pages` must remain valid for the entire lifetime of the returned
274         // - `sgt.get()` is a valid pointer to uninitialized memory.  in new()
300         // SAFETY: `sgt` is a valid and initialized `struct sg_table`.  in drop()
355         // SAFETY: `dev.as_raw()` is a valid pointer to a `struct device`.  in new()
363             // - `page_vec` is a `KVec` of valid `struct page *` obtained from `pages`.  in new()
364             // - The pages contained in `pages` remain valid for the entire lifetime of the  in new()
368                 // SAFETY: `this` is a valid pointer to uninitialized memory.  in new()
449         // - `self.inner.sgt.as_raw()` is a valid pointer to a `struct sg_table` for the entire  in deref()
480         // SAFETY: `entry.as_raw()` is a valid pointer to a `struct scatterlist`.  in next()
484             // SAFETY: If `next` is not NULL, `sg_next()` guarantees to return a valid pointer to  in next()