HP-UX Reference (11i v2 03/08) - 3 Library Functions N-Z (vol 7)

realpath(3X) realpath(3X)

NAME

realpath - resolve pathname

SYNOPSIS

#include <stdlib.h>

char *realpath(const char *ﬁle_name, char *resolved_name);

DESCRIPTION

The realpath() function derives, from the pathname pointed to by ﬁle_name , an absolute pathname

that names the same ﬁle, whose resolution does not involve ‘‘

.’’, ‘‘..’’, or symbolic links. The generated

pathname is stored, up to a maximum of

{PATH_MAX} bytes, in the buffer pointed to by resolved_name.

RETURN VALUE

On successful completion,

realpath() returns a pointer to the resolved name. Otherwise,

real-

path() returns a null pointer and sets errno to indicate the error, and the contents of the buffer pointed

to by resolved_name are undeﬁned.

ERRORS

The

realpath() function will fail if:

[EACCES] Read or search permission was denied for a component of ﬁle_name.

[EINVAL] Either the ﬁle_name or resolved_name argument is a null pointer.

[EIO] An error occurred while reading from the ﬁle system.

[ELOOP] Too many symbolic links were encountered in resolving path.

[ENAMETOOLONG] The ﬁle_name argument is longer than

{PATH_MAX} or a pathname

component is longer than

{NAME_MAX}.

[ENOENT] A component of ﬁle_name does not name an existing ﬁle or ﬁle_name

points to an empty string.

[ENOTDIR] A component of the path preﬁx is not a directory.

The realpath() function may fail if:

[ENAMETOOLONG] Pathname resolution of a symbolic link produced an intermediate result

whose length exceeds

{PATH_MAX}.

[ENOMEM] Insufﬁcient storage space is available.