SHTOOL-TARBALL.TMP(1) GNU Portable Shell Tool SHTOOL-TARBALL.TMP(1) NAME shtool tarball - GNU shtool command for rolling standardized tarballs SYNOPSIS shtool tarball [-t|--trace] [-v|--verbose] [-o|--output tarball] [-c|--com- press prog] [-d|--directory directory] [-u|--user user] [-g|--group group] [-e|--exclude pattern] path [path ...] DESCRIPTION This command is for rolling input files under path into a distribution tar- balls which can be extracted by tar(1). The four important aspects of good open source software tarballs are: (1) unpack into a single top-level directory, (2) top-level directory corre- sponds to the tarball filename, (3) tarball files should be sorted and (4) arbitrary names for file owner and group. OPTIONS The following command line options are available. -v, --verbose Display some processing information. -t, --trace Enable the output of the essential shell commands which are executed. -o, --output tarball Output tarball to file tarball. -c, --compress prog Pipe resulting tarball through compression program prog. -d, --directory directory Sets the top-level directory into which the tarball unpacks. By de- fault it is tarball without the trailing ".tar.*" extension. -u, --user user The user (owner) of files and directories in the tarball to user. -g, --group group The group of files and directories in the tarball to group. -e, --exclude pattern Exclude files and directories matching comma-separated list of regex pattern from the tarball. Directories are expanded before the filtering takes place. The default filter pattern is ""CVS,\\.cvsig- nore,\\.svn,\\.[oa]\$"". EXAMPLE # Makefile.in dist: ... V=`shtool version -d short ...`; \ shtool tarball -o foobar-$$V.tar.gz -c 'gzip -9' \ -u bar -g gnu -e 'CVS,\.cvsignore' . HISTORY The GNU shtool tarball command was originally written by Ralf S. En- gelschall <rse@engelschall.com> in 1999 for GNU shtool. SEE ALSO shtool(1), tar(1), compress(1). 18-Jul-2008 shtool 2.0.8 SHTOOL-TARBALL.TMP(1)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLE | HISTORY | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=shtool-tarball&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>