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.