Auto merge of #13845 - thiblahute:zfs_macos_hard_link, r=weihanglo

Workaround copying file returning EAGAIN on ZFS on mac OS

### What does this PR try to resolve?

Fixes #13838

Trying to build simple hello world fail when on zfs file system on macOS fails while trying to copy files around.

This PR makes cargo fallback to using hard_link when that happens, retrying can lead to very long wait before copying works (up to 4secs in my tests) while hard_linking works straight away.

crates/cargo-util/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "cargo-util"
-version = "0.2.12"
+version = "0.2.13"
 rust-version = "1.77"  # MSRV:1
 edition.workspace = true
 license.workspace = true

crates/cargo-util/src/paths.rs

@@ -585,7 +585,23 @@ fn _link_or_copy(src: &Path, dst: &Path) -> Result<()> {
             // Note that: fs::copy on macos is using CopyOnWrite (syscall fclonefileat) which should be
             // as fast as hardlinking.
             // See https://github.com/rust-lang/cargo/issues/10060 for the details
-            fs::copy(src, dst).map(|_| ())
+            fs::copy(src, dst).map_or_else(
+                |e| {
+                    if e.raw_os_error()
+                        .map_or(false, |os_err| os_err == 35 /* libc::EAGAIN */)
+                    {
+                        tracing::info!("copy failed {e:?}. falling back to fs::hard_link");
+
+                        // Working around an issue copying too fast with zfs (probably related to
+                        // https://github.com/openzfsonosx/zfs/issues/809)
+                        // See https://github.com/rust-lang/cargo/issues/13838
+                        fs::hard_link(src, dst)
+                    } else {
+                        Err(e)
+                    }
+                },
+                |_| Ok(()),
+            )
         } else {
             fs::hard_link(src, dst)
         }