junction-verbatim

⚠️ DEPRECATED - Use Upstream junction Crate Instead

This crate is no longer needed. The verbatim prefix fix has been merged and published in the upstream junction crate.

Migration Instructions

Replace junction-verbatim with junction in your Cargo.toml:

# Old:
# junction-verbatim = "1.3.0"

# New:
junction = "1.4.1"  # or latest version

The API is identical, so no code changes are required—just update your dependency and imports:

// Change from:
// use junction_verbatim::{create, delete, exists, get_target};

// To:
use junction::{create, delete, exists, get_target};

About This Fork (Historical)

This was a fork of tesuji/junction with a fix for verbatim prefix handling.

Library for working with NTFS junctions.

As opposed to symlinks, junction does not require administrator privileges during creation. (However starting with Windows 10 Insiders build 14972, symlinks can be created without needing to elevate the console as administrator)^1.

Quoted from Computer Hope:

A junction, also called an NTFS junction point, is a feature of the NTFS file system. It is pointer to a directory on the local volume, similar to a symlink. It can be accessed through the Windows GUI in addition to the Windows command line. Junction points were first introduced with Windows 2000 and NTFS 3.0, and are supported in all subsequent versions of Windows.

What Was Fixed in This Fork

This fork fixed an issue where junction::create() would silently fail when passed paths containing the Windows verbatim prefix (\\?\), which are commonly produced by std::fs::canonicalize() on Windows. See issue #30 for details.

This fix is now available in the upstream crate.

Minimal Supported Rust versions

Specified in the rust-version field in Cargo.toml.

All relevant references

• https://www.codeproject.com/Articles/194/Windows-2000-Junction-Points#The_Solution
• https://www.codeproject.com/Articles/15633/Manipulating-NTFS-Junction-Points-in-NET
• https://web.archive.org/web/20230411010804/http://www.flexhex.com/docs/articles/hard-links.phtml
• https://googleprojectzero.blogspot.com/2016/02/the-definitive-guide-on-win32-to-nt.html
• https://github.com/googleprojectzero/symboliclink-testing-tools/blob/master/DumpReparsePoint/DumpReparsePoint.cpp
• https://github.com/googleprojectzero/symboliclink-testing-tools/blob/master/CommonUtils/ReparsePoint.cpp
• https://github.com/containerd/continuity/blob/master/syscallx/syscall_windows.go

License

All the code in this repository is released under the MIT License, for more information, please read COPYRIGHT file.