STRAR(1)

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.