---
name: "shape_tar"
section: "1"
platform: "linux"
package: "shapetools"
version: "1.4pl6-15+b1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/shape_tar"
---

# shape\_tar(1)

shapeTools RMS bundle up subsystem in a tar or shar archive

## NAME

shape\_tar - shapeTools RMS bundle up subsystem in a tar or shar archive

## SYNOPSIS

**shape tar	\[VERSIONS=\<version\_selection\_rule\>\] \[ARCHIVE=\<filename\>\]**

**shape shar	\[VERSIONS=\<version\_selection\_rule\>\] \[ARCHIVE=\<filename\>\]**

## DESCRIPTION

*Shape tar* and *shape shar* create a tar or a shar archive containing all source components of the current node in the system tree. All source components listed in the *COMPONENTS* macro in the Makefile and the release identification file (*VERSIONFILE*) are written to the archive.  Components of subsystems are *not* included in the archive file.

The *VERSIONS* macro may be set to specify a version selection rule to be active during archive file creation. Default is *most\_recent*, selecting the most recent version of each component. See [shape\_stdrul(7)](/shape_stdrul/7.md) or the $(SHAPELIBPATH)/stdrules for other possible settings. You may also use self defined version selection rules as VERSIONS.

*ARCHIVE* is the base name of the file where the output shall be written to. Default is *$(SUBSYSTEMNAME)*. The output file gets the filename extension *.tar* (resp. *.shar*). When ARCHIVE=- is given, data will be written to standard output.

## SEE ALSO

[shape\_RMS(1)](/shape_RMS/1.md), [shape\_stdrul(7)](/shape_stdrul/7.md)

## FILES

$(SUBSYSTEMNAME).tar $(SUBSYSTEMNAME).shar