---
name: "emdebuild"
section: "1"
platform: "linux"
package: "emdebian-tools"
version: "1.4.3"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/emdebuild"
---

# emdebuild(1)

emdebuild is the emdebian version of debuild.

## NAME

emdebuild - emdebuild is the emdebian version of debuild.

## SYNOPSIS

**emdebuild** \[\[-a\] \| \[--arch\] *ARCH*\] \[\[-n\] \| \[--next\]\] \[--svn\] \[--sign\] \[\[-v\] \| \[--verbose\]\] \[\[-q\] \| \[--quiet\]\]

**emdebuild** \[--svn-only\]

**emdebuild** \[--build-dep\]

**emdebuild** \[\[-h\] \| \[--help\]\] \[\[--version\]\]

## DESCRIPTION

After a Debian package has been ´emdebianised´ with **em\_make**, **emdebuild** provides a convenient wrapper around dpkg-buildpackage.

**emdebuild** needs to be run in the source directory of the package.

By default, **emdebuild** cross-builds the package for the **dpkg-cross** default architecture. Specify other architectures with **-a\|--arch**. Ensure the current toolchain is installed for the chosen architecture.

running debian/rules alone is unsupported

There is no equivalent for the **fakeroot debian/rules binary** type shorthand for a quick rebuild of the package due to the needs of the cross-build.

## COMMANDS

- **--svn-only**

  Commit modifications to the emdebian patch files back to Emdebian SVN **without** rebuilding, e.g. once a failed build has been repaired. Requires a subversion working directory which can be provided by unpacking the source with **emsource**. The working copy must have been checked out with developer access. **emsource** will use developer access if a valid Emdebian SVN username is available.

  Note that the build log will need to be added to svn and checked in separately.

  **--svn-only** is disabled when using machine:variant customisation patches via **emsource** **-m**.

- **--build-dep**

  Read the *debian/xcontrol* file (if any) and parse the list of *Build-Cross-Depends:* and call **apt-cross** to install the cross dependencies.

  See **emdebuild** support for *debian/xcontrol*.

## OPTIONS

**-a**\|**--arch** ARCH

Override the default architecture (set by **dpkg-cross**).

**-n**\|**--next**

Increment the emdebian version before building. Note that, in most cases, it is advisable to edit *debian/changelog* and add an explanatory message before uploading the built package. **emdebuild** merely adds a very brief comment.

When building a package that has been updated upstream, the **-n** option can be used to restore the effect of a default Emdebian version if the *emdebian-changelog.patch* could not be applied.

- **--svn**

  Commit modifications to the emdebian patch files back to Emdebian SVN upon a successful build. Requires a subversion working directory which can be provided by unpacking the source with **emsource**. The working copy must have been checked out with developer access. **emsource** will use developer access if a valid Emdebian SVN username is available.

  If the build fails, **emdebuild** can be restarted and the patches committed to Emdebian SVN once the build has been fixed using the **-svn-only** option.

  **--svn** will abort the SVN commit when using machine:variant customisation patches via **emsource** **-m**.

- **--sign**

  Sign the changes file created by the underlying **dpkg-buildpackage**. Many repositories require changes files to be signed with an authorised GnuPG key. If *~/.devscripts* is configured so that *DEBUILD\_DPKG\_BUILDPACKAGE\_OPTS* options specify that **dpkg-buildpackage** should not sign the changes file directly, this option can be used to call **debsign** with the generated changes file at the end of the build. Experience has shown that even when **dpkg-buildpackage** is unable to sign the changes file, running **debsign** directly succeeds.

**-v**\|**--verbose**

be verbose - repeat once for extra verbosity. Most users are highly recommended to use at least one level of verbosity.

**-q**\|**--quiet**

be quiet. **emdebuild** will be very quiet with this option, only essential warnings and messages from the build process itself are output. Intended for automated buildd purposes.

**-h**\|**--help**

print the usage message and exit.

- **--version**

  print the usage message and exit.

## AUTHOR

**emdebuild** was written by Neil Williams \<codehelp@debian.org\>.

This manual page was written by Neil Williams \<codehelp@debian.org\>

## SEE ALSO

See also *apt-cross* (1), *dpkg-cross* (1), *emsource* (1), *emsetup* (1), *em\_make* (1), *empdebuild* (1), *xcontrol* (1), *emdebian-tools* (1).

*General Introduction*\[1\] to crossbuilding Debian.

## AUTHOR

**Emdebian**

**Neil Williams**

-

  Author.

## COPYRIGHT

## NOTES

- 1\.

  General Introduction

  http://www.emdebian.org/emdebian/intro.html