hex_erl_tar (hex_core v0.20.0)

-type add_opt() ::
          dereference | verbose |
          {chunks, pos_integer()} |
          {atime, non_neg_integer()} |
          {mtime, non_neg_integer()} |
          {ctime, non_neg_integer()} |
          {mode, non_neg_integer()} |
          {uid, non_neg_integer()} |
          {gid, non_neg_integer()}.

create_opt/0

-type create_opt() :: compressed | cooked | dereference | verbose.

extract_opt/0

-type extract_opt() ::
          {cwd, string()} |
          {files, [name_in_archive()]} |
          {chunks, pos_integer()} |
          {max_size, pos_integer() | infinity} |
          compressed | cooked | memory | keep_old_files | verbose.

file_op/0

-type file_op() ::
          fun((close, file:io_device()) -> ok | {error, term()}) |
          fun((position, {file:io_device(), file:location()}) -> {ok, integer()} | {error, term()}) |
          fun((read2, {file:io_device(), non_neg_integer()}) ->
                  {ok, string() | binary()} | eof | {error, term()}) |
          fun((write, {file:io_device(), iodata()}) -> ok | {error, term()}).

filelist/0

-type filelist() :: [file:filename() | {name_in_archive(), file:filename_all()}].

gid/0

-type gid() :: non_neg_integer().

mode/0

-type mode() :: non_neg_integer().

name_in_archive/0

-type name_in_archive() :: string().

open_type/0

-type open_type() :: file:filename_all() | {binary, binary()} | {file, file:io_device()}.

tar_descriptor/0

-opaque tar_descriptor()

tar_entry/0

-type tar_entry() ::
          {Name :: name_in_archive(),
           Type :: typeflag(),
           Size :: non_neg_integer(),
           MTime :: tar_time(),
           Mode :: mode(),
           Uid :: uid(),
           Gid :: gid()}.

tar_time/0

-type tar_time() :: non_neg_integer().

typeflag/0

-type typeflag() :: regular | link | symlink | char | block | directory | fifo | reserved | unknown.

uid/0

-type uid() :: non_neg_integer().

user_data/0

-type user_data() :: term().

Functions

add(TarDescriptor, Name, Options)

-spec add(TarDescriptor, Name, Options) -> ok | {error, term()}
             when
                 TarDescriptor :: tar_descriptor(),
                 Name :: name_in_archive() | {name_in_archive(), file:filename_all()},
                 Options :: [add_opt()].

add(TarDescriptor, Filename, NameInArchive, Options)

-spec add(TarDescriptor, Filename, NameInArchive, Options) -> ok | {error, term()}
             when
                 TarDescriptor :: tar_descriptor(),
                 Filename :: file:filename_all() | {symlink, string()} | directory,
                 NameInArchive :: name_in_archive(),
                 Options :: [add_opt()].

close(TarDescriptor)

-spec close(TarDescriptor :: tar_descriptor()) -> ok | {error, term()}.

create(Name, FileList)

-spec create(file:filename_all(), filelist()) -> ok | {error, {string(), term()}}.

create(Name, FileList, Options)

-spec create(file:filename_all(), filelist(), [create_opt()]) ->
                ok | {error, term()} | {error, {string(), term()}}.

extract(Open)

-spec extract(Open :: open_type()) -> ok | {error, term()}.

extract(Open, Opts)

-spec extract(Open :: open_type(), []) -> ok | {error, term()};
             (Open :: open_type(), [extract_opt(), ...]) ->
                 ok | {ok, [{string(), binary()}]} | {error, term()}.

-spec format_error(term()) -> string().

init(UserData, AccessMode, Fun)

-spec init(UserData :: user_data(), write | read, file_op()) -> {ok, tar_descriptor()} | {error, badarg}.

open(Open, Mode)

-spec open(Open :: open_type(), [write | compressed | cooked]) ->
              {ok, tar_descriptor()} | {error, term()}.

t(Name)

-spec t(file:filename()) -> ok | {error, term()}.

table(Open)

-spec table(Open :: open_type()) -> {ok, [name_in_archive()]} | {error, term()}.

table(Open, Opts)

-spec table(Open :: open_type(), [compressed | verbose | cooked]) ->
               {ok, [name_in_archive() | tar_entry()]} | {error, term()}.

tt(Name)

-spec tt(open_type()) -> ok | {error, term()}.