Function std::fs::hard_link

pub fn hard_link<P: AsRef<Path>, Q: AsRef<Path>>(src: P, dst: Q) -> Result<()>

Creates a new hard link on the filesystem.

The dst path will be a link pointing to the src path. Note that systems often require these two paths to both be located on the same filesystem.

Platform-specific behavior

This function currently corresponds to the link function on Unix and the CreateHardLink function on Windows. Note that, this may change in the future.


This function will return an error in the following situations, but is not limited to just these cases:

  • The src path is not a file or doesn't exist.


use std::fs;

fn main() -> std::io::Result<()> {
    fs::hard_link("a.txt", "b.txt")?; // Hard link a.txt to b.txt

© 2010 The Rust Project Developers
Licensed under the Apache License, Version 2.0 or the MIT license, at your option.