1
0
Fork 0
mirror of https://github.com/tldr-pages/tldr.git synced 2025-07-23 00:35:33 +02:00

atool: move to common and add examples (#16426)

Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
This commit is contained in:
Onni Hakala 2025-05-24 07:51:59 +02:00 committed by GitHub
parent e9a31096f7
commit a23d41742e
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 37 additions and 20 deletions

37
pages/common/atool.md Normal file
View file

@ -0,0 +1,37 @@
# atool
> A script for managing file archives of various types.
> `atool` uses external archiver programs but provides a consistent command-line interface for listing, extracting, creating, and managing archives.
> More information: <https://manned.org/atool>.
- List files in an archive:
`atool {{[-l|--list]}} {{path/to/archive.zip}}`
- Extract an archive (safely creates a subdirectory if needed):
`atool {{[-x|--extract]}} {{archive.tar.gz}}`
- Extract an archive to a specific directory:
`atool {{[-X|--extract-to]}} {{path/to/output_directory}} {{archive.rar}}`
- Display a specific file's content from an archive to standard output (like `cat`):
`atool {{[-c|--cat]}} {{archive.tar}} {{path/to/file_in_archive.txt}}`
- Create a new archive from specified files and/or directories:
`atool {{[-a|--add]}} {{new_archive.zip}} {{path/to/file1 path/to/file2 ...}}`
- List files in an archive and send the output through a pager:
`atool {{[-l|--list]}} {{[-p|--pager]}} {{large_archive.tar.bz2}}`
- Extract multiple archives at once (each to its own subdirectory if needed):
`atool {{[-x|--extract]}} {{[-e|--each]}} {{archive1.zip}} {{archive2.tar.gz}} {{*.rar}}`
- Repack an archive from one format to another (e.g., .tar.gz to .tar.7z):
`atool {{[-r|--repack]}} {{old_archive.tar.gz}} {{new_archive.tar.7z}}`

View file

@ -1,20 +0,0 @@
# atool
> Manage archives of various formats.
> More information: <https://manned.org/atool>.
- List files in a Zip archive:
`atool {{[-l|--list]}} {{path/to/archive.zip}}`
- Unpack a tar.gz archive into a new subdirectory (or current directory if it contains only one file):
`atool {{[-x|--extract]}} {{path/to/archive.tar.gz}}`
- Create a new 7z archive with two files:
`atool {{[-a|--add]}} {{path/to/archive.7z}} {{path/to/file1 path/to/file2 ...}}`
- Extract all Zip and rar archives in the current directory:
`atool {{[-e|--each]}} {{[-E|--extract]}} {{*.zip *.rar}}`