NAME
gfs_realpath - resolve pathname in Gfarm filesystem
SYNOPSIS
#include <gfarm/gfarm.h>
char *gfs_realpath (const char * gfarm_url, char ** resolved_pathp);
DESCRIPTION
gfs_realpath expands a home directory ’~’ and resolves references to
’.’, ’..’ and extra ’/’ characters in the null terminated string
pointed to by gfarm_url and stores the canonicalized absolute pathname
to dynamically allocated memory space whose pointer is returned to
resolved_pathp. It will be necessary to free the dynamically allocated
memory space pointed to by resolved_pathp.
RETURN VALUES
NULL The function terminated successfully.
GFARM_ERR_NO_MEMORY
Insufficient memory was available.
GFARM_ERR_NOT_A_DIRECTORY
A component of the path prefix is not a directory.
GFARM_ERR_INVALID_ARGUMENT
gfarm_url is NULL.
GFARM_ERR_PERMISSION_DENIED
gfarm_url points outside your accessible address space.
GFARM_ERR_NO_SUCH_OBJECT
gfarm_url does not exist.
Others An error except the above occurred. The reason is shown by its
pointed strings.