Previous: mktemp invocation, Up: File name manipulation [Contents][Index]
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]