dh_suidregister.1

   1 .TH DH_SUIDREGISTER 1 "" "Debhelper Commands" "Debhelper Commands"
   2 .SH NAME
   3 dh_suidregister \- set up package to register files with suidregister
   4 .SH SYNOPSIS
   5 .B dh_suidregister
   6 .I "[debhelper options] [-A] [file ...]"
   7 .SH "DESCRIPTION"
   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
  10 with
  11 .BR suidregister (1)
  12 when it is installed.
  13 .P
  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.
  18 .P
  19 Files named debian/package.suid can list other files to be registered.
  20 .P
  21 If neither of these methods is used to specify files, dh_suidregister will
  22 scan the package build directory for files that have suid permissions, and
  23 will automatically register all files it finds.
  24 .P
  25 Note that this program modifies your postinst and postrm files. See
  26 .BR dh_installdeb (1)
  27 for an explanation of how this works.
  28 .P
  29 Also note that all files registered by this program will *not* be suid in the
  30 resulting .deb file. The postinst of the package will set their permissions
  31 (even if the user doesn't have suidmanager installed).
  32 .SH OPTIONS
  33 .TP
  34 .B debhelper options
  35 See
  36 .BR debhelper (1)
  37 for a list of options common to all debhelper commands.
  38 .TP
  39 .B \-A, \--all
  40 Register any files specified by command line parameters in ALL packages
  41 acted on. I doubt anyone will find this useful, it's here for consitency
  42 with other debhelper programs.
  43 .TP
  44 .B file ...
  45 Register these files in the first package acted on. (Or in all packages if
  46 -A is specified.)
  47 .SH NOTES
  48 dh_suidregister does not make anything suid. It merely records the
  49 permissions binaries already have. If you need to make something suid, you
  50 must do so manually before calling dh_suidregister.
  51 .SH ENVIRONMENT
  52 See
  53 .BR debhelper (1)
  54 for a list of environment variables that affect all debhelper commands.
  55 .SH "SEE ALSO"
  56 .TP
  57 .BR debhelper (1)
  58 .TP
  59 .BR suidregister (8)
  60 .SH AUTHOR
  61 Joey Hess <joeyh@debian.org>