NAME

       lfc_symlink - make a symbolic link to a file or a directory in the LFC Name Server

SYNOPSIS

       #include <sys/types.h>
       #include "lfc_api.h"

       int lfc_symlink (const char *target, const char *linkname)

DESCRIPTION

       lfc_symlink makes a symbolic link to a file or a directory in the LFC Name Server.

       linkname
              specifies  the  link  name  relative  to  the current LFC directory or the full LFC
              pathname.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation  failed.  In
       the latter case, serrno is set appropriately.

ERRORS

       ENOENT       A component of linkname prefix does not exist.

       EACCES       Search  permission  is  denied  on  a  component  of linkname prefix or write
                    permission on linkname parent directory is denied.

       EFAULT       target or linkname is a NULL pointer.

       EEXIST       linkname exists already.

       ENOTDIR      A component of linkname prefix is not a directory.

       ENOSPC       The name server database is full.

       ENAMETOOLONG The length of target or linkname exceeds CA_MAXPATHLEN or  the  length  of  a
                    linkname component exceeds CA_MAXNAMELEN.

       SENOSHOST    Host unknown.

       SENOSSERV    Service unknown.

       SECOMERR     Communication error.

       SELOOP       Too many symbolic links encountered when parsing linkname.

       ENSNACT      Name server is not running or is being shutdown.

SEE ALSO

       Castor_limits(4), lfc_chdir(3), lfc_chmod(3), lfc_readlink(3), lfc_statg(3), Cupvlist(1)

AUTHOR

       LCG Grid Deployment Team