fix: unaligned read panic on macos

Author: anonkey

changelog/2311.fixed.md

@@ -0,0 +1 @@
+Fixed `::unistd::Group::members` crash on misaligned read by read_unaligned use

src/unistd.rs

@@ -3569,13 +3569,41 @@ impl Group {
     ///
     /// # Examples
     ///
+    // Disable this test on all OS except BSD as wheel group may not exist.
+    #[cfg_attr(not(bsd), doc = " ```no_run")]
+    #[cfg_attr(bsd, doc = " ```")]
+    /// use nix::unistd::Group;
+    /// // Returns an Result<Option<Group>>, thus the double unwrap.
+    /// let group = Group::from_name("wheel").unwrap().unwrap();
+    /// assert!(group.name == "wheel");
+    /// let group_id = group.gid;
+    /// let group = Group::from_gid(group_id).unwrap().unwrap();
+    /// assert_eq!(group.gid, group_id);
+    /// assert_eq!(group.name, "wheel");
+    /// ```
+    // Disable this test on all OS except Apple as everyone group may not exist.
+    #[cfg_attr(not(apple_targets), doc = " ```no_run")]
+    #[cfg_attr(apple_targets, doc = " ```")]
+    /// use nix::unistd::Group;
+    /// // Returns an Result<Option<Group>>, thus the double unwrap.
+    /// let group = Group::from_name("everyone").unwrap().unwrap();
+    /// assert!(group.name == "everyone");
+    /// let group_id = group.gid;
+    /// let group = Group::from_gid(group_id).unwrap().unwrap();
+    /// assert_eq!(group.gid, group_id);
+    /// assert_eq!(group.name, "everyone");
+    /// ```
     // Disable this test on all OS except Linux as root group may not exist.
     #[cfg_attr(not(target_os = "linux"), doc = " ```no_run")]
     #[cfg_attr(target_os = "linux", doc = " ```")]
     /// use nix::unistd::Group;
     /// // Returns an Result<Option<Group>>, thus the double unwrap.
-    /// let res = Group::from_name("root").unwrap().unwrap();
-    /// assert!(res.name == "root");
+    /// let group = Group::from_name("root").unwrap().unwrap();
+    /// assert!(group.name == "root");
+    /// let group_id = group.gid;
+    /// let group = Group::from_gid(group_id).unwrap().unwrap();
+    /// assert_eq!(group.gid, group_id);
+    /// assert_eq!(group.name, "root");
     /// ```
     pub fn from_name(name: &str) -> Result<Option<Self>> {
         let name = match CString::new(name) {