package tar
Install
Dune Dependency
Authors
Maintainers
Sources
sha256=06fd25f419fb65648cef70e363beead722a95f250165f4629b3f7ee283c1b85b
sha512=90e1d667cbf31ee3424280b0d6fddf5bcf51228b29eee48d45e81615706c25f3ea64fd403138875755ddeec44ae96be34d7852a1840fc7eabf88b3a6f3dd46dd
Description
tar is a simple library to read and write tar files with an emphasis on streaming.
This is pure OCaml code, no C bindings.
README
tar — decode and encode tar files
tar is a simple library to read and write tar files with an emphasis on streaming.
This is pure OCaml code, no C bindings.
Installation
tar
can be installed with opam
:
opam install tar
opam install tar-unix # for use in Unix/Lwt
opam install tar-mirage # for use in MirageOS
If you don't use opam
consult the tar.opam
file for build instructions.
Example toplevel session
In utop:
utop # #require "tar";;
utop # #require "tar-unix";;
utop # let f = Lwt_unix.openfile "/tmp/foo.tar" [ Unix.O_RDONLY ] 0;;
val f : Lwt_unix.file_descr = <abstr>
utop # Lwt.bind f Tar_lwt_unix.Archive.list;;
[{Tar.Header.file_name = "_build/lib/tar.mli.depends";
Tar.Header.file_mode = 420; Tar.Header.user_id = 1000;
Tar.Header.group_id = 1000; Tar.Header.file_size = 21L;
Tar.Header.mod_time = 1381080315L;
Tar.Header.link_indicator = Tar.Header.Link.Normal;
Tar.Header.link_name = ""};
{Tar.Header.file_name = "_build/lib/tar_unix.mli.depends";
Tar.Header.file_mode = 420; Tar.Header.user_id = 1000;
Tar.Header.group_id = 1000; Tar.Header.file_size = 27L;
Tar.Header.mod_time = 1381080318L;
Tar.Header.link_indicator = Tar.Header.Link.Normal;
Tar.Header.link_name = ""};
{Tar.Header.file_name = "_build/lib/tar.mllib";
Tar.Header.file_mode = ...; Tar.Header.user_id = ...;
Tar.Header.group_id = ...; Tar.Header.file_size = ...;
Tar.Header.mod_time = ...; Tar.Header.link_indicator = ...;
Tar.Header.link_name = ...};
...]
Compressed tarball
The distribution gives a small implementation to create a tarball, a compressed archive. The software allows to list the contents of a given tarball. The compression is done with decompress. You can look at the project documentation for more information on how to compress.
Alternatively, it is possible to use the Tar_gz
module which offers the same interface as Tar
with compression.
Example users
This library is used by
Documentation
The documentation and API reference is automatically generated by odoc
from the interfaces. It can be consulted online.
Dependencies (5)
-
decompress
>= "1.5.1"
-
cstruct
>= "6.0.0"
-
ocaml
>= "4.08.0"
- camlp-streams
-
dune
>= "2.9"
Dev Dependencies (1)
-
odoc
with-doc
Used by (6)
- octez-shell-libs
-
octez-smart-rollup-node-lib
>= "19.0"
-
tar-mirage
= "2.5.0"
-
tar-unix
< "0.9.0" | = "2.5.0"
-
tezos-store
>= "13.0"
-
vpnkit
>= "0.1.1"
Conflicts
None