Return_Values

   0                  Successful completion
   -1                 Indicates an error. errno is set to indicate
                      the error:

                      o  EACCES - Write permission is denied in the
                         directory where the symbolic link is being
                         created, or search permission is denied
                         for a component of the path prefix of link_
                         name.

                      o  EEXIST - The link_name argument names an
                         existing file or symbolic link.

                      o  ENAMETOOLONG - The length of the link_name
                         argument exceeds PATH_MAX, or a pathname
                         component is longer than NAME_MAX, or the
                         length of the link_contents argument is
                         longer than SYMLINK_MAX.

                      o  ENOSPC - The directory in which the entry
                         for the new symbolic link is being placed
                         cannot be extended because no space is
                         left on the file system containing the
                         directory, or the new symbolic link cannot
                         be created because no space is left on the
                         file system that would contain the link, or
                         the file system is out of file-allocation
                         resources.

                      o  Any errno value from creat, fsync, lstat,
                         or write.