Function std::fs::hard_link

1.0.0 · source ·
pub fn hard_link<P: AsRef<Path>, Q: AsRef<Path>>(
    original: P,
    link: Q
) -> Result<()>
Expand description

在文件系统上创建一个新的硬链接。

link 路径将是指向 original 路径的链接。请注意,系统通常要求这两个路径都位于同一文件系统上。

如果 original 命名符号链接,则是否遵循符号链接是特定于平台的。 在可能不遵循它的平台上,它不会被遵循,并且创建的硬链接指向符号链接本身。

特定于平台的行为

该函数目前对应于 Windows 上的 CreateHardLink 函数。 在大多数 Unix 系统上,它对应于没有标志的 linkat 函数。 在 Android、VxWorks 和 Redox 上,它对应于 link 函数。 在 MacOS 上,它使用 linkat 函数 (如果可用),但在 linkat 不可用的非常旧的系统上,link 在运行时被选择。

注意,这个 将来可能会改变

Errors

在以下情况下,此函数将返回错误,但不仅限于这些情况:

  • original 路径不是文件或不存在。

Examples

use std::fs;

fn main() -> std::io::Result<()> {
    fs::hard_link("a.txt", "b.txt")?; // 硬链接 a.txt 到 b.txt
    Ok(())
}
Run