``str``

        :returns:   True if file was successfully copied to remote, or False
        :rtype:     ``bool``
        r