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

# gbp-export-orig(1)

Recreate upstream tarballs from a Git repository

## NAME

gbp-export-orig - Recreate upstream tarballs from a Git repository

## SYNOPSIS

FC**gbp export-orig**F\[0\]  \[FC**--verbose**F\[0\]\] \[FC**--color=**F\[0\]\[auto\|on\|off\]\] \[FC**--color-scheme**F\[0\]= *COLOR\_SCHEME*\] \[FC**--upstream-branch=**F\[0\] *BRANCH\_NAME*\] \[FC**--\[no-\]submodules**F\[0\]\] \[FC**--upstream-tag=**F\[0\] *tag-format*\] \[FC**--upstream-tree=**F\[0\] *\[TAG\|BRANCH\|TREEISH\]*\] \[FC**--tarball-dir=**F\[0\] *DIRECTORY*\] \[FC**--force-create**F\[0\]\] \[FC**--compression=**F\[0\] *TYPE*\] \[FC**--compression-level=**F\[0\] *LEVEL*\] \[FC**--component=**F\[0\] *component*\]... \[FC**--\[no-\]pristine-tar**F\[0\]\] \[FC**--\[no-\]pristine-tar-commit**F\[0\]\] \[FC**--upstream-signatures=**F\[0\]\[auto\|on\|off\]\]

## DESCRIPTION

**gbp export-orig** is used to export upstream tarballs from a Git repository. Usually upstream tarballs are created by **gbp buildpackage** when needed but if you don't want to perform a build you can use this command.

## OPTIONS

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

  verbose execution

- 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 --color-scheme='cyan:34::' 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-branch**F\[0\]=*BRANCH\_NAME*

  Branch to build the orig tarball from if FC**--upstream-tree**F\[0\] is set to *BRANCH*. Default is *upstream*.

- FC**--\[no-\]submodules**F\[0\]

  Include git submodules in the orig tarball.

- FC**--upstream-tag=**F\[0\]*TAG-FORMAT*

  Use this tag format when looking for tags of upstream versions, default is *upstream/%(version)s*.

- FC**--force-create**F\[0\]

  Force creation of an orig tarball (overwriting a pre-existing one if present).

- FC**--upstream-tree=**F\[0\]*\[BRANCH\|TAG\|TREEISH\]*

  How to find the upstream sources used to generate the tarball. *TAG* (the default) looks at a tag corresponding to the version in the changelog. *BRANCH* looks at the upstream branch given via the FC**--upstream-branch**F\[0\] option.

  Other values are interpreted as treeishs.

  This doesn't have any effect if FC**--pristine-tar**F\[0\] is being used.

- FC**--tarball-dir=**F\[0\]*DIRECTORY*

  Search for original tarballs in *DIRECTORY* instead of generating them. *DIRECTORY* can contain a version format substitution pattern, eg: *foo-%(version)s*.

- FC**--compression=**F\[0\]*TYPE*

  Specifies the upstream tarball compression type. This will be used to locate and build the upstream tarball if necessary. The default is *auto* which derives the compression type from the pristine-tar branch if available and falls back to gzip otherwise. Other options are *gzip*, *bzip2*, *lzma* and *xz*.

- FC**--compression-level=**F\[0\]*LEVEL*

  Specifies the upstream tarball compression level if an upstream tarball needs to be built.

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

  When generating tarballs create an additional original tarball of directory *COMPONENT* in the source tree. Using additional original tarballs is a feature of the 3.0 (quilt) source format. See the **dpkg-source** manpage for details. Note that the *--pristine-tar-commit* option is currently incompatible with this option.

  This is considered an experimental feature and might change incompatibly.

- FC**--pristine-tar**F\[0\]

  Use pristine-tar when generating the upstream tarball if it doesn't exist.

- FC**--pristine-tar-commit**F\[0\]

  Commit the pristine-tar delta to the pristine-tar branch if a new tarball was generated and the pristine-tar data isn't already there.

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

  Whether to export with upstream signatures.

## EXAMPLES

Generate an upstream tarball of the version currently referenced in the changelog using pristine-tar:

```
FC
      gbp export-orig --pristine-tar
    F[0]
```

Same as above but generate and additional tarball for directory FC*foo*F\[0\].

```
FC
      gbp export-orig --pristine-tar --component=foo
    F[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-buildpackage**(1)](/gbp-buildpackage/1.md), [**gbp-import-orig**(1)](/gbp-import-orig/1.md), [**gbp-pristine-tar**(1)](/gbp-pristine-tar/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\]\>