diff --git a/ansible_mitogen/connection.py b/ansible_mitogen/connection.py index bfcae929..192c6dd4 100644 --- a/ansible_mitogen/connection.py +++ b/ansible_mitogen/connection.py @@ -117,7 +117,6 @@ def _connect_machinectl(spec): def _connect_setns(spec): - print 'ULTRAFLEEN', spec['remote_addr'], spec['remote_user'] return { 'method': 'setns', 'kwargs': { diff --git a/docs/ansible.rst b/docs/ansible.rst index 929835f8..d86a42cb 100644 --- a/docs/ansible.rst +++ b/docs/ansible.rst @@ -257,10 +257,17 @@ command line, or as host and group variables. File Transfer ~~~~~~~~~~~~~ -Normally a tool like ``scp`` is used to copy a file with the ``copy`` or -``template`` actions, or when uploading modules with pipelining disabled. With -Mitogen copies are implemented natively using the same interpreters, connection -tree, and routed message bus that carries RPCs. +Normally `sftp `_ or +`scp `_ is used to copy a file by the +`assemble `_, +`copy `_, +`patch `_, +`script `_, +`template `_, and +`unarchive `_ +actions, or when uploading modules with pipelining disabled. With Mitogen +copies are implemented natively using the same interpreters, connection tree, +and routed message bus that carries RPCs. This permits streaming directly between endpoints regardless of execution environment, without necessitating temporary copies in intermediary accounts or @@ -278,14 +285,16 @@ Safety Incomplete transfers proceed to a hidden file in the destination directory, with content and metadata synced using `fsync(2) -`_ prior to being renamed over any existing -file. This ensures the file remains consistent in the event of a crash, or when +`_ prior to rename over any existing file. +This ensures the file remains consistent in the event of a crash, or when overlapping `ansible-playbook` runs deploy differing file contents. -The ``sftp`` and ``scp`` tools may cause undetectable data corruption in the -form of truncated files, or files containing partial data copies from -overlapping runs of `ansible-playbook`. Both tools additionally expose a window -where users of the file may observe inconsistent contents. +The `sftp `_ and `scp +`_ tools may cause undetectable data +corruption in the form of truncated files, or files containing intermingled +data segments from overlapping runs. In normal operation both tools +additionally expose a window where users of the file may observe inconsistent +contents. Performance