returns stats of the file/dir passed in the pathname
in success it will return a meta_data outcome storing stats regarding the file/dir
in case of failure an error will be returned
this feature does not resolve symbolic links and returns stats of the link itself