LFC_SYMLINK(3)						       LFC Library Functions						    LFC_SYMLINK(3)

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

LFC
							   $Date: 2004/06/28 09:18:05 $ 					    LFC_SYMLINK(3)