From: Wichert Akkerman <wakkerma@debian.org>
Date: Thu, 15 Jun 2000 00:10:07 +0000 (+0000)
Subject: really add that manpage
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a34da3f1021c855521c53f33cd81cf265412ff08;p=dpkg

really add that manpage
---

diff --git a/scripts/dpkg-statoverride.8 b/scripts/dpkg-statoverride.8
new file mode 100644
index 00000000..295546f0
--- /dev/null
+++ b/scripts/dpkg-statoverride.8
@@ -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.