#file #inode #read-file #index #system #unique-id

bin+lib file-id

Utility for reading inode numbers (Linux, MacOS) and file IDs (Windows)

4 releases

0.2.2 Oct 25, 2024
0.2.1 Aug 21, 2023
0.2.0 Aug 20, 2023
0.1.0 May 17, 2023

#522 in Filesystem

Download history 42286/week @ 2024-07-27 39640/week @ 2024-08-03 36284/week @ 2024-08-10 37527/week @ 2024-08-17 39513/week @ 2024-08-24 37414/week @ 2024-08-31 35588/week @ 2024-09-07 35330/week @ 2024-09-14 41652/week @ 2024-09-21 37146/week @ 2024-09-28 42526/week @ 2024-10-05 41027/week @ 2024-10-12 47370/week @ 2024-10-19 40665/week @ 2024-10-26 50161/week @ 2024-11-02 42220/week @ 2024-11-09

188,824 downloads per month
Used in 132 crates (4 directly)

MIT/Apache

13KB
171 lines

File Id

» Docs

A utility to read file IDs.

Modern file systems assign a unique ID to each file. On Linux and MacOS it is called an inode number, on Windows it is called file index. Together with the device id, a file can be identified uniquely on a device at a given time.

Keep in mind though, that IDs may be re-used at some point.

Example

let file_id = file_id::get_file_id(path).unwrap();

println!("{file_id:?}");

Features

  • serde for serde support, off by default

lib.rs:

Utility for reading inode numbers (Linux, macOS) and file ids (Windows) that uniquely identify a file on a single computer.

Modern file systems assign a unique ID to each file. On Linux and macOS it is called an inode number, on Windows it is called a file id or file index. Together with the device id (Linux, macOS) or the volume serial number (Windows), a file or directory can be uniquely identified on a single computer at a given time.

Keep in mind though, that IDs may be re-used at some point.

Example

let file = tempfile::NamedTempFile::new().unwrap();

let file_id = file_id::get_file_id(file.path()).unwrap();
println!("{file_id:?}");

Example (Windows Only)

let file = tempfile::NamedTempFile::new().unwrap();

let file_id = file_id::get_low_res_file_id(file.path()).unwrap();
println!("{file_id:?}");

let file_id = file_id::get_high_res_file_id(file.path()).unwrap();
println!("{file_id:?}");

Dependencies

~0–7.5MB
~59K SLoC