path: root/dh_suidregister.1
diff options
authorjoey <joey>1999-11-23 23:51:29 +0000
committerjoey <joey>1999-11-23 23:51:29 +0000
commitb94647e38f768cb0f5eff426fffc96ac7d70fd4a (patch)
treef43e1e921970948c7dacf465ff1e683932bbf6df /dh_suidregister.1
parentb0ebd80067950b5ef61fd4344a88a8bf53ee31ef (diff)
r309: removed 'master'
Diffstat (limited to 'dh_suidregister.1')
1 files changed, 36 insertions, 36 deletions
diff --git a/dh_suidregister.1 b/dh_suidregister.1
index e15e6d5..a4be758 100644
--- a/dh_suidregister.1
+++ b/dh_suidregister.1
@@ -1,9 +1,9 @@
+.TH DH_SUIDREGISTER 1 "" "Debhelper Commands" "Debhelper Commands"
dh_suidregister \- set up package to register files with suidregister
.B dh_suidregister
-.I "[-v] [-a] [-i] [-ppackage] [file ...]"
+.I "[debhelper options] [-A] [file ...]"
dh_suidregister is a debhelper program that is responsible for modifying the
postinst and postrm scripts of a package so the package will register files
@@ -11,52 +11,52 @@ with
.BR suidregister (1)
when it is installed.
-Any files specified as parameters will be registered, if dh_suidregister is
-acting on the first binary package listed in debian/control.
+Any filenames specified as parameters will be registered in the first
+package dh_suidregister is told to act on. By default, this is the first
+binary package in debian/control, but if you use -p, -i, or -a flags,
+it will be the first package specified by those flags.
-The files debian/suid (for the first binary package in debian/control) or
-debian/package.suid (for each additional package in debian/control) can
-list other files to be registered.
+Files named debian/package.suid (or debian/suid for the first binary package
+in debian/control) can list other files to be registered.
If neither of these methods is used to specify files, dh_suidregister will
scan the package build directory for files that have suid permissions, and
will automatically register all files it finds.
-Note that this package modifies your postinst and postrm files. See
-.BR dh_installdebfiles (1)
-for an explination of how this works.
+Note that this program modifies your postinst and postrm files. See
+.BR dh_installdeb (1)
+for an explanation of how this works.
+Also note that all files registered by this program will *not* be suid in the
+resulting .deb file. The postinst of the package will set their permissions
+(even if the user doesn't have suidmanager installed).
-.B \-v
-Verbose mode; show all commands that modify the package build directory.
-.B \-a
-Register files for all architecture dependent packages.
+.B debhelper options
+.BR debhelper (1)
+for a list of options common to all debhelper commands.
-.B \-i
-Register files for all architecture independent packages.
-.B \-ppackage
-Register files for the package named "package".
+.B \-A, \--all
+Register any files specified by command line parameters in ALL packages
+acted on. I doubt anyone will find this useful, it's here for consitency
+with other debhelper programs.
.B file ...
-Register these files in the first binary package listed in debian/control,
-if we are acting on that package.
+Register these files in the first package acted on. (Or in all packages if
+-A is specified.)
-.B \-a
-.B \-i
-.B \-p
-arguments are cumulative. If none are specified, then all packages listed in
-the control file will be effected.
+dh_suidregister does not make anything suid. It merely records the
+permissions binaries already have. If you need to make something suid, you
+must do so manually before calling dh_suidregister.
-Enables verbose mode
+.BR debhelper (1)
+for a list of environment variables that affect all debhelper commands.
-.BR /usr/doc/debhelper/README
-.BR suidregister (1)
+.BR debhelper (1)
+.BR suidregister (8)
-Joey Hess <>
+Joey Hess <>