|
|
@@ -0,0 +1,72 @@
|
|
|
+.TH DPKG-STATOVERRIDE 8 "June 2000" "Debian project" "dpkg utililties"
|
|
|
+.SH NAME
|
|
|
+dpkg-statoverride -- override ownership and mode of files
|
|
|
+.SH SYNOPSIS
|
|
|
+\fBdpkg-statoverride\fR [options] --add <user> <group> <mode> \fI<file>\fR
|
|
|
+.br
|
|
|
+\fBdpkg-statoverride\fR [options] --remove \fI<file>\fR
|
|
|
+.br
|
|
|
+\fBdpkg-statoverride\fR [options] --list \fI[<glob-pattern>]\fR
|
|
|
+.SH DESCRIPTION
|
|
|
+`\fBstat overrides\fR' are a way to tell dpkg to use a different owner
|
|
|
+or mode for a file when a package is installed. (note: I use the word
|
|
|
+`file' here, but in reality this can be any filesystem object that dpkg
|
|
|
+handles, including directories, devices, etc.). This can be used to
|
|
|
+force programs that are normall setuid to be install without a setuid
|
|
|
+flag, or only executable by a certain group.
|
|
|
+.P
|
|
|
+\fBdpkg-statoverride\fR is a utility to manager the list of stat
|
|
|
+overrides. It has three basic functions: adding, removing and listing
|
|
|
+overrides.
|
|
|
+.SH OPTIONS
|
|
|
+.TP
|
|
|
+.I --add <user> <group> <mode> <file>
|
|
|
+Add an override for \fB<file>\fR. The might does not need to exist at
|
|
|
+this moment, the override will be stored and used later. Users and
|
|
|
+groups can be specified by their name (for example \fBroot\fR or
|
|
|
+\fBnobody\fR), or by their number by prepending the number with a
|
|
|
+`\fB#\fR' (for example \fB#0\fR or \fB#65534\fR).
|
|
|
+.TP
|
|
|
+.I --remove <file>
|
|
|
+Remove an override for \fB<file>\fR.
|
|
|
+.TP
|
|
|
+.I --list [<glob-pattern>]
|
|
|
+List all overrides. If a glob pattern is specified restrict the output
|
|
|
+to overrides which match the glob.
|
|
|
+.TP
|
|
|
+.I --force
|
|
|
+Force an action, even if a sanity check would otherwise prohibit it.
|
|
|
+This is necessary to override an existing override.
|
|
|
+.TP
|
|
|
+.I --update
|
|
|
+Immediately try to change the file to the new owner and mode if it
|
|
|
+exists. This is only done for \fI--add\fR.
|
|
|
+.TP
|
|
|
+.I --quiet
|
|
|
+Be less verbose about what we do.
|
|
|
+.TP
|
|
|
+.I --help
|
|
|
+Show version, copyright and usage information.
|
|
|
+.TP
|
|
|
+.I --admindir
|
|
|
+Change the directory of the dpkg database where the statoverride file is
|
|
|
+also stored. Defaults to /var/lib/dpkg.
|
|
|
+.SH FILES
|
|
|
+.TP
|
|
|
+.I /var/lib/dpkg/statoverride
|
|
|
+File which contains the current list of stat overrides of the system. It
|
|
|
+is located in the dpkg administration directory, along with other files
|
|
|
+important to dpkg, such as `status' or `available'.
|
|
|
+.br
|
|
|
+Note: dpkg-statoverride preserves the old copy of this file, with
|
|
|
+extension "-old", before replacing it with the new one.
|
|
|
+.SH SEE ALSO
|
|
|
+.BR dpkg (8)
|
|
|
+.SH AUTHOR
|
|
|
+Copyright 2000 Wichert Akkerman
|
|
|
+.UR mailto:wakkerma@debian.org
|
|
|
+<wakkerma@debian.org>
|
|
|
+.UE
|
|
|
+.sp
|
|
|
+This is free software; see the GNU General Public Licence version 2 or
|
|
|
+later for copying conditions. There is NO warranty.
|
Wichert Akkerman