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 (or debian/suid for the first binary package
  20 in debian/control) can list other files to be registered.
  21 .P
  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.
  25 .P
  26 Note that this program modifies your postinst and postrm files. See
  27 .BR dh_installdeb (1)
  28 for an explanation of how this works.
  29 .P
  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).
  33 .SH OPTIONS
  34 .TP
  35 .B debhelper options
  36 See
  37 .BR debhelper (1)
  38 for a list of options common to all debhelper commands.
  39 .TP
  40 .B \-A, \--all
  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.
  44 .TP
  45 .B file ...
  46 Register these files in the first package acted on. (Or in all packages if
  47 -A is specified.)
  48 .SH NOTES
  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.
  52 .SH ENVIRONMENT
  53 See
  54 .BR debhelper (1)
  55 for a list of environment variables that affect all debhelper commands.
  56 .SH "SEE ALSO"
  57 .TP
  58 .BR debhelper (1)
  59 .TP
  60 .BR suidregister (8)
  61 .SH AUTHOR
  62 Joey Hess <joeyh@master.debian.org>