.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "GFS_REALPATH" "3" "13 November 2006" "Gfarm" ""

.SH NAME
gfs_realpath \- resolve pathname in Gfarm filesystem
.SH SYNOPSIS
.sp
\fB#include <gfarm/gfarm.h>
.sp
char *gfs_realpath (const char * \fIgfarm_url\fB, char ** \fIresolved_pathp\fB);
\fR
.SH "DESCRIPTION"
.PP
\fBgfs_realpath\fR expands a home directory '~'
and resolves references to '.', '..' and extra '/' characters in the
null terminated string pointed to by \fIgfarm_url\fR
and stores the canonicalized absolute pathname to dynamically
allocated memory space whose pointer is returned to
\fIresolved_pathp\fR\&.  It will be necessary to free
the dynamically allocated memory space pointed to by
\fIresolved_pathp\fR\&.
.SH "RETURN VALUES"
.TP
\fBNULL\fR
The function terminated successfully.
.TP
\fBGFARM_ERR_NO_MEMORY\fR
Insufficient memory was available.
.TP
\fBGFARM_ERR_NOT_A_DIRECTORY\fR
A component of the path prefix is not a directory.
.TP
\fBGFARM_ERR_INVALID_ARGUMENT\fR
\fIgfarm_url\fR is NULL.
.TP
\fBGFARM_ERR_PERMISSION_DENIED\fR
\fIgfarm_url\fR points outside your accessible
address space.
.TP
\fBGFARM_ERR_NO_SUCH_OBJECT\fR
\fIgfarm_url\fR does not exist.
.TP
\fBOthers\fR
An error except the above occurred.  The reason is shown by its
pointed strings.