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

NAME

6       dpkg-realpath - print the resolved pathname with DPKG_ROOT support
7

SYNOPSIS

9       dpkg-realpath [option...] pathname
10

DESCRIPTION

12       dpkg-realpath is a tool (since dpkg 1.20.1) to resolve a pathname, that
13       takes the dpkg(1) root directory into account, either implicitly from
14       the DPKG_ROOT environment variable or from the command-line --root or
15       --instdir options, and returns an absolute pathname relative to the
16       root directory.  The root directory must not be prefixed to the
17       pathname to be resolved.
18
19       This is intended to be used by other dpkg helpers, or by maintainer
20       scripts instead of using realpath(1) or readlink(1) to canonicalize
21       pathnames, as these latter commands do not support canonicalization
22       relative to a different root than /.
23

OPTIONS

25       -z, --zero
26           Use a NUL byte to end output lines instead of a new line character
27           (since dpkg 1.20.6).
28
29       --instdir directory
30       --root directory
31           Set the root directory to directory, which is the base directory
32           that pathnames get canonicalized against.  Defaults to «/» if
33           DPKG_ROOT has not been set.
34
35       -?, --help
36           Show the usage message and exit.
37
38       --version
39           Show the version and exit.
40

ENVIRONMENT

42       DPKG_ROOT
43           If set and the --instdir or --root options have not been specified,
44           it will be used as the filesystem root directory.
45
46       DPKG_COLORS
47           Sets the color mode.  The currently accepted values are: auto
48           (default), always and never.
49

SEE ALSO

51       realpath(1), readlink(1).
52
53
54
551.21.8                            2022-05-25                  dpkg-realpath(1)
Impressum