gbp-import-orig-rpm

Name

git-import-orig-rpm, gbp-import-orig-rpm -- Import an upstream source into a git repository.

Synopsis

gbp import-orig-rpm [--version] [--help] [--verbose] [--color=[auto|on|off]] [--color-scheme=COLOR_SCHEME] [--vendor=VENDOR] [--upstream-version=VERSION] [--[no-]merge] [--upstream-branch=BRANCH-NAME] [--packaging-branch=BRANCH-NAME] [--packaging-dir=DIRECTORY] [--[no-]create-missing-branches] [--upstream-vcs-tag=TAG-NAME] [--[no-]sign-tags] [--keyid=GPG-KEYID] [--upstream-tag=TAG-FORMAT] [--filter=PATTERN] [--[no-]pristine-tar] [--[no-]filter-pristine-tar] [--pristine-tarball-name=FILENAME] [--orig-prefix=PREFIX] [--postimport=CMD] [--[no-]interactive] UPSTREAM-SOURCE

DESCRIPTION

gbp import-orig-rpm is an basically identical to the gbp import-orig tool, with only some rpm-specific functionality added and some Debian-specific functionality removed.

gbp import-orig-rpm imports UPSTREAM-SOURCE into the Git repository. UPSTREAM-SOURCE can either be a gzip, bzip2, lzma or xz compressed tar archive, a zip archive or an already unpacked source tree. If it is already of the form package-name-version.tar.gz, the version information is read from the tarball's filename otherwise it can be given on the command line via --upstream-version. If the source package name or version can't be determined gbp import-orig-rpm will prompt for it unless --no-interactive is given.

gbp import-orig-rpm tries to download the archive from a remote server if a remote URL is given. In addition, if no UPSTREAM-SOURCE is given gbp import-orig-rpm takes the archive URI from the spec file - this makes it possible to import a new upstream version just by bumping the version number in the spec file and running gbp import-orig-rpm (assuming that the spec file contains a full URL for the archive and its filename automatically follows the package version e.g. by using the %{version} macro, of course).

The sources are placed on the upstream branch (default: upstream) and tagged.

OPTIONS

--version

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

-v, --verbose

Verbose execution

-h, --help

Print help and exit

--color=[auto|on|off]

Whether to use colored output.

--color-scheme=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, --git-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).

--vendor=VENDOR

Distribution vendor name.

--upstream-version=VERSION, -uVERSION

The upstream version number.

--merge

Merge the upstream branch to the packaging branch after import.

--upstream-branch=BRANCH-NAME

The branch in the Git repository the upstream sources are put onto. Default is upstream.

--packaging-branch=BRANCH-NAME

The branch in the Git repository the package is being developed on, default is master. After importing the new sources on the upstream branch, gbp import-orig-rpm will try to merge the new version onto this branch.

--packaging-dir=DIRECTORY

Subdirectory that contains the RPM packaging files. gbp import-orig-rpm uses this to try to find a spec file which, in turn, is used to get the upstream source archive URI if one is not specified on the command line.

--[no-]create-missing-branches

Create missing upstream branch if it does not exist.

--upstream-vcs-tag=TAG-NAME

Add TAG-NAME as additional parent to the commit of the upstream tarball. Useful when upstream uses git and you want to link to it's revision history.

--[no-]sign-tags

GPG sign all created tags.

--keyid=GPG-KEYID

Use this keyid for gpg signing tags.

--upstream-tag=TAG-FORMAT

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

--import-msg=MSG-FORMAT

Use this format string for the commit message when importing upstream versions, default is Imported Upstream version %(version)s.

--filter=PATTERN

Filter out files glob-matching pattern. Can be given multiple times.

--[no-]pristine-tar

Generate pristine-tar delta file.

--[no-]filter-pristine-tar

If using a filter also filter the files out of the tarball passed to pristine-tar.

--pristine-tarball-name=FILENAME

Filename to record to pristine-tar. This does not alter the tarball content, just the filename with which the tarball can be checked out with pristine-tar.

--orig-prefix=PREFIX

Prefix (directory) to be used when importing sources into pristine-tar. Only takes effect when --pristine-tar is used. Special value auto causes gbp import-orig-rpm to guess the prefix when importing unpacked sources, or, not to change the prefix when importing source archives.

Note: Using this option will alter the source archive that is imported to pristine-tar! That is, pristine-tar does not produce and identical copy of the original tarball (but the mangled tarball, instead).

--postimport=CMD

Run CMD after the import.

--[no-]interactive

Run command interactively, i.e. ask package name and version if needed.

EXAMPLES

Download and import a new upstream version using the informantion from the spec file

      gbp import-orig-rpm
    

After manually downloading an upstream import it

      gbp import-orig-rpm ../upstream-tarball-0.1.tar.gz
    

Import unpacked sources

      gbp import-orig-rpm --orig-prefix=upstream-0.1 ../upstream/
    

CONFIGURATION FILES

Several gbp.conf files are parsed to set defaults for the above command-line arguments. See the gbp.conf(5)> manpage for details.

SEE ALSO

gbp-buildpackage(1), gbp-import-srpm(1), gbp-rpm-ch(1), gbp.conf(5), debuild(1), git(1), pristine-tar(1), The Git-Buildpackage Manual

AUTHOR

Markus Lehtonen