1 .TH DH_SUIDREGISTER 1 "" "Debhelper Commands" "Debhelper Commands"
3 dh_suidregister \- set up package to register files with suidregister
6 .I "[debhelper options] [-A] [file ...]"
8 dh_suidregister is a debhelper program that is responsible for modifying the
9 postinst and postrm scripts of a package so the package will register files
14 Any filenames specified as parameters will be registered in the first
15 package dh_suidregister is told to act on. By default, this is the first
16 binary package in debian/control, but if you use -p, -i, or -a flags,
17 it will be the first package specified by those flags.
19 Files named debian/package.suid (or debian/suid for the first binary package
20 in debian/control) can list other files to be registered.
22 If neither of these methods is used to specify files, dh_suidregister will
23 scan the package build directory for files that have suid permissions, and
24 will automatically register all files it finds.
26 Note that this program modifies your postinst and postrm files. See
28 for an explanation of how this works.
30 Also note that all files registered by this program will *not* be suid in the
31 resulting .deb file. The postinst of the package will set their permissions
32 (even if the user doesn't have suidmanager installed).
38 for a list of options common to all debhelper commands.
41 Register any files specified by command line parameters in ALL packages
42 acted on. I doubt anyone will find this useful, it's here for consitency
43 with other debhelper programs.
46 Register these files in the first package acted on. (Or in all packages if
49 dh_suidregister does not make anything suid. It merely records the
50 permissions binaries already have. If you need to make something suid, you
51 must do so manually before calling dh_suidregister.
55 for a list of environment variables that affect all debhelper commands.
62 Joey Hess <joeyh@debian.org>