dpkg-statoverride - override ownership and mode of files
“ stat overrides
” are a way to tell dpkg
(1) to use a
different owner or mode for a path when a package is installed (this applies
to any filesystem object that dpkg
handles, including directories,
devices, etc.). This can be used to force programs that are normally setuid to
be install without a setuid flag, or only executable by a certain group.
is a utility to manage the list of stat overrides. It
has three basic functions: adding, removing and listing overrides.
- --add user group mode path
- Add an override for path. path does not need
to exist when this command is used; the override will be stored and used
later. Users and groups can be specified by their name (for example
root or nobody), or by their number by prepending the number
with a ‘ #’ (for example #0 or #65534).
The mode needs to be specified in octal.
If --update is specified and path exists, it is immediately
set to the new owner and mode.
- --remove path
- Remove an override for path, the status of
path is left unchanged by this command.
- --list [glob-pattern]
- List all overrides. If a glob pattern is specified restrict
the output to overrides which match the glob.
- Show the usage message and exit.
- Show the version and exit.
- --admindir directory
- Change the directory of the dpkg database
where the statoverride file is also stored. Defaults to
- Force an action, even if a sanity check would otherwise
prohibit it. This is necessary to override an existing override.
- Immediately try to change the path to the new owner
and mode if it exists.
- Be less verbose about what we do.
- The requested action was successfully performed.
- For --list, if there are no overrides or none match
the supplied glob.
- Fatal or unrecoverable error due to invalid command-line
usage, or interactions with the system, such as accesses to the database,
memory allocations, etc.
- If set and the --admindir option has not been
specified, it will be used as the dpkg data directory.
- 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
Note: dpkg-statoverride preserves the old copy of this file, with
extension “-old”, before replacing it with the new one.