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.

Gfarm                                           13 November 2006                                 GFS_REALPATH(3)