mirror/86Box-docs
1
0
Fork 0
mirror of https://github.com/86Box/docs.git synced 2026-02-22 09:35:33 -07:00
Code Issues Packages Projects Releases Wiki Activity

network: vde_switch does not require root

Browse Source 
Just a bit of erronous documentation.  VDE's whole purpose was to run
a networking stack as a user without requiring root; vde_switch
defaults to setting the UID/GID of the socket to the user that
initiated it with mode 0600: plenty good enough for most users (and
86Box usage).

The default socket directory is already /tmp/vde.ctl, too, but might
as well keep it in the documentation here so that it's more obvious to
change.
This commit is contained in:
Mike Swanson
2024-09-02 16:26:36 -07:00
parent d19501ed9f
commit 1e46002678
1 changed files with 2 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
hardware/network.rst
View File

@@ -96,18 +96,15 @@ Creating the virtual switch
Before connecting 86Box, a virtual switch must be created with the ``vde_switch`` tool.
.. note:: ``vde_switch`` requires root privileges to *create* the switch. Applications will be able to connect to the switch with unprivileged (non-root) permissions.
.. code-block:: shell
vde_switch --mode 666 --numports 8 --mgmt /tmp/vde.mgmt --mgmtmode 666 -s /tmp/vde.ctl
vde_switch --numports 8 --mgmt /tmp/vde.mgmt -s /tmp/vde.ctl
This command:
* Creates the *management* socket at ``/tmp/vde.mgmt``
* Creates the *control* socket at ``/tmp/vde.ctl``
* Sets the sockets' permissions to world read/write to allow unprivileged access
* Sets the number of switch ports to 8
* Sets the number of switch ports to 8 (default is 32)
Adding ``--daemon`` to the command will run ``vde_switch`` in the background.