Gnu/coreutils/realpath-invocation
Previous: mktemp invocation, Up: File name manipulation [Contents][Index]
18.5 realpath
: Print the resolved file name.
realpath
expands all symbolic links and resolves references to
‘/./
’, ‘/../
’ and extra ‘/
’ characters. By default,
all but the last component of the specified files must exist. Synopsis:
realpath [option]… file…
The file name canonicalization functionality overlaps with that of the
readlink
command. This is the preferred command for
canonicalization as it’s a more suitable and standard name. In addition
this command supports relative file name processing functionality.
The program accepts the following options. Also see Common options.
- ‘
-e
’
‘--canonicalize-existing
’ Ensure that all components of the specified file names exist. If any component is missing or unavailable,
realpath
will output a diagnostic unless the-q
option is specified, and exit with a nonzero exit code. A trailing slash requires that the name resolve to a directory.- ‘
-m
’
‘--canonicalize-missing
’ If any component of a specified file name is missing or unavailable, treat it as a directory.
- ‘
-L
’
‘--logical
’ Symbolic links are resolved in the specified file names, but they are resolved after any subsequent ‘
..
’ components are processed.- ‘
-P
’
‘--physical
’ Symbolic links are resolved in the specified file names, and they are resolved before any subsequent ‘
..
’ components are processed. This is the default mode of operation.- ‘
-q
’
‘--quiet
’ Suppress diagnostic messages for specified file names.
- ‘
--relative-to=dir
’ Print the resolved file names relative to the specified directory. Note this option honors the
-m
and-e
options pertaining to file existence.- ‘
--relative-base=dir
’ Print the resolved file names as relative if the files are descendants of
dir
. Otherwise, print the resolved file names as absolute. Note this option honors the-m
and-e
options pertaining to file existence. For details about combining--relative-to
and--relative-base
, see Realpath usage examples.- ‘
-s
’
‘--strip
’
‘--no-symlinks
’ Do not resolve symbolic links. Only resolve references to ‘
/./
’, ‘/../
’ and remove extra ‘/
’ characters. When combined with the-m
option, realpath operates only on the file name, and does not touch any actual file.- ‘
-z
’
‘--zero
’ Output a zero byte (ASCII NUL) at the end of each line, rather than a newline. This option enables other programs to parse the output even when that output would contain data with embedded newlines.
Exit status:
0 if all file names were printed without issue. 1 otherwise.
• Realpath usage examples | Realpath usage examples. |
Previous: mktemp invocation, Up: File name manipulation [Contents][Index]