crates/nonstick: libpam-sys/libpam-sys-helpers/src/lib.rs annotate

annotate libpam-sys/libpam-sys-helpers/src/lib.rs @ 183:4f46681b3f54 default tip

Catch a few stray cargo fmt things.

author	Paul Fisher <paul@pfish.zone>
date	Wed, 30 Jul 2025 18:43:07 -0400
parents	9e4ce1631bd3
children

rev	line source
148 4b3a5095f68c Move libpam-sys helpers into their own library. Paul Fisher <paul@pfish.zone> parents: 143 diff changeset	1 //! This package contains helpers to deal with memory management and
4b3a5095f68c Move libpam-sys helpers into their own library. Paul Fisher <paul@pfish.zone> parents: 143 diff changeset	2 //! annoying type stuff in `libpam-sys` (and LibPAM in general).
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	3
110 2346fd501b7a Add tests for constants and do other macro niceties. Paul Fisher <paul@pfish.zone> parents: 109 diff changeset	4 use std::error::Error;
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	5 use std::marker::{PhantomData, PhantomPinned};
110 2346fd501b7a Add tests for constants and do other macro niceties. Paul Fisher <paul@pfish.zone> parents: 109 diff changeset	6 use std::mem::ManuallyDrop;
109 bb465393621f Minor cleanup and reorg. Paul Fisher <paul@pfish.zone> parents: 106 diff changeset	7 use std::ptr::NonNull;
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	8 use std::{any, fmt, mem, ptr, slice};
148 4b3a5095f68c Move libpam-sys helpers into their own library. Paul Fisher <paul@pfish.zone> parents: 143 diff changeset	9
4b3a5095f68c Move libpam-sys helpers into their own library. Paul Fisher <paul@pfish.zone> parents: 143 diff changeset	10 // Memory management
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	11
136 efbc235f01d3 Separate libpam-sys-helpers from libpam-sys. Paul Fisher <paul@pfish.zone> parents: 134 diff changeset	12 /// A pointer-to-pointer-to-message container for PAM's conversation callback.
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	13 ///
136 efbc235f01d3 Separate libpam-sys-helpers from libpam-sys. Paul Fisher <paul@pfish.zone> parents: 134 diff changeset	14 /// The PAM conversation callback requires a pointer to a pointer of
efbc235f01d3 Separate libpam-sys-helpers from libpam-sys. Paul Fisher <paul@pfish.zone> parents: 134 diff changeset	15 /// `pam_message`s. Linux-PAM handles this differently than all other
efbc235f01d3 Separate libpam-sys-helpers from libpam-sys. Paul Fisher <paul@pfish.zone> parents: 134 diff changeset	16 /// PAM implementations (including the X/SSO PAM standard).
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	17 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	18 /// X/SSO appears to specify a pointer-to-pointer-to-array:
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	19 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	20 /// ```text
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	21 /// points to ┌────────────┐ ╔═ Message[] ═╗
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	22 /// messages ┄┄┄┄┄┄┄┄┄┄> │ *messages ┄┼┄┄┄┄┄> ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	23 /// └────────────┘ ║ data ┄┄┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	24 /// ╟─────────────╢
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	25 /// ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	26 /// ║ data ┄┄┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	27 /// ╟─────────────╢
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	28 /// ║ ... ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	29 /// ```
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	30 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	31 /// whereas Linux-PAM uses an `**argv`-style pointer-to-array-of-pointers:
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	32 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	33 /// ```text
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	34 /// points to ┌──────────────┐ ╔═ Message ═╗
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	35 /// messages ┄┄┄┄┄┄┄┄┄┄> │ messages[0] ┄┼┄┄┄┄> ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	36 /// │ messages[1] ┄┼┄┄┄╮ ║ data ┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	37 /// │ ... │ ┆ ╚═══════════╝
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	38 /// ┆
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	39 /// ┆ ╔═ Message ═╗
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	40 /// ╰┄┄> ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	41 /// ║ data ┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	42 /// ╚═══════════╝
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	43 /// ```
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	44 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	45 /// Because the `messages` remain owned by the application which calls into PAM,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	46 /// we can solve this with One Simple Trick: make the intermediate list point
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	47 /// into the same array:
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	48 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	49 /// ```text
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	50 /// points to ┌──────────────┐ ╔═ Message[] ═╗
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	51 /// messages ┄┄┄┄┄┄┄┄┄┄> │ messages[0] ┄┼┄┄┄┄> ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	52 /// │ messages[1] ┄┼┄┄╮ ║ data ┄┄┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	53 /// │ ... │ ┆ ╟─────────────╢
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	54 /// ╰┄> ║ style ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	55 /// ║ data ┄┄┄┄┄┄┄╫┄┄> ...
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	56 /// ╟─────────────╢
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	57 /// ║ ... ║
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	58 /// ```
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	59 #[derive(Debug)]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	60 pub struct PtrPtrVec<T> {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	61 data: Vec<T>,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	62 pointers: Vec<*const T>,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	63 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	64
125 2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	65 // Since this is a wrapper around a Vec with no dangerous functionality*,
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	66 // this can be Send and Sync provided the original Vec is.
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	67 //
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	68 // * It will only become unsafe when the user dereferences a pointer or sends it
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	69 // to an unsafe function.
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	70 unsafe impl<T> Send for PtrPtrVec<T> where Vec<T>: Send {}
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	71 unsafe impl<T> Sync for PtrPtrVec<T> where Vec<T>: Sync {}
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	72
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	73 impl<T> PtrPtrVec<T> {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	74 /// Takes ownership of the given Vec and creates a vec of pointers to it.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	75 pub fn new(data: Vec<T>) -> Self {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	76 let start = data.as_ptr();
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	77 // We do this slightly tricky little dance to satisfy Miri:
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	78 //
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	79 // A pointer extracted from a reference can only legally access
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	80 // that reference's memory. This means that if we say:
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	81 // pointers[0] = &data[0] as *const T;
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	82 // we can't traverse through pointers[0] to reach data[1],
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	83 // we can only use pointers[1].
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	84 //
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	85 // However, if we use the start-of-vec pointer from the `data` vector,
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	86 // its "provenance"* is valid for the entire array (even if the address
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	87 // of the pointer is the same). This avoids some behavior which is
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	88 // technically undefined. While the CPU sees no difference between
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	89 // those two pointers, the compiler is allowed to make optimizations
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	90 // based on that provenance (even if, in this case, it isn't likely
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	91 // to do so).
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	92 //
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	93 // data.as_ptr() points here, and is valid for the whole Vec.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	94 // ┃
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	95 // ┠─────────────────╮
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	96 // ┌─────┬─────┬─────┐
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	97 // data │ [0] │ [1] │ [2] │
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	98 // └─────┴─────┴─────┘
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	99 // ┠─────╯ ┊
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	100 // ┃ ┊ ┊
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	101 // (&data[0] as *const T) points to the same place, but is valid
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	102 // only for that 0th element.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	103 // ┊ ┊
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	104 // ┠─────╯
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	105 // ┃
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	106 // (&data[1] as *const T) points here, and is only valid
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	107 // for that element.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	108 //
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	109 // We only have to do this for pointers[0] because only that pointer
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	110 // is used for accessing elements other than data[0] (in XSSO).
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	111 //
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	112 // * "provenance" is kind of like if every pointer in your program
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	113 // remembered where it came from and, based on that, it had an implied
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	114 // memory range it was valid for, separate from its address.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	115 // https://doc.rust-lang.org/std/ptr/#provenance
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	116 // (It took a long time for me to understand this.)
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	117 let mut pointers = Vec::with_capacity(data.len());
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	118 // Ensure the 0th pointer has provenance from the entire vec
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	119 // (even though it's numerically identical to &data[0] as *const T).
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	120 pointers.push(start);
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	121 // The 1st and everything thereafter only need to have the provenance
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	122 // of their own memory.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	123 pointers.extend(data[1..].iter().map(\|r\| r as *const T));
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	124 Self { data, pointers }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	125 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	126
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	127 /// Gives you back your Vec.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	128 pub fn into_inner(self) -> Vec<T> {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	129 self.data
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	130 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	131
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	132 /// Gets a pointer-to-pointer suitable for passing into the Conversation.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	133 pub fn as_ptr<Dest>(&self) -> const const Dest {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	134 Self::assert_size::<Dest>();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	135 self.pointers.as_ptr().cast::<*const Dest>()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	136 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	137
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	138 /// Iterates over a Linux-PAM–style pointer-to-array-of-pointers.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	139 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	140 /// # Safety
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	141 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	142 /// `ptr_ptr` must be a valid pointer to an array of pointers,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	143 /// there must be at least `count` valid pointers in the array,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	144 /// and each pointer in that array must point to a valid `T`.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	145 #[deprecated = "use [`Self::iter_over`] instead, unless you really need this specific version"]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	146 #[allow(dead_code)]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	147 pub unsafe fn iter_over_linux<'a, Src>(
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	148 ptr_ptr: const const Src,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	149 count: usize,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	150 ) -> impl Iterator<Item = &'a T>
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	151 where
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	152 T: 'a,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	153 {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	154 Self::assert_size::<Src>();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	155 slice::from_raw_parts(ptr_ptr.cast::<&T>(), count)
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	156 .iter()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	157 .copied()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	158 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	159
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	160 /// Iterates over an X/SSO–style pointer-to-pointer-to-array.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	161 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	162 /// # Safety
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	163 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	164 /// You must pass a valid pointer to a valid pointer to an array,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	165 /// there must be at least `count` elements in the array,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	166 /// and each value in that array must be a valid `T`.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	167 #[deprecated = "use [`Self::iter_over`] instead, unless you really need this specific version"]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	168 #[allow(dead_code)]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	169 pub unsafe fn iter_over_xsso<'a, Src>(
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	170 ptr_ptr: const const Src,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	171 count: usize,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	172 ) -> impl Iterator<Item = &'a T>
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	173 where
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	174 T: 'a,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	175 {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	176 Self::assert_size::<Src>();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	177 slice::from_raw_parts(*ptr_ptr.cast(), count).iter()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	178 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	179
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	180 /// Iterates over a PAM message list appropriate to your system's impl.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	181 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	182 /// This selects the correct pointer/array structure to use for a message
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	183 /// that was given to you by your system.
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	184 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	185 /// # Safety
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	186 ///
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	187 /// `ptr_ptr` must point to a valid message list, there must be at least
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	188 /// `count` messages in the list, and all messages must be a valid `Src`.
134 6c1e1bdb4164 Use standard #[cfg] directives rather than custom proc macros. Paul Fisher <paul@pfish.zone> parents: 127 diff changeset	189 #[allow(deprecated)]
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	190 pub unsafe fn iter_over<'a, Src>(
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	191 ptr_ptr: const const Src,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	192 count: usize,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	193 ) -> impl Iterator<Item = &'a T>
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	194 where
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	195 T: 'a,
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	196 {
134 6c1e1bdb4164 Use standard #[cfg] directives rather than custom proc macros. Paul Fisher <paul@pfish.zone> parents: 127 diff changeset	197 #[cfg(pam_impl = "LinuxPam")]
6c1e1bdb4164 Use standard #[cfg] directives rather than custom proc macros. Paul Fisher <paul@pfish.zone> parents: 127 diff changeset	198 return Self::iter_over_linux(ptr_ptr, count);
6c1e1bdb4164 Use standard #[cfg] directives rather than custom proc macros. Paul Fisher <paul@pfish.zone> parents: 127 diff changeset	199 #[cfg(not(pam_impl = "LinuxPam"))]
6c1e1bdb4164 Use standard #[cfg] directives rather than custom proc macros. Paul Fisher <paul@pfish.zone> parents: 127 diff changeset	200 return Self::iter_over_xsso(ptr_ptr, count);
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	201 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	202
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	203 fn assert_size<That>() {
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	204 assert_eq!(
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	205 mem::size_of::<T>(),
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	206 mem::size_of::<That>(),
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	207 "type {t} is not the size of {that}",
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	208 t = any::type_name::<T>(),
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	209 that = any::type_name::<That>(),
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	210 );
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	211 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	212 }
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	213
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	214 /// Error returned when attempting to allocate a buffer that is too big.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	215 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	216 /// This is specifically used in [`OwnedBinaryPayload`] when you try to allocate
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	217 /// a message larger than 2<sup>32</sup> bytes.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	218 #[derive(Debug, PartialEq)]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	219 pub struct TooBigError {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	220 pub size: usize,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	221 pub max: usize,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	222 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	223
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	224 impl Error for TooBigError {}
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	225
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	226 impl fmt::Display for TooBigError {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	227 fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	228 write!(
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	229 f,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	230 "can't allocate a message of {size} bytes (max {max})",
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	231 size = self.size,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	232 max = self.max
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	233 )
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	234 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	235 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	236
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	237 /// A trait wrapping memory management.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	238 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	239 /// This is intended to allow you to bring your own allocator for
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	240 /// [`OwnedBinaryPayload`]s.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	241 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	242 /// For an implementation example, see the implementation of this trait
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	243 /// for [`Vec`].
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	244 #[allow(clippy::wrong_self_convention)]
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	245 pub trait Buffer {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	246 /// Allocates a buffer of `len` elements, filled with the default.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	247 fn allocate(len: usize) -> Self;
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	248
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	249 fn as_ptr(this: &Self) -> *const u8;
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	250
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	251 /// Returns a slice view of `size` elements of the given memory.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	252 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	253 /// # Safety
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	254 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	255 /// The caller must not request more elements than are allocated.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	256 unsafe fn as_mut_slice(this: &mut Self, len: usize) -> &mut [u8];
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	257
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	258 /// Consumes this ownership and returns a pointer to the start of the arena.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	259 fn into_ptr(this: Self) -> NonNull<u8>;
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	260
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	261 /// "Adopts" the memory at the given pointer, taking it under management.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	262 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	263 /// Running the operation:
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	264 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	265 /// ```
148 4b3a5095f68c Move libpam-sys helpers into their own library. Paul Fisher <paul@pfish.zone> parents: 143 diff changeset	266 /// # use libpam_sys_helpers::Buffer;
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	267 /// # fn test<T: Default, OwnerType: Buffer>(bytes: usize) {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	268 /// let owner = OwnerType::allocate(bytes);
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	269 /// let ptr = OwnerType::into_ptr(owner);
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	270 /// let owner = unsafe { OwnerType::from_ptr(ptr, bytes) };
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	271 /// # }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	272 /// ```
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	273 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	274 /// must be a no-op.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	275 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	276 /// # Safety
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	277 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	278 /// The pointer must be valid, and the caller must provide the exact size
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	279 /// of the given arena.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	280 unsafe fn from_ptr(ptr: NonNull<u8>, bytes: usize) -> Self;
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	281 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	282
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	283 impl Buffer for Vec<u8> {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	284 fn allocate(bytes: usize) -> Self {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	285 vec![0; bytes]
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	286 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	287
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	288 fn as_ptr(this: &Self) -> *const u8 {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	289 Vec::as_ptr(this)
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	290 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	291
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	292 unsafe fn as_mut_slice(this: &mut Self, bytes: usize) -> &mut [u8] {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	293 &mut this[..bytes]
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	294 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	295
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	296 fn into_ptr(this: Self) -> NonNull<u8> {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	297 let mut me = ManuallyDrop::new(this);
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	298 // SAFETY: a Vec is guaranteed to have a nonzero pointer.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	299 unsafe { NonNull::new_unchecked(me.as_mut_ptr()) }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	300 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	301
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	302 unsafe fn from_ptr(ptr: NonNull<u8>, bytes: usize) -> Self {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	303 Vec::from_raw_parts(ptr.as_ptr(), bytes, bytes)
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	304 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	305 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	306
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	307 /// The structure of the "binary message" payload for the `PAM_BINARY_PROMPT`
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	308 /// extension from Linux-PAM.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	309 pub struct BinaryPayload {
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	310 /// The total byte size of the message, including this header,
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	311 /// as u32 in network byte order (big endian).
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	312 pub total_bytes_u32be: [u8; 4],
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	313 /// A tag used to provide some kind of hint as to what the data is.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	314 /// Its meaning is undefined.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	315 pub data_type: u8,
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	316 /// Where the data itself would start, used as a marker to make this
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	317 /// not [`Unpin`] (since it is effectively an intrusive data structure
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	318 /// pointing to immediately after itself).
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	319 pub _marker: PhantomData<PhantomPinned>,
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	320 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	321
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	322 impl BinaryPayload {
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	323 /// The most data it's possible to put into a [`BinaryPayload`].
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	324 pub const MAX_SIZE: usize = (u32::MAX - 5) as usize;
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	325
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	326 /// Fills in the provided buffer with the given data.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	327 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	328 /// This uses [`copy_from_slice`](slice::copy_from_slice) internally,
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	329 /// so `buf` must be exactly 5 bytes longer than `data`, or this function
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	330 /// will panic.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	331 pub fn fill(buf: &mut [u8], data: &[u8], data_type: u8) {
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	332 let ptr: *mut Self = buf.as_mut_ptr().cast();
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	333 // SAFETY: We're given a slice, which always has a nonzero pointer.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	334 let me = unsafe { ptr.as_mut().unwrap_unchecked() };
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	335 me.total_bytes_u32be = u32::to_be_bytes(buf.len() as u32);
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	336 me.data_type = data_type;
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	337 buf[5..].copy_from_slice(data)
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	338 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	339
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	340 /// The total storage needed for the message, including header.
149 14708d9061dc Add safety section to BinaryPayload::total_bytes. Paul Fisher <paul@pfish.zone> parents: 148 diff changeset	341 ///
14708d9061dc Add safety section to BinaryPayload::total_bytes. Paul Fisher <paul@pfish.zone> parents: 148 diff changeset	342 /// # Safety
14708d9061dc Add safety section to BinaryPayload::total_bytes. Paul Fisher <paul@pfish.zone> parents: 148 diff changeset	343 ///
14708d9061dc Add safety section to BinaryPayload::total_bytes. Paul Fisher <paul@pfish.zone> parents: 148 diff changeset	344 /// The pointer must point to a valid `BinaryPayload`.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	345 pub unsafe fn total_bytes(this: *const Self) -> usize {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	346 let header = this.as_ref().unwrap_unchecked();
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	347 u32::from_be_bytes(header.total_bytes_u32be) as usize
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	348 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	349
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	350 /// Gets the total byte buffer of the BinaryMessage stored at the pointer.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	351 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	352 /// The returned data slice is borrowed from where the pointer points to.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	353 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	354 /// # Safety
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	355 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	356 /// - The pointer must point to a valid `BinaryPayload`.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	357 /// - The borrowed data must not outlive the pointer's validity.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	358 pub unsafe fn buffer_of<'a>(ptr: *const Self) -> &'a [u8] {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	359 slice::from_raw_parts(ptr.cast(), Self::total_bytes(ptr).max(5))
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	360 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	361
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	362 /// Gets the contents of the BinaryMessage stored at the given pointer.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	363 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	364 /// The returned data slice is borrowed from where the pointer points to.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	365 /// This is a cheap operation and doesn't do any copying.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	366 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	367 /// We don't take a `&self` reference here because accessing beyond
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	368 /// the range of the `Self` data (i.e., beyond the 5 bytes of `self`)
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	369 /// is undefined behavior. Instead, you have to pass a raw pointer
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	370 /// directly to the data.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	371 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	372 /// # Safety
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	373 ///
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	374 /// - The pointer must point to a valid `BinaryPayload`.
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	375 /// - The borrowed data must not outlive the pointer's validity.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	376 pub unsafe fn contents<'a>(ptr: *const Self) -> (&'a [u8], u8) {
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	377 let header: &Self = ptr.as_ref().unwrap_unchecked();
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	378 (&Self::buffer_of(ptr)[5..], header.data_type)
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	379 }
143 ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	380
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	381 /// Zeroes out the data of this payload.
143 ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	382 ///
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	383 /// # Safety
143 ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	384 ///
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	385 /// - The pointer must point to a valid `BinaryPayload`.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	386 /// - The binary payload must not be used in the future,
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	387 /// since its length metadata is gone and so its buffer is unknown.
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	388 pub unsafe fn zero(ptr: *mut Self) {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	389 let size = Self::total_bytes(ptr);
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	390 let ptr: *mut u8 = ptr.cast();
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	391 for x in 0..size {
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	392 ptr::write_volatile(ptr.byte_add(x), mem::zeroed())
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	393 }
118 39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	394 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	395 }
39760dfc9b3b Detect PAM library based only on system lib; rename minimal lib to XSso. Paul Fisher <paul@pfish.zone> parents: 117 diff changeset	396
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	397 /// A binary message owned by some storage.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	398 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	399 /// This is an owned, memory-managed version of [`BinaryPayload`].
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	400 /// The `O` type manages the memory where the payload lives.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	401 /// [`Vec<u8>`] is one such manager and can be used when ownership
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	402 /// of the data does not need to transit through PAM.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	403 #[derive(Debug)]
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	404 pub struct OwnedBinaryPayload<Owner: Buffer>(Owner);
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	405
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	406 impl<O: Buffer> OwnedBinaryPayload<O> {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	407 /// Allocates a new OwnedBinaryPayload.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	408 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	409 /// This will return a [`TooBigError`] if you try to allocate too much
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	410 /// (more than [`BinaryPayload::MAX_SIZE`]).
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	411 pub fn new(data: &[u8], type_: u8) -> Result<Self, TooBigError> {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	412 let total_len: u32 = (data.len() + 5).try_into().map_err(\|_\| TooBigError {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	413 size: data.len(),
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	414 max: BinaryPayload::MAX_SIZE,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	415 })?;
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	416 let total_len = total_len as usize;
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	417 let mut buf = O::allocate(total_len);
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	418 // SAFETY: We just allocated this exact size.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	419 BinaryPayload::fill(
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	420 unsafe { Buffer::as_mut_slice(&mut buf, total_len) },
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	421 data,
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	422 type_,
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	423 );
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	424 Ok(Self(buf))
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	425 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	426
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	427 /// The contents of the buffer.
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	428 pub fn contents(&self) -> (&[u8], u8) {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	429 unsafe { BinaryPayload::contents(self.as_ptr()) }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	430 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	431
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	432 /// The total bytes needed to store this, including the header.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	433 pub fn total_bytes(&self) -> usize {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	434 unsafe { BinaryPayload::buffer_of(Buffer::as_ptr(&self.0).cast()).len() }
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	435 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	436
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	437 /// Unwraps this into the raw storage backing it.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	438 pub fn into_inner(self) -> O {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	439 self.0
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	440 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	441
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	442 /// Gets a const pointer to the start of the message's buffer.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	443 pub fn as_ptr(&self) -> *const BinaryPayload {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	444 Buffer::as_ptr(&self.0).cast()
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	445 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	446
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	447 /// Consumes ownership of this message and converts it to a raw pointer
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	448 /// to the start of the message.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	449 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	450 /// To clean this up, you should eventually pass it into [`Self::from_ptr`]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	451 /// with the same `O` ownership type.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	452 pub fn into_ptr(self) -> NonNull<BinaryPayload> {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	453 Buffer::into_ptr(self.0).cast()
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	454 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	455
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	456 /// Takes ownership of the given pointer.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	457 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	458 /// # Safety
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	459 ///
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	460 /// You must provide a valid pointer, allocated by (or equivalent to one
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	461 /// allocated by) [`Self::new`]. For instance, passing a pointer allocated
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	462 /// by `malloc` to `OwnedBinaryPayload::<Vec<u8>>::from_ptr` is not allowed.
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	463 pub unsafe fn from_ptr(ptr: NonNull<BinaryPayload>) -> Self {
143 ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	464 Self(O::from_ptr(
ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	465 ptr.cast(),
ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	466 BinaryPayload::total_bytes(ptr.as_ptr()),
ebb71a412b58 Turn everything into OsString and Just Walk Out! for strings with nul. Paul Fisher <paul@pfish.zone> parents: 140 diff changeset	467 ))
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	468 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	469 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	470
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	471 #[cfg(test)]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	472 mod tests {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	473 use super::*;
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	474 use std::ptr;
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	475
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	476 type VecPayload = OwnedBinaryPayload<Vec<u8>>;
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	477
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	478 #[test]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	479 fn test_binary_payload() {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	480 let simple_message = &[0u8, 0, 0, 16, 0xff, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10];
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	481 let empty = &[0u8; 5];
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	482
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	483 assert_eq!((&[0u8, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10][..], 0xff), unsafe {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	484 BinaryPayload::contents(simple_message.as_ptr().cast())
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	485 });
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	486 assert_eq!((&[][..], 0x00), unsafe {
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	487 BinaryPayload::contents(empty.as_ptr().cast())
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	488 });
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	489 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	490
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	491 #[test]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	492 fn test_owned_binary_payload() {
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	493 let (data, typ) = (
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	494 &[0, 1, 1, 8, 9, 9, 9, 8, 8, 1, 9, 9, 9, 1, 1, 9, 7, 2, 5, 3][..],
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	495 112,
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	496 );
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	497 let payload = VecPayload::new(data, typ).unwrap();
33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	498 assert_eq!((data, typ), payload.contents());
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	499 let ptr = payload.into_ptr();
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	500 let payload = unsafe { VecPayload::from_ptr(ptr) };
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	501 assert_eq!((data, typ), payload.contents());
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	502 }
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	503
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	504 #[test]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	505 #[ignore]
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	506 fn test_owned_too_big() {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	507 let data = vec![0xFFu8; 0x1_0000_0001];
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	508 assert_eq!(
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	509 TooBigError {
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	510 max: 0xffff_fffa,
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	511 size: 0x1_0000_0001
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	512 },
139 33b9622ed6d2 Remove redundant memory management in nonstick::libpam; fix UB. Paul Fisher <paul@pfish.zone> parents: 136 diff changeset	513 VecPayload::new(&data, 5).unwrap_err()
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	514 )
49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	515 }
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	516
123 98a624cacd82 Get rid of all the warnings, and arrange attributes. Paul Fisher <paul@pfish.zone> parents: 119 diff changeset	517 #[cfg(debug_assertions)]
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	518 #[test]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	519 #[should_panic]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	520 fn test_new_wrong_size() {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	521 let bad_vec = vec![0; 19];
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	522 let msg = PtrPtrVec::new(bad_vec);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	523 let _ = msg.as_ptr::<u64>();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	524 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	525
123 98a624cacd82 Get rid of all the warnings, and arrange attributes. Paul Fisher <paul@pfish.zone> parents: 119 diff changeset	526 #[allow(deprecated)]
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	527 #[test]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	528 #[should_panic]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	529 fn test_iter_xsso_wrong_size() {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	530 unsafe {
127 c77846f3a979 GET CTEST WORKING. Paul Fisher <paul@pfish.zone> parents: 125 diff changeset	531 let _ = PtrPtrVec::<u8>::iter_over_xsso::<f64>(ptr::null(), 1);
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	532 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	533 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	534
123 98a624cacd82 Get rid of all the warnings, and arrange attributes. Paul Fisher <paul@pfish.zone> parents: 119 diff changeset	535 #[allow(deprecated)]
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	536 #[test]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	537 #[should_panic]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	538 fn test_iter_linux_wrong_size() {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	539 unsafe {
127 c77846f3a979 GET CTEST WORKING. Paul Fisher <paul@pfish.zone> parents: 125 diff changeset	540 let _ = PtrPtrVec::<u128>::iter_over_linux::<()>(ptr::null(), 1);
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	541 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	542 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	543
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	544 #[allow(deprecated)]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	545 #[test]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	546 fn test_right_size() {
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	547 let good_vec = vec![(1u64, 2u64), (3, 4), (5, 6)];
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	548 let ptr = good_vec.as_ptr();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	549 let msg = PtrPtrVec::new(good_vec);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	550 let msg_ref: const const (i64, i64) = msg.as_ptr();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	551 assert_eq!(unsafe { *msg_ref }, ptr.cast());
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	552
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	553 let linux_result: Vec<(i64, i64)> = unsafe { PtrPtrVec::iter_over_linux(msg_ref, 3) }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	554 .cloned()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	555 .collect();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	556 let xsso_result: Vec<(i64, i64)> = unsafe { PtrPtrVec::iter_over_xsso(msg_ref, 3) }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	557 .cloned()
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	558 .collect();
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	559 assert_eq!(vec![(1, 2), (3, 4), (5, 6)], linux_result);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	560 assert_eq!(vec![(1, 2), (3, 4), (5, 6)], xsso_result);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	561 drop(msg)
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	562 }
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	563
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	564 #[allow(deprecated)]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	565 #[test]
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	566 fn test_iter_ptr_ptr() {
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	567 // These boxes are larger than a single pointer because we want to
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	568 // make sure they're not accidentally allocated adjacently
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	569 // in such a way that it's compatible with X/SSO.
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	570 //
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	571 // a pointer to (&str, i32) can be treated as a pointer to (&str).
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	572 #[repr(C)]
158 d5b7b28d754e Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Paul Fisher <paul@pfish.zone> parents: 149 diff changeset	573 struct Pair(&'static str, i32);
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	574 let boxes = vec![
158 d5b7b28d754e Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Paul Fisher <paul@pfish.zone> parents: 149 diff changeset	575 Box::new(Pair("a", 1)),
d5b7b28d754e Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Paul Fisher <paul@pfish.zone> parents: 149 diff changeset	576 Box::new(Pair("b", 2)),
d5b7b28d754e Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Paul Fisher <paul@pfish.zone> parents: 149 diff changeset	577 Box::new(Pair("c", 3)),
d5b7b28d754e Add `__TARGET_DEFAULT__` PamImpl and set up for docsrs build. Paul Fisher <paul@pfish.zone> parents: 149 diff changeset	578 Box::new(Pair("D", 4)),
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	579 ];
add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	580 let ptr: const const &str = boxes.as_ptr().cast();
125 2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	581 let got: Vec<&str> = unsafe { PtrPtrVec::iter_over_linux(ptr, 4) }
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	582 .cloned()
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	583 .collect();
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	584 assert_eq!(vec!["a", "b", "c", "D"], got);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	585
140 add7228adb2f Neaten up some stuff in libpam-sys memory module. Paul Fisher <paul@pfish.zone> parents: 139 diff changeset	586 // On the other hand, we explicitly want these to be adjacent.
123 98a624cacd82 Get rid of all the warnings, and arrange attributes. Paul Fisher <paul@pfish.zone> parents: 119 diff changeset	587 let nums = [-1i8, 2, 3];
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	588 let ptr = nums.as_ptr();
125 2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	589 let got: Vec<u8> = unsafe { PtrPtrVec::iter_over_xsso(&ptr, 3) }
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	590 .cloned()
2b255c92417b Introduce base PAM functions; use the real X/SSO PAM header for tests. Paul Fisher <paul@pfish.zone> parents: 123 diff changeset	591 .collect();
119 476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	592 assert_eq!(vec![255, 2, 3], got);
476a22db8639 Add PtrPtrVec to make it easy to pass pointer-to-pointers to PAM. Paul Fisher <paul@pfish.zone> parents: 118 diff changeset	593 }
106 49d9e2b5c189 An irresponsible mix of implementing libpam-sys and other stuff. Paul Fisher <paul@pfish.zone> parents: diff changeset	594 }

Mercurial > crates > nonstick

annotate libpam-sys/libpam-sys-helpers/src/lib.rs @ 183:4f46681b3f54 default tip