Updated docs
This commit is contained in:
parent
d1cb07356c
commit
ac4606bcf7
@ -251,7 +251,7 @@ destinations on the Reticulum network.
|
|||||||
|
|
||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
usage: rnpath.py [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
||||||
|
|
||||||
Reticulum Path Discovery Utility
|
Reticulum Path Discovery Utility
|
||||||
|
|
||||||
@ -281,7 +281,7 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
# Run rnprobe
|
# Run rnprobe
|
||||||
python3 -m RNS.Utilities.rnprobe example_utilities.echo.request 9382f334de63217a4278
|
rnprobe example_utilities.echo.request 9382f334de63217a4278
|
||||||
|
|
||||||
# Example output
|
# Example output
|
||||||
Sent 16 byte probe to <9382f334de63217a4278>
|
Sent 16 byte probe to <9382f334de63217a4278>
|
||||||
@ -290,7 +290,7 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
|
|
||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
usage: rnprobe.py [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
usage: rnprobe [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
||||||
|
|
||||||
Reticulum Probe Utility
|
Reticulum Probe Utility
|
||||||
|
|
||||||
@ -305,6 +305,47 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
-v, --verbose
|
-v, --verbose
|
||||||
|
|
||||||
|
|
||||||
|
The rncp Utility
|
||||||
|
================
|
||||||
|
|
||||||
|
The ``rncp`` utility is a simple file transfer tool. Using it, you can transfer
|
||||||
|
files through Reticulum.
|
||||||
|
|
||||||
|
.. code:: text
|
||||||
|
|
||||||
|
# Run rncp on the receiving system, specifying which identities
|
||||||
|
# are allowed to send files.
|
||||||
|
rncp --receive --allow 940ea3f9e1037d38758f --allow e28d5aee4317c24a9041
|
||||||
|
|
||||||
|
# From another system, copy a file to the receiving system
|
||||||
|
rncp ~/path/to/file.tgz 256320d405d6d525d1e9
|
||||||
|
|
||||||
|
You can specify as many allowed senders as needed, or complete disable authentication.
|
||||||
|
|
||||||
|
.. code:: text
|
||||||
|
|
||||||
|
usage: rncp.py [-h] [--config path] [-v] [-q] [-i] [-r] [-b] [-a ALLOW] [-n] [-w seconds] [--version] [file] [destination]
|
||||||
|
|
||||||
|
Reticulum File Transfer Utility
|
||||||
|
|
||||||
|
positional arguments:
|
||||||
|
file file to be transferred
|
||||||
|
destination hexadecimal hash of the receiver
|
||||||
|
|
||||||
|
optional arguments:
|
||||||
|
-h, --help show this help message and exit
|
||||||
|
--config path path to alternative Reticulum config directory
|
||||||
|
-v, --verbose increase verbosity
|
||||||
|
-q, --quiet decrease verbosity
|
||||||
|
-i, --identity print identity and destination info and exit
|
||||||
|
-r, --receive wait for incoming files
|
||||||
|
-b, --no-announce don't announce at program start
|
||||||
|
-a ALLOW, --allow ALLOW accept from this identity
|
||||||
|
-n, --no-auth accept files from anyone
|
||||||
|
-w seconds sender timeout before giving up
|
||||||
|
--version show program's version number and exit
|
||||||
|
|
||||||
|
|
||||||
Improving System Configuration
|
Improving System Configuration
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
|
@ -76,6 +76,7 @@ to participate in the development of Reticulum itself.</p>
|
|||||||
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnstatus-utility">The rnstatus Utility</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnstatus-utility">The rnstatus Utility</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnpath-utility">The rnpath Utility</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnpath-utility">The rnpath Utility</a></li>
|
||||||
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnprobe-utility">The rnprobe Utility</a></li>
|
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rnprobe-utility">The rnprobe Utility</a></li>
|
||||||
|
<li class="toctree-l3"><a class="reference internal" href="using.html#the-rncp-utility">The rncp Utility</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li class="toctree-l2"><a class="reference internal" href="using.html#improving-system-configuration">Improving System Configuration</a><ul>
|
<li class="toctree-l2"><a class="reference internal" href="using.html#improving-system-configuration">Improving System Configuration</a><ul>
|
||||||
|
File diff suppressed because one or more lines are too long
@ -267,7 +267,7 @@ rnpath eca6f4e4dc26ae329e61
|
|||||||
Path found, destination <eca6f4e4dc26ae329e61> is 4 hops away via <56b115c30cd386cad69c> on TCPInterface[Testnet/frankfurt.rns.unsigned.io:4965]
|
Path found, destination <eca6f4e4dc26ae329e61> is 4 hops away via <56b115c30cd386cad69c> on TCPInterface[Testnet/frankfurt.rns.unsigned.io:4965]
|
||||||
</pre></div>
|
</pre></div>
|
||||||
</div>
|
</div>
|
||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnpath.py [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
||||||
|
|
||||||
Reticulum Path Discovery Utility
|
Reticulum Path Discovery Utility
|
||||||
|
|
||||||
@ -294,7 +294,7 @@ to the <code class="docutils literal notranslate"><span class="pre">ping</span><
|
|||||||
specified destination is configured to send proofs for received packets. Many
|
specified destination is configured to send proofs for received packets. Many
|
||||||
destinations will not have this option enabled, and will not be probable.</p>
|
destinations will not have this option enabled, and will not be probable.</p>
|
||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnprobe
|
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rnprobe
|
||||||
python3 -m RNS.Utilities.rnprobe example_utilities.echo.request 9382f334de63217a4278
|
rnprobe example_utilities.echo.request 9382f334de63217a4278
|
||||||
|
|
||||||
# Example output
|
# Example output
|
||||||
Sent 16 byte probe to <9382f334de63217a4278>
|
Sent 16 byte probe to <9382f334de63217a4278>
|
||||||
@ -302,7 +302,7 @@ Valid reply received from <9382f334de63217a4278>
|
|||||||
Round-trip time is 38.469 milliseconds over 2 hops
|
Round-trip time is 38.469 milliseconds over 2 hops
|
||||||
</pre></div>
|
</pre></div>
|
||||||
</div>
|
</div>
|
||||||
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnprobe.py [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rnprobe [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
||||||
|
|
||||||
Reticulum Probe Utility
|
Reticulum Probe Utility
|
||||||
|
|
||||||
@ -318,6 +318,42 @@ optional arguments:
|
|||||||
</pre></div>
|
</pre></div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
<div class="section" id="the-rncp-utility">
|
||||||
|
<h3>The rncp Utility<a class="headerlink" href="#the-rncp-utility" title="Permalink to this headline">¶</a></h3>
|
||||||
|
<p>The <code class="docutils literal notranslate"><span class="pre">rncp</span></code> utility is a simple file transfer tool. Using it, you can transfer
|
||||||
|
files through Reticulum.</p>
|
||||||
|
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span># Run rncp on the receiving system, specifying which identities
|
||||||
|
# are allowed to send files.
|
||||||
|
rncp --receive --allow 940ea3f9e1037d38758f --allow e28d5aee4317c24a9041
|
||||||
|
|
||||||
|
# From another system, copy a file to the receiving system
|
||||||
|
rncp ~/path/to/file.tgz 256320d405d6d525d1e9
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
<p>You can specify as many allowed senders as needed, or complete disable authentication.</p>
|
||||||
|
<div class="highlight-text notranslate"><div class="highlight"><pre><span></span>usage: rncp.py [-h] [--config path] [-v] [-q] [-i] [-r] [-b] [-a ALLOW] [-n] [-w seconds] [--version] [file] [destination]
|
||||||
|
|
||||||
|
Reticulum File Transfer Utility
|
||||||
|
|
||||||
|
positional arguments:
|
||||||
|
file file to be transferred
|
||||||
|
destination hexadecimal hash of the receiver
|
||||||
|
|
||||||
|
optional arguments:
|
||||||
|
-h, --help show this help message and exit
|
||||||
|
--config path path to alternative Reticulum config directory
|
||||||
|
-v, --verbose increase verbosity
|
||||||
|
-q, --quiet decrease verbosity
|
||||||
|
-i, --identity print identity and destination info and exit
|
||||||
|
-r, --receive wait for incoming files
|
||||||
|
-b, --no-announce don't announce at program start
|
||||||
|
-a ALLOW, --allow ALLOW accept from this identity
|
||||||
|
-n, --no-auth accept files from anyone
|
||||||
|
-w seconds sender timeout before giving up
|
||||||
|
--version show program's version number and exit
|
||||||
|
</pre></div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
</div>
|
</div>
|
||||||
<div class="section" id="improving-system-configuration">
|
<div class="section" id="improving-system-configuration">
|
||||||
<h2>Improving System Configuration<a class="headerlink" href="#improving-system-configuration" title="Permalink to this headline">¶</a></h2>
|
<h2>Improving System Configuration<a class="headerlink" href="#improving-system-configuration" title="Permalink to this headline">¶</a></h2>
|
||||||
@ -415,6 +451,7 @@ WantedBy=multi-user.target
|
|||||||
<li><a class="reference internal" href="#the-rnstatus-utility">The rnstatus Utility</a></li>
|
<li><a class="reference internal" href="#the-rnstatus-utility">The rnstatus Utility</a></li>
|
||||||
<li><a class="reference internal" href="#the-rnpath-utility">The rnpath Utility</a></li>
|
<li><a class="reference internal" href="#the-rnpath-utility">The rnpath Utility</a></li>
|
||||||
<li><a class="reference internal" href="#the-rnprobe-utility">The rnprobe Utility</a></li>
|
<li><a class="reference internal" href="#the-rnprobe-utility">The rnprobe Utility</a></li>
|
||||||
|
<li><a class="reference internal" href="#the-rncp-utility">The rncp Utility</a></li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
<li><a class="reference internal" href="#improving-system-configuration">Improving System Configuration</a><ul>
|
<li><a class="reference internal" href="#improving-system-configuration">Improving System Configuration</a><ul>
|
||||||
|
@ -251,7 +251,7 @@ destinations on the Reticulum network.
|
|||||||
|
|
||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
usage: rnpath.py [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
usage: rnpath [-h] [--config CONFIG] [--version] [-t] [-r] [-d] [-D] [-w seconds] [-v] [destination]
|
||||||
|
|
||||||
Reticulum Path Discovery Utility
|
Reticulum Path Discovery Utility
|
||||||
|
|
||||||
@ -281,7 +281,7 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
# Run rnprobe
|
# Run rnprobe
|
||||||
python3 -m RNS.Utilities.rnprobe example_utilities.echo.request 9382f334de63217a4278
|
rnprobe example_utilities.echo.request 9382f334de63217a4278
|
||||||
|
|
||||||
# Example output
|
# Example output
|
||||||
Sent 16 byte probe to <9382f334de63217a4278>
|
Sent 16 byte probe to <9382f334de63217a4278>
|
||||||
@ -290,7 +290,7 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
|
|
||||||
.. code:: text
|
.. code:: text
|
||||||
|
|
||||||
usage: rnprobe.py [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
usage: rnprobe [-h] [--config CONFIG] [--version] [-v] [full_name] [destination_hash]
|
||||||
|
|
||||||
Reticulum Probe Utility
|
Reticulum Probe Utility
|
||||||
|
|
||||||
@ -305,6 +305,47 @@ destinations will not have this option enabled, and will not be probable.
|
|||||||
-v, --verbose
|
-v, --verbose
|
||||||
|
|
||||||
|
|
||||||
|
The rncp Utility
|
||||||
|
================
|
||||||
|
|
||||||
|
The ``rncp`` utility is a simple file transfer tool. Using it, you can transfer
|
||||||
|
files through Reticulum.
|
||||||
|
|
||||||
|
.. code:: text
|
||||||
|
|
||||||
|
# Run rncp on the receiving system, specifying which identities
|
||||||
|
# are allowed to send files.
|
||||||
|
rncp --receive --allow 940ea3f9e1037d38758f --allow e28d5aee4317c24a9041
|
||||||
|
|
||||||
|
# From another system, copy a file to the receiving system
|
||||||
|
rncp ~/path/to/file.tgz 256320d405d6d525d1e9
|
||||||
|
|
||||||
|
You can specify as many allowed senders as needed, or complete disable authentication.
|
||||||
|
|
||||||
|
.. code:: text
|
||||||
|
|
||||||
|
usage: rncp.py [-h] [--config path] [-v] [-q] [-i] [-r] [-b] [-a ALLOW] [-n] [-w seconds] [--version] [file] [destination]
|
||||||
|
|
||||||
|
Reticulum File Transfer Utility
|
||||||
|
|
||||||
|
positional arguments:
|
||||||
|
file file to be transferred
|
||||||
|
destination hexadecimal hash of the receiver
|
||||||
|
|
||||||
|
optional arguments:
|
||||||
|
-h, --help show this help message and exit
|
||||||
|
--config path path to alternative Reticulum config directory
|
||||||
|
-v, --verbose increase verbosity
|
||||||
|
-q, --quiet decrease verbosity
|
||||||
|
-i, --identity print identity and destination info and exit
|
||||||
|
-r, --receive wait for incoming files
|
||||||
|
-b, --no-announce don't announce at program start
|
||||||
|
-a ALLOW, --allow ALLOW accept from this identity
|
||||||
|
-n, --no-auth accept files from anyone
|
||||||
|
-w seconds sender timeout before giving up
|
||||||
|
--version show program's version number and exit
|
||||||
|
|
||||||
|
|
||||||
Improving System Configuration
|
Improving System Configuration
|
||||||
------------------------------
|
------------------------------
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user