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.