---
name: "gbp-pristine-tar"
section: "1"
platform: "linux"
package: "git-buildpackage"
version: "0.9.38"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/gbp-pristine-tar"
---

# gbp-pristine-tar(1)

Manage pristine-tar commits in a git repository

## NAME

gbp-pristine-tar - Manage pristine-tar commits in a git repository

## SYNOPSIS

FC**gbp pristine-tar**F\[0\]  \[FC**--version**F\[0\]\] \[FC**--help**F\[0\]\] \[FC**--verbose**F\[0\]\] \[FC**--color=**F\[0\]\[auto\|on\|off\]\] \[FC**--color-scheme=**F\[0\] *COLOR\_SCHEME*\] \[FC**--upstream-tag=**F\[0\] *tag-format*\] \[FC**--upstream-signatures=**F\[0\]\[auto\|on\|off\]\] \[FC**--component=**F\[0\] *component*\]... FC**commit**F\[0\] *filename*

## DESCRIPTION

**gbp pristine-tar** adds the pristine-tar commit for a given upstream tarball to a Git repository. This command is typically not invoked manually, as creating new pristine-tar commits is done automatically by e.g. **gbp import-orig**. This command may howeer be useful if a original tarball has been already imported and the pristine-tar commits should be added at a later time or if you're tracking upstream git and want to create pristine-tar commits nevertheless.

## OPTIONS

- FC**--version**F\[0\]

  Print version of the program, i.e. version of the git-buildpackage suite

- FC**-v**F\[0\], FC**--verbose**F\[0\]

  Verbose execution

- FC**-h**F\[0\], FC**--help**F\[0\]

  Print help and exit

- FC**--color=**F\[0\]\[auto\|on\|off\]

  Whether to use colored output.

- FC**--color-scheme=**F\[0\]*COLOR\_SCHEME*

  Colors to use in output (when color is enabled). The format for COLOR\_SCHEME is '\<debug\>:\<info\>:\<warning\>:\<error\>'. Numerical values and color names are accepted, empty fields imply the default color. For example, FC**--git-color-scheme=**F\[0\]FC'cyan:34::'F\[0\] would show debug messages in cyan, info messages in blue and other messages in default (i.e. warning and error messages in red).

- FC**--upstream-tag=**F\[0\]*tag-format*

  use this tag format when tagging upstream versions, default is *upstream/%(version)s*

- FC**--upstream-signatures=**F\[0\]\[auto\|on\|off\]

  Whether upstream signatures should be imported as well. *off* turns this off completely while *on* always tries to import a signature (which can be useful if you want to fail if e.g. **uscan** did not fetch a signature). The default *auto* means to import a signature file if present but do nothing otherwise.

- FC**--component=**F\[0\]*COMPONENT*

  When creating the pristine-tar commits also look for an additional tarball with component name *COMPONENT*. E.g. in FC*hello-debhelper\_1.0.orig-foo.tar.gz*F\[0\] the component name would be *foo*. The additional tarball is expected to be in the same directory than the upstream tarball and to use the same compression type. This option can be given multiple times to add multiple additional tarballs.

  Using additional original tarballs is a feature of the 3.0 (quilt) source format. See the **dpkg-source** manpage for details. This is currently considered an experimental feature and might change incompatibly.

## EXAMPLES

Add pristine-tar commits for an upstream tarball:

```
FC
      gbp pristine-tar commit ../upstream-tarball-0.1.tar.gzF[0]
```

Same as above with an additional tarball FC*../upstream-tarball-foo-0.1.tar.gz:*F\[0\]

```
FC
      gbp pristine-tar --component-tarball=foo commit ../upstream-tarball-0.1.tar.gzF[0]
```

## CONFIGURATION FILES

Several FC*gbp.conf*F\[0\] files are parsed  to set defaults for the above command-line arguments. See the [**gbp.conf**(5)](/gbp.conf/5.md) manpage for details.

## SEE ALSO

[**gbp-import-orig**(1)](/gbp-import-orig/1.md), [**gbp.conf**(5)](/gbp.conf/5.md), [**debuild**(1)](/debuild/1.md), [**git**(1)](/git/1.md), [**pristine-tar**(1)](/pristine-tar/1.md),\
        The Git-Buildpackage Manual ⟨file:///usr/share/doc/git-buildpackage/manual-html/index.html⟩

## AUTHOR

Guido Günther \<FCagx@sigxcpu.orgF\[0\]\>