In general Debian Policy allows static linking but it has various downsides.

This page aims to document the downsides and mitigations we have in place for those downsides as well as improving the situation in Debian around static linking.




Various technology in Debian uses or is affected by static linking.

C libraries

C libraries support static linking and files are named *.a and can be unpacked with the ar tool from binutils.

Packages can declare they were built using code from other packages by using the Built-Using header and the Debian archive keeps around old sources, marking them with the Extra-Source-Only header. Debian Policy unfortunately says that Built-Using may *only* be used for the purposes of DFSG/license compliance so tracking static linking must be done using custom headers.

Lintian detects binaries that have been statically linked.


All Haskell libraries are statically linked into the final binary.

The release team have a transition that tracks Haskell rebuilds.


All OCaml libraries are statically linked into the final binary.

The release team have a transition that tracks OCaml rebuilds.


The go tool from golang currently requires all libraries be available in source form and then builds everything into one binary. These source files in the -dev packages are the equivalent of the .a file.

When using gccgo-5 (go -gccgo), the Go runtime library is dynamically linked against an executable, however everything else is again linked "statically".

Michael Hudson-Doyle has tried building shared go libraries. Support for dynamic linking (for amd64 only) has been in Ubuntu for a while. But this plan is abandoned now. Even micro releases of the Go compiler break ABI, dynamic linking is just way too tedious, said by mwhudson.

The golang tooling generates Built-Using headers for all(both direct and indirect) dependencies.


Lisp libraries are cl-* packages shipping the source code in /usr/share/common-lisp/, similar to Go libraries. The compiler (e.g. sbcl) builds a static binary from all used cl-* packages.


The ?FreePascal Compiler (fpc) packages in Debian don't seem to use dynamic linking. See also here.


The default for Rust is static linking but dynamic linking is available with rustc -C prefer-dynamic. The ABI is not stable but this is being worked on.


browserify and other tools merge together multiple JS files for shipping to browsers.

Some browser extensions (webext-* packages) copy their dependencies at build time instead of symlinking, because some browsers (Firefox) do not follow symlinks installed into /usr/share/webext/.


Java has "uberjars" which bundle dependencies into the pre-built jar files.


The Debian archive keeps around old sources referenced by the Built-Using header, marking them with the Extra-Source-Only header. This is only to be used for licensing reasons though, not for tracking static linking.

Manual binNMUs can be done for packages that declare a Built-Using header.

For safety reasons, binaries should be linked dynamically to include hardening features e.g. ASLR. A user should be able to presume that binaries shipped by Debian are safe to use in front-facing (e.g. web services) scripts, etc.

More automatic detection of static linking? #698398

Make it easier to add Built-Using?

Change debian-policy & lintian to discourage static linking?

Do browserify from package postinsts?

Something based on searching for statically-linkable files and then mapping those packages to buildinfo files?

Using annobin to watermark binaries with source code hashes. This would reduce binary reproducibility for situations where source changes don't affect the binary output though. An alternative might be to have annobin write the source to binary trace data outside packages or to the buildinfo files or to files referenced by the buildinfo files. Unfortunately annobin does not have access to the source files, only the GCC internal representation.

Modify toolchains and build systems using plugins or patches to record source and binary file paths and hashes, including system headers, static libraries and so on. Write the metadata outside of the binary package, to a file referenced by the buildinfo file. Different distros will likely want different file formats, so a socket or FIFO might be an alternative since a daemon reading from it could transform to other file formats.