Consecutive slash
.RI ( / )
characters are replaced by a single slash.
-
+.PP
The returned string is dynamically allocated by
.BR canonicalize_file_name ()
and the caller should deallocate it with
.BR free (3)
when it is no longer required.
-
+.PP
The call
.I canonicalize_file_name(path)
is equivalent to the call:
-
+.PP
realpath(path, NULL);
.SH RETURN VALUE
On success,