NAME

strar - StreamArchive handler

SYNOPSIS

strar  command [options] file1 ... filen

DESCRIPTION

strar is a simple archiver with tar like command like syntax that handles StreamArchives.

strar archives and extracts multiple files to and from a single file called a StreamArchive. A StreamArchive is usually used in network communication, but it can be any file.

Strar's actions are controlled by the mandatory command flags from the list below. The way strar acts may be modified by additional options.

Note that unpacking StramArchives may be a security risk because strar may overwrite existing files. See SECURITY NOTES for more information.

COMMAND

strar is compatible to the command line syntax of a typical POSIX command and for this reason expects commands and options to start with a single dash (-). In this case, commands and options may be specified separately, all boolean or increment type options may be specified either separately or combined.

-c

Create a new StreamArchive and write named files into it. Writing starts at the beginning of the Streamarchive. See -v option for information on how to increase verbosity while the archive is written.

-t

Table of contents. List the contents of the StreamArchive. If the -v flag is used, the listing is similar to the format of ls -l output.

-x

Extract files from the StreamArchive. If no filename argument or pattern is specified, the entire content of the StreamArchive is restored.

Exactly one of the commands above must be specified.

OPTIONS

-help

Print a summary of the options for strar(1).

-basemeta

Only add basic meta data: path, mode, size, filetype.

-nometa

Only add minimal meta data: path, size. In this mode, only plain files may occur in the archive.

-v

Increment verbose level by one. This normally results in more output during operation. See also in the description for the -t flag. Normally, strar does its work silently. If the verbose level is 2 or more and strar is in create or update mode, strar will produce a listing to the format of the ls -l output.

-version

Print version information and exit.

SEE ALSO

star(1), spax(1), suntar(1), scpio(1), tar(1), cpio(1), pax(1), rcp(1), mt(1), rmt(1), match(1), dd(1), sdd(1), rsh(1), ssh(1), star(5), streamarchive(5), rcmd(3).

SECURITY NOTES

If you unpack a StramArchive in a non empty directory, any file in that directory may be overwritten. If the archive contains symbolic links or hard links, strar may even overwrite files outside the current directory.

LIMITATIONS

If strar is running on a large file aware platform, strar is able to handle files of arbitrary size.

BUGS

None currently known.

Mail bugs and suggestions to schilytools@mlists.in-berlin.de or open a ticket at https://codeberg.org/schilytools/schilytools/issues.

The mailing list archive may be found at:

https://mlists.in-berlin.de/mailman/listinfo/schilytools-mlists.in-berlin.de.

HISTORY

strar was initially written by Joerg Schilling in 2017.

AUTHORS

Joerg Schilling and the schilytools project authors.

SOURCE DOWNLOAD

The source code for strar is included in the schilytools project and may be retrieved from the schilytools project at Codeberg at

https://codeberg.org/schilytools/schilytools.

The download directory is

https://codeberg.org/schilytools/schilytools/releases.