realpath(3STDC)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | CAVEATS | ATTRIBUTES | SEE ALSO

NAME

realpath- returns the canonicalized absolute pathname

SYNOPSIS

$(OS_DIR)/lib/libc.a
#include <stdlib.h>
#include <sys/param.h>

car *realpath(const char*path, char *resolved_path[MAXPATHLEN]);

API RESTRICTIONS

The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.

See API(5FEA) for details.

DESCRIPTION

The realpath() function resolves all symbolic links, extra / characters and references to /./ and /../ in path, and copies the resulting absolute pathname into the memory referenced by resolved_path. The resolved_path argument must refer to a buffer capable of storing at least MAXPATHLEN characters.

The realpath() function will resolve both absolute and relative paths and return the absolute pathname corresponding to path. All but the last component of path must exist when realpath() is called.

RETURN VALUES

The realpath() function returns resolved_path on success.

If an error occurs, realpath() returns NULL , and resolved_path contains the pathname which caused the problem.

ERRORS

The function realpath() may fail and set the external variable errno for any of the errors specified for the library functions chdir, close, fchdir, lstat, open, readlink and getcwd.

CAVEATS

realpath() allocates an array of characters of MAXPATHLEN size on the stack. The user must make sure that the stack is big enough to contain this array.

This implementation of realpath() differs slightly from the Solaris implementation. The 4.4BSD version always returns absolute pathnames, whereas the Solaris implementation will, under certain circumstances, return a relative resolved_path when given a relative path.

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving

SEE ALSO

getcwd(3POSIX)

NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUES | ERRORS | CAVEATS | ATTRIBUTES | SEE ALSO