# dpkg-genbuildinfo

## NAME



           dpkg-genbuildinfo - generate Debian .buildinfo files
    


## SYNOPSIS



           **dpkg-genbuildinfo**[_option_...]
    


## DESCRIPTION



           **dpkg-genbuildinfo** reads information from an unpacked and built
           Debian source tree and from the files it has generated and
           generates a Debian control file describing the build environment
           and the build artifacts (**.buildinfo** file).
    
           This program was introduced in dpkg 1.18.11.
    


## OPTIONS



           **--build=**_type_
               Specifies the build _type_ from a comma-separated list of
               components.
    
               The allowed values are:
    
               **any** Generate build information including unqualified build
                   dependencies (**Build-Depends**) and architecture specific
                   build dependencies (**Build-Depends-Arch**).
    
               **all** Generate build information including unqualified build
                   dependencies (**Build-Depends**) and architecture independent
                   build dependencies (**Build-Depends-Indep**).
    
               **source**
                   Effectively ignored; generate build information with just
                   the unqualified build dependencies (**Build-Depends**).
    
               **binary**
                   Generate build information with all three types of build
                   dependencies.  This is an alias for **any,all**.
    
               **full**
                   Generate build information with all three types of build
                   dependencies.  This is an alias for **any,all,source** , and
                   the same as the default case when no build option is
                   specified.
    
           **-c** _controlfile_
               Specifies the main source control file to read information
               from.  The default is **debian/control**.
    
           **-l** _changelog-file_
               Specifies the changelog file to read information from.  The
               default is **debian/changelog**.
    
           **-f** _files-list-file_
               Specifies where is the list of files that have been produced
               by the build, rather than using **debian/files**.
    
           **-F** _changelog-format_
               Specifies the format of the changelog.  See
               dpkg-parsechangelog(1) for information about alternative
               formats.
    
           **-O**[_filename_]
               Print the buildinfo file to standard output (or _filename_ if
               specified) rather than to _dir_**/**_source-name_**_**_binary-_
               _version_**_**_arch_**.buildinfo**(where _dir_ is **..** by default or _upload-_
               _files-dir_ if **-u** was used).
    
           **-u** _upload-files-dir_
               Look for the files to be uploaded in _upload-files-dir_ rather
               than **..**(**dpkg-genbuildinfo** needs to find these files so that
               it can include their sizes and checksums in the **.buildinfo**
               file).
    
           **--always-include-kernel**
               By default, the **Build-Kernel-Version** field will not be written
               out.
    
               Specify this option (since dpkg 1.19.0) to always write a
               **Build-Kernel-Version** field when generating the **.buildinfo**.
    
           **--always-include-path**
               By default, the **Build-Path** field will only be written if the
               current directory starts with an allowed pattern.
    
               On Debian and derivatives the pattern matches on **/build/** at
               the start of the pathname.
    
               Specify this option to always write a **Build-Path** field when
               generating the **.buildinfo**.
    
           **--admindir=**_dir_
               Change the location of the **dpkg** database.  The default
               location is _/var/lib/dpkg_.
    
           **-q  dpkg-genbuildinfo** might produce informative messages on
               standard error.  **-q** suppresses these messages.
    
           **-?** , **--help**
               Show the usage message and exit.
    
           **--version**
               Show the version and exit.
    


## ENVIRONMENT



           **DEB_BUILD_OPTIONS**
               This variable can be used to enable or disable various
               features that affect the information included in the
               .buildinfo file, via the **buildinfo** option (since dpkg
               1.18.19).  This option contains a comma-separated list of
               features, prefixed with the ‘**+** ’ or ‘**-** ’ modifiers, to denote
               whether to enable or disable them.  The special feature “**all** ”
               can be used to enable or disable all other features.  The
               feature “**path** ” controls whether to unconditionally include the
               **Build-Path** field.
    
           **DEB_BUILD_ARCH**
               Sets the build architecture.  This affects the value for the
               **Build-Architecture** field, and the check for the cross-
               compilation mode.
    
           **DEB_HOST_ARCH**
               Sets the host architecture.  This affects the filename used
               for the .buildinfo file, and the check for the cross-
               compilation mode.
    
           **DPKG_COLORS**
               Sets the color mode (since dpkg 1.18.5).  The currently
               accepted values are: **auto**(default), **always** and **never**.
    
           **DPKG_NLS**
               If set, it will be used to decide whether to activate Native
               Language Support, also known as internationalization (or i18n)
               support (since dpkg 1.19.0).  The accepted values are: **0** and **1**
               (default).
    


## FILES



           **debian/files**
               The list of generated files.  **dpkg-genbuildinfo** reads the data
               here when producing a **.buildinfo** file.
    


* * *