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] [--no-act] [-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 \--no-act
  41 Do not really do anything. If used with -v, the result is that this command
  42 will output a list of what it would have done.
  43 .TP
  44 .B \-ppackage, \--package=package
  45 Register files for the package named "package".
  46 .TP
  47 .B \-Ptmpdir, \--tmpdir=tmpdir
  48 Use "tmpdir" for package build directory.
  49 .TP
  50 .B \-A, \--all
  51 Register any files specified by command line parameters in ALL packages
  52 acted on. I doubt anyone will find this useful, it's here for consitency
  53 with other debhelper programs.
  54 .TP
  55 .B file ...
  56 Register these files in the first package acted on. (Or in all packages if
  57 -A is specified.)
  58 .SH NOTES
  59 The
  60 .B \-a
  61 .B \-i
  62 and
  63 .B \-p
  64 arguments are cumulative. If none are specified, then all packages listed in
  65 the control file will be effected.
  66 .SH ENVIRONMENT
  67 .TP
  68 .I DH_VERBOSE
  69 Enables verbose mode
  70 .TP
  71 .I DH_NO_ACT
  72 Enables no-act mode (see above).
  73 .SH "SEE ALSO"
  74 .BR /usr/doc/debhelper/README
  75 ,
  76 .BR suidregister (1)
  77 .SH AUTHOR
  78 Joey Hess <joeyh@master.debian.org>