.\" @(#)$RCSfile: lfc_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 LFC_READLINK 3 "$Date: 2004/06/28 09:46:55 $" LFC "LFC Library Functions"
.SH NAME
lfc_readlink \- read value of a symbolic link in the LFC Name Server
.SH SYNOPSIS
.B #include <sys/types.h>
.br
\fB#include "lfc_api.h"\fR
.sp
.BI "int lfc_readlink (const char *" path ,
.BI "char *" buf ,
.BI "size_t " bufsiz )
.SH DESCRIPTION
.B lfc_readlink
reads the value of a symbolic link in the LFC Name Server.
.TP
.I path
specifies the link name relative to the current LFC directory or
the full LFC 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 lfc_chdir(3) ,
.BR lfc_statg(3) ,
.B lfc_symlink(3)
.SH AUTHOR
\fBLCG Grid Deployment\fP Team