diff --git a/src/compression/tar/tar-compress.md b/src/compression/tar/tar-compress.md index 25735a63..d2454343 100644 --- a/src/compression/tar/tar-compress.md +++ b/src/compression/tar/tar-compress.md @@ -6,7 +6,7 @@ Compress `/var/log` directory into `archive.tar.gz`. Creates a [`File`] wrapped in [`GzEncoder`] and [`tar::Builder`].
Adds contents of `/var/log` directory recursively into the archive -under `backup/logs`path with [`Builder::append_dir_all`]. +under `backup/logs` path with [`Builder::append_dir_all`]. [`GzEncoder`] is responsible for transparently compressing the data prior to writing it into `archive.tar.gz`. @@ -21,11 +21,35 @@ fn main() -> Result<(), std::io::Error> { let enc = GzEncoder::new(tar_gz, Compression::default()); let mut tar = tar::Builder::new(enc); tar.append_dir_all("backup/logs", "/var/log")?; + tar.finish()?; Ok(()) } ``` +To add the contents without renaming them, an empty string can be used as the first argument of [`Builder::append_dir_all`]: + +```rust,edition2018,no_run + +use std::fs::File; +use flate2::Compression; +use flate2::write::GzEncoder; + +fn main() -> Result<(), std::io::Error> { + let tar_gz = File::create("archive.tar.gz")?; + let enc = GzEncoder::new(tar_gz, Compression::default()); + let mut tar = tar::Builder::new(enc); + tar.append_dir_all("", "/var/log")?; + tar.finish()?; + Ok(()) +} +``` + +The default behavior of [`tar::Builder`] differs from the GNU `tar` utility's defaults [tar(1)], +notably [`tar::Builder::follow_symlinks(true)`] is the equivalent of `tar --dereference`. + +[tar(1)]: https://man7.org/linux/man-pages/man1/tar.1.html [`Builder::append_dir_all`]: https://docs.rs/tar/*/tar/struct.Builder.html#method.append_dir_all [`File`]: https://doc.rust-lang.org/std/fs/struct.File.html [`GzEncoder`]: https://docs.rs/flate2/*/flate2/write/struct.GzEncoder.html [`tar::Builder`]: https://docs.rs/tar/*/tar/struct.Builder.html +[`tar::Builder::follow_symlinks(true)`]: https://docs.rs/tar/latest/tar/struct.Builder.html#method.follow_symlinks