When we hard-link a file, and the link path already exists, give the link path in the error message instead of the source

When a symlink fails because the path already exists and force=no, we should output path in the error message instead of source.

Also adds an integration test for the above.

Fixes #7254

now when making multiple dirs in path to make dir, same permissions are assigned (but only for NEW dirs)

Signed-off-by: Brian Coca <briancoca+ansible@gmail.com>

I came to this example today (line 50), and when I tried it, I got an error:

`msg: src and dest are required for creating links`

So, I changed **path** to **src** and it worked fine. Looks like the example is wrong, since the docs say "dest" is already an alias for "path", in which case we would have 2 "path" definitions.

Use common file argument system previously implemented by @sivel for rax modules on the file modules as well (copy/file/template).
Application to other cloud providers would make very good sense.

previous operation.

else which made it try to link x2

also updated docs to be a bit clearer on symlink behaviour

timeit shows a speedup of ~3x on Python 2.7.5 x86_64.
It also makes the code a bit shorter.

- unified set attribute functions ... not sure why 2 identical functions
exist with diff names, now there are 3 while i repoint all modules to 1
- fixed issue with symlinks being created w/o existing src when force=no
- refactored conditionals, simplified where possible
- added tests for symlink to nonexistant source, with both force options
- made symlink on existing attomic (force)

c(dest) -> c(path)

Updated the force parameter description; added one example how to create the symlinks pointing to non-absolute paths

Found a way how to have symlinks towards files without absolute paths in prefixes; fixed incorrect force setting on the hard links, which can not point to non-existing files

Started the development of the 'chdir' functionality for file module - creation symlinks without the base directory prefix

Added to the file module the functionality to force conversion hard link and symlink when the force attribute is set to 'yes'

This fixes issue #5159.

raise errors when omitted, updated changelog with new modules.

This reverts commit 4d4518ed.

Signed-off-by: Dave Simons <dave@inuits.eu>

For this, add internal "original_basename" param to file module,
similar to copy module. (Param name is a bit misnormer now, should
be treated as "original basepath").

Resolves this issue: https://github.com/ansible/ansible/issues/2067