.\" @(#)$RCSfile: dpns_readlink.man,v $ $Revision: 1.1.1.1 $ $Date: 2004/06/28 09:46:55 $ CERN IT-GD/CT Jean-Philippe Baud
.\" Copyright (C) 2004 by CERN/IT/GD/CT
.\" All rights reserved
.\"
.TH DPNS_READLINK 3 "$Date: 2004/06/28 09:46:55 $" DPNS "DPNS Library Functions"
.SH NAME
dpns_readlink \- read value of a symbolic link in the DPNS Name Server
.SH SYNOPSIS
.B #include <sys/types.h>
.br
\fB#include "dpns_api.h"\fR
.sp
.BI "int dpns_readlink (const char *" path ,
.BI "char *" buf ,
.BI "size_t " bufsiz )
.SH DESCRIPTION
.B dpns_readlink
reads the value of a symbolic link in the DPNS Name Server.
.TP
.I path
specifies the link name relative to the current DPNS directory or
the full DPNS pathname.
.TP
.I buf
points at a buffer to receive the value.
.TP
.I bufsiz
gives the buffer size.
.SH RETURN VALUE
This routine returns the number of characters put in the buffer if the operation
was successful or -1 if the operation failed. In the latter case,
.B serrno
is set appropriately.
.SH ERRORS
.TP 1.3i
.B ENOENT
The named link does not exist or is a null pathname.
.TP
.B EACCES
Search permission is denied on a component of the
.I path
prefix.
.TP
.B EFAULT
.I path
or
.I buf
is a NULL pointer.
.TP
.B ENOTDIR
A component of
.I path
prefix is not a directory.
.TP
.B EINVAL
.I path
is not a symbolic link.
.TP
.B ENAMETOOLONG
The length of
.I path
exceeds
.B CA_MAXPATHLEN
or the length of a
.I path
component exceeds
.BR CA_MAXNAMELEN .
.TP
.B SENOSHOST
Host unknown.
.TP
.B SENOSSERV
Service unknown.
.TP
.B SECOMERR
Communication error.
.TP
.B ENSNACT
Name server is not running or is being shutdown.
.SH SEE ALSO
.BR Castor_limits(4) ,
.BR dpns_chdir(3) ,
.BR dpns_stat(3),\ dpns_statg(3) ,
.B dpns_symlink(3)
.SH AUTHOR
\fBLCG Grid Deployment\fP Team