symlink(2)                                             symlink(2)



NAME
     symlink - make symbolic link to a file

SYNOPSIS
     int symlink(name1, name2)
     char *name1, *name2;

DESCRIPTION
     A symbolic link name2 is created to name1 (name2 is the name
     of the file created, name1 is the string used in creating
     the symbolic link).  Either name may be an arbitrary path
     name; the files need not be on the same file system.

STATUS MESSAGES AND VALUES
     Upon successful completion, a zero value is returned.  If an
     error occurs, the error code is stored in errno and a -1
     value is returned.

     The symbolic link is made unless one or more of the
     following is true:

     EPERM
          Either name1 or name2 contains a character with the
          high-order bit set.

     EPERM
          A pathname contains a character with the high-order bit
          set.

     ENAMETOOLONG
          A component of a pathname exceeded NAME_MAX characters,
          or an entire pathname exceeded PATH_MAX.

     ELOOP
          Too many symbolic links were encountered in translating
          a pathname.

     ENOENT
          One of the pathnames specified was too long.

     ENOTDIR
          A component of the name2 prefix is not a directory.

     EEXIST
          name2 already exists.

     EACCES
          A component of the name2 path prefix denies search
          permission.

     EROFS
          The file name2 would reside on a read-only file system.



January 1992                                                    1

symlink(2)                                             symlink(2)



     EFAULT
          name1 or name2 points outside the process's allocated
          address space.

SEE ALSO
     link(2), readlink(2), unlink(2)

     ln(1) in A/UX Command Reference















































2                                                    January 1992