]> git.donarmstrong.com Git - debhelper.git/blob - dh_suidregister.1
r273: * dh_installdocs.1: clarified how the doc-id is determined. Closes: #44864
[debhelper.git] / 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] [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 files specified as parameters will be registered, if dh_suidregister is
15 acting on the first binary package listed in debian/control.
16 .P
17 The files debian/suid (for the first binary package in debian/control) or 
18 debian/package.suid (for  each  additional package in debian/control) can 
19 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 package modifies your postinst and postrm files. See
26 .BR dh_installdebfiles (1)
27 for an explination of how this works.
28 .SH OPTIONS
29 .TP
30 .B \-v
31 Verbose mode; show all commands that modify the package build directory.
32 .TP
33 .B \-a
34 Register files for all architecture dependent packages.
35 .TP
36 .B \-i
37 Register files for all architecture independent packages.
38 .TP
39 .B \-ppackage
40 Register files for the package named "package".
41 .TP
42 .B file ...
43 Register these files in the first binary package listed in debian/control, 
44 if we are acting on that package.
45 .SH NOTES
46 The
47 .B \-a
48 .B \-i
49 and
50 .B \-p
51 arguments are cumulative. If none are specified, then all packages listed in
52 the control file will be effected.
53 .SH ENVIRONMENT
54 .TP
55 .I DH_VERBOSE
56 Enables verbose mode
57 .SH "SEE ALSO"
58 .BR /usr/doc/debhelper/README
59 ,
60 .BR suidregister (1)
61 .SH AUTHOR
62 Joey Hess <joeyh@master.debian.org>