Archived
1
0
Fork 0

doc: Add a note and warning regarding the usage of deb packs.

* doc/guix.texi (Invoking guix pack): Move to the end of the table, and add a
note and warning regarding the usage of deb packs.
This commit is contained in:
Hartmut Goebel 2020-08-19 10:44:27 +02:00 committed by Maxim Cournoyer
parent b7d70aeb0b
commit 364db4fdf6
No known key found for this signature in database
GPG key ID: 1260E46482E63562

View file

@ -6028,11 +6028,6 @@ This produces a SquashFS image containing all the specified binaries and
symlinks, as well as empty mount points for virtual file systems like symlinks, as well as empty mount points for virtual file systems like
procfs. procfs.
@item deb
This produces a Debian archive (a package with the @samp{.deb} file
extension) containing all the specified binaries and symbolic links,
that can be installed on top of any dpkg-based GNU/Linux distribution.
@quotation Note @quotation Note
Singularity @emph{requires} you to provide @file{/bin/sh} in the image. Singularity @emph{requires} you to provide @file{/bin/sh} in the image.
For that reason, @command{guix pack -f squashfs} always implies @code{-S For that reason, @command{guix pack -f squashfs} always implies @code{-S
@ -6047,6 +6042,27 @@ If you forget the @code{bash} (or similar) package, @command{singularity
run} and @command{singularity exec} will fail with an unhelpful ``no run} and @command{singularity exec} will fail with an unhelpful ``no
such file or directory'' message. such file or directory'' message.
@end quotation @end quotation
@item deb
This produces a Debian archive (a package with the @samp{.deb} file
extension) containing all the specified binaries and symbolic links,
that can be installed on top of any dpkg-based GNU(/Linux) distribution.
@quotation Note
Because archives produced with @command{guix pack} contain a collection
of store items and because each @command{dpkg} package must not have
conflicting files, in practice that means you likely won't be able to
install more than one such archive on a given system.
@end quotation
@quotation Warning
@command{dpkg} will assume ownership of any files contained in the pack
that it does @emph{not} know about. It is unwise to install
Guix-produced @samp{.deb} files on a system where @file{/gnu/store} is
shared by other software, such as a Guix installation or other, non-deb
packs.
@end quotation
@end table @end table
@cindex relocatable binaries @cindex relocatable binaries