dh_suidregister.1

   1 .TH DH_SUIDREGISTER 1
   2 .SH NAME
   3 dh_suidregister \- set up package to register files with suidregister
   4 .SH SYNOPSIS
   5 .B dh_suidregister
   6 .I "[-v] [-a] [-i] [-ppackage] [-Ptmpdir] [-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_installdocs 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 package modifies your postinst and postrm files. See
  27 .BR dh_installdeb (1)
  28 for an explanation of how this works.
  29 .SH OPTIONS
  30 .TP
  31 .B \-v, \--verbose
  32 Verbose mode; show all commands that modify the package build directory.
  33 .TP
  34 .B \-a, \--arch
  35 Register files for all architecture dependent packages.
  36 .TP
  37 .B \-i, \--indep
  38 Register files for all architecture independent packages.
  39 .TP
  40 .B \-ppackage, \--package=package
  41 Register files for the package named "package".
  42 .TP
  43 .B \-Ptmpdir, \--tmpdir=tmpdir
  44 Use "tmpdir" for package build directory.
  45 .TP
  46 .B \-A, \--all
  47 Register any files specified by command line parameters in ALL packages
  48 acted on. I doubt anyone will find this useful, it's here for consitency
  49 with other debhelper programs.
  50 .TP
  51 .B file ...
  52 Register these files in the first package acted on. (Or in all packages if
  53 -A is specified.)
  54 .SH NOTES
  55 The
  56 .B \-a
  57 .B \-i
  58 and
  59 .B \-p
  60 arguments are cumulative. If none are specified, then all packages listed in
  61 the control file will be effected.
  62 .SH ENVIRONMENT
  63 .TP
  64 .I DH_VERBOSE
  65 Enables verbose mode
  66 .SH "SEE ALSO"
  67 .BR /usr/doc/debhelper/README
  68 ,
  69 .BR suidregister (1)
  70 .SH AUTHOR
  71 Joey Hess <joeyh@master.debian.org>