package tar-unix

  1. Overview
  2. Docs
Decode and encode tar format files from Unix

Install

Dune Dependency

Authors

Maintainers

Sources

tar-2.2.0.tbz
sha256=c28647b0491a2e95c315b7c47b2e8ff43e9731375e9945c813a7c6cc866d7d63
sha512=ac1ef2d86fd4cd55fabf8ce796bd08b44108748a71d46872a22f2abb0e8cb8e58e8eef4935adfe2ab3a831c3ad5633065ce4be46f72c565e426699a52d6a3994

Description

tar is a simple library to read and write tar files with an emphasis on streaming. This library provides a Unix or Windows compatible interface.

Tags

org:xapi-project org:mirage

Published: 20 Oct 2022

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][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

  • xapi to read and write VM images

Documentation

The documentation and API reference is automatically generated by ocamldoc from the interfaces. It can be consulted online.

Dependencies (6)

  1. tar = version
  2. lwt
  3. cstruct-lwt
  4. cstruct >= "6.0.0"
  5. ocaml >= "4.03.0"
  6. dune >= "2.9"

Dev Dependencies (1)

  1. odoc with-doc

Used by (5)

  1. obuilder < "0.6.0"
  2. octez-shell-libs
  3. octez-smart-rollup-node-lib >= "19.0"
  4. tar-mirage >= "1.0.0" & < "2.0.0" | = "2.2.0"
  5. tezos-store >= "16.0"

Conflicts

None

OCaml

Innovation. Community. Security.