dpkg-statoverride(1)

1dpkg-statoverride(1)              dpkg suite              dpkg-statoverride(1)
2
3
4

NAME

6       dpkg-statoverride - override ownership and mode of files
7

SYNOPSIS

9       dpkg-statoverride [option...] command
10

DESCRIPTION

12       “stat  overrides” are a way to tell dpkg(1) to use a different owner or
13       mode for a path when a  package  is  installed  (this  applies  to  any
14       filesystem  object  that  dpkg handles, including directories, devices,
15       etc.). This can be used to force programs that are normally  setuid  to
16       be  install  without  a  setuid  flag,  or only executable by a certain
17       group.
18
19       dpkg-statoverride is a utility to manage the list of stat overrides. It
20       has three basic functions: adding, removing and listing overrides.
21

COMMANDS

23       --add user group mode path
24              Add  an override for path. path does not need to exist when this
25              command is used; the override will be  stored  and  used  later.
26              Users  and  groups  can  be specified by their name (for example
27              root or nobody), or by their number  by  prepending  the  number
28              with  a  ‘#’  (for  example #0 or #65534).  The mode needs to be
29              specified in octal.
30
31              If --update is specified and path exists, it is immediately  set
32              to the new owner and mode.
33
34       --remove path
35              Remove  an  override  for  path,  the  status  of  path  is left
36              unchanged by this command.
37
38       --list [glob-pattern]
39              List all overrides. If a glob pattern is specified restrict  the
40              output to overrides which match the glob.
41
42       --help Show the usage message and exit.
43
44       --force-help
45              Give help about the --force-thing options (since dpkg 1.19.5).
46
47       --version
48              Show the version and exit.
49

OPTIONS

51       --admindir directory
52              Set  the  administrative  directory to directory.  This is where
53              the statoverride file is stored.  Defaults to «/var/lib/dpkg».
54
55       --instdir directory
56              Set the installation directory, which refers  to  the  directory
57              where  packages  get installed (since dpkg 1.19.2).  Defaults to
58              «/».
59
60       --root directory
61              Set the root directory to directory, which sets the installation
62              directory  to  «directory»  and  the administrative directory to
63              «directory/var/lib/dpkg» (since dpkg 1.19.2).
64
65       --force-things
66       --no-force-things, --refuse-things
67              Force or refuse (no-force and refuse mean the same thing) to  do
68              some  things  (since  dpkg 1.19.5).  things is a comma separated
69              list of things specified below.  --force-help displays a message
70              describing them.  Things marked with (*) are forced by default.
71
72              Warning: These options are mostly intended to be used by experts
73              only.  Using them without fully understanding their effects  may
74              break your whole system.
75
76              all: Turns on (or off) all force options.
77
78              statoverride-add:  Overwrite  an  existing  stat  override  when
79              adding it (since dpkg 1.19.5).
80
81              statoverride-remove:  Ignore  a  missing  stat   override   when
82              removing it (since dpkg 1.19.5).
83
84              security-mac(*): Use platform-specific Mandatory Access Controls
85              (MAC) based security when installing files into  the  filesystem
86              (since  dpkg  1.19.5).  On Linux systems the implementation uses
87              SELinux.
88
89       --force
90              Force an action, even if a sanity check would otherwise prohibit
91              it.   This  is necessary to override an existing override.  This
92              option is deprecated (since dpkg  1.19.5),  it  is  replaced  by
93              --force-all.
94
95       --update
96              Immediately  try to change the path to the new owner and mode if
97              it exists.
98
99       --quiet
100              Be less verbose about what we do.
101

EXIT STATUS

103       0      The requested action was successfully performed.
104
105       1      For --list, if there are no overrides or none match the supplied
106              glob.
107
108       2      Fatal  or unrecoverable error due to invalid command-line usage,
109              or interactions  with  the  system,  such  as  accesses  to  the
110              database, memory allocations, etc.
111

ENVIRONMENT

113       DPKG_ROOT
114              If  set  and  the  --instdir  or  --root  options  have not been
115              specified, it will be used  as  the  filesystem  root  directory
116              (since dpkg 1.19.2).
117
118       DPKG_ADMINDIR
119              If  set  and  the  --admindir  or  --root  options have not been
120              specified, it will be used as the dpkg data directory.
121
122       DPKG_FORCE
123              If set and none of the --force-... options have been  specified,
124              it will be used as the force options to use (since dpkg 1.19.5).
125
126       DPKG_COLORS
127              Sets the color mode (since dpkg 1.18.5).  The currently accepted
128              values are: auto (default), always and never.
129

FILES

131       /var/lib/dpkg/statoverride
132              File which contains the current list of stat  overrides  of  the
133              system.  It  is  located  in  the dpkg administration directory,
134              along with other files important to  dpkg,  such  as  status  or
135              available.
136              Note:  dpkg-statoverride  preserves  the  old copy of this file,
137              with extension “-old”, before replacing it with the new one.
138